IBM Books

Image Extender、Audio Extender 和 Video Extender 管理和程序设计

Content


图象 音频 视频
X X X

从数据库中检索或更新图象、音频或视频的 内容。可以将内容检索至客户机缓冲区、 客户机文件或服务器文件。

包含文件

图象 (image)
dmbimage.h

音频 (audio)
dmbaudio.h

视频 (video)
dmbvideo.h

语法

将内容检索至缓冲区或客户机文件

>>-Content--(--handle--)---------------------------------------><
 

语法

将内容段检索至缓冲区或客户机文件

>>-Content--(--handle--,--offset--,--size--)-------------------><
 

语法

将内容检索至服务器文件

>>-内容--(--handle--,--target_file--,--overwrite--)------------><
 

语法

将内容检索至缓冲区或客户机 文件,并进行格式转换-仅适用于图象

>>-Content--(--handle--,--target_format--)---------------------><
 

语法

将内容检索至服务器文件,并进行格式转换-仅适用于图象

>>-Content--(--handle--,--target_file--,--overwrite--,---------->
 
>----target_format--)------------------------------------------><
 

语法

将内容检索至缓冲区或客户机 文件,并进行格式转换和其他更改-仅适用于图象

>>-Content--(--handle--,--target_format--,--conversion_options--)-->
 
>--------------------------------------------------------------><
 

语法

将内容检索至服务器文件, 并进行格式转换和其他更改-仅适用于图象

>>-Content--(--handle--,--target_file--,--overwrite--,---------->
 
>----target_format--,--conversion_options--)-------------------><
 

语法

从缓冲区或客户机 文件更新内容

>>-Content--(--handle--,--content--,--source_format--,---------->
 
>----target_file--)--------------------------------------------><
 

语法

从服务器文件更新内容

>>-Content--(--handle--,--source_file--,--source_format--,------>
 
>----stortype--)-----------------------------------------------><
 

语法

从缓冲区或客户机文件更新具有用户提供的属性的内容

>>-Content--(--handle--,--content--,---------------------------->
 
>----target_file--,--attrs--,--thumbnail--)--------------------><
 

语法

从服务器文件更新具有用户提供的属性的内容

>>-Content--(--handle--,--source_file--,--stortype--,--attrs--,-->
 
>---thumbnail--)-----------------------------------------------><
 

语法

从缓冲区或客户机文件更新内容, 并进行格式转换-仅适用于图象

>>-Content--(--handle--,--content--,--source_format--,---------->
 
>----target_format--,--target_file--)--------------------------><
 

语法

从服务器文件更新内容,并进行格式转换-仅适用于图象

>>-Content--(--handle--,--source_file--,--source_format--,------>
 
>----target_format--,--target_file--)--------------------------><
 

语法

从缓冲区或客户机文件更新内容, 并进行格式转换和其他更改-仅适用于图象

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

语法

从服务器文件更新内容, 并进行格式转换和附加的更改-仅适用于图象

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

参数(数据类型)

handle(DB2IMAGE、DB2AUDIO 或 DB2VIDEO)
包含图象、音频或视频的句柄的列名或主变量。

offset (INTEGER)
要检索的图象、音频或视频的起始位移(从 1 开始)。

size (INTEGER)
要检索的图象、音频或视频的字节数。

source_file (LONG VARCHAR)
包含图象、音频或视频的更新内容的文件的名称。

target_file (LONG VARCHAR)
对于检索,是要将图象、音频或视频检索到其中的文件的名称。对于更新,是包含要更新的图象、音频或视频的文件的名称。

stortype (INTEGER)
指示将在何处存储已更新的图象、音频或视频的值。常量 MMDB_STORAGE_TYPE_INTERNAL(值=1) 指示将把更新过的对象以 BLOB 形式存储在数据库中。常量 MMDB_STORAGE_TYPE_EXTERNAL(值=0) 指示将把更新过的对象存储在服务器文件中。

overwrite (INTEGER)
指示是否重写目标文件(若它已存在的话)的值。值可以是 0 或 1。值 0 表示将不重写目标文件(实际上,将不发生检索)。值 1 表示若目标文件已存在,则重写它。

target_format (VARCHAR(8))
检索或更新之后图象的格式。将适当地转换源图象的格式。对于将图象检索至服务器文件, 若 target_file 与 source_file 相同,则目标格式必须与源格式相同。对于 MPG1 格式,可指定 MPG1、mpg1、MPEG1 或 mpeg1。对于 MPG2 格式, 可指定 MPG2、mpg2、MPEG2 或 mpeg2。

conversion_options (VARCHAR(100))
指定检索或更新图象时,要对其应用的更改,如旋转和压缩。参见表 5 以获取受支持的转换选项。

content (BLOB(2G) AS LOCATOR)
包含图象、音频或视频的更新内容的主变量的名称。主变量的类型可以是 BLOB、BLOB_FILE 或 BLOB_LOCATOR。DB2 使内容的数据类型转换为 BLOB_LOCATOR, 并将 LOB 定位器传送至 Content UDF。

source_format (VARCHAR(8))
图象、音频或视频的更新源的格式。可指定空值或空字符串,或仅对于图象,可指定字符串 ASIS; 在这三种情况下,Extender 将试图自动确定格式。对于 MPG1 格式,可指定 MPG1、mpg1、MPEG1 或 mpeg1。对于 MPG2 格式, 可指定 MPG2、mpg2、MPEG2 或 mpeg2。

attrs (LONG VARCHAR FOR BIT)
图象、音频或视频的属性

thumbnail (LONG VARCHAR FOR BIT DATA)
图象或视频帧的缩略图(仅适用于图象和视频)

返回值(数据类型)

检索到的图象、音频或视频的内容(若检索至缓冲区),(BLOB(2G) AS LOCATOR)。若检索至文件,VARCHAR(254)。

对于更新,是要更新的图象、音频或视频的句柄(DB2IMAGE、DB2AUDIO 或 DB2VIDEO)。

将 employee 表的 picture 列中存储的 Anita Jones 的图象检索到服务器文件中:

struct{
        short len;
      char data[250];
      }hvImg_fname;
   EXEC SQL END DECLARE SECTION;
 
EXEC SQL SELECT CONTENT (PICTURE,
       '/Employee/images/ajones.bmp',1)
     INTO :hvImg_fname
  FROM EMPLOYEE
       WHERE NAME='Anita Jones';

将 Employee 表的 Sound 列中存储的 Robert Smith 的 1-MB 的音频剪辑检索到客户机缓冲区中:

EXEC SQL BEGIN DECLARE SECTION;
     SQL TYPE IS BLOB_LOCATOR audio_loc;
   EXEC SQL END DECLARE SECTION;
 
EXEC SQL SELECT CONTENT (SOUND, 1, 1000000)
      INTO :audio_loc
  FROM EMPLOYEE
     WHERE NAME='Robert Smith';

更新 Employee 表的 picture 列中 Anita Jones 的图象; 将图象的格式由 BMP 转换为 GIF,并将图象缩小为原始大小的 50%:

EXEC SQL UPDATE EMPLOYEE
  SET picture = CONTENT(PICTURE,
       '/Employee/newimg/ajones.bmp',
         'BMP',
         'GIF',
        '-s 0.5',
       '');
       WHERE NAME='Anita Jones';


[ 页的顶部 | 上一页 | 下一页 | 目录 | 索引 ]