Référence d'Up ! Graphical Engine

Up ! Graphical Engine est étendu par les services suivants selon support utilisé :

Up ! Graphical Engine est aussi complété par les pilotes suivants selon la technologie utilisée :

Le dessin s'effectue :

• A partir d'une feuille de styles.
  Elle est modélisée par le type FeuilleDeStyles. Elle regroupe des définitions pré-définies que vous pouvez enrichir :
  • Les palettes de couleurs modélisées par le type Palette.
  • Les pinceaux modélisés par le type Pinceau.
  • Les motifs modélisés par le type Motif.
  • Les brosses modélisées par le type Brosse.
  • Les styles de cadre modélisés par le type StyleCadre.
  • Les styles de texte modélisés par le type StyleTexte.
• Sur un support.
  Le support comporte un contexte graphique modélisé par le type ContexteGraphique. Il mémorise les objets graphiques courants - pinceau, motif, brosse, style de cadre et style de texte - ainsi que le repère et l'unité choisie.

Une feuille de styles est une ressource conservée dans un fichier en marge des applications. Deux applications peuvent partager la même feuille de styles qui peut être conservé en locale ou sur un serveur.

Une feuille de styles peut être dans deux formats :

• Format binaire.
  Elle a pour extension ugn. Par exemple, la feuille de styles de nom ma-feuille-de-styles aura pour nom de fichier ma-feuille-de-styles.ugn.
  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 ! Graphical Engine. L'inconvénient est que :
  • Il n'est pas modifiable manuellement.
  • Il ne peut comporter du code en Up ! 5GL mixé.
• Format texte en Up ! 5GL.
  Elle a pour extension upl. Par exemple, la feuille de styles de nom ma-feuille-de-styles aura pour nom de fichier ma-feuille-de-styles.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 ! Graphical Engine.
  Pour connaître la syntaxe de ce format, merci de se référer à la fiche Syntaxe d'Up ! 5GL pour Up ! Graphical Engine.

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

Les feuilles de styles sont usuellement conservées dans le répertoire ${UPS_HOME}/upsvtm/resources/${UPS_LANGUAGE}. Le fichier conservant le contenu de la feuille de styles porte le nom de celui-ci.

Une fois la feuille de styles chargée, Up ! Graphical Engine la présente sous forme d'objets du type FeuilleDeStyles.

Pour tracer des traits dans un contexte graphique, il faut sélectionner un pinceau modélisé par le type Pinceau puis appeler par exemple la méthode DessinerLigne. Quand plusieurs traits sont dessinés simultanément via un poly ligne, Up ! Graphical Engine ajuste la jointure des traits.

Pour remplir une zone d'un contexte graphique, il faut sélectionner un motif modélisé par le type Motif puis appeler par exemple la méthode DessinerRectangle.

Pour tracer un cadre dans un contexte graphique, il faut sélectionner un style de cadre modélisé par le type StyleCadre puis appeler par exemple la méthode DessinerRectangleArrondi.

Pour écrire du texte dans un contexte graphique, il faut sélectionner un style de texte modélisé par le type StyleTexte puis appeler par exemple la méthode EcrireTexte.

Le repère sur le support est toujours orienté de la gauche vers la droite et du bas vers le haut avec l'origine au coin supérieur gauche. L'unité de mesure est paramétrable via la propriété Unite du contexte graphique.

Les pinceaux, les motifs, les polices, etc. sont des objets graphiques gérés au travers d'un poule de ressources qu'il est possible de dimensionner. Ces dernières font appels à des fichiers complémentaires qui doivent être déclarés dans la configuration d'Up ! Graphical Engine. Par exemple pour les polices, il s'agit des fichiers Type1 d'Adobe, True Type ou Open Type de Microsoft.

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

Enumérés

Types

ContexteGraphique Couleur Contour

FeuilleDeStyles

MasqueDessin Motif

Palette Pinceau Point PoliceInstallee

Rectangle

StyleCadre StyleTexte

Variables

FeuilleDeStylesLocale

Exceptions

AjoutFeuilleDeStylesImpossible

BrosseInexistante

CouleurInexistante

FeuilleDeStylesInexistante FichierFeuilleDeStylesInexistant FigureTropComplexe

GraphismeImpossible

MotifInexistant

ObjetGraphiqueExisteDeja

PaletteInexistante PinceauInexistant PoliceDejaInstallee PoliceNonSupportee PouleRessourcesTropPetit

SelectionObjetGraphiqueImpossible StyleCadreInexistant StyleTexteInexistant SuppressionPoliceImpossible

TaillePoliceNonSupportee TropDeCouleurs TypePaletteImpossible

Procédures et fonctions

Fonction Habilitation ListerPolicesInstallees(CritereFiltre : Nul Ou Caractere=Nul, CritereTri : Nul Ou Caractere=Nul) Retourner Nul Ou IResultatRequeteDe Nul Ou PoliceSupportee;

Adaptateurs