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

Replace


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

データベースに保管されている画像や、音声、ビデオの内容を更新します。 また、その注釈を更新します。

インクルード・ファイル

イメージ
dmbimage.h

オーディオ
dmbaudio.h

ビデオ
dmbvideo.h

構文

内容をバッファーまたはクライアント・ファイルから更新し、注釈を更新する

>>-Replace--(--handle--,--content--,--source_format--,---------->
 
>----target_file--,--comment--)--------------------------------><
 

構文

内容をサーバー・ファイルから更新し、注釈を更新する

>>-Replace--(--handle--,--source_file--,--source_format--,--stortype--,-->
 
>---comment--)-------------------------------------------------><
 

インクルード・ファイル

ユーザー指定属性をもつ内容をバッファーかクライアント・ファイルから更新し、注釈を更新する

>>-Replace--(--handle--,--content--,--target_file--,------------>
 
>----comment--,--attrs--,--thumbnail--)------------------------><
 

インクルード・ファイル

ユーザー指定属性をもつ内容をサーバー・ファイルから更新し、注釈を更新する

>>-Replace--(--handle--,--source_file--,--stortype--,--comment--,-->
 
>---attrs--,--thumbnail--)-------------------------------------><
 

構文

内容をバッファーまたはクライアント・ファイルから更新し、形式変換および注釈の更新を行う − 画像のみ

>>-Replace--(--handle--,--content--,--source_format--,---------->
 
>----target_format--,--target_file--,--comment--)--------------><
 

構文

内容をサーバー・ファイルから更新し、形式変換を行い、注釈を更新する − 画像のみ

>>-Replace--(--handle--,--source_file--,--source_format--,------>
 
>----target_format--,--target_file--,--comment--)--------------><
 

構文

内容をバッファーまたはクライアント・ファイルから更新し、形式変換および追加の変更を行い、注釈を更新する − 画像のみ

>>-Replace--(--handle--,--content--,--source_format--,---------->
 
>----target_format--,--target_file--,--conversion_options--,---->
 
>----comment--)------------------------------------------------><
 

構文

内容をサーバー・ファイルから更新し、形式変換および追加の変更を行い、注釈を更新する − 画像のみ

>>-Replace--(--handle--,--source_file--,--source_format--,------>
 
>----target_format--,--conversion_options--,--target_file--,---->
 
>----comment--)------------------------------------------------><
 

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

handle (DB2IMAGE、DB2AUDIO、または DB2VIDEO)
画像、音声、またはビデオのハンドルをもつ列名またはホスト変数。

source_file (LONG VARCHAR)
画像や、音声、ビデオの更新内容をもつファイルの名前。

target_file (LONG VARCHAR)
更新前の画像や、音声、ビデオの内容をもつファイルの名前。

create_target (INTEGER)
ソース内容がサーバー・ファイルにある場合にターゲット・ファイルを作成するかどうかを指定する値。 値は 0 か 1 です。値が 0 の場合、ターゲット・ファイルは作成されません (実際には、取り出しが行われません)。 値が 1 の場合、ファイルが作成されます (ターゲット・ファイルがすでにある場合には、この値によって、実際にはそのファイルが重ね書きされます)。 ソース内容が BLOB の場合には、ターゲット・ファイルが常に作成されます (ファイルがすでにある場合には、それが重ね書きされます)。

target_format (VARCHAR(8))
取り出し後の画像の形式。 ソース・イメージの形式が、適宜、変換されます。 その内容を形式変換して更新する場合には、そのターゲット・ファイルへのパスを DB2IMAGEPATH と DB2MMPATH 環境変数に指定する必要があります。 MPG1 形式の場合、 MPG1、mpg1、MPEG1、または mpeg1 を指定できます。 MPG2 形式の場合、MPG2、mpg2、MPEG2、または mpeg2 を指定できます。

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

source_format (VARCHAR(8))
画像や、音声、ビデオの更新ソースの形式。 ヌル値や空ストリングを指定できます。 あるいは、画像の場合、文字ストリング ASIS を指定できます。 これら 3 つの場合、その形式はエクステンダーが自動的に判定します。 MPG1 形式の場合、 MPG1、mpg1、MPEG1、または mpeg1 を指定できます。 MPG2 形式の場合、MPG2、mpg2、MPEG2、または mpeg2 を指定できます。

comment (LONG VARCHAR)
注釈。

attrs (LONG VARCHAR FOR BIT DATA)
画像や、音声、ビデオの属性。

thumbnail (LONG VARCHAR FOR BIT DATA)
その画像やビデオ・フレームのサムネール (画像とビデオのみ)。

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

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

更新される画像や、音声、ビデオのハンドル (DB2IMAGE、DB2AUDIO、または DB2VIDEO)。

従業員表のピクチャー列に保管されている Anita Jones の画像を更新します。 その際、その画像の形式を BMP から GIF へ変換し、注釈を更新します。

EXEC SQL BEGIN DECLARE SECTION;
  long hvStorageType;
EXEC SQL END DECLARE SECTION;
 
hvStorageType = MMDB_STORAGE_TYPE_INTERNAL;
 
EXEC SQL UPDATE EMPLOYEE
  SET PICTURE = REPLACE(PICTURE,
        '/employee/newimg/ajones.bmp',
        'BMP',
        'GIF',
        :hvStorageType,
        'Anita''s new picture')
  WHERE NAME='Anita Jones';


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