imageresolution

(PHP 7 >= 7.2.0, PHP 8)

imageresolution — Récupère ou définit la résoltion de l'image

Description

imageresolution(GdImage $image, ?int $resolution_x = null, ?int $resolution_y = null): array|bool

imageresolution() permet de définir et récupérer la résolution d'une image en DPI (dots per inch/point par pouce). Si les paramètres optionnel sont null, la résolution actuelle est retournée dans un tableau indexé, Si uniquement resolution_x n'est pas null, la résolution horizontale et verticale sont définit à cette valeur. Si aucun des paramètres optionnels sont null, la résolution horizontale et verticale sont définit à ces valeurs respectivement.

La résolution est uniquement utilisé en tant que méta données quand les images sont lu et écrit à des formats supportant ce genre d'information (actuellement PNG et JPEG). Ceci n'affecte pas les opérations de dessin. La résolution par défaut des nouvelles images est 96 DPI.

Liste de paramètres

image: Un objet GdImage, retournée par une des fonctions de création d'images, comme imagecreatetruecolor().
resolution_x: La résolution horizontale en DPI/PPP.
resolution_y: La résolution verticale en DPI/PPP.

Valeurs de retour

Quand utilisé en tant que récupérateur, ceci retourne un tableau indexé avec les résolutions horizontale et verticale en cas de succès, ou false si une erreur survient. Quand utilisé en tant que définisseur, ceci retourne true en cas de succès, ou false si une erreur survient.

Historique

Version	Description
8.0.0	`resolution_x` et `resolution_y` sont désormais nullable.

Exemples

Exemple #1 Définir et récupérer la résolution d'une image


<?php
$im = imagecreatetruecolor(100, 100);
imageresolution($im, 200);
print_r(imageresolution($im));
imageresolution($im, 300, 72);
print_r(imageresolution($im));
?>

L'exemple ci-dessus va afficher :

Array
(
    [0] => 200
    [1] => 200
)
Array
(
    [0] => 300
    [1] => 72
)