Image、Audio 及 Video Extenders 管理與程式設計

QbQuerySetFeatureData


影像 音效 視訊
X    

設定查詢物件中某特性之相關影像資料的來源。 您只能在新增特性到查詢物件中後,才能設定資料的來源。 資料來源可以是使用者表格、檔案或工作站緩衝區的影像。唯有在非分割資料庫環境中,才能使用從屬站檔案或工作站緩衝區做為資料來源。 此外,您可以明確地指定平均色或直方圖色特性的資料。

使用 QbQuerySetFeatureData 於伺服器檔案中設定影像資料的來源後,使用 QbQueryStringSearch。 QbQuerySearch 不使用 QbQuerySetFeatureData 於伺服器檔案中設定影像資料的來源。

Image Extender 具有下列特性:

授權

無。

檔案庫
OS/2 與 Windows AIX、HP-UX 及 Solaris
dmbqqry.lib libdmbqqry.a (AIX)

libdmbqqry.sl (HP-UX)

libdmbqqry.so (Solaris)

併入檔

dmbqbapi.h

語法

SQLRETURN QbQuerySetFeatureData(
      QbQueryHandle qObj,
      char *featureName,
      QbImageSource* imgSource
      );

參數

qObj (in)
查詢物件的 handle。

featureName (in)
所要設定的特性名稱。

imgSource (in)
指向影像來源結構的指標。假設您將 imgSource 的值設為 0 (NULL), 則表示不應變更特性中的資訊。 進一步資訊請參閱使用資料來源結構

錯誤碼

qbiECinvalidQueryHandle
您指定的查詢物件 handle 所參照的查詢物件無效。

qbiECunknownFeatureClass
您指定的特性不是一個可辨識的特性類別名稱。

qbiECinvalidFeatureClass
您指定之特性的名稱格式無效。

qbiECfeatureNotPresent
您指定的特性並非查詢物件內的成員。

qbiECfileUnreadable
找不到或無法讀取影像來源檔。

範例

在查詢物件中設定直方圖顏色特性的資料來源。此特性的資料來源是從屬站工作站上的檔案:

#include <dmbqbapi.h>
QbQueryHandle qoHandle;
QbImageSource        imgSource;
imgSource.sourceType = qbiSource_ClientFile;
strcpy(featureName,"QbColorHistogramFeatureClass");
strcpy(imgSource.clientFile, "/tmp/image.gif");
rc = QbQuerySetFeatureData(qoHandle, featureName, &imgSource);


[ 頁面頂端 | 前一頁 | 下一頁 | 目錄 | 索引 ]