Class Driver

La classe Driver est une couche d'abstraction à GD et permet de dessiner toutes sortes de formes géométriques sur une Image.

Sur une image, l'axe des abscisses rejoint l'axe des ordonnées sur le coin haut-gauche. Le coin haut-gauche de l'image a donc pour coordonnées (0, 0) et le coin bas-droite (largeur, hauteur). Par exemple, sur une image de largeur 100 et de hauteur 50, un point à 50 sur l'axe des abscisses et 25 sur l'axe des ordonnées sera au centre de l'image.

Méthodes et propriétés

Documentation

  • public resource $resource
    La ressource GD utilisée par le pilote.
  • public int $imageWidth
    La largeur de l'image gérée par le pilote.
  • public int $imageHeight
    La hauteur de l'image gérée par le pilote.
  • protected bool $antiAliasing := FALSE
    Doit-on utiliser l'anti-aliasing sur ce dessin ?
  • public __construct()
    Construit le pilote.
  • public init(Image $image)
    • Disponible depuis Artichow 1.1.0
    Crée la ressource GD dont a besoin le Driver pour dessiner l'Image.
  • public initFromFile(FileImage $fileImage, string $file)
    • Disponible depuis Artichow 1.1.0
    Crée la ressource GD dont a besoin le Driver à partir d'un fichier déjà existant dont le nom est $file.
  • public setImageSize(int $width, int $height)
    Change la taille de l'image gérée par le pilote pour la largeur $width et la hauteur $height.
  • public setPosition(float $x, float $y)
    Informe le pilote de la position de la sous-image sur l'image. Les positions X et Y sont données via les paramètres $x et $y, qui représentent une fraction de la taille de l'image.
  • public movePosition(int $x, int $y)
    Demande au pilote de déplacer la position de la sous-image sur l'image. $x et $y représentent respectivement les déplacements latéral et vertical de la position en pixels.
  • public setAbsPosition(int $x, int $y)
    Informe le pilote de la position de la sous-image sur l'image. Les positions X et Y sont données via les paramètres $x et $y, dont l'unité est le pixel.
  • public setSize(float $w, float $h)
    Informe le pilote de la taille de la sous-image sur l'image. Les largeur et hauteur de la sous-image sont données via les paramètres $w et $h, qui représentent une fraction de la taille de l'image.
  • public setAbsSize(int $w, int $h)
    Informe le pilote de la taille de la sous-image sur l'image. Les largeur et hauteur de la sous-image sont données via les paramètres $w et $h, dont l'unité est le pixel.
  • public array getSize()
    Retourne la taille de la sous-image en pixels. Les valeurs sont retournées sous la forme d'un tableau, de la forme array(largeur, hauteur).
  • public int getColor(Color $color)
    Retourne la couleur sous la forme d'un entier numérique, utilisable ensuite avec les fonctions GD de PHP.
  • public send(Image $image)
    Construit l'image passée en paramètre et l'envoie sur la sortie standard accompagnée des en-têtes HTTP correspondants. A aucun moment vous ne devriez avoir besoin d'appeler vous-même cette méthode. Pour générez les images, utilisez Graph::draw().
  • public get(Image $image)
    • Disponible depuis Artichow 1.1.0
    Construit l'image passée en paramètre et la renvoie sous forme de données binaires. Vous pouvez donc la stocker dans une variable si vous voulez faire des manipulations spécifiques. A aucun moment vous ne devriez avoir besoin d'appeler vous-même cette méthode. Pour générez les images, utilisez Graph::draw().
  • public setAntiAliasing(bool $bool)
    • Disponible depuis Artichow 1.0.9
    Active ou désactive l'anti-aliasing lors du dessin. L'anti-aliasing permet d'avoir des graphiques plus propres mais demande plus de ressources. L'anti-aliasing n'est pas activé par défaut.
  • public copyImage(Image $image, Point $p1, Point $p2)
    Copie l'image $image vers la sous-image courante. L'image sera copiée sur la sous-image du point $p1 (coin haut-gauche) ou point $p2 (coin bas-droit). Les coordonnées de $p1 et $p2 doivent être relatives à celles de la sous-image.
  • public copyResizeImage(Image $image, Point $d1, Point $d2, Point $s1, Point $s2, bool $resampled)
    Copie l'image $image vers l'image courante. L'image $image sera copiée des points $s1 (coin haut-gauche) et $s2 (coin bas-droit) vers les points $d1 (coin haut-gauche) et $d2 (coin bas-droit) de l'image courante. Si $resampled est placé à TRUE, l'image sera rééchantillonée.
  • public string(Text $text, Point $point, int $width := NULL)
    Dessine la chaîne de caractères $text à partir du point $point. Les coordonnées de $point doivent être relatives à celles de la sous-image. Le paramètre $width permet de spécifier la largeur maximale en pixels de la boîte de texte.
  • public point(Color $color, Point $point)
    Dessine un pixel de couleur $color au point $point. Les coordonnées de $point doivent être relatives à celles de la sous-image.
  • public line(Color $color, Line $line)
    Dessine la ligne $line de couleur $color. Les coordonnées de la ligne doivent être relatives à celles de la sous-image.
  • public arc(Color $color, Point $center, int $width, int $height, float $from, float $to)
    Dessine un arc d'ellipse de couleur $color dont les deux extrémités sont reliées au centre de l'ellipse. L'ellipse a pour centre $center et est de largeur et hauteur respectives $width et $height. L'angle de départ pour l'arc est $from et l'angle d'arrivée $to.
    Voir aussi :
  • public filledArc(mixed $background, Point $center, int $width, int $height, float $from, float $to)
    Dessine un arc d'ellipse dont les deux extrémités sont reliées au centre de l'ellipse et le remplit avec la couleur ou le dégradé $background. L'ellipse a pour centre $center et est de largeur et hauteur respectives $width et $height. L'angle de départ pour l'arc est $from et l'angle d'arrivée $to.
    Voir aussi :
  • public ellipse(Color $color, Point $center, int $width, int $height)
    Dessine une ellipse de couleur $color, ayant pour centre $center et de largeur et hauteur respectives $width et $height. Les coordonnées de l'ellipse doivent être relatives à celles de la sous-image.
  • public filledEllipse(mixed $background, Point $center, int $width, int $height)
    Dessine et remplit une ellipse avec la couleur ou le dégradé $background. Cette ellipse a pour centre $center et est de largeur et hauteur respectives $width et $height. Les coordonnées de l'ellipse doivent être relatives à celles de la sous-image.
    Voir aussi :
  • public rectangle(Color $color, Point $p1, Point $p2)
    Dessine un rectangle de couleur $color des points $p1 à $p2 (le segment qui relie ces points représente la diagonale du rectangle). Les coordonnées du rectangle doivent être relatives à celles de la sous-image.
  • public filledRectangle(mixed $background, Point $p1, Point $p2)
    Dessine et remplit un rectangle avec la couleur ou le dégradé $background des points $p1 à $p2 (le segment qui relie ces points représente la diagonale du rectangle). Les coordonnées du rectangle doivent être relatives à celles de la sous-image.
    Voir aussi :
  • public polygon(Color $color, Polygon $polygon)
    Dessine le polygone $polygon de couleur $color. Les coordonnées de chaque point du polygone doivent être relatives à celles de la sous-image.
  • public filledPolygon(mixed $background, Polygon $polygon)
    Dessine et remplit le polygone $polygon avec la couleur ou le dégradé $background. Les coordonnées de chaque point du polygone doivent être relatives à celles de la sous-image.
    Voir aussi :