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

內容


影像 音效 視訊
X X X

擷取或更新資料庫中影像、音效或視訊的內容。 此內容可被擷取到從屬站緩衝區、 從屬站檔案、 或伺服器檔案。

併入檔

影像
dmbimage.h

音效
dmbaudio.h

視訊
dmbvideo.h

語法

將內容擷取到緩衝區或從屬站檔案

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

語法

將內容區段擷取到緩衝區或從屬站檔案

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

語法

將內容擷取到伺服器檔案

>>-Content--(--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)
含有影像、音效或視訊 handle 的主變數或直欄名稱。

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))
更新影像、音效或視訊的來源格式。 您可以指定 NULL 值或空白字串,或僅對影像指定字串 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)。

以更新而言,指所要更新的影像、音效或視訊的 handle (DB2IMAGE、DB2AUDIO 或 DB2VIDEO)。

範例

將員工表格的圖片直欄中,儲存在 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';

將儲存在員工表格的聲音直欄中 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';

更新員工表格的圖片直欄中 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';


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