Multimédia

Les informations sur le multimédia joint à un enregistrement EMu de n’importe quel module (sauf le module Multimédia lui-même) peuvent être récupérées à l’aide de la méthode de classe IMu::Module fetch en spécifiant l’une des colonnes virtuelles suivantes.

Les colonnes virtuelles suivantes renvoient des informations sur un seul fichier multimédia joint à l’enregistrement en cours. L’information est renvoyée sous la forme d’une référence à une table de hachage :

• application
• audio
• image
• video

Les colonnes virtuelles suivantes renvoient des informations sur un ensemble de fichiers multimédias joints de l’enregistrement en cours. L’information est renvoyée sous la forme d’une référence à un tableau. Chaque membre du tableau est une référence à une table de hachage contenant les informations pour un seul fichier joint multimédia de l’ensemble :

• applications
• audios
• images
• multimedia
• videos

Toutes ces colonnes virtuelles renvoient les irn, type et format de l’enregistrement Multimédia joint à l’enregistrement en cours. Ils servent également de colonnes de référence pour le module Multimédia. Cela signifie que d’autres colonnes du module Multimédia (y compris colonnes virtuelles) peuvent également être demandées à partir de l’enregistrement Multimédia correspondant, par exemple :

1. Inclure le titre de tous les multimédias joints :

   multimedia. MulTitle

2. Inclure le titre de toutes les images jointes :

   images. MulTitle

3. Incluez des détails sur le fichier multimédia principal pour toutes les images jointes (en utilisant la colonne virtuelle master du module Multimédia) :

   images.master

4. Inclure plusieurs colonnes pour toutes les images jointes :

   images. (master,MulTitle,MulDescription)

5. Inclure et renommer plusieurs colonnes pour toutes les images jointes :

   images. (master,title=MulTitle,description=MulDescription)

Exemple

Cet exemple montre la récupération des informations de base et du titre pour toutes les images multimédia jointes à un enregistrement Personnes / Organisations :

my $columns = [ 'images.MulTitle' ]; my $result = $parties->fetch('start', 0, 1, $columns); foreach my $row (@{$result->{'rows'}}) { foreach my $image (@{$row->{'images'}}) { my $irn = $image->{'irn'}; my $type = $image->{'type'}; my $format = $image->{'format'}; my $title = $image->{'MulTitle'}; printf("irn %d: %s - %s/%s\n", $irn, $title, $type, $format); } }

Cela génère des résultats similaires à ceux qui suivent :

irn 100105: Signature of Luciano Pavarotti - image/jpeg

irn 100096: Luciano Pavarotti - image/gif

irn 100100: Luciano Pavarotti with Celine Dion - image/gif

irn 100101: Luciano Pavarotti with Natalie Cole - image/gif

irn 100102: Luciano Pavarotti with the Spice Girls - image/gif

De même, les informations sur les fichiers multimédias associés à un enregistrement du module Multimédia peuvent être récupérées en utilisant la méthode de classe IMu::Module fetch en spécifiant l’une des colonnes virtuelles suivantes.

Les colonnes virtuelles suivantes renvoient des informations sur un seul fichier multimédia à partir de l’enregistrement Multimédia en cours. L’information est renvoyée sous la forme d’une référence à une table de hachage :

• master
• resource
• thumbnail

Les colonnes virtuelles suivantes renvoient des informations sur un ensemble de fichiers multimédia de l’enregistrement Multimédia en cours. L’information est renvoyée sous la forme d’une référence à un tableau. Chaque membre du tableau est une référence à une table de hachage contenant les informations d’un seul fichier multimédia de l’ensemble :

• resolutions
• resources
• supplementary

Les colonnes virtuelles master (principal), thumbnail (vignette), resolutions (résolutions) et supplementary (supplémentaires) renvoient toutes le même type d’informations. Ces informations diffèrent selon qu’il s’agit de multimédias image ou de multimédias non image, comme suit :

Pour les multimédias non image, ils renvoient :

Retourne	Détails
fileSize	La taille du fichier en octets.
identifier	Le nom du fichier multimédia.
index	Un entier qui indique la position du fichier multimédia dans la liste des fichiers multimédias principal, vignette, résolutions et supplémentaires, dans cet ordre, numérotés à partir de 0.
kind	Le type (master, thumbnail, resolution, ou supplementary) du multimédia.
md5Checksum	La somme de contrôle MD5 du fichier multimédia.
md5Sum	Identique à md5Checksum (inclus pour assurer la rétrocompatibilité).
mimeFormat	Le format du média.
mimeType	Le type de média.
size	Identique à fileSize (inclus pour assurer la rétrocompatibilité).

Pour les multimédias image, elles renvoient toutes les valeurs spécifiées pour les multimédias non image et incluent également :

Retourne	Détails
bitsPerPixel	La profondeur de couleur de l’image.
colourSpace	L’espace colorimétrique de l’image.
compression	Le type de compression utilisé pour l’image.
height	La hauteur de l'image en pixels.
imageType	La classification de type de l’image. Par exemple : Bilevel : spécifie une image monochrome. ColorSeparation : spécifie une image en cyan, magenta, jaune et noir (CMYK). Grayscale : spécifie une image en niveaux de gris. GrayscaleMatte : spécifie une image en niveaux de gris avec une opacité. Palette : spécifie une image en couleurs indexées (palette). PaletteMatte : spécifie une image en couleurs indexées (palette) avec une opacité. TrueColor : spécifie une image en couleurs réelles. TrueColorMatte : spécifie une image en couleurs réelles avec une opacité. Vous trouverez de plus amples informations ici.
numberColours	Le nombre de couleurs présentes dans l’image.
numberPages	Nombre d’images contenues dans l’image principale — fonctionnalité prise en charge uniquement par certains types de fichiers, par exemple les fichiers TIFF.
planes	Le nombre de plans dans une image.
quality	Une valeur entière comprise entre 1 et 100 qui indique la qualité de l’image. Une valeur plus faible indique une qualité d’image inférieure et une compression plus élevée, tandis qu’une valeur plus élevée indique une qualité d’image supérieure mais une compression plus faible. Applicable uniquement aux formats d’image JPEG et MPEG.
resolution	La résolution de l’image en PPI (pixels par pouce).
width	La largeur de l'image en pixels.

Les colonnes virtuelles resource et resources renvoient toutes deux le même type d’informations, comme suit :

Retourne	Détails
identifier	Le nom du fichier multimédia.
mimeType	Le type de média.
mimeFormat	Le format du média.
size	La taille du fichier en octets.
file	Un objet IO:File. Cela fournit un descripteur de fichier en lecture seule vers une copie temporaire du fichier multimédia. La copie temporaire du fichier est supprimée lorsque le descripteur de fichier est fermé ou détruit. Note Si la colonne resource est spécifiée avec un filtre, un modificateur doit également être fourni pour que le descripteur de fichier soit renvoyé, par exemple : 'resources(height @ 200){resource:include}' Les options de modification sont les suivantes : resource:include - ajoute le descripteur de fichier à l’ensemble de données renvoyé. resource:only - remplace l’ensemble de données renvoyé par le descripteur de fichier.
height	La hauteur de l'image en pixels.
width	La largeur de l'image en pixels.

Bien que les colonnes virtuelles du module Multimédia offrent un moyen assez précis de sélectionner des fichiers multimédias spécifiques associés à un enregistrement multimédia, il peut parfois être utile de disposer d’un contrôle encore plus fin sur la sélection de ces fichiers, notamment lors de la spécification des colonnes virtuelles resolutions, resources ou supplementary.

Les filtres permettent de sélectionner des fichiers multimédias spécifiques associés à un enregistrement multimédia en fonction de certaines caractéristiques de ces fichiers. Les filtres se composent de trois éléments : un nom, un opérateur et une valeur. Ils sont spécifiés entre parenthèses après une colonne virtuelle :

colonne(nomopérateurvaleur) 

Il est possible de spécifier plusieurs valeurs en séparant chaque filtre par une virgule :

colonne(nomopérateurvaleur, nomopérateurvaleur) 

• nom

  Le nom du filtre indique la caractéristique du fichier multimédia à utiliser comme critère de filtrage. Sauf indication contraire, la signification des noms de filtres est celle définie dans la section Fichiers multimédia.

  Les noms de filtres suivants peuvent être utilisés pour filtrer n’importe quel fichier multimédia :

  • fileSize (ou size)
  • height
  • identifier
  • index
  • kind
  • mimeFormat (ou format)
  • mimeType (ou type)
  • width

  Les noms de filtres suivants peuvent être utilisés pour filtrer les fichiers multimédias image :

  • bitsPerPixel
  • colourSpace
  • compression
  • imageType
  • md5Checksum (ou md5sum)
  • numberColours
  • numberPages
  • planes
  • quality
  • resolution

  Le nom de filtre suivant peut être utilisé pour filtrer les fichiers multimédias supplémentaires :

  • usage

    La valeur de la colonne Utilisation des attributs supplémentaire (SupUsage_tab).

• opérateur

  L’opérateur précise la relation entre la valeur du filtre value et la caractéristique du fichier multimédia spécifiée par le filtre name.

  Les valeurs disponibles sont :

  Valeur	Nom	Détails
  ==	égal à	Sélectionne les fichiers multimédias pour lesquels la caractéristique spécifiée par le filtre name correspond à la valeur du filtre value.
  !=	différent de	Sélectionne les fichiers multimédias pour lesquels la caractéristique spécifiée par le filtre name ne correspond pas à la valeur du filtre value.
  <	inférieur à	Sélectionne les fichiers multimédias pour lesquels la caractéristique spécifiée par le filtre name est inférieure à la valeur du filtre value. Ne s’applique qu’aux valeurs numériques.
  >	supérieur à	Sélectionne les fichiers multimédias pour lesquels la caractéristique spécifiée par le filtre name est supérieure à la valeur du filtre value. Ne s’applique qu’aux valeurs numériques.
  <=	inférieur ou égal à	Sélectionne les fichiers multimédias pour lesquels la caractéristique spécifiée par le filtre name est inférieure ou égale à la valeur du filtre value. Ne s’applique qu’aux valeurs numériques.
  >=	supérieur ou égal à	Sélectionne les fichiers multimédias pour lesquels la caractéristique spécifiée par le filtre name est supérieure ou égale à la valeur du filtre value. Ne s’applique qu’aux valeurs numériques.
  @	le plus proche de	Sélectionne le fichier multimédia unique dont la caractéristique spécifiée par le filtre name est la plus proche de la valeur du filtre value. Ne s’applique qu’aux valeurs numériques.
  ^	le plus proche mais supérieur à	Sélectionne le fichier multimédia unique pour lequel la caractéristique spécifiée par le filtre name est la plus proche de la valeur du filtre value tout en lui étant supérieure. Ne s’applique qu’aux valeurs numériques.

• valeur

  La valeur à utiliser comme critère de filtrage. N’importe quelle valeur peut être utilisée, mais seules certaines valeurs ont un sens pour chaque filtre. Par exemple, si le filtre fileSize est utilisé, seul un value numérique a du sens. De même, si le filtre mimeType est utilisé, seul un value textuel correspondant à un type MIME valide a du sens.

Par exemple :

1. Sélectionnez les résolutions multimédia dont la largeur est supérieure à 300 pixels :

   resources(width @ 600)

2. Sélectionnez la ressource multimédia unique dont la largeur est la plus proche de 600 :

   resources(width @ 600)

3. Sélectionnez la ressource miniature :

   resources(kind == thumbnail)

4. Spécifiez plusieurs filtres pour sélectionner la ressource multimédia unique dont la largeur et la hauteur sont les plus proches de 600 :

   resources(width @ 600, height @

Bien que l’API IMu offre plusieurs moyens de sélectionner des fichiers multimédias spécifiques à partir d’un enregistrement multimédia, il arrive parfois qu’aucun des fichiers disponibles ne réponde aux critères requis. Il est parfois nécessaire de modifier un fichier multimédia existant pour obtenir le résultat souhaité.

Les modificateurs permettent de convertir de différentes manières les images multimédias renvoyées par le serveur IMu. Les modifications sont effectuées à la volée et n’affectent pas les fichiers multimédias stockés dans la base de données Multimédia ; elles s’appliquent uniquement à la copie temporaire des fichiers multimédias renvoyés par l’API IMu. Les modificateurs se composent de deux éléments : un nom et une valeur séparés par deux points. Ils sont spécifiés entre accolades après une colonne virtuelle resource ou resources :

colonne{nom:valeur}

Il est possible de spécifier plusieurs valeurs en séparant chaque filtre par une virgule :

colonne{nom:valeur, nom:valeur} 

Des modificateurs peuvent également être spécifiés après un filtre :

colonne(...){nom:valeur}

Les valeurs prises en charge pour name sont les suivantes :

Valeur	Détails
checksum	Ajouter une valeur de somme de contrôle à la réponse de la colonne virtuelle resource (ou resources). Bien que cela n’entraîne aucune modification du fichier multimédia, cette option est utile lorsque vous avez besoin d’une somme de contrôle pour un fichier multimédia auquel un modificateur a été appliqué (cf. fichier multimédia d’origine). Les éléments value autorisés sont les suivants : crc32 Inclure une somme de contrôle CRC32. md5 Inclure une somme de contrôle MD5. Lorsque le modificateur checksum est utilisé, la réponse de la colonne virtuelle resource (ou resources) inclut un composant checksum.
encoding	Spécifie que les octets réels du multimédia (accessibles via la valeur file de la réponse de la colonne virtuelle resource ou resources) doivent être encodés. Par défaut, ils sont renvoyés sous forme de données binaires brutes. Les éléments value autorisés sont les suivants : base64 Utilisez l’encodage Base64.
format	Spécifie que le fichier multimédia doit être converti au format spécifié. Si le fichier multimédia n’est pas déjà au format requis, il est reformaté à la volée. Le serveur IMu utilise ImageMagick pour traiter les images et prend en charge un très large éventail de formats. La liste complète est disponible à l'adresse suivante : http://www.imagemagick.org/script/formats.php. N’importe lequel des formats pris en charge peut être utilisé comme value de ce modificateur.
resource	Spécifie qu’un descripteur de fichier multimédia doit être renvoyé. Les éléments value autorisés sont les suivants : include only
height	Spécifie que le fichier image multimédia doit être redimensionné à la hauteur spécifiée (en pixels). Si l’enregistrement Multimédia contient une résolution correspondant à cette hauteur, c’est cette résolution qui est renvoyée à la place (c’est-à-dire qu’aucune modification n’est appliquée). Sinon, la résolution supérieure la plus proche est redimensionnée à la hauteur demandée à la volée. Les éléments value autorisés correspondent à toute valeur numérique indiquant la hauteur en pixels.
width	Spécifie que le fichier image multimédia doit être redimensionné à la largeur spécifiée (en pixels). Si l’enregistrement Multimédia contient une résolution correspondant à cette largeur, c’est cette résolution qui est renvoyée à la place (c’est-à-dire qu’aucune modification n’est appliquée). Sinon, la résolution supérieure la plus proche est redimensionnée à la largeur demandée à la volée. Les éléments value autorisés correspondent à toute valeur numérique indiquant la largeur en pixels.
aspectratio	Détermine si le rapport d’aspect de l’image doit être conservé lorsque les modificateurs height et width sont tous deux spécifiés. S’il est défini sur no, le rapport d’aspect n’est pas conservé. par défaut, les proportions de l’image sont conservées. Les éléments value autorisés sont les suivants : yes no

Note: Les modificateurs ne s’appliquent actuellement qu’aux multimédias image et ne peuvent être spécifiés qu’après les colonnes virtuelles resource ou resources du module Multimédia.
Seules les parties resource ou resources des résultats renvoyés sont affectées par les modificateurs. Par conception, toutes les autres parties de la réponse contiennent les informations relatives au multimédia d’origine non modifié.

Par exemple :

1. Spécifiez un modificateur d’encodage Base64 :

   resource{encoding :base64}

2. Inclure une somme de contrôle CRC32 dans la réponse :

   resource{checksum :crc32}

3. Reformatez l’image multimédia au format GIF :

   resource{format :gif}

4. Redimensionnez l’image multimédia à une hauteur de 300 pixels :

   resource{height :300}

5. Redimensionnez l’image multimédia à une largeur de 300 pixels :

   resource{width :300}

6. Redimensionnez l’image multimédia à une hauteur et une largeur de 300 pixels sans conserver le rapport d’aspect :

   resource{height :300, width :300, aspectratio :no}