PHP 8.5.4 Released!

imageresolution

(PHP 7 >= 7.2.0, PHP 8)

imageresolutionRé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
)
add a note

User Contributed Notes 1 note

up
0
fernando dot fonseca at afteryou dot pt
4 years ago
It should be clear that the set version of the function doesn't change the image it self, just the resource in memory, which probably is fine if you didn't save the image yet. If your use case is for an image that is already on disk,  image you should always do something like:

imageresolution($img, 300, 300);
imagepng($img, $filname, $quality);
To Top