イメージ、オーディオ、およびビデオ・エクステンダー 管理およびプログラミングの手引き

QbQuerySetFeatureData


イメージ オーディオ ビデオ
O

照会オブジェクト内のフィーチャーに関して、画像データのソースをセットします。 データ・ソースは、照会オブジェクトにフィーチャーを追加した後でなければセットできません。 このデータ・ソースは、ユーザー表、ファイル、またはワークステーション・バッファー内の画像にすることができます。 クライアント・ファイルまたはワークステーション・バッファーをデータ・ソースとして使用できるのは、非区分データベース環境である場合に限ります。さらに、平均色やヒストグラムのフィーチャーに対してはデータを明示的に指定することができます。

QbQuerySetFeatureData を使ってサーバー・ファイル内に画像データのソースをセットした後で、QbQueryStringSearch を使用してください。 QbQuerySearch では、QbQuerySetFeatureData を使ってサーバー・ファイル内にセットした画像データのソースを使用することはありません。

イメージ・エクステンダーには、次のフィーチャーが提供されています。

許可

なし。

ライブラリー・ファイル
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)
照会オブジェクト・ハンドル。

featureName (in)
設定するフィーチャーの名前。

imgSource (in)
イメージ・ソース構造を指すポインター。 imgSource に 0 (NULL) を指定すると、フィーチャー情報の変更を禁止することになります。 詳細については、データ・ソース構造体の使用を参照してください。

エラー・コード

qbiECinvalidQueryHandle
指定された照会オブジェクト・ハンドルが有効な照会オブジェクトを参照していません。

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);


[ ページのトップ | 前ページ | 次ページ | 目次 | 索引 ]