International PHP Conference Berlin 2025

imageresolution

(PHP 7 >= 7.2.0, PHP 8)

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

User Contributed Notes 1 note

up
1
fernando dot fonseca at afteryou dot pt
3 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