Image, Audio und Video Extender Verwaltung und Programmierung

Content


Image Audio Video
X X X

Ruft den Inhalt eines Abbilds, Tons oder Videos aus der Datenbank ab oder aktualisiert ihn. Der Inhalt kann in einen Client-Puffer, eine Client-Datei oder eine Server-Datei abgerufen werden.

Kopfdatei

Image
dmbimage.h

Audio
dmbaudio.h

Video
dmbvideo.h

Syntax

Abrufen des Inhalts in einen Puffer oder eine Client-Datei

>>-Content--(--kennung--)--------------------------------------><
 

Syntax

Abrufen eines Inhaltsegments in einen Puffer oder eine Client-Datei

>>-Content--(--kennung--,--rel_adresse--,--größe--)------------><
 

Syntax

Abrufen des Inhalts in eine Server-Datei

>>-Content--(--kennung--,--zieldatei--,--überschreiben--)------><
 

Syntax

Abrufen des Inhalts in einen Puffer oder eine Client-Datei mit Formatumsetzung (nur Abbilder)

>>-Content--(--kennung--,--zielformat--)-----------------------><
 

Syntax

Abrufen des Inhalts in eine Server-Datei mit Formatumsetzung (nur Abbilder)

>>-Content--(--kennung--,--zieldatei--,--überschreiben--,------->
 
>----zielformat--)---------------------------------------------><
 

Syntax

Abrufen des Inhalts in einen Puffer oder eine Client-Datei mit Formatumsetzung und zusätzlichen Änderungen (nur Abbilder)

>>-Content--(--kennung--,--zielformat--,--umsetzungsoptionen--)-->
 
>--------------------------------------------------------------><
 

Syntax

Abrufen des Inhalts in eine Server-Datei mit Formatumsetzung und zusätzlichen Änderungen (nur Abbilder)

>>-Content--(--kennung--,--zieldatei--,--überschreiben--,------->
 
>----zielformat--,--umsetzungsoptionen--)----------------------><
 

Syntax

Aktualisieren des Inhalts eines Puffers oder einer Client-Datei

>>-Content--(--kennung--,--inhalt--,--quellenformat--,---------->
 
>----zieldatei--)----------------------------------------------><
 

Syntax

Aktualisieren des Inhalts einer Server-Datei

>>-Content--(--kennung--,--quellendatei--,--quellenformat--,---->
 
>----speichertyp--)--------------------------------------------><
 

Syntax

Aktualisieren des Inhalts eines Puffers oder einer Client-Datei mit vom Benutzer angegebenen Attributen

>>-Content--(--kennung--,--inhalt--,---------------------------->
 
>----zieldatei--,--attribute--,--piktogramm--)-----------------><
 

Syntax

Aktualisieren des Inhalts einer Server-Datei mit vom Benutzer angegebenen Attributen

>>-Content--(--kennung--,--quellendatei--,--speichertyp--,--attribute--,-->
 
>---piktogramm--)----------------------------------------------><
 

Syntax

Aktualisieren des Inhalts eines Puffers oder einer Client-Datei mit Formatumsetzung (nur Abbilder)

>>-Content--(--kennung--,--inhalt--,--quellenformat--,---------->
 
>----zielformat--,--zieldatei--)-------------------------------><
 

Syntax

Aktualisieren des Inhalts einer Server-Datei mit Formatumsetzung (nur Abbilder)

>>-Content--(--kennung--,--quellendatei--,--quellenformat--,---->
 
>----zielformat--,--zieldatei--)-------------------------------><
 

Syntax

Aktualisieren des Inhalts eines Puffers oder einer Client-Datei mit Formatumsetzung und zusätzlichen Änderungen (nur Abbilder)

>>-Content--(--kennung--,--inhalt--,--quellenformat--,---------->
 
>----zielformat--,--umsetzungsoptionen--,--zieldatei--)--------><
 

Syntax

Aktualisieren des Inhalts einer Server-Datei mit Formatumsetzung und zusätzlichen Änderungen (nur Abbilder)

>>-Content--(--kennung--,--quellendatei--,--quellenformat--,---->
 
>----zielformat--,--umsetzungsoptionen--,--zieldatei--)--------><
 

Parameter (Datentyp)

kennung (DB2IMAGE, DB2AUDIO oder DB2VIDEO)
Name der Spalte oder Host-Variable, die die Kennung des Abbilds, Tons oder Videos enthält.

rel_adresse (INTEGER)
Die relative Startadresse (Ursprung 1) eines Abbilds, Tons oder Videos, das/der abgerufen werden soll.

größe (INTEGER)
Anzahl an Byte eines Abbilds, Tons oder Videos, das/der abgerufen werden soll.

quellendatei (LONG VARCHAR)
Der Name der Datei, die den Inhalt zum Aktualisieren des Abbilds, Tons oder Videos enthält.

zieldatei (LONG VARCHAR)
Beim Abrufen der Name der Datei, in die das Abbild, der Ton oder das Video abgerufen werden soll. Beim Aktualisieren der Name der Datei, die das Abbild, den Ton oder das Video enthält, das aktualisiert werden soll.

speichertyp (INTEGER)
Ein Wert, der angibt, wo das aktualisierte Abbild, der aktualisierte Ton oder das aktualisierte Video gespeichert werden soll. Die Konstante MMDB_STORAGE_TYPE_INTERNAL (Wert=1) gibt an, daß das aktualisierte Objekt in der Datenbank als BLOB gespeichert wird. Die Konstante MMDB_STORAGE_TYPE_EXTERNAL (Wert=0) gibt an, daß das aktualisierte Objekt in einer Server-Datei gespeichert wird.

überschreiben (INTEGER)
Ein Wert, der angibt, ob die Zieldatei, wenn sie bereits existiert, überschrieben wird. Der Wert kann 0 oder 1 sein. Der Wert 0 bedeutet, daß die Zieldatei nicht überschrieben wird (im Prinzip findet kein Abrufen statt). Der Wert 1 bedeutet, daß die Zieldatei überschrieben wird, wenn sie bereits existiert.

zielformat (VARCHAR(8))
Das Format des Abbilds nach dem Abrufen oder Aktualisieren. Das Format des Quellenabbilds wird entsprechend umgesetzt. Beim Abrufen eines Abbilds in eine Server-Datei muß das Zielformat, wenn die Zieldatei der Quellendatei entspricht, dasselbe Format sein wie das Quellenformat. Für das MPG1-Format können Sie MPG1, mpg1, MPEG1 bzw. mpeg1 angeben. Für das MPG2-Format können Sie MPG2, mpg2, MPEG2 bzw. mpeg2 angeben.

umsetzungsoptionen (VARCHAR(100))
Ein Wert, der Änderungen, wie z. B. Drehung und Komprimierung, angibt, die beim Abrufen oder Aktualisieren des Abbilds angewendet werden sollen. Unterstützte Umsetzungsoptionen befinden sich in Tabelle 5.

inhalt (BLOB(2G) AS LOCATOR)
Die Host-Variable, die den Inhalt für die Aktualisierung des Abbilds, Tons oder Videos enthält. Die Host-Variable kann vom Typ BLOB, BLOB_FILE oder BLOB_LOCATOR sein. DB2 stuft den Datentyp des Inhalts in BLOB_LOCATOR um und übergibt den LOB-Zeiger an die UDF Content.

quellenformat (VARCHAR(8))
Das Format der Quelle für die Aktualisierung des Abbilds, Tons oder Videos. Ein Nullwert oder eine leere Zeichenfolge kann angegeben werden, bzw. nur für Abbilder die Zeichenfolge ASIS. Bei diesen drei Angaben versucht der Extender, das Format automatisch zu bestimmen. Für das MPG1-Format können Sie MPG1, mpg1, MPEG1 bzw. mpeg1 angeben. Für das MPG2-Format können Sie MPG2, mpg2, MPEG2 bzw. mpeg2 angeben.

attribute (LONG VARCHAR FOR BIT)
Die Attribute des Abbilds, Tons oder Videos.

piktogramm (LONG VARCHAR FOR BIT DATA)
Ein Piktogramm des Abbilds oder Videovollbilds (nur Abbild und Video).

Rückgabewerte (Datentyp)

Der Inhalt des abgerufenen Abbilds, Tons oder Videos, wenn er in einen Puffer abgerufen wird (BLOB(2G) AS LOCATOR). Wenn der Inhalt in eine Datei abgerufen wird, VARCHAR(254).

Beim Aktualisieren die Kennung des zu aktualisierenden Abbilds, Tons oder Videos (DB2IMAGE, DB2AUDIO oder DB2VIDEO).

Beispiele

Abrufen des Abbilds, das für Anita Jones in der Spalte 'picture' der Tabelle 'employee' gespeichert ist, in eine Server-Datei:

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

Abrufen des 1-MB-Audioclips, der für Robert Smith in der Spalte 'sound ' der Tabelle 'employee' gespeichert ist, in einen Client-Puffer:

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

Aktualisieren des Abbilds für Anita Jones in der Spalte 'picture' der Tabelle 'employee'; Umsetzen des Formats des Abbilds von BMP in GIF und Verkleinern des Abbilds auf 50 % der Originalgröße:

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


[ Seitenanfang | Vorherige Seite | Nächste Seite | Inhaltsverzeichnis | Index ]