DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Champs, pages et fenêtres / Fonctions de dessin
  • Utilisation des fonctions de dessin
  • Polices
  • Polices en PHP
  • Dessin en PHP
  • Dessin en code Navigateur
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
Déclare la police de caractères qui sera utilisée par la fonction dTexte :
  • dans un champ Image,
  • dans une variable de type Image.
    WEBDEV - Code NavigateurPHP Ce type de variable n'est pas disponible.
  • WEBDEV - Code Serveur dans une variable de type WDPic (sur le calque d'arrière-plan),
  • WEBDEV - Code Serveur dans une variable de type picCalque.
Linux Attention : L'utilisation de cette fonction sous Linux nécessite une configuration spécifique. Pour plus de détails, consultez Les dessins.
// Initialise le dessin dans un champ Image
dDébutDessin(IMG_Dessin)
 
// Déclaration de la police de caractères :
// Arial, taille 12, gras
dPolice("Arial", 12, iGras)
WEBDEV - Code ServeurAjax
// Déclaration de la police de caractères :
// Arial, taille 12, gras
dPolice(IMG_Dessin, "Arial", 12, iGras)
Syntaxe

Utiliser une police spécifique pour les dessins Masquer les détails

dPolice([<Image>, ] <Police> [, <Taille de la police> [, <Attributs de la police> [, <Inclinaison du texte>]]])
<Image> : Nom de champ optionnel ou variable de type Image, WDPic ou picCalque optionnelle
WindowsLinux Image à manipuler. Cette image peut correspondre :
  • au nom d'un champ Image.
  • au nom d'une variable de type Image.
  • WEBDEV - Code Serveur au nom d'une variable de type WDPic. Seul le calque d'arrière-plan sera manipulé.
  • WEBDEV - Code Serveur au nom d'une variable de type picCalque.
Si ce paramètre n'est pas précisé, il est nécessaire de définir la destination du dessin avec la fonction dDébutDessin.
<Police> : Chaîne de caractères
Nom de la police utilisée lors du dessin du texte par dTexte. Ce paramètre ne doit pas correspondre à une famille de polices. La liste des polices installées sur le poste en cours peut être connue avec la fonction PoliceListe.
<Taille de la police> : Entier optionnel
Taille de la police (en points). La valeur par défaut est 12.
<Attributs de la police> : Constante (ou combinaison de constantes) optionnelle
Attributs de police à utiliser :
iBarreBarre le texte dessiné.
WEBDEV - Code Navigateur Cette constante n'est pas gérée.
iGrasMet le texte dessiné en gras.
iItaliqueMet le texte dessiné en italique.
iNormal
(Valeur par défaut)
Normalise le texte dessiné
iSouligneSouligne le texte dessiné.
WEBDEV - Code Navigateur Cette constante n'est pas gérée.
<Inclinaison du texte> : Entier optionnel
Indique l'inclinaison (en degrés) du texte. La valeur par défaut est 0.
WEBDEV - Code ServeurAjax

Utiliser une police créée par programmation Masquer les détails

dPolice([<Image>, ] <Police utilisée>)
<Image> : Nom de champ optionnel ou variable de type Image, WDPic ou picCalque optionnelle
Image à manipuler. Cette image peut correspondre :
  • au nom d'un champ Image.
  • au nom d'une variable de type Image.
  • WEBDEV - Code Serveur au nom d'une variable de type WDPic. Seul le calque d'arrière-plan sera manipulé.
  • WEBDEV - Code Serveur au nom d'une variable de type picCalque.
Si ce paramètre n'est pas précisé, il est nécessaire de définir la destination du dessin avec la fonction dDébutDessin.
<Police utilisée> : Police
Police à utiliser pour les dessins. Ce paramètre correspond à une variable de type Police. Les caractéristiques de la police ont été définies grâce à la fonction PoliceCrée ou grâce aux propriétés de gestion des polices.
Remarques

Utilisation des fonctions de dessin

Les fonctions de dessin peuvent être utilisées selon 2 méthodes :
  • Méthode 1 : Utilisation de la fonction dDébutDessin
    • La fonction dDébutDessin doit être appelée avant toute autre fonction de dessin. La fonction dDébutDessin permet de définir l'élément (champ Image ou variable) sur lequel les fonctions de dessin vont intervenir.
    • Dans le cas du dessin sur un champ Image :
      • Les fonctions de dessin travaillent sur une copie ("bitmap") de l'image. Vous pouvez utiliser les fonctions de dessin de Windows (grâce à la fonction API ou AppelDLL32) mais ces fonctions doivent utiliser le DC (Device Context) renvoyé par la fonction dDébutDessin.
      • La fonction dFinDessin ne doit pas être appelée dans le même traitement que la fonction dDébutDessin.
        Si la fonction dFinDessin est appelée dans le même traitement que la fonction dDébutDessin, le dessin n'apparaîtra pas : il sera automatiquement effacé.
  • WindowsLinux Méthode 2 : indication de la destination du dessin directement dans la syntaxe (via un paramètre)
    Le paramètre <Image> permet de spécifier directement la destination du dessin. La fonction dDébutDessin devient inutile. Cette fonction doit être supprimée.
WEBDEV - Code ServeurWindowsPHPAjax

Polices

La fonction PoliceListe permet de récupérer la liste des polices valides (TrueType, PostScript) installées sur la machine en cours.
Pour obtenir un résultat satisfaisant lors de l'inclinaison du texte dessiné, la <Police> utilisée doit être de type "True Type".
PHP

Polices en PHP

Pour utiliser les attributs de mise en forme (gras, italique, ...), il est nécessaire que les fichiers des polices correspondantes soient accessibles (fichiers ttf). Ces fichiers doivent être présents dans le répertoire du site (répertoire _WEB connu avec la fonction fRepWeb) et nommés de la façon suivante :
  • <Nom de la police normale>
  • <Nom de la police normale>_Bold
  • <Nom de la police normale>_Italic
  • <Nom de la police normale>_Italic_Bold
La gestion du souligné est automatique comme la gestion du &.
Si aucune police n'est trouvée, le texte sera normal, sans gestion du &.
PHP

Dessin en PHP

En PHP, les fonctions de dessin s'appuient sur la librairie graphique GD. Cette librairie est très courante chez les hébergeurs PHP, et donc toujours activée. La version de la librairie GD devra être au moins 2.0.28. Cette librairie peut être téléchargée sur le site de PHP.
Pour activer si nécessaire cette librairie en local, les éléments nécessaires sont :
  • PHP installé.
  • le fichier PHP.INI présent dans le répertoire Windows doit avoir la ligne "extension=php_gd2.dll" et non pas ";extension=php_gd2.dll".
  • le fichier php_gd2.dll doit exister dans le répertoire des extensions PHP. Ce répertoire est défini dans le fichier PHP.INI par la variable "extension_dir".
WEBDEV - Code Navigateur

Dessin en code Navigateur

Certaines fonctions de dessin sont disponibles en code Navigateur. Les fonctions de dessin en code Navigateur sont basées sur la norme HTML 5. Pour les spécialistes, ces fonctions s'appuient sur la balise "canvas" de HTML 5.
Les fonctionnalités de dessin en code navigateur sont disponibles uniquement sur les navigateurs récents (supportant la norme HTML 5). Pour savoir si le navigateur utilisé propose les fonctionnalités de dessin, utilisez la fonction DessinDisponible.
Attention : Pour utiliser les fonctions de dessin avec Internet Explorer 9, le projet doit inclure la référence au fichier DTD. Pour cela, le mode HTML doit être "HTML 4.01 Transitional + DTD". Cette option est disponible dans l'onglet "Avancé" de la fenêtre de description du projet.
Rappel : Pour afficher la fenêtre de description du projet, sous le volet "Projet", dans le groupe "Projet", cliquez sur "Description".
Cas particulier : Dessiner dans le navigateur d'un téléphone Android : Les fonctions de dessin navigateur sont disponibles uniquement à partir de la version 3 de Android.
Classification Métier / UI : Code neutre
Composante : wd290pnt.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 25/05/2022

Signaler une erreur ou faire une suggestion | Aide en ligne locale