Extensions Image, Audio et Vidéo Administration et programmation

QbScoreFromName


Image Audio Vidéo
X    

Renvoie, sous forme d'un chiffre, le score d'une image, c'est-à-dire le degré de correspondance de ses caractéristiques par rapport à celles de l'objet de la requête. Ce chiffre est calculé par le biais du catalogue QBIC associé à la colonne à laquelle 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. (QbScoreFromName remplace QbScore, mais QbScore est toujours admis.)

Remarques :

  1. Produit EEE uniquement : QbScoreFromName 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 QbScoreFromName 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

>>-QbScoreFromName--(--descripteurImg--,--nomRequête--)--------><
 

Syntaxe

Version déconseillée

>>-QbScoreFromName--(--nomRequête--,--descripteurImg--)--------><
 

Paramètres (type de données)

descripteurImg (DB2Image)
Descripteur de l'image.

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

Codes retour (type de données)

Score de l'image (DOUBLE). 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. Une valeur nulle signifie que l'image n'a pas été cataloguée ; dans la version déconseillée, la valeur du score est -1 lorsque l'image n'a pas été cataloguée.

Exemples

Recherche des images cataloguées contenues dans une colonne de table et dont la couleur moyenne est très proche du rouge :

EXEC SQL BEGIN DECLARE SECTION;
char Img_fnd[100];
  EXEC SQL END DECLARE SECTION;
 
EXEC SQL SELECT NAME
  INTO :Img_fnd
  FROM FABRIC
  WHERE (QBSCOREFROMNAME(SWATCH_IMG,
         'fshavgcol'))<0.1;


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