imageresolution

(PHP 7 >= 7.2.0, PHP 8)

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

Description

function 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, les résolutions horizontale et verticale sont définies à cette valeur. Si aucun des paramètres optionnels n'est null, les résolutions 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 depuis ou écrites vers 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
)