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

DB2Image


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

画像の内容をデータベース表に保管します。 イメージ・ソースは、クライアント・バッファー、クライアント・ファイル、またはサーバー・ファイルのどれにあってもかまいません。 画像は、データベース表に BLOB として保管することも、サーバー・ファイル (データベースによって参照される) に保管することもできます。 イメージ・ソースは、サポートされる形式であっても、サポートされない形式であってもかまいません。 サポートされる形式の場合には、DB2 イメージ・エクステンダーがその属性を識別して保管します。 サポートされない形式の場合には、その属性を UDF に指定しなければなりません。

インクルード・ファイル

dmbimage.h

構文

内容をバッファーまたはクライアント・ファイルから保管する

>>-DB2Image--(--dbname--,--content--,--source_format--,--------->
 
>----target_file--,--comment--)--------------------------------><
 

構文

内容をサーバー・ファイルから保管する

>>-DB2Image--(--dbname--,--source_file--,--source_format--,----->
 
>----stortype--,--comment--)-----------------------------------><
 

構文

ユーザー指定属性をもつ内容をバッファーまたはクライアント・ファイルから保管する

>>-DB2Image--(--dbname--,--content--,--target_file--,----------->
 
>----comment--,--attrs--,--thumbnail--)------------------------><
 

構文

ユーザー指定属性をもつ内容をサーバー・ファイルから保管する

>>-DB2Image--(--dbname--,--source_file--,--stortype--,--comment--,-->
 
>---attrs--,--thumbnail--)-------------------------------------><
 

構文

内容をバッファーまたはクライアント・ファイルから保管し、形式変換する

>>-DB2Image--(--dbname--,--content--,--source_format--,--------->
 
>----target_format--,--target_file--,--comment--)--------------><
 

構文

内容をサーバー・ファイルから保管し、形式変換する

>>-DB2Image--(--dbname--,--source_file--,--source_format--,----->
 
>----target_format--,--target_file--,--comment--)--------------><
 

構文

内容をバッファーまたはクライアント・ファイルから保管し、形式変換する

>>-DB2Image--(--dbname--,--content--,--source_format--,--------->
 
>----target_format--,--conversion_options--,--target_file--,---->
 
>----comment--)------------------------------------------------><
 

構文

内容をサーバー・ファイルから保管し、形式変換および変更の追加を行う

>>-DB2Image--(--dbname--,--source_file--,--source_format--,----->
 
>----target_format--,--conversion_options--,--target_file--,---->
 
>----comment--)------------------------------------------------><
 

パラメーター (データ・タイプ)

dbname (VARCHAR(18))
現在接続されているデータベース・サーバーの名前。 これは、特殊レジスター CURRENT SERVER で示されます。

content (BLOB(2G) AS LOCATOR)
画像の内容をもつホスト変数。 ホスト変数のタイプは BLOB、BLOB_FILE、または BLOB_LOCATOR です。 DB2 は、内容のデータ・タイプを BLOB_LOCATOR にプロモートし、LOB ロケーターを DB2Image UDF に渡します。

source_format (VARCHAR(8))
ソース・イメージの形式。 ヌル値や、空ストリング、文字ストリング ASIS が指定できます。 これら 3 つの場合、その形式はイメージ・エクステンダーが自動的に決定します。 画像は、そのソースと同じ形式で保管されます。 サポートされる画像形式については、表 4 を参照してください。

target_format (VARCHAR(8))
保管後の画像の形式。 ソース・イメージの形式が、適宜、変換されます。

target_file (LONG VARCHAR)
ターゲットのサーバー・ファイルの名前 (サーバー・ファイルへ保管する場合)、またはヌル値か空ストリング (データベースへ BLOB として保管する場合)。 ターゲットのファイル名には完全修飾名を指定できます。 名前が修飾されていない場合は、そのファイルを見つけるのにサーバーの DB2IMAGESTORE と DB2MMSTORE 環境変数が使用されます。 画像を形式変換して保管する場合には、ターゲット・ファイルへのパスを DB2IMAGEPATH と DB2MMPATH 環境変数に指定しなければなりません。

source_file (LONG VARCHAR)
ソースのサーバー・ファイルの名前。 ソース・ファイルの名前は、完全修飾されていても、修飾されていなくてもかまいませんが、ヌル値や空ストリングであってはなりません。 名前が修飾されていないと、そのファイルを見つけるのにサーバーの DB2IMAGEPATH と DB2MMPATH 環境変数が使用されます。

stortype (INTEGER)
その画像をどこに保管するかを示す値。 定数 MMDB_STORAGE_TYPE_INTERNAL (値=1) の場合、画像は、データベースに BLOB として保管されます。 定数 MMDB_STORAGE_TYPE_EXTERNAL (値=0) の場合、イメージ内容は、サーバー・ファイル (データベースからポイント指定される) に保管されます。

comment (LONG VARCHAR)
画像とともに保管する注釈。

attrs (LONG VARCHAR FOR BIT DATA)
画像の属性。

thumbnail (LONG VARCHAR FOR BIT DATA)
その画像のサムネール。

conversion_options (VARCHAR(100))
画像の保管時に適用する回転や圧縮などの変更を指定します。 サポートされる変換オプションについては、表 5 を参照してください。

戻り値 (データ・タイプ)

画像のハンドル (DB2IMAGE)

Anita Jones の画像が入ったレコードを従業員表に挿入します。 イメージ・ソースは、クライアント・バッファーにあります。 画像を表に BLOB として保管します。

EXEC SQL BEGIN DECLARE SECTION
     SQL TYPE IS BLOB (2M) hvImg
EXEC SQL END DECLARE SECTION;
 
EXEC SQL INSERT INTO EMPLOYEE VALUES(
      '128557',
      'Anita Jones',
      DB2IMAGE(
         CURRENT SERVER,
         :hvImg,
         'ASIS',
         CAST(NULL as LONG VARCHAR),
         
         'Anita''s picture'));

Robert Smith の画像が入ったレコードを従業員表に挿入します。 イメージ・ソースは、サーバー・ファイルにあります。 そのファイルは、従業員表レコードからポイントされます。 画像の形式を保管時に BMP から GIF に変換します。さらに、画像を 110 ピクセルの幅と 150 ピクセルの高さに切り取り、LZW タイプの圧縮を使用して圧縮します。

EXEC SQL INSERT INTO EMPLOYEE VALUES(
      '384779',
      'Robert Smith',
      DB2IMAGE(
         CURRENT SERVER,
         '/employee/pictures/rsmith.bmp',
         'BMP',
         'GIF',
         '-x 110 -y 150 -c 14',
         '',
         'Robert"s picture'));

Robert Smith の画像が入ったレコードを従業員表に挿入します。 サーバー・ファイルにあるソース画像は、高さが 640 ピクセル、幅が 480 ピクセルのユーザー定義形式です。 画像は BLOB として保管します。

EXEC SQL BEGIN DECLARE SECTION;
long hvStorageType;
struct {
       short len;
       char data[400];
}hvImgattrs;
EXEC SQL END DECLARE SECTION;
 
DB2IMAGEATTRS    *pimgattr;
 
hvStorageType = MMDB_STORAGE_TYPE_INTERNAL;
 
pimgattr = (DB2IMAGEATTRS *) hvImgattrs.data;
strcpy(pimgattrt>cFormat,"FormatI");
pimgattr>width=640;
pimgattr>height=480;
hvImgattrs.len=sizeof(DB2IMAGEATTRS);
 
EXEC SQL INSERT INTO EMPLOYEE VALUES(
        '128557',
        'Anita Jones',
        DB2IMAGE(
          CURRENT SERVER,
          '/employee/images/ajones.bmp',
          :hvStorageType,
          'Anita''s picture',
          :hvImgattrs,
          CAST(NULL as LONG VARCHAR))
       );


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