imageresolution

(PHP 7 >= 7.2.0, PHP 8)

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

Description

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

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 optionnels 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éfinies à cette valeur. Si aucun des paramètres optionnels ne sont null, la résolution horizontale et verticale sont définies à ces valeurs respectivement.

La résolution est uniquement utilisée en tant que métadonnées quand les images sont lues et écrites à 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. Quand utilisé en tant que définisseur, ceci retourne toujours true.

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
)