Extensions Image, Audio et Vidéo Administration et programmation

Content


Image Audio Vidéo
X X X

Extrait ou met à jour le contenu d'un objet image, audio ou vidéo à partir d'une base de données. Ce contenu peut être extrait vers une mémoire tampon client, un fichier client ou un fichier du serveur.

Fichier d'inclusion

image
dmbimage.h

audio
dmbaudio.h

vidéo
dmbvideo.h

Syntaxe

Extraction du contenu vers une mémoire tampon ou un fichier client

>>-Content--(--descripteur--)----------------------------------><
 

Syntaxe

Extraction d'un segment de contenu vers une mémoire tampon ou un fichier client

>>-Content--(--descripteur--,--décalage--,--taille--)----------><
 

Syntaxe

Extraction du contenu vers un fichier du serveur

>>-Content--(--descripteur--,--fichier_cible--,--écrasement--)--><
 

Syntaxe

Extraction du contenu vers une mémoire tampon ou un fichier client avec conversion de fichier (image uniquement)

>>-Content--(--descripteur--,--format_cible--)-----------------><
 

Syntaxe

Extraction du contenu vers un fichier serveur avec conversion de format (image uniquement)

>>-Content--(--descripteur--,--fichier_cible--,--écrasement--,-->
 
>----format_cible--)-------------------------------------------><
 

Syntaxe

Extraction du contenu vers une mémoire tampon ou un fichier client avec conversion et modifications supplémentaires (image uniquement)

>>-Content--(--descripteur--,--format_cible--,--options_conversion--)-->
 
>--------------------------------------------------------------><
 

Syntaxe

Extraction du contenu à partir d'un fichier serveur avec conversion de format et modifications supplémentaires (image uniquement)

>>-Content--(--descripteur--,--fichier_cible--,--écrasement--,-->
 
>----format_cible--,--options_conversion--)--------------------><
 

Syntaxe

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

>>-Content--(--descripteur--,--contenu--,--format_source--,----->
 
>----fichier_cible--)------------------------------------------><
 

Syntaxe

Mise à jour du contenu à partir du fichier serveur

>>-Content--(--descripteur--,--fichier_source--,--format_source--,-->
 
>---typestoc--)------------------------------------------------><
 

Syntaxe

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

>>-Content--(--descripteur--,--contenu--,----------------------->
 
>----fichier_cible--,--attrs--,--miniature--)------------------><
 

Syntaxe

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

>>-Content--(--descripteur--,--fichier_source--,--typestoc--,--attrs--,-->
 
>---miniature--)-----------------------------------------------><
 

Syntaxe

Mise à jour du contenu à partir d'une mémoire tampon ou d'un fichier client avec conversion de fichier (image uniquement)

>>-Content--(--descripteur--,--contenu--,--format_source--,----->
 
>----format_cible--,--fichier_cible--)-------------------------><
 

Syntaxe

Mise à jour du contenu à partir du fichier serveur avec conversion de format (image uniquement)

>>-Content--(--descripteur--,--fichier_source--,--format_source--,-->
 
>---format_cible--,--fichier_cible--)--------------------------><
 

Syntaxe

Mise à jour du contenu à partir d'une mémoire tampon ou d'un fichier client avec conversion et modifications supplémentaires (image uniquement)

>>-Content--(--descripteur--,--contenu--,--format_source--,----->
 
>----format_cible--,--options_conversion--,--fichier_cible--)--><
 

Syntaxe

Mise à jour du contenu à partir d'un fichier serveur avec conversion de format et modifications supplémentaires (image uniquement)

>>-Content--(--descripteur--,--fichier_source--,--format_source--,-->
 
>---format_cible--,--options_conversion--,--fichier_cible--)---><
 

Paramètres (type de données)

descripteur (DB2IMAGE, DB2AUDIO ou DB2VIDEO)
Nom de colonne ou variable SQL contenant le descripteur de la séquence image, audio ou vidéo.

décalage (INTEGER)
Décalage de début (en partant de 1) d'un objet image, audio, ou vidéo à extraire.

taille (INTEGER)
Nombre d'octets d'un objet image, audio ou vidéo à extraire.

fichier_source (LONG VARCHAR)
Nom du fichier dans lequel se trouve le contenu pour mise à jour de l'objet image, audio ou vidéo.

fichier_cible(LONG VARCHAR)
Pour l'extraction, il s'agit du nom du fichier à partir duquel est extrait l'objet image, audio ou vidéo. Pour la mise à jour, nom du fichier contenant l'objet image, audio ou vidéo à mettre à jour.

typestoc (INTEGER)
Valeur indiquant où sera stocké l'objet image, audio ou vidéo mis à jour. La constante MMDB_STORAGE_TYPE_INTERNAL (value=1) indique que l'objet mis à jour sera stocké dans la base de données en tant qu'objet BLOB. La constante MMDB_STORAGE_TYPE_EXTERNAL (value=0) indique que l'objet mis à jour sera stocké dans un fichier du serveur.

écrasement (INTEGER)
Valeur indiquant si le fichier cible doit être écrasé s'il existe déjà. Cette valeur peut être 0 ou 1. La valeur 0 signifie que le fichier cible n'est pas écrasé (en fait, l'extraction n'a pas lieu). La valeur 1 signifie que le fichier cible est écrasé s'il existe déjà.

format_cible (VARCHAR(8))
Format de l'image après extraction ou mise à jour. Le format de l'image source est converti en fonction des besoins. Dans le cas d'une extraction d'une image vers un fichier du serveur, si le paramètre fichier_cible est identique au fichier_source, le format cible doit également être identique au format source. Pour le format MPG1, vous pouvez indiquer MPG1, mpg1, MPEG1 ou mpeg1. Pour le format MPG2, vous pouvez indiquer MPG2, mpg2, MPEG2 ou mpeg2.

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

contenu (BLOB(2G) AS LOCATOR)
Variable SQL dans laquelle est stocké le contenu de la mise à jour d'un objet image, audio ou vidéo. 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 Content.

format_source (VARCHAR(8))
Format de la source pour la mise à jour de l'objet image, audio ou vidéo. Il peut s'agir d'une valeur nulle ou d'une chaîne de caractères vide et, pour les images uniquement, d'une chaîne de caractères ASIS ; dans ces trois cas, l'extension tente de déterminer le format automatiquement. Pour le format MPG1, vous pouvez indiquer MPG1, mpg1, MPEG1 ou mpeg1. Pour le format MPG2, vous pouvez indiquer MPG2, mpg2, MPEG2 ou mpeg2.

attrs (LONG VARCHAR FOR BIT)
Attributs de l'objet image, audio ou vidéo

miniature (LONG VARCHAR FOR BIT DATA)
Version miniature de l'image de base de données ou de vidéo (uniquement pour ces deux types d'images)

Codes retour (type de données)

Contenu de l'objet image, audio ou vidéo s'il s'agit d'une extraction vers une mémoire tampon, (BLOB(2G) AS LOCATOR). S'il s'agit d'une extraction vers un fichier, VARCHAR(254).

Pour la mise à jour, le descripteur de l'objet image, audio ou vidéo à mettre à jour (DB2IMAGE, DB2AUDIO ou DB2VIDEO).

Exemples

Extraction dans un fichier du serveur de l'image stockée pour Anne Dupont dans la colonne Photo de la table Employés :

struct{
        short len;
        char data [250];
         }hvImg_fname;
  EXEC SQL END DECLARE SECTION;
 
EXEC SQL SELECT CONTENT (PICTURE,
       '/Employés/images/adupont.bmp',1)
INTO :hvImg_fname
       FROM EMPLOYEE
       WHERE NAME='Anne Dupont';

Extraction dans une mémoire tampon client de la séquence audio de 1 Mo stockée pour Robert Durand dans la colonne Son de la table Employés :

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

Mise à jour de l'image d'Anne Dupont dans la colonne Photo de la table Employés ; conversion de l'image du format BMP en format GIF et réduction de l'image à 50% de sa taille d'origine :

EXEC SQL UPDATE EMPLOYEE
  SET picture = CONTENT(PICTURE,
        '/Employés/nouvimg/adupont.bmp',
          'BMP',
          'GIF',
        '-s 0.5',
       '');
       WHERE NAME='Anne Dupont';


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