Extensions Image, Audio et Vidéo Administration et programmation

QbScoreTBFromName


Image Audio Vidéo
X    

Renvoie une table de scores pour une colonne Image. Chaque score est un chiffre qui exprime le degré de correspondance des caractéristiques de l'image par rapport à celles de l'objet de la requête. Ce chiffre est calculé par le biais du catalogue QBIC associé à la table et à la colonne spécifiées auxquelles appartient le descripteur de l'image. Moins ce chiffre est élevé, plus les caractéristiques de l'image correspondent à celles de l'objet de la requête.

Remarques :

  1. Produit EEE uniquement : QbScoreTBFromName n'est pas pris en charge dans un environnement de bases de données partitionnées. Utilisez la fonction UDF QbScoreFromStr après avoir obtenu la chaîne de requête à l'aide de l'API QbQueryGetString.

  2. La fonction QbScoreTBFromName ne sera plus utilisée dans les prochaines versions des environnements de bases de données non partitionnées. Pour sauvegarder une requête en vue de l'utiliser ultérieurement dans votre application, il est donc conseillé d'extraire la chaîne de requête à l'aide de l'API QbQueryGetString.

Fichier d'inclusion

Aucun.

Syntaxe

Scores renvoyés pour toutes les images cataloguées d'une colonne

>>-QbScoreTBFromName--(--nomRequête--,--table--,--colonne--)---><
 

Syntaxe

Scores renvoyés pour un nombre spécifique d'images cataloguées d'une colonne

>>-QbScoreTBFromName--(--nomRequête--,--table--,--colonne--,---->
 
>----retoursMax--)---------------------------------------------><
 

Paramètres (type de données)

nomRequête (VARCHAR(18))
Nom de l'objet de la requête.

table (CHAR (18))
Nom qualifié de la table contenant la colonne Image. Vous pouvez indiquer un nom de table non qualifié si le schéma de table correspond à l'ID utilisateur servant à lancer les services de DB2 Extensions.

colonne (CHAR(18))
Nom de la colonne Image.

retoursMax (INTEGER)
Nombre maximal de descripteurs qui seront renvoyés par la table de résultats. Si aucune valeur n'est indiquée, le nombre maximal de descripteurs renvoyés st 100.

Codes retour (type de données)

Table des descripteurs et des scores pour les images de la colonne. La table de résultats comporte deux colonnes : IMAGE_ID (DB2Image), qui contient les descripteurs d'image, et SCORE (DOUBLE), qui contient les scores. Les valeurs de cette table sont en ordre croissant de score. La valeur du score peut aller de 0.0 à une valeur proche de l'infini. Plus cette valeur est faible, plus les valeurs des caractéristiques de l'image cible sont proches de celles spécifiées dans la requête. La valeur 0.0 indique que l'image correspond exactement. La valeur -1 indique que l'image n'a pas été cataloguée.

Exemples

Compare la texture des images d'une colonne de table à celle spécifiée dans un objet de requête ; renvoie les descripteurs d'image ainsi que leurs scores :

 SELECT name, description
 INTO :hvName, :hvDesc
 FROM fabric
 WHERE CAST (swatch_img as varchar(250)) IN 
  (SELECT CAST (image_id as varchar(250)) FROM TABLE
  (QbScoreTBFromName
      'fstxtr',
      'clothes.fabric',
      'swatch_img'))
  AS T1));           


[ Début de page | Page précédente | Page suivante | Table des matières | Index ]