# Gmagick

# Introduction

Avertissement

Cette extension est EXPERIMENTALE. Le comportement de cette extension, les noms de ses fonctions, et toute la documentation autour de cette extension peut changer sans préavis dans une prochaine version de PHP. Cette extension doit être utilisée à vos risques et périls.

Gmagick est une extension PHP pour créer, modifier et obtenir des informations méta sur des images en utilisant l'API GraphicsMagick.

GraphicsMagick s'enorgueillit d'être le couteau suisse du traitement de l'image. Il fonctionne avec quelque 88 formats majeurs, incluant des formats importants comme DPX, GIF, JPEG, JPEG-2000, PNG, PDF, PNM, et TIFF.

Gmagick est composé d'une classe principale Gmagick, d'une classe GmagickDraw qui s'occupe du dessin et d'une classe GmagickPixel dont les instances représentent un seul pixel d'une image (couleur, opacité).

- Installation/Configuration
  - Pré-requis
  - Installation
- Constantes pré-définies
- Exemples
- Gmagick — La classe Gmagick
  - Gmagick::addimage — Ajoute une nouvelle image à la liste des images de l'objet Gmagick
  - Gmagick::addnoiseimage — Ajoute du bruit aléatoirement dans l'image
  - Gmagick::annotateimage — Annote une image avec du texte
  - Gmagick::blurimage — Ajoute un filtre flou à l'image
  - Gmagick::borderimage — Ajoute une bordure à l'image
  - Gmagick::charcoalimage — Simule un dessin au fusain
  - Gmagick::chopimage — Supprime une région de l'image
  - Gmagick::clear — Efface toutes les ressources associées à l'objet Gmagick
  - Gmagick::commentimage — Ajoute un commentaire à l'image
  - Gmagick::compositeimage — Assemble 2 images
  - Gmagick::__construct — Le constructeur Gmagick
  - Gmagick::cropimage — Extrait une portion d'une image
  - Gmagick::cropthumbnailimage — Crée une miniature recadrée
  - Gmagick::current — Le contexte courant
  - Gmagick::cyclecolormapimage — Déplace la carte des couleurs d'une image
  - Gmagick::deconstructimages — Retourne les pixels différents entre des images
  - Gmagick::despeckleimage — Le but de despeckleimage
  - Gmagick::destroy — Le but de la méthode destroy
  - Gmagick::drawimage — Fait un rendu de l'objet GmagickDraw sur l'image courante
  - Gmagick::edgeimage — Améliore les bords intérieurs de l'image
  - Gmagick::embossimage — Retourne une image en niveaux de gris avec un effet à 3 dimensions
  - Gmagick::enhanceimage — Améliore la qualité d'une image contenant du bruit
  - Gmagick::equalizeimage — Égalise l'histogramme de l'image
  - Gmagick::flipimage — Crée une image miroir verticale
  - Gmagick::flopimage — Crée une image miroir horizontale
  - Gmagick::frameimage — Ajoute une bordure afin de simuler un effet 3D
  - Gmagick::gammaimage — Corrige le gamma d'une image
  - Gmagick::getcopyright — Retourne le copyright de l'API GraphicsMagick
  - Gmagick::getfilename — Retourne le nom du fichier associé avec une séquence d'image
  - Gmagick::getimagebackgroundcolor — Retourne la couleur d'arrière plan de l'image
  - Gmagick::getimageblueprimary — Retourne le point bleu primaire chromatique
  - Gmagick::getimagebordercolor — Retourne la couleur du bord de l'image
  - Gmagick::getimagechanneldepth — Récupère la profondeur d'un canal particulier de l'image
  - Gmagick::getimagecolors — Retourne la couleur de l'indice de la carte des couleurs spécifiée
  - Gmagick::getimagecolorspace — Récupère l'espace colorimétrique de l'image
  - Gmagick::getimagecompose — Retourne l'opérateur de composition associé avec l'image
  - Gmagick::getimagedelay — Récupère le délai de l'image
  - Gmagick::getimagedepth — Récupère la profondeur de l'image
  - Gmagick::getimagedispose — Récupère la méthode de disposition de l'image
  - Gmagick::getimageextrema — Récupère les extrémités de l'image
  - Gmagick::getimagefilename — Récupère le nom du fichier d'une image particulière dans une séquence
  - Gmagick::getimageformat — Récupère le format d'une image particulière dans une séquence
  - Gmagick::getimagegamma — Récupère le gamma de l'image
  - Gmagick::getimagegreenprimary — Récupère le point chromatique primaire vert
  - Gmagick::getimageheight — Récupère la hauteur de l'image
  - Gmagick::getimagehistogram — Récupère l'histogramme de l'image
  - Gmagick::getimageindex — Récupère l'indice de l'image active courante
  - Gmagick::getimageinterlacescheme — Récupère le schéma d'entrelacement de l'image
  - Gmagick::getimageiterations — Récupère les itérations de l'image
  - Gmagick::getimagematte — Vérifie si l'image a un canal mate
  - Gmagick::getimagemattecolor — Récupère la couleur mate de l'image
  - Gmagick::getimageprofile — Récupère le nom du profil de l'image
  - Gmagick::getimageredprimary — Récupère le point chromatique primaire rouge
  - Gmagick::getimagerenderingintent — Récupère l'image de rendu
  - Gmagick::getimageresolution — Récupère la résolution de l'image
  - Gmagick::getimagescene — Récupère la scène de l'image
  - Gmagick::getimagesignature — Génère la signature SHA-256 de l'image
  - Gmagick::getimagetype — Récupère le type potentiel d'une image
  - Gmagick::getimageunits — Récupère les unités utilisées pour la résolution de l'image
  - Gmagick::getimagewhitepoint — Récupère le point chromatique blanc
  - Gmagick::getimagewidth — Récupère la largeur de l'image
  - Gmagick::getpackagename — Récupère le nom du paquet GraphicsMagick
  - Gmagick::getquantumdepth — Récupère la profondeur du quantum Gmagick
  - Gmagick::getreleasedate — Récupère la date de sortie de la version courante de GraphicsMagick
  - Gmagick::getsamplingfactors — Récupère le facteur d'échantillonnage horizontal et vertical
  - Gmagick::getsize — Récupère la taille associée avec l'objet Gmagick
  - Gmagick::getversion — Récupère la version de l'API GraphicsMagick
  - Gmagick::hasnextimage — Vérifie si l'objet contient au moins une autre image
  - Gmagick::haspreviousimage — Vérifie si l'objet contient une image précédente
  - Gmagick::implodeimage — Crée une image à partir d'une copie
  - Gmagick::labelimage — Ajoute un libellé à une image
  - Gmagick::levelimage — Ajuste les niveaux d'une image
  - Gmagick::magnifyimage — Retaille par 2 une image en conservant les proportions
  - Gmagick::mapimage — Remplace les couleurs d'une image avec les couleurs les plus proches d'une image de référence
  - Gmagick::medianfilterimage — Applique un filtre numérique
  - Gmagick::minifyimage — Réduit une image de moitié en gardant les proportions
  - Gmagick::modulateimage — Contrôle la luminosité, la saturation et la teinte
  - Gmagick::motionblurimage — Simule un flou cinétique
  - Gmagick::newimage — Crée une nouvelle image
  - Gmagick::nextimage — Se déplace sur l'image suivante
  - Gmagick::normalizeimage — Améliore le contraste de la couleur de l'image
  - Gmagick::oilpaintimage — Simule une peinture à l'huile
  - Gmagick::previousimage — Se déplace vers l'image précédente de l'objet
  - Gmagick::profileimage — Ajoute ou supprime un profil d'une image
  - Gmagick::quantizeimage — Analyse les couleurs d'une image de référence
  - Gmagick::quantizeimages — Le but de quantizeimages
  - Gmagick::queryfontmetrics — Retourne un tableau représentant la métrique pour la police de caractères
  - Gmagick::queryfonts — Retourne les polices de caractères configurées
  - Gmagick::queryformats — Retourne les formats supportés par Gmagick
  - Gmagick::radialblurimage — Brouille une image suivant un rayon
  - Gmagick::raiseimage — Crée un bouton avec un effet 3D
  - Gmagick::read — Lit une image depuis un fichier
  - Gmagick::readimage — Lit une image depuis un fichier
  - Gmagick::readimageblob — Lit une image depuis une chaîne binaire
  - Gmagick::readimagefile — Le but de readimagefile
  - Gmagick::reducenoiseimage — Lisse les contours de l'image
  - Gmagick::removeimage — Supprime une image depuis la liste des images
  - Gmagick::removeimageprofile — Supprime un profil nommé de l'image
  - Gmagick::resampleimage — Échantillonne l'image à la résolution désirée
  - Gmagick::resizeimage — Redimensionne une image
  - Gmagick::rollimage — Repositionne une image
  - Gmagick::rotateimage — Effectue une rotation de l'image
  - Gmagick::scaleimage — Met à l'échelle une image
  - Gmagick::separateimagechannel — Sépare un canal depuis une image
  - Gmagick::setCompressionQuality — Définit la qualité de compression par défaut de l'objet
  - Gmagick::setfilename — Définit le nom de fichier avant la lecture ou l'écriture d'une image
  - Gmagick::setimagebackgroundcolor — Définit la couleur d'arrière-plan de l'image
  - Gmagick::setimageblueprimary — Définit le point bleu primaire de l'image chromatique
  - Gmagick::setimagebordercolor — Définit la couleur de la bordure de l'image
  - Gmagick::setimagechanneldepth — Définit la profondeur d'un canal particulier de l'image
  - Gmagick::setimagecolorspace — Définit l'espace de couleurs de l'image
  - Gmagick::setimagecompose — Définit l'opérateur de composition de l'image
  - Gmagick::setimagedelay — Définit le délai de l'image
  - Gmagick::setimagedepth — Définit la profondeur de l'image
  - Gmagick::setimagedispose — Définit la méthode de disposition de l'image
  - Gmagick::setimagefilename — Définit le nom du fichier pour une image particulière d'une séquence
  - Gmagick::setimageformat — Définit le format d'une image
  - Gmagick::setimagegamma — Définit le gamma de l'image
  - Gmagick::setimagegreenprimary — Définit le point vert sur l'image chromatique primaire
  - Gmagick::setimageindex — Définit l'itérateur à la position spécifiée dans l'image de la liste pointée par son index
  - Gmagick::setimageinterlacescheme — Définit le schéma d'entrelacement de l'image
  - Gmagick::setimageiterations — Définit les itérations de l'image
  - Gmagick::setimageprofile — Ajoute un profil nommé à l'objet Gmagick
  - Gmagick::setimageredprimary — Définit le point rouge sur l'image chromatique primaire
  - Gmagick::setimagerenderingintent — Définit l'image de rendu
  - Gmagick::setimageresolution — Définit la résolution de l'image
  - Gmagick::setimagescene — Définit l'image de scène
  - Gmagick::setimagetype — Définit le type de l'image
  - Gmagick::setimageunits — Définit les unités à utiliser pour la résolution de l'image
  - Gmagick::setimagewhitepoint — Définit le point blanc sur l'image chromatique primaire
  - Gmagick::setsamplingfactors — Définit les facteurs d'échantillonnage de l'image
  - Gmagick::setsize — Définit la taille de l'objet Gmagick
  - Gmagick::shearimage — Crée un parallélogramme
  - Gmagick::solarizeimage — Applique un effet de solarisation à l'image
  - Gmagick::spreadimage — Déplace aléatoirement chaque pixel d'un bloc
  - Gmagick::stripimage — Supprime d'une image tous les profils et tous les commentaires
  - Gmagick::swirlimage — Remous les pixels du centre de l'image
  - Gmagick::thumbnailimage — Modifie la taille d'une image
  - Gmagick::trimimage — Supprime les coins de l'image
  - Gmagick::write — Alias de Gmagick::writeimage
  - Gmagick::writeimage — Écrit une image dans un fichier
- GmagickDraw — La classe GmagickDraw
  - GmagickDraw::annotate — Dessine un texte sur l'image
  - GmagickDraw::arc — Dessine un arc
  - GmagickDraw::bezier — Dessine une courbe de Bézier
  - GmagickDraw::ellipse — Dessine une ellipse sur l'image
  - GmagickDraw::getfillcolor — Retourne la couleur de remplissage
  - GmagickDraw::getfillopacity — Retourne l'opacité utilisée lors d'un dessin
  - GmagickDraw::getfont — Retourne la police de caractères
  - GmagickDraw::getfontsize — Retourne la taille du point d'une police de caractères
  - GmagickDraw::getfontstyle — Retourne le style de la police de caractères
  - GmagickDraw::getfontweight — Retourne le poids de la police de caractères
  - GmagickDraw::getstrokecolor — Retourne la couleur utilisée pour tracer les contours de l'objet
  - GmagickDraw::getstrokeopacity — Retourne l'opacité du tracé des contours de l'objet
  - GmagickDraw::getstrokewidth — Retourne la largeur utilisée pour les contours de l'objet
  - GmagickDraw::gettextdecoration — Retourne la décoration du texte
  - GmagickDraw::gettextencoding — Retourne le code du jeu de caractères à utiliser pour les annotations
  - GmagickDraw::line — Trace une ligne
  - GmagickDraw::point — Dessine un point
  - GmagickDraw::polygon — Dessine un polygone
  - GmagickDraw::polyline — Dessine une polyligne
  - GmagickDraw::rectangle — Dessine un rectangle
  - GmagickDraw::rotate — Applique une rotation
  - GmagickDraw::roundrectangle — Dessine un rectangle arrondi
  - GmagickDraw::scale — Ajuste le facteur d'échelle
  - GmagickDraw::setfillcolor — Définit la couleur de remplissage à utiliser pour dessiner des objets pleins
  - GmagickDraw::setfillopacity — Le but de la méthode setfillopacity
  - GmagickDraw::setfont — Définit la police de caractère à utiliser lors d'une annotation
  - GmagickDraw::setfontsize — Définit la taille, en points, de la police de caractère utilisée lors d'une annotation
  - GmagickDraw::setfontstyle — Définit le style de police de caractères à utiliser lors d'une annotation
  - GmagickDraw::setfontweight — Définit le poids de la police de caractères
  - GmagickDraw::setstrokecolor — Définit la couleur à utiliser pour tracer les contours de l'objet
  - GmagickDraw::setstrokeopacity — Spécifie l'opacité pour les contours de l'objet
  - GmagickDraw::setstrokewidth — Définit la largeur des contours de l'objet
  - GmagickDraw::settextdecoration — Spécifie une décoration
  - GmagickDraw::settextencoding — Spécifie le code du jeu de caractères à utiliser
- GmagickPixel — La classe GmagickPixel
  - GmagickPixel::__construct — Le constructeur GmagickPixel
  - GmagickPixel::getcolor — Retourne la couleur
  - GmagickPixel::getcolorcount — Retourne le nombre de couleurs associées avec cette couleur
  - GmagickPixel::getcolorvalue — Récupère la valeur normalisée du canal de la couleur fournie
  - GmagickPixel::setcolor — Définit la couleur
  - GmagickPixel::setcolorvalue — Définit la valeur normalisée d'un des canaux

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open