Extensions Image, Audio et Vidéo Administration et programmation

DB2Image


Image Audio Vidéo
X    

Stocke le contenu d'une image dans une table de base de données. L'objet image source peut se trouver dans une mémoire tampon client, un fichier client ou dans un fichier du serveur. L'objet image peut être stocké dans la table de la base de données en tant qu'objet BLOB ou dans un fichier du serveur (référencé par la table de la base de données). Le format de l'objet image source peut être pris en charge ou pas. Dans le premier cas, l'extension DB2Image identifie ses attributs pour le stockage. Dans le second cas, les attributs doivent être indiqués dans la fonction UDF.

Fichier d'inclusion

dmbimage.h

Syntaxe

Stockage du contenu à partir d'une mémoire tampon ou d'un fichier client

>>-DB2Image--(--nombd--,--contenu--,--format_source--,---------->
 
>----fichier_cible--,--commentaire--)--------------------------><
 

Syntaxe

Stockage du contenu à partir d'un fichier serveur

>>-DB2Image--(--nombd--,--fichier_source--,--format_source--,--->
 
>----typestoc--,--commentaire--)-------------------------------><
 

Syntaxe

Stockage du contenu avec des attributs définis par l'utilisateur à partir d'une mémoire tampon ou d'un fichier client

>>-DB2Image--(--nombd--,--contenu--,--fichier_cible--,---------->
 
>----commentaire--,--attrs--,--miniature--)--------------------><
 

Syntaxe

Stockage du contenu avec des attributs définis par l'utilisateur à partir d'un fichier serveur

>>-DB2Image--(--nombd--,--fichier_source--,--typestoc--,--commentaire--,-->
 
>---attrs--,--miniature--)-------------------------------------><
 

Syntaxe

Stockage du contenu à partir d'une mémoire tampon ou d'un fichier client avec conversion de fichier

>>-DB2Image--(--nombd--,--contenu--,--format_source--,---------->
 
>----format_cible--,--fichier_cible--,--commentaire--)---------><
 

Syntaxe

Stockage du contenu à partir d'un fichier serveur avec conversion de format

>>-DB2Image--(--nombd--,--fichier_source--,--format_source--,--->
 
>----format_cible--,--fichier_cible--,--commentaire--)---------><
 

Syntaxe

Stockage du contenu à partir d'une mémoire tampon ou d'un fichier client avec conversion et modifications supplémentaires

>>-DB2Image--(--nombd--,--contenu--,--format_source--,---------->
 
>----format_cible--,--options_conversion--,--fichier_cible--,--->
 
>----commentaire--)--------------------------------------------><
 

Syntaxe

Stockage du contenu à partir d'un fichier serveur avec conversion de format et modifications supplémentaires

>>-DB2Image--(--nombd--,--fichier_source--,--format_source--,--->
 
>----format_cible--,--options_conversion--,--fichier_cible--,--->
 
>----commentaire--)--------------------------------------------><
 

Paramètres (type de données)

nombd (VARCHAR(18))
Nom de la base de données à laquelle vous êtes connecté, indiqué par le registre spécial CURRENT SERVER.

contenu (BLOB(2G) AS LOCATOR)
Variable SQL dans laquelle se trouve le contenu de l'objet image. Cette variable peut être de type BLOB, BLOB_FILE ou BLOB_LOCATOR. DB2 transmet le type de données du contenu à BLOB_LOCATOR, et le releveur de coordonnées LOB à la fonction UDF DB2Audio.

format_source (VARCHAR(8))
Format de l'image source. Il peut s'agir d'une valeur nulle, d'une chaîne de caractères vide ou de la chaîne de caractères ASIS ; dans ces trois cas, l'extension Image tente de déterminer le format source automatiquement. L'image est stockée dans le même format que l'image source correspondante. Pour connaître les formats d'image admis, reportez-vous au Tableau 4.

format_cible (VARCHAR(8))
Format de l'image après stockage. Le format de l'image source est converti en fonction des besoins.

fichier_cible(LONG VARCHAR)
Nom du fichier du serveur cible (dans le cas d'un stockage dans un fichier du serveur), valeur nulle ou chaîne de caractères vide (dans le cas d'un stockage dans une table de base de données en tant qu'objet BLOB). Le nom du fichier cible peut être qualifié complet. S'il n'est pas qualifié, le fichier est localisé à l'aide des variables d'environnement DB2IMAGESTORE et DB2MMSTORE sur le serveur. Si l'image est stockée avec conversion de format, le chemin d'accès au fichier cible doit être indiqué dans les variables d'environnement DB2IMAGEPATH et DB2MMPATH.

fichier_source (LONG VARCHAR)
Nom du fichier du serveur source. Ce nom peut être qualifié complet ou non qualifié, mais ne doit pas être une valeur nulle ou une chaîne de caractères vide. Si le nom du fichier n'est pas qualifié, ce dernier est localisé à l'aide des variables d'environnement DB2IMAGEPATH et DB2MMPATH sur le serveur.

typestoc (INTEGER)
Valeur indiquant où l'image est stockée. La constante MMDB_STORAGE_TYPE_INTERNAL (value=1) indique que l'image est stockée dans la base de données en tant qu'objet BLOB ; la constante MMDB_STORAGE_TYPE_EXTERNAL (value=0) indique que le contenu de l'image est stocké dans un fichier du serveur (la base de données contient un pointeur sur ce fichier).

commentaire (LONG VARCHAR)
Commentaire à stocker avec l'image.

attrs (LONG VARCHAR FOR BIT DATA)
Attributs de l'image.

miniature (LONG VARCHAR FOR BIT DATA)
Version miniature de l'image.

options_conversion (VARCHAR(100))
Indique les modifications (rotation ou compression, par exemple) à appliquer à l'image lors de son stockage. Pour connaître les options de conversion admises, reportez-vous au Tableau 5.

Codes retour (type de données)

Descripteur de l'image (DB2IMAGE)

Exemples

Insertion d'un enregistrement incluant une image d'Anne Dupont dans la table Employés. L'image source se trouve dans une mémoire tampon sur le poste client. Stockage de l'image dans la table en tant qu'objet BLOB :

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

Insertion d'un enregistrement incluant une photo de Robert Durand, dans la table Employés. L'objet image source se trouve dans un fichier du serveur. L'enregistrement de la table Employés pointe sur ce fichier. Conversion de l'image du format BMP au format GIF lors de son stockage. Réduction de l'image à une largeur de 110 pixels et une hauteur de 150 pixels et compression de l'image en utilisant le type de compression LZW :

EXEC SQL INSERT INTO EMPLOYEE VALUES(
      '384779',
      'Robert Durand',
      DB2IMAGE(
          CURRENT SERVER,
         '/employés/photo/rdurand.bmp',
          'BMP',
          'GIF',
         '-x 110 -y 150 -c 14',
         '',
         'photo de Robert'));

Insertion d'un enregistrement incluant une photo de Robert Durand, dans la table Employés. L'image source qui se trouve dans un fichier du serveur, a un format défini par l'utilisateur, une hauteur de 640 pixels et une largeur de 480 pixels. Stockage de l'image en tant qu'objet 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',
      'Anne Dupont',
      DB2IMAGE(
          CURRENT SERVER,
          '/Employés/images/adupont.bmp',
          :hvStorageType,
          'Photo d''Anne',
          :hvImgattrs,
          CAST(NULL as LONG VARCHAR))
       );


[ Début de page | Page précédente | Page suivante | Table des matières | Index ]