Image, Audio und Video Extender Verwaltung und Programmierung

QbScoreFromName


Image Audio Video
X    

Gibt das Ähnlichkeitsergebnis eines Abbilds zurück, wobei es sich um eine Zahl handelt, die angibt, wie weit die Merkmale eines Abbilds mit denen eines Abfrageobjekts übereinstimmen. Der QBIC-Katalog, der der Spalte zugeordnet ist, zu der die Abbildkennung gehört, wird verwendet, um das Ähnlichkeitsergebnis des Abbilds zu berechnen. Je niedriger das Ähnlichkeitsergebnis, desto mehr stimmen die Merkmale des Abbilds mit denen des angegebenen Abfrageobjekts überein. (QbScoreFromName ersetzt QbScore; QbScore wird jedoch noch akzeptiert.)

Anmerkungen:

  1. Nur EEE: QbScoreFromName wird nicht in einer Umgebung für partitionierte Datenbanken unterstützt. Verwenden Sie statt dessen die UDF QbScoreFromStr, nachdem Sie die API QbQueryGetString verwendet haben, um die Abfragezeichenfolge abzurufen.

  2. QbScoreFromName wird in zukünftigen Releases für Umgebungen für nicht partitionierte Datenbanken nicht mehr unterstützt. Um eine Abfrage erneut zu verwenden, sollten Sie die API QbQueryGetString verwenden, um die Abfragezeichenfolge abzurufen, und diese Zeichenfolge für die spätere Verwendung in Ihrer Anwendung sichern.

Kopfdatei

Keine

Syntax

>>-QbScoreFromName--(--abbildkennung--,--abfragename--)--------><
 

Syntax

Veraltete Version

>>-QbScoreFromName--(--abfragename--,--abbildkennung--)--------><
 

Parameter (Datentyp)

abbildkennung (DB2Image)
Die Kennung für das Abbild.

abfragename (varchar(18))
Der Name des Abfrageobjekts.

Rückgabewerte (Datentyp)

Das Ähnlichkeitsergebnis des Abbilds (DOUBLE). Das Ähnlichkeitsergebnis kann im Bereich von 0,0 bis gegen unendlich liegen. Je niedriger das Ähnlichkeitsergebnis, desto mehr stimmen die Merkmalwerte des Zielabbilds mit den Merkmalwerten überein, die in der Abfrage angegeben sind. Ein Ähnlichkeitsergebnis von 0,0 gibt eine exakte Übereinstimmung an. Ein Ähnlichkeitsergebnis von Null bedeutet, daß das Abbild nicht katalogisiert wurde; die veraltete Version dieser UDF gibt das Ähnlichkeitsergebnis -1 zurück, wenn das Abbild nicht katalogisiert wurde.

Beispiele

Suchen der katalogisierten Abbilder in einer Tabellenspalte, deren Durchschnittsfarbe sehr nah an Rot liegt:

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;


[ Seitenanfang | Vorherige Seite | Nächste Seite | Inhaltsverzeichnis | Index ]