UpsPct.Référence d'Up ! Picture

Up ! Picture gère deux types d'images :

• Les images bitmaps.
  Elles sont composées d'une matrice de picture elements (pixels) qui sont allumés selon une couleur. La couleur provient soit de :
  • Une palette de couleurs.
    En ce cas, la valeur du pixel est l'index de la couleur dans la table.
    
  • Des coordonnées dans un repère colorimétrique.
    En ce cas, la valeur du pixel est la coordonnée de la couleur. Up ! Picture gère deux systèmes de coordonnées :
    • Rouge, Vert et Bleu (RVB).
      Il correspond au fonctionnement des appareils électroniques.
    • Teinte, Saturation et Luminosité (TSL).
      Il correspond à la perception de l'oeil.
      

• Les images vectorielles.
  Elles sont composées d'ordres graphiques simples ou composés comme dessiner un point, remplir un rectangle, écrire du texte, etc, qui sont interprétés au moment où l'image doit être transformée en image bitmap pour une résolution et une capacité colorimétrique données.

  Un format d'image vectorielle particulier est celui en Up ! 5GL for Up ! Picture composée d'instructions correspondant aux ordres de dessin d'Up ! Graphical Engine.

  Les pinceaux non continus et les motifs non unis sont construits ainsi. Vous ferez de même pour les pinceaux et les motifs personnalisés.

Les Application Program Interfaces (API) d'Up ! Picture permettent d'appliquer des transformations sur les images soit en terme de types, de couleurs, de résolutions, de tailles ou soit à caractère géométriques.

Quelle que soit la plate-forme cible, ces Application Program Interfaces (API) sont identiques tant dans leurs paramétrages, leurs codes retour et leur comportement.

Up ! Picture est complété par les pilotes suivants :

Une image est modélisée par l'interface IImage. Les API d'Up ! Picture permettent de charger, de dessiner dans, de transformer et de enregistrer indépendemment du format choisi, du transport choisi - le flux - et de la plate-forme.

Outre les formats classiques cités précédemment, une image peut être dans deux formats :

• Format binaire.
  Elle a pour extension upc. Par exemple, l'image de nom mon-image aura pour nom de fichier mon-image.upc.
  L'avantage du format binaire est qu'il est plus rapide à charger et à enregistrer, sans nécessiter les extensions d'Up ! 5GL Parser et d'Up ! 5GL Generator pour Up ! Picture. L'inconvénient est que :
  • Il n'est pas modifiable manuellement.
  • Il ne peut comporter de code en Up ! 5GL mixé.
• Format texte en Up ! 5GL.
  Elle a pour extension upl. Par exemple, l'image de nom mon-image aura pour nom de fichier mon-image.upl.
  L'avantage du format texte en Up ! 5GL est que :
  • Il est modifiable manuellement.
  • Il peut comporter du code en Up ! 5GL mixé.
  L'inconvénient est qu'il est plus lent à charger et à enregistrer, nécessitant les extensions d'Up ! 5GL Parser et d'Up ! 5GL Generator pour Up ! Picture.
  Pour connaître la syntaxe de ce format, merci de se référer à la fiche Syntaxe d'Up ! 5GL pour Up ! Picture.

Il est possible de passer du format binaire au format Up ! 5GL en changeant le mode d'enregistrement.

Les images sont usuellement conservées dans le répertoire ${UPS_HOME}/upspct/resources/${UPS_LANGUAGE}. Le fichier conservant le contenu de l'image porte le nom de celui-ci.

Une fois l'image chargée, Up ! Picture la présente sous forme d'objets du type ImageUpsPct.

Pour connaître les paramètres d'Up ! Picture, merci de se référer à la fiche Paramètres d'Up ! Picture.

Enumérés

FormatsImageSupportes

ModeCopie

FinSequenceImage

Interfaces

Types

Procédures et fonctions

Exceptions

ConversionImageImpossible

ImageImpossible ImageInexistante

OperationImageImpossible

Adaptateurs