PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

  • Propriétés spécifiques à la description des variables de type Image
  • Accès aux pixels
  • Gestion de la couche Alpha
  • Variable de type Image et champ Image
  • Variable de type Image et débogueur
  • Créer une image à une taille spécifique
  • Fonctions manipulant des variables de type Image
  • Fonctions (syntaxe objet) manipulant des variables de type Image
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Autres
Procédures stockées
Le type Image permet de définir toutes les caractéristiques avancées d'une image. Les caractéristiques de cette image peuvent être définies et modifiées à l'aide de différentes propriétés WLangage.
Remarque : Pour plus de détails sur la déclaration de ce type de variable et l'utilisation des propriétés WLangage, consultez Déclaration d'une variable.
Versions 18 et supérieures
Java Ce type de variable est désormais disponible pour les applications Java.
Android Ce type de variable est désormais disponible pour les applications Android.
Universal Windows 10 App Ce type de variable est désormais disponible en mode Windows Store apps.
Nouveauté 18
Java Ce type de variable est désormais disponible pour les applications Java.
Android Ce type de variable est désormais disponible pour les applications Android.
Universal Windows 10 App Ce type de variable est désormais disponible en mode Windows Store apps.
Java Ce type de variable est désormais disponible pour les applications Java.
Android Ce type de variable est désormais disponible pour les applications Android.
Universal Windows 10 App Ce type de variable est désormais disponible en mode Windows Store apps.
Versions 21 et supérieures
Universal Windows 10 App Ce type de variable est désormais disponible en mode Universal Windows 10 App.
Nouveauté 21
Universal Windows 10 App Ce type de variable est désormais disponible en mode Universal Windows 10 App.
Universal Windows 10 App Ce type de variable est désormais disponible en mode Universal Windows 10 App.
Exemple
MonImage est une Image
// Chargement à partir d'un fichier
MonImage = dChargeImage("image.png")
// Syntaxes équivalentes
// MonImage = "image.png"
// MonImage..Image = "image.png"

// Dessin dans l'image
dDébutDessin(MonImage)

// Ecriture d'un texte
dPolice("Arial", 12, iNormal, 0)
dTexte(4, 0, "J'écris mon texte dans un champ Image !")

// Redimensionnement
dRedimensionne(MonImage, 100, 100)

// Fin du dessin
dFinDessin(MonImage)

// Affectation à un champ Image
IMG_ChampImage = MonImage
Remarques

Propriétés spécifiques à la description des variables de type Image

Les propriétés suivantes peuvent être utilisées pour manipuler une variable de type Image :
Nom de la propriétéType manipuléEffet
AvecAlphaBooléenPermet de savoir si l'image contient une couche alpha :
  • Vrai si l'image contient une couche alpha,
  • Faux dans le cas contraire.
Cette propriété est disponible en lecture uniquement.
BitParPixelEntierNombre de bits par pixels.
Cette propriété est disponible en lecture uniquement.
CouleurRemplissageVariable de type CouleurCouleur de remplissage de l'image. Cette couleur est utilisée :
  • lors d'un redimensionnement de l'image (propriétés ..Hauteur et ..Largeur)
  • lors de la rotation de l'image (fonction dRotation).
Versions 21 et supérieures
EchelleDessin
Nouveauté 21
EchelleDessin
EchelleDessin
RéelEchelle à utiliser pour les fonctions de dessin (fonctions dXXX) : les coordonnées utilisées par ces fonctions seront multipliées par cette valeur.
Java Cette propriété n'est pas disponible.
EXIF[Tag exif]Tableau associatifPermet de connaître le contenu du tag Exif spécifié.
La propriété ..Vide permet de savoir si le contenu du tag Exif est vide ou non. Par exemple :
SI PAS MonImage..EXIF[320]..Vide ALORS
lsTagValeur = MonImage..EXIF[320]
FIN
Les tags Exif utilisables sont ceux listés dans la documentation de la fonction ImageInfoValeur.
Cette propriété est disponible uniquement en lecture.
AndroidiPhone/iPadJava Cette propriété n'est pas disponible.
HauteurEntierHauteur en pixels de l'image.
Si cette propriété est modifiée, l'image n'est pas déformée : des pixels supplémentaires sont ajoutés. Ces pixels ont la couleur définie avec la propriété ..CouleurRemplissage.
ImageTous typesPermet de charger une image à partir d'un buffer, d'un fichier ou d'un mémo. Cette propriété est équivalente à la fonction dChargeImage.
Remarques :
  • En lecture, cette propriété renvoie un buffer contenant l'image au format PNG.
  • Les images au format SVG ou PDF ne sont pas supportées. Pour gérer ces formats, il est nécessaire d'utiliser la fonction dChargeImage.
  • Les images animées ne sont pas gérées.
  • Une seule page des images multi-pages (TIF, ICO) peut être chargée. Seule la première page est chargée.
  • Versions 19 et supérieures
    Il est possible de dessiner un graphe dans une variable de type Image grâce à la fonction grDestinationImage.
    Nouveauté 19
    Il est possible de dessiner un graphe dans une variable de type Image grâce à la fonction grDestinationImage.
    Il est possible de dessiner un graphe dans une variable de type Image grâce à la fonction grDestinationImage.
iPhone/iPad Le format ICO n'est pas supporté par iOS.
LargeurEntierLargeur en pixels de l'image.
Si cette propriété est modifiée, l'image n'est pas déformée : des pixels supplémentaires sont ajoutés. Ces pixels ont la couleur définie avec la propriété ..CouleurRemplissage.
Pixel[x,y]Tableau de CouleurPermet de manipuler les pixels de l'image.
ValideBooléenRenvoie la validité de l'image :
  • Vrai si l'image est valide : elle a été correctement chargée ou créée.
  • Faux dans le cas contraire.
Cette propriété est disponible en lecture uniquement.

Remarque : Ces propriétés peuvent être utilisées avec une des deux syntaxes suivantes :
  • <Nom de la variable>..<Nom de la propriété>
  • <Nom de la variable>.<Nom de la propriété>

Accès aux pixels

Pour accéder aux pixels de l'image, il est possible d'utiliser la syntaxe suivante :
<Nom de la variable Image>[<Coordonnée horizontale>, <Coordonnée verticale>]
L'origine des coordonnées est (0,0).
Par exemple :
// Modification du pixel aux coordonnées 220,300
MonImage[220,300] = JauneClair
Il est également possible d'utiliser directement les propriétés du type Couleur. Par exemple :
MonImage[220,300]..Luminosité = MonImage[220,300]..Luminosité + 10

Gestion de la couche Alpha

Une image contient une couche alpha dans les cas suivants :
  • si elle a été créée avec une couche alpha par défaut, spécifiée par la propriété ..CouleurRemplissage.
  • si elle a été chargée à partir d'un format d'image contenant une couche alpha (par exemple le format PNG).
Il est possible de manipuler la couche Alpha de l'image en manipulant ses pixels.

Variable de type Image et champ Image

Il est possible de :
  • affecter un champ Image avec une variable de type Image.
  • affecter une variable de type Image avec un champ Image.
Ces manipulations sont disponibles dans les champs Image de l'éditeur de fenêtres, de pages et d'états.

Variable de type Image et débogueur

Il est possible de visualiser le contenu d'une variable de type Image dans le débogueur.

Créer une image à une taille spécifique

Pour créer une image à une taille spécifique, il suffit d'utiliser les propriétés ..Largeur et ..Hauteur.
Par exemple :
MonImage est une Image
MonImage..Largeur = 10
MonImage..Hauteur = 10
L'unité utilisée est le pixel.
Le code suivant crée une image de 0 x 0.
MonImage est une Image

Fonctions manipulant des variables de type Image

Versions 09 et supérieures
dArc
Nouveauté 09
dArc
dArc
Dessine un arc de cercle ou un arc d'ellipse :
  • dans un champ Image,
  • dans une variable de type Image.
Versions 21 et supérieures
dCadre
Nouveauté 21
dCadre
dCadre
Dessine un cadre.
Versions 09 et supérieures
dCercle
Nouveauté 09
dCercle
dCercle
Dessine un cercle ou une ellipse :
  • dans un champ Image,
  • dans une variable de type Image.
Versions 09 et supérieures
dChangeMode
Nouveauté 09
dChangeMode
dChangeMode
Change le mode de dessin utilisé par les fonctions de dessin (fonctions dLigne, dRectangle, ....).
Versions 17 et supérieures
dChargeImage
Nouveauté 17
dChargeImage
dChargeImage
Charge une image dans une variable de type Image à partir d'un mémo, d'un fichier ou d'un buffer binaire.
Versions 18 et supérieures
dCopie
Nouveauté 18
dCopie
dCopie
Copie une image dans une autre image.
Versions 09 et supérieures
dCopieImage
Nouveauté 09
dCopieImage
dCopieImage
Copie une image :
  • d'un champ Image vers un autre champ Image.
  • d'une une variable de type Image dans une autre variable de type Image.
Versions 17 et supérieures
dCopieImageEcran
Nouveauté 17
dCopieImageEcran
dCopieImageEcran
Copie le contenu de l’écran dans une variable de type Image ou dans un champ Image.
Versions 17 et supérieures
dCopieImageFenêtre
Nouveauté 17
dCopieImageFenêtre
dCopieImageFenêtre
Copie l'image d'une fenêtre WINDEV dans une variable de type Image ou dans un champ Image.
Versions 09 et supérieures
dCorde
Nouveauté 09
dCorde
dCorde
Dessine une corde de cercle (intersection d'une ellipse et d'une droite) :
  • dans un champ Image,
  • dans une variable de type Image.
Versions 17 et supérieures
dDécoupe
Nouveauté 17
dDécoupe
dDécoupe
Renvoie la partie découpée d'une image. Cette image est présente dans une variable de type Image.
Versions 09 et supérieures
dFond
Nouveauté 09
dFond
dFond
Déclare la couleur de fond par défaut des rectangles, des cercles, ... utilisés :
  • dans un champ Image,
  • dans une variable de type Image.
Versions 17 et supérieures
dHalo
Nouveauté 17
dHalo
dHalo
Ajoute un effet de halo sur une image présente dans une variable de type Image.
Versions 17 et supérieures
dIncrusteCouleur
Nouveauté 17
dIncrusteCouleur
dIncrusteCouleur
Incruste une couleur dans une image contenue dans une variable de type Image.
Versions 09 et supérieures
dLigne
Nouveauté 09
dLigne
dLigne
Dessine une ligne :
  • dans un champ Image,
  • dans une variable de type Image.
Versions 17 et supérieures
dOmbre
Nouveauté 17
dOmbre
dOmbre
Ajoute un effet d'ombre sur une image contenue dans une variable de type Image.
Versions 09 et supérieures
dPoint
Nouveauté 09
dPoint
dPoint
Dessine un point :
  • dans un champ Image,
  • dans une variable de type Image.
Versions 09 et supérieures
dPolice
Nouveauté 09
dPolice
dPolice
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.
Versions 09 et supérieures
dPolygone
Nouveauté 09
dPolygone
dPolygone
Dessine un polygone :
  • dans un champ Image,
  • dans une variable de type Image.
Versions 24 et supérieures
dPolyligne
Nouveauté 24
dPolyligne
dPolyligne
Dessine une ligne composée de plusieurs segments.
Versions 09 et supérieures
dPortion
Nouveauté 09
dPortion
dPortion
Dessine une portion de cercle ou d'ellipse :
  • dans un champ Image,
  • dans une variable de type Image.
Versions 09 et supérieures
dRectangle
Nouveauté 09
dRectangle
dRectangle
Dessine un rectangle :
  • dans un champ Image,
  • dans une variable de type Image.
Versions 21 et supérieures
dRectangleArrondi
Nouveauté 21
dRectangleArrondi
dRectangleArrondi
Dessine un rectangle arrondi :
  • dans un champ Image,
  • dans une variable de type Image.
Versions 12 et supérieures
dRectangleDégradé
Nouveauté 12
dRectangleDégradé
dRectangleDégradé
Dessine un rectangle :
  • dans un champ Image,
  • dans une variable de type Image.
Versions 09 et supérieures
dRemplissage
Nouveauté 09
dRemplissage
dRemplissage
Colorie une zone :
  • dans un champ Image,
  • dans une variable de type Image.
Versions 09 et supérieures
dStylo
Nouveauté 09
dStylo
dStylo
Déclare la couleur et le style par défaut du tracé des traits, des rectangles, des cercles, ... contenus :
  • dans un champ Image,
  • dans une variable de type Image.
Versions 09 et supérieures
dTexte
Nouveauté 09
dTexte
dTexte
Dessine un texte :
  • dans un champ Image,
  • dans une variable de type Image.
Versions 20 et supérieures
dTexteRTF
Nouveauté 20
dTexteRTF
dTexteRTF
Dessine un texte RTF :
  • dans un champ Image,
  • dans une variable de type Image.
Versions 17 et supérieures
dTransfertVersImage
Nouveauté 17
dTransfertVersImage
dTransfertVersImage
Crée une image à partir d'un buffer de pixels encodé sous un format spécifique.
Cette fonction est d'un usage avancé. Cette fonction est intéressante notamment pour manipuler des images renvoyées par des API externes grâce à des variables de type Image.
Versions 19 et supérieures
grDestinationImage
Nouveauté 19
grDestinationImage
grDestinationImage
Définit une variable de type Image comme destination d'un graphe.
Versions 09 et supérieures
iHauteurImage
Nouveauté 09
iHauteurImage
iHauteurImage
Calcule la hauteur de l'image à imprimer (en millimètres).
Versions 09 et supérieures
iImprimeImage
Nouveauté 09
iImprimeImage
iImprimeImage
Envoie au buffer d'impression le fichier image à imprimer.
Versions 09 et supérieures
iLargeurImage
Nouveauté 09
iLargeurImage
iLargeurImage
Calcule la largeur de l'image à imprimer (en millimètres).

Fonctions (syntaxe objet) manipulant des variables de type Image

Versions 24 et supérieures
<Variable Image>.DessineArc
<Variable Image>.DessineArc
Dessine un arc de cercle ou un arc d'ellipse dans une variable de type Image.
Versions 24 et supérieures
<Variable Image>.DessineCadre
<Variable Image>.DessineCadre
Dessine un cadre dans une variable de type Image.
Versions 24 et supérieures
<Variable Image>.DessineCercle
<Variable Image>.DessineCercle
Dessine un cercle ou une ellipse dans une variable de type Image.
Versions 24 et supérieures
<Variable Image>.ChangeMode
<Variable Image>.ChangeMode
Change le mode de dessin utilisé par les fonctions de dessin (fonctions dLigne, dRectangle, ....).
Versions 24 et supérieures
<Variable Image>.Copie
<Variable Image>.Copie
Copie une image dans une autre image.
Versions 24 et supérieures
<Variable Image>.DessineCorde
<Variable Image>.DessineCorde
Dessine une corde de cercle (intersection d'une ellipse et d'une droite) dans une variable de type Image.
Versions 24 et supérieures
<Variable Image>.CouleurDominanteImage
<Variable Image>.CouleurDominanteImage
Renvoie la couleur dominante (c'est-à-dire la plus fréquente) d'une image présente dans une variable de type Image.
Versions 24 et supérieures
<Variable Image>.DébutDessin
<Variable Image>.DébutDessin
Versions 24 et supérieures
<Variable Image>.Découpe
<Variable Image>.Découpe
Renvoie la partie découpée d'une image. Cette image est présente dans une variable de type Image.
Versions 24 et supérieures
<Variable Image>.Fond
<Variable Image>.Fond
Déclare la couleur de fond par défaut des rectangles, des cercles, ... utilisés dans une variable de type Image.
Versions 24 et supérieures
<Variable Image>.DessineHalo
<Variable Image>.DessineHalo
Ajoute un effet de halo sur une image présente dans une variable de type Image.
Versions 24 et supérieures
<Variable Image>.IncrusteCouleur
<Variable Image>.IncrusteCouleur
Incruste une couleur dans une image contenue dans une variable de type Image.
Versions 24 et supérieures
<Variable Image>.InverseCouleur
<Variable Image>.InverseCouleur
Inverse les couleurs dans une variable de type Image.
Versions 24 et supérieures
<Variable Image>.DessineLigne
<Variable Image>.DessineLigne
Dessine une ligne dans une variable de type Image.
Versions 24 et supérieures
<Variable Image>.ModifieLuminosité
<Variable Image>.ModifieLuminosité
Modifie la luminosité d'une image contenue dans une variable de type Image.
Versions 24 et supérieures
<Variable Image>.ModifieOpacité
<Variable Image>.ModifieOpacité
Modifie l'opacité d'une image (c'est-à-dire la couche alpha de l'image).
Versions 24 et supérieures
<Variable Image>.ModifieSaturation
<Variable Image>.ModifieSaturation
Modifie la saturation d'une image contenue dans une variable de type Image.
Versions 24 et supérieures
<Variable Image>.ModifieTeinte
<Variable Image>.ModifieTeinte
Modifie la teinte d'une image contenue dans une variable de type Image.
Versions 24 et supérieures
<Variable Image>.ModifieTSL
<Variable Image>.ModifieTSL
Modifie la teinte, la saturation et la luminosité d'une image contenue dans une variable de type Image.
Versions 24 et supérieures
<Variable Image>.DessineOmbre
<Variable Image>.DessineOmbre
Ajoute un effet d'ombre sur une image contenue dans une variable de type Image.
Versions 24 et supérieures
<Variable Image>.PixelCouleur
<Variable Image>.PixelCouleur
Identifie la couleur d'un pixel contenu dans une variable de type Image.
Versions 24 et supérieures
<Variable Image>.PixelOpacité
<Variable Image>.PixelOpacité
Identifie l'opacité d'un pixel d'une image (présente dans une variable de type Image) gérant la couche Alpha.
Versions 24 et supérieures
<Variable Image>.DessinePoint
<Variable Image>.DessinePoint
Dessine un point dans une variable de type Image.
Versions 24 et supérieures
<Variable Image>.Police
<Variable Image>.Police
Déclare la police de caractères qui sera utilisée par la fonction dTexte dans une variable de type Image.
Versions 24 et supérieures
<Variable Image>.DessinePolygone
<Variable Image>.DessinePolygone
Dessine un polygone dans une variable de type Image.
Versions 24 et supérieures
<Variable Image>.DessinePolyligne
<Variable Image>.DessinePolyligne
Dessine dans une variable de type Image une ligne composée de plusieurs segments.
Versions 24 et supérieures
<Variable Image>.DessinePortion
<Variable Image>.DessinePortion
Dessine une portion de cercle ou d'ellipse dans une variable de type Image.
Versions 24 et supérieures
<Variable Image>.DessineRectangleArrondi
<Variable Image>.DessineRectangleArrondi
Dessine un rectangle arrondi dans une variable de type Image.
<Variable Image>.DessineRectangleDégradéDessine un rectangle dans une variable de type Image.
Versions 24 et supérieures
<Variable Image>.DessineRectangle
<Variable Image>.DessineRectangle
Dessine un rectangle dans une variable de type Image.
Versions 24 et supérieures
<Variable Image>.Redimensionne
<Variable Image>.Redimensionne
Redimensionne une image contenue dans une variable de type Image.
Versions 24 et supérieures
<Variable Image>.Remplissage
<Variable Image>.Remplissage
Colorie une zone dans une variable de type Image.
Versions 24 et supérieures
<Variable Image>.Rotation
<Variable Image>.Rotation
Effectue une rotation d'une image contenue dans une variable de type Image.
Versions 24 et supérieures
<Variable Image>.SauveBMP
<Variable Image>.SauveBMP
Sauve une image contenue dans une variable de type Image :
  • soit dans un fichier au format BMP.
  • soit en mémoire.
Versions 24 et supérieures
<Variable Image>.SauveGIF
<Variable Image>.SauveGIF
Sauve une image présente dans une variable de type Image :
  • soit dans un fichier au format GIF.
  • soit en mémoire.
Versions 24 et supérieures
<Variable Image>.SauveJPEG
<Variable Image>.SauveJPEG
Sauve une image présente dans une variable de type Image :
  • soit dans un fichier au format JPEG.
  • soit en mémoire.
Versions 24 et supérieures
<Variable Image>.SauvePNG
<Variable Image>.SauvePNG
Sauve une image présente dans une variable de type Image :
  • soit dans un fichier au format PNG.
  • soit en mémoire.
Versions 24 et supérieures
<Variable Image>.Stylo
<Variable Image>.Stylo
Déclare la couleur et le style par défaut du tracé des traits, des rectangles, des cercles, ... contenus dans une variable de type Image.
Versions 24 et supérieures
<Variable Image>.SymétrieHorizontale
<Variable Image>.SymétrieHorizontale
Effectue une symétrie horizontale d'une image contenue dans une variable de type Image.
Versions 24 et supérieures
<Variable Image>.SymétrieVerticale
<Variable Image>.SymétrieVerticale
Effectue une symétrie verticale d'une image contenue dans une variable de type Image.
Versions 24 et supérieures
<Variable Image>.DessineTexteRTF
<Variable Image>.DessineTexteRTF
Dessine un texte RTF dans une variable de type Image.
Versions 24 et supérieures
<Variable Image>.DessineTexte
<Variable Image>.DessineTexte
Dessine un texte dans une variable de type Image.
Version minimum requise
  • Version 17
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire