Nette Documentation Preview

syntax
Λειτουργίες εικόνας
*******************
הההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההה
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

Λειτουργίες εικόνας

Η κλάση Nette\Utils\Image απλοποιεί την επεξεργασία εικόνων, όπως η αλλαγή μεγέθους, η περικοπή, η όξυνση, η σχεδίαση ή η συγχώνευση πολλαπλών εικόνων.

Η PHP διαθέτει ένα εκτεταμένο σύνολο λειτουργιών για την επεξεργασία εικόνων. Αλλά το API δεν είναι πολύ ωραίο. Δεν θα ήταν ένα Neat Framework να δημιουργήσει ένα σέξι API.

Εγκατάσταση:

composer require nette/utils

Τα ακόλουθα παραδείγματα υποθέτουν ότι έχει οριστεί το ακόλουθο ψευδώνυμο κλάσης:

use Nette\Utils\Image;
use Nette\Utils\ImageColor;
use Nette\Utils\ImageType;

Δημιουργία εικόνας

Θα δημιουργήσουμε μια νέα έγχρωμη εικόνα, για παράδειγμα με διαστάσεις 100×200:

$image = Image::fromBlank(100, 200);

Προαιρετικά, μπορείτε να καθορίσετε ένα χρώμα φόντου (το προεπιλεγμένο είναι μαύρο):

$image = Image::fromBlank(100, 200, ImageColor::rgb(125, 0, 0));

Ή φορτώνουμε την εικόνα από ένα αρχείο:

$image = Image::fromFile('nette.jpg');

Αποθήκευση της εικόνας

Η εικόνα μπορεί να αποθηκευτεί σε αρχείο:

$image->save('resampled.jpg');

Μπορούμε να καθορίσουμε την ποιότητα συμπίεσης στο εύρος 0..100 για JPEG (προεπιλογή 85), WEBP (προεπιλογή 80) και AVIF (προεπιλογή 30) και 0..9 για PNG (προεπιλογή 9):

$image->save('resampled.jpg', 80); // JPEG, ποιότητα 80%

Εάν η μορφή δεν είναι προφανής από την επέκταση του αρχείου, μπορεί να καθοριστεί με σταθερά:

$image->save('resampled.tmp', null, ImageType::JPEG);

Η εικόνα μπορεί να εγγραφεί σε μια μεταβλητή αντί στο δίσκο:

$data = $image->toString(ImageType::JPEG, 80); // JPEG, ποιότητα 80%

ή να στείλετε απευθείας στο πρόγραμμα περιήγησης με την κατάλληλη επικεφαλίδα HTTP Content-Type:

// στέλνει επικεφαλίδα Content-Type: image/png
$image->send(ImageType::PNG);

Μορφές

Οι υποστηριζόμενοι μορφότυποι είναι JPEG, PNG, GIF, WebP, AVIF και BMP. Ωστόσο, πρέπει επίσης να υποστηρίζονται από την έκδοση της PHP σας, κάτι που μπορεί να επαληθευτεί με τη χρήση της συνάρτησης isTypeSupported(). Τα κινούμενα σχέδια δεν υποστηρίζονται.

Οι μορφές αναπαρίστανται από τις σταθερές ImageType::JPEG, ImageType::PNG, ImageType::GIF, ImageType::WEBP, ImageType::AVIF και ImageType::BMP.

$supported = Image::isTypeSupported(ImageType::JPEG);

Πρέπει να ανιχνεύσετε τη μορφή μιας εικόνας κατά τη φόρτωση; Η μέθοδος την επιστρέφει στη δεύτερη παράμετρο:

$image = Image::fromFile('nette.jpg', $type);

Η πραγματική ανίχνευση χωρίς φόρτωση της εικόνας πραγματοποιείται από τη διεύθυνση Image::detectTypeFromFile().

Αλλαγή μεγέθους εικόνας

Μια συνηθισμένη λειτουργία είναι η αλλαγή μεγέθους μιας εικόνας. Οι τρέχουσες διαστάσεις επιστρέφονται από τις μεθόδους getWidth() και getHeight().

Η μέθοδος resize() χρησιμοποιείται για την αλλαγή μεγέθους. Αυτό είναι παράδειγμα αναλογικής αλλαγής του μεγέθους ώστε να μην υπερβαίνει τα 500×300 pixels (είτε το πλάτος θα είναι ακριβώς 500px είτε το ύψος θα είναι ακριβώς 300px, μία από τις διαστάσεις υπολογίζεται για να διατηρηθεί η αναλογία διαστάσεων):

$image->resize(500, 300);

Είναι δυνατόν να ορίσετε μόνο μία διάσταση και η δεύτερη θα υπολογιστεί:

$image->resize(500, null); // πλάτος 500px, ύψος auto

$image->resize(null, 300); // πλάτος auto, ύψος 300px

Οποιαδήποτε διάσταση μπορεί να καθοριστεί σε ποσοστά:

$image->resize('75%', 300); // 75% × 300px

Η συμπεριφορά του resize μπορεί να επηρεαστεί από τις ακόλουθες σημαίες. Όλα εκτός από το Image::Stretch διατηρούν την αναλογία διαστάσεων.

Σημαία Περιγραφή
Image::OrSmaller (προεπιλογή) οι διαστάσεις που θα προκύψουν θα είναι μικρότερες ή ίσες με τις καθορισμένες
Image::OrBigger γεμίζει την περιοχή στόχου και ενδεχομένως την επεκτείνει προς μία κατεύθυνση
Image::Cover γεμίζει όλη την περιοχή και κόβει ό,τι την υπερβαίνει
Image::ShrinkOnly Απλά μικραίνει (δεν επεκτείνει μια μικρή εικόνα)
Image::Stretch δεν διατηρεί την αναλογία διαστάσεων

Οι σημαίες περνούν ως τρίτο όρισμα της συνάρτησης:

$image->resize(500, 300, Image::OrBigger);

Οι σημαίες μπορούν να συνδυαστούν:

$image->resize(500, 300, Image::ShrinkOnly | Image::Stretch);

Οι εικόνες μπορούν να αναστραφούν κάθετα ή οριζόντια καθορίζοντας μία από τις διαστάσεις (ή και τις δύο) ως αρνητικό αριθμό:

$flipped = $image->resize(null, '-100%'); // αναστροφή κάθετη

$flipped = $image->resize('-100%', '-100%'); // περιστροφή κατά 180°

$flipped = $image->resize(-125, 500); // αλλαγή μεγέθους & αναστροφή οριζόντια

Μετά τη μείωση της εικόνας μπορούμε να τη βελτιώσουμε με την όξυνση:

$image->sharpen();

Κοπή

Η μέθοδος crop() χρησιμοποιείται για την καλλιέργεια:

$image->crop($left, $top, $width, $height);

Όπως και με το resize(), όλες οι τιμές μπορούν να καθοριστούν σε ποσοστά. Τα ποσοστά για τα $left και $top υπολογίζονται από τον υπόλοιπο χώρο, παρόμοια με την ιδιότητα της CSS background-position:

$image->crop('100%', '50%', '80%', '80%');

Η εικόνα μπορεί επίσης να περικοπεί αυτόματα, π.χ. περικοπή μαύρων άκρων:

$image->cropAuto(IMG_CROP_BLACK);

Η μέθοδος cropAuto() είναι μια ενθυλάκωση αντικειμένου της συνάρτησης imagecropauto(), δείτε την τεκμηρίωσή της για περισσότερες πληροφορίες.

Χρώματα

Η μέθοδος ImageColor::rgb() σας επιτρέπει να ορίσετε ένα χρώμα χρησιμοποιώντας τιμές κόκκινου, πράσινου και μπλε (RGB). Προαιρετικά, μπορείτε επίσης να καθορίσετε μια τιμή διαφάνειας που κυμαίνεται από 0 (εντελώς διαφανής) έως 1 (πλήρως αδιαφανής), όπως ακριβώς και στα CSS.

$color = ImageColor::rgb(255, 0, 0); // Red
$transparentBlue = ImageColor::rgb(0, 0, 255, 0.5); // Semi-transparent blue

Η μέθοδος ImageColor::hex() σάς επιτρέπει να ορίσετε ένα χρώμα χρησιμοποιώντας τη δεκαεξαδική μορφή, παρόμοια με τη CSS. Υποστηρίζει τις μορφές #rgb, #rrggbb, #rgba και #rrggbbaa:

$color = ImageColor::hex("#F00"); // Red
$transparentGreen = ImageColor::hex("#00FF0080"); // Semi-transparent green

Τα χρώματα μπορούν να χρησιμοποιηθούν σε άλλες μεθόδους, όπως ellipse(), fill(), κ.λπ.

Σχεδίαση και επεξεργασία

Μπορείτε να σχεδιάσετε, να γράψετε, να χρησιμοποιήσετε όλες τις συναρτήσεις της PHP για την επεξεργασία εικόνων, βλέπε Επισκόπηση μεθόδων, αλλά σε ένα αντικειμενοστραφές περιτύλιγμα:

$image->filledEllipse($centerX, $centerY, $width, $height, ImageColor::rgb(255, 0, 0));

Δεδομένου ότι οι συναρτήσεις της PHP για τη σχεδίαση ορθογωνίων δεν είναι πρακτικές λόγω του καθορισμού συντεταγμένων, η κλάση Image προσφέρει την αντικατάστασή τους με τη μορφή των συναρτήσεων rectangleWH() και filledRectangleWH().

Συγχώνευση πολλαπλών εικόνων

Μπορείτε εύκολα να τοποθετήσετε μια άλλη εικόνα μέσα στην εικόνα:

$logo = Image::fromFile('logo.png');
$blank = Image::fromBlank(320, 240, ImageColor::rgb(52, 132, 210));

// οι συντεταγμένες μπορούν να οριστούν επίσης σε ποσοστό
$blank->place($logo, '80%', '80%'); // κοντά στην κάτω δεξιά γωνία

Κατά την επικόλληση, το κανάλι άλφα τηρείται, επιπλέον, μπορούμε να επηρεάσουμε τη διαφάνεια της εισαγόμενης εικόνας (θα δημιουργήσουμε ένα λεγόμενο υδατογράφημα):

$blank->place($image, '80%', '80%', 25); // η διαφάνεια είναι 25 %

Ένα τέτοιο API είναι πραγματικά ευχάριστο στη χρήση, έτσι δεν είναι;

Επισκόπηση των μεθόδων

static fromBlank(int $width, int $height, ?ImageColor $color=null)Image

Δημιουργεί μια νέα έγχρωμη εικόνα με τις δεδομένες διαστάσεις. Το προεπιλεγμένο χρώμα είναι το μαύρο.

static fromFile(string $file, int &$detectedFormat=null)Image

Διαβάζει μια εικόνα από ένα αρχείο και επιστρέφει τον τύπο της σε $detectedFormat.

static fromString(string $s, int &$detectedFormat=null)Image

Διαβάζει μια εικόνα από μια συμβολοσειρά και επιστρέφει τον τύπο της σε $detectedFormat.

static rgb(int $red, int $green, int $blue, int $transparency=0)array

Το χαρακτηριστικό αυτό έχει αντικατασταθεί από την κλάση ImageColor, βλέπε χρώματα.

static typeToExtension(int $type)string

Επιστρέφει την επέκταση αρχείου για τον δεδομένο τύπο.

static typeToMimeType(int $type)string

Επιστρέφει τον τύπο mime για τον δεδομένο τύπο.

static extensionToType(string $extension)int

Επιστρέφει τον τύπο της εικόνας σύμφωνα με την επέκταση του αρχείου.

static detectTypeFromFile(string $file, int &$width=null, int &$height=null)?int

Επιστρέφει τον τύπο του αρχείου εικόνας και στις παραμέτρους $width και $height επίσης τις διαστάσεις του.

static detectTypeFromString(string $s, int &$width=null, int &$height=null)?int

Επιστρέφει τον τύπο της εικόνας από το αλφαριθμητικό και στις παραμέτρους $width και $height επίσης τις διαστάσεις της.

static isTypeSupported(int $type)bool

Καθορίζει αν υποστηρίζεται ο συγκεκριμένος τύπος εικόνας.

static getSupportedTypes(): array

Επιστρέφει έναν πίνακα υποστηριζόμενων τύπων εικόνας (σταθερές ImageType::XXX).

static calculateTextBox(string $text, string $fontFile, float $size, float $angle=0, array $options=[])array

Υπολογίζει τις διαστάσεις του ορθογωνίου που περικλείει το κείμενο σε καθορισμένη γραμματοσειρά και μέγεθος. Επιστρέφει έναν συσχετιστικό πίνακα που περιέχει τα κλειδιά left, top, width, height. Το αριστερό περιθώριο μπορεί να είναι αρνητικό εάν το κείμενο ξεκινά με αριστερή προεξοχή.

affine(array $affine, ?array $clip=null)Image

Επιστρέφει μια εικόνα που περιέχει την affine μετασχηματισμένη εικόνα src, χρησιμοποιώντας μια προαιρετική περιοχή αποκοπής. (περισσότερα).

affineMatrixConcat(array $m1, array $m2)array

Επιστρέφει τη συνένωση δύο πινάκων μετασχηματισμού affine, η οποία είναι χρήσιμη εάν πρέπει να εφαρμοστούν πολλαπλοί μετασχηματισμοί στην ίδια εικόνα με μία κίνηση. (περισσότερα)

affineMatrixGet(int $type, ?mixed $options=null)array

Επιστρέφει έναν πίνακα μετασχηματισμού affine. (περισσότερα)

alphaBlending(bool $on): void

Επιτρέπει δύο διαφορετικούς τρόπους σχεδίασης σε εικόνες truecolor. Στη λειτουργία ανάμειξης, η συνιστώσα του καναλιού άλφα του χρώματος που παρέχεται σε όλες τις λειτουργίες σχεδίασης, όπως το setPixel(), καθορίζει πόσο από το υποκείμενο χρώμα θα πρέπει να επιτρέπεται να διαφαίνεται. Ως αποτέλεσμα, αναμειγνύει αυτόματα το υπάρχον χρώμα στο συγκεκριμένο σημείο με το χρώμα του σχεδίου και αποθηκεύει το αποτέλεσμα στην εικόνα. Το εικονοστοιχείο που προκύπτει είναι αδιαφανές. Στη λειτουργία μη ανάμειξης, το χρώμα σχεδίασης αντιγράφεται κυριολεκτικά με τις πληροφορίες του καναλιού άλφα, αντικαθιστώντας το εικονοστοιχείο προορισμού. Η λειτουργία ανάμειξης δεν είναι διαθέσιμη όταν σχεδιάζετε σε εικόνες παλέτας. (περισσότερα)

antialias(bool $on): void

Ενεργοποιήστε τις γρήγορες μεθόδους αντιδιαμετρικής σχεδίασης για γραμμές και καλωδιωμένα πολύγωνα. Δεν υποστηρίζει στοιχεία άλφα. Λειτουργεί με απευθείας ανάμειξη. Λειτουργεί μόνο με truecolor εικόνες.

Η χρήση primitives με αντιδιαμετρική απεικόνιση και διαφανές χρώμα φόντου μπορεί να οδηγήσει σε απροσδόκητα αποτελέσματα. Η μέθοδος ανάμειξης χρησιμοποιεί το χρώμα φόντου όπως όλα τα άλλα χρώματα. Η έλλειψη υποστήριξης του συστατικού άλφα δεν επιτρέπει μια μέθοδο αντιδιαστολής με βάση το άλφα. (περισσότερα)

arc(int $centerX, int $centerY, int $width, int $height, int $startAngle, int $endAngle, ImageColor $color)void

Σχεδιάζει ένα τόξο κύκλου με κέντρο τις δεδομένες συντεταγμένες. (περισσότερα)

colorAllocate(int $red, int $green, int $blue)int

Επιστρέφει ένα αναγνωριστικό χρώματος που αντιπροσωπεύει το χρώμα που αποτελείται από τις δεδομένες συνιστώσες RGB. Πρέπει να κληθεί για να δημιουργήσει κάθε χρώμα που πρόκειται να χρησιμοποιηθεί στην εικόνα. (περισσότερα)

colorAllocateAlpha(int $red, int $green, int $blue, int $alpha)int

Συμπεριφέρεται πανομοιότυπα με το colorAllocate() με την προσθήκη της παραμέτρου διαφάνειας $alpha. (περισσότερα)

colorAt(int $x, int $y)int

Επιστρέφει τον δείκτη του χρώματος του εικονοστοιχείου στην καθορισμένη θέση στην εικόνα. Εάν η εικόνα είναι εικόνα πραγματικών χρωμάτων, η συνάρτηση αυτή επιστρέφει την τιμή RGB του συγκεκριμένου εικονοστοιχείου ως ακέραιο αριθμό. Χρησιμοποιήστε bitshifting και masking για να αποκτήσετε πρόσβαση στις ξεχωριστές τιμές των κόκκινων, πράσινων και μπλε συνιστωσών: (περισσότερα)

colorClosest(int $red, int $green, int $blue)int

Επιστρέφει τον δείκτη του χρώματος στην παλέτα της εικόνας που είναι πιο κοντά στην καθορισμένη τιμή RGB. Η „απόσταση“ μεταξύ του επιθυμητού χρώματος και κάθε χρώματος στην παλέτα υπολογίζεται σαν οι τιμές RGB να αντιπροσωπεύουν σημεία στον τρισδιάστατο χώρο. (περισσότερα)

colorClosestAlpha(int $red, int $green, int $blue, int $alpha)int

Επιστρέφει τον δείκτη του χρώματος στην παλέτα της εικόνας που είναι „πιο κοντά“ στην καθορισμένη τιμή RGB και το επίπεδο $alpha. (περισσότερα)

colorClosestHWB(int $red, int $green, int $blue)int

Λήψη του δείκτη του χρώματος που έχει την απόχρωση, το λευκό και το μαύρο που είναι πλησιέστερα στο δεδομένο χρώμα. (περισσότερα)

colorDeallocate(int $color)void

Αποδεσμεύει ένα χρώμα που είχε προηγουμένως εκχωρηθεί με το colorAllocate() ή το colorAllocateAlpha(). (περισσότερα)

colorExact(int $red, int $green, int $blue)int

Επιστρέφει το δείκτη του καθορισμένου χρώματος στην παλέτα της εικόνας. (περισσότερα)

colorExactAlpha(int $red, int $green, int $blue, int $alpha)int

Επιστρέφει το δείκτη του καθορισμένου χρώματος+άλφα στην παλέτα της εικόνας. (περισσότερα)

colorMatch(Image $image2)void

Κάνει τα χρώματα της έκδοσης παλέτας μιας εικόνας να ταιριάζουν περισσότερο με την έκδοση πραγματικών χρωμάτων. (περισσότερα)

colorResolve(int $red, int $green, int $blue)int

Επιστρέφει έναν δείκτη χρώματος για ένα ζητούμενο χρώμα, είτε το ακριβές χρώμα είτε την πλησιέστερη δυνατή εναλλακτική λύση. (περισσότερα)

colorResolveAlpha(int $red, int $green, int $blue, int $alpha)int

Επιστρέφει έναν δείκτη χρώματος για ένα ζητούμενο χρώμα, είτε το ακριβές χρώμα είτε την πλησιέστερη δυνατή εναλλακτική λύση. (περισσότερα)

colorSet(int $index, int $red, int $green, int $blue)void

Αυτό θέτει τον καθορισμένο δείκτη στην παλέτα στο καθορισμένο χρώμα. (περισσότερα)

colorsForIndex(int $index)array

Λαμβάνει το χρώμα για έναν καθορισμένο δείκτη. (περισσότερα)

colorsTotal(): int

Επιστρέφει τον αριθμό των χρωμάτων σε μια παλέτα εικόνας (more).

colorTransparent(?int $color=null)int

Λαμβάνει ή ορίζει το διαφανές χρώμα της εικόνας. (περισσότερα)

convolution(array $matrix, float $div, float $offset)void

Εφαρμόζει έναν πίνακα συνέλιξης στην εικόνα, χρησιμοποιώντας τον δεδομένο συντελεστή και τη μετατόπιση. (περισσότερα)

Απαιτεί Επέκταση GD, οπότε δεν είναι σίγουρο ότι θα λειτουργήσει παντού.

copy(Image $src, int $dstX, int $dstY, int $srcX, int $srcY, int $srcW, int $srcH)void

Αντιγράφει ένα τμήμα του $src στην εικόνα ξεκινώντας από τις συντεταγμένες $srcX, $srcY με πλάτος $srcW και ύψος $srcH. Το καθορισμένο τμήμα θα αντιγραφεί στις συντεταγμένες, $dstX και $dstY. (περισσότερα)

copyMerge(Image $src, int $dstX, int $dstY, int $srcX, int $srcY, int $srcW, int $srcH, int $opacity)void

Αντιγράφει ένα τμήμα του $src στην εικόνα ξεκινώντας από τις συντεταγμένες $srcX, $srcY με πλάτος $srcW και ύψος $srcH. Το καθορισμένο τμήμα θα αντιγραφεί στις συντεταγμένες, $dstX και $dstY. (περισσότερα)

copyMergeGray(Image $src, int $dstX, int $dstY, int $srcX, int $srcY, int $srcW, int $srcH, int $opacity)void

Αντιγράφει ένα τμήμα του $src στην εικόνα ξεκινώντας από τις συντεταγμένες $srcX, $srcY με πλάτος $srcW και ύψος $srcH. Το καθορισμένο τμήμα θα αντιγραφεί στις συντεταγμένες, $dstX και $dstY.

Αυτή η λειτουργία είναι πανομοιότυπη με τη λειτουργία copyMerge(), με τη διαφορά ότι κατά τη συγχώνευση διατηρεί την απόχρωση της πηγής μετατρέποντας τα εικονοστοιχεία προορισμού σε κλίμακα του γκρι πριν από τη λειτουργία αντιγραφής. (περισσότερα)

copyResampled(Image $src, int $dstX, int $dstY, int $srcX, int $srcY, int $dstW, int $dstH, int $srcW, int $srcH)void

Αντιγράφει ένα ορθογώνιο τμήμα μιας εικόνας σε μια άλλη εικόνα, παρεμβάλλοντας ομαλά τις τιμές των εικονοστοιχείων, έτσι ώστε, ειδικότερα, κατά τη μείωση του μεγέθους μιας εικόνας να διατηρείται μεγάλη ευκρίνεια.

Με άλλα λόγια, το copyResampled() θα πάρει μια ορθογώνια περιοχή από το $src πλάτους $srcW και ύψους $srcH στη θέση ($srcX,$srcY) και θα την τοποθετήσει σε μια ορθογώνια περιοχή της εικόνας πλάτους $dstW και ύψους $dstH στη θέση ($dstX,$dstY).

Εάν οι συντεταγμένες πηγής και προορισμού και τα πλάτη και ύψη διαφέρουν, θα πραγματοποιηθεί η κατάλληλη επιμήκυνση ή συρρίκνωση του τμήματος εικόνας. Οι συντεταγμένες αναφέρονται στην επάνω αριστερή γωνία. Αυτή η λειτουργία μπορεί να χρησιμοποιηθεί για την αντιγραφή περιοχών εντός της ίδιας εικόνας, αλλά αν οι περιοχές επικαλύπτονται, τα αποτελέσματα θα είναι απρόβλεπτα. (περισσότερα)

copyResized(Image $src, int $dstX, int $dstY, int $srcX, int $srcY, int $dstW, int $dstH, int $srcW, int $srcH)void

Αντιγράφει ένα ορθογώνιο τμήμα μιας εικόνας σε μια άλλη εικόνα. Με άλλα λόγια, το copyResized() θα πάρει μια ορθογώνια περιοχή από το $src πλάτους $srcW και ύψους $srcH στη θέση ($srcX,$srcY) και θα την τοποθετήσει σε μια ορθογώνια περιοχή της εικόνας πλάτους $dstW και ύψους $dstH στη θέση ($dstX,$dstY).

Εάν οι συντεταγμένες πηγής και προορισμού και τα πλάτη και ύψη διαφέρουν, θα πραγματοποιηθεί η κατάλληλη επιμήκυνση ή συρρίκνωση του τμήματος εικόνας. Οι συντεταγμένες αναφέρονται στην επάνω αριστερή γωνία. Αυτή η λειτουργία μπορεί να χρησιμοποιηθεί για την αντιγραφή περιοχών εντός της ίδιας εικόνας, αλλά αν οι περιοχές επικαλύπτονται, τα αποτελέσματα θα είναι απρόβλεπτα. (περισσότερα)

crop(int|string $left, int|string $top, int|string $width, int|string $height)Image

Περικόπτει μια εικόνα στη δεδομένη ορθογώνια περιοχή. Οι διαστάσεις μπορούν να μεταβιβαστούν ως ακέραιοι αριθμοί σε pixels ή συμβολοσειρές σε ποσοστό (π.χ. '50%').

cropAuto(int $mode=-1, float $threshold=.5, ?ImageColor $color=null)Image

Αυτόματη περικοπή μιας εικόνας σύμφωνα με το δεδομένο $mode. (περισσότερα)

ellipse(int $centerX, int $centerY, int $width, int $height, ImageColor $color)void

Σχεδιάζει μια έλλειψη με κέντρο τις καθορισμένες συντεταγμένες. (περισσότερα)

fill(int $x, int $y, ImageColor $color)void

Εκτελεί ένα γέμισμα πλημμύρας με αφετηρία τη δεδομένη συντεταγμένη (πάνω αριστερά είναι 0, 0) με το δεδομένο $color στην εικόνα. (περισσότερα)

filledArc(int $centerX, int $centerY, int $width, int $height, int $startAngle, int $endAngle, ImageColor $color, int $style)void

Σχεδιάζει ένα μερικό τόξο με κέντρο την καθορισμένη συντεταγμένη στην εικόνα. (περισσότερα)

filledEllipse(int $centerX, int $centerY, int $width, int $height, ImageColor $color)void

Σχεδιάζει μια έλλειψη με κέντρο την καθορισμένη συντεταγμένη στην εικόνα. (περισσότερα)

filledPolygon(array $points, ImageColor $color)void

Δημιουργεί ένα γεμάτο πολύγωνο στην εικόνα $image. (περισσότερα)

filledRectangle(int $x1, int $y1, int $x2, int $y2, ImageColor $color)void

Δημιουργεί ένα ορθογώνιο γεμάτο με $color στην εικόνα που ξεκινά από τα σημεία $x1 & $y1 και καταλήγει στα σημεία $x2 & $y2. Το σημείο 0, 0 είναι η επάνω αριστερή γωνία της εικόνας. (περισσότερα)

filledRectangleWH(int $left, int $top, int $width, int $height, ImageColor $color)void

Δημιουργεί ένα ορθογώνιο γεμάτο με $color στην εικόνα ξεκινώντας από τα σημεία $left & $top με πλάτος $width και ύψος $height. Το σημείο 0, 0 είναι η επάνω αριστερή γωνία της εικόνας.

fillToBorder(int $x, int $y, int $border, ImageColor $color)void

Εκτελεί ένα γέμισμα πλημμύρας του οποίου το χρώμα των ορίων ορίζεται από το $border. Το σημείο εκκίνησης για το γέμισμα είναι $x, $y (πάνω αριστερά είναι 0, 0) και η περιοχή γεμίζεται με το χρώμα $color. (περισσότερα)

filter(int $filtertype, int …$args)void

Εφαρμόζει το συγκεκριμένο φίλτρο $filtertype στην εικόνα. (περισσότερα)

flip(int $mode): void

Αναποδογυρίζει την εικόνα χρησιμοποιώντας το δεδομένο $mode. (περισσότερα)

ftText(float $size, float $angle, int $x, int $y, ImageColor $color, string $fontFile, string $text, array $options=[])array

Γράψτε το κείμενο στην εικόνα. (περισσότερα)

gammaCorrect(float $inputgamma, float $outputgamma)void

Εφαρμόζει διόρθωση γάμμα στην εικόνα με δεδομένο ένα γάμμα εισόδου και ένα γάμμα εξόδου. (περισσότερα)

getClip(): array

Ανακτά το τρέχον ορθογώνιο αποκοπής, δηλαδή την περιοχή πέρα από την οποία δεν θα σχεδιαστεί κανένα εικονοστοιχείο. (περισσότερα)

getHeight(): int

Επιστρέφει το ύψος της εικόνας.

getImageResource(): resource|GdImage

Επιστρέφει τον αρχικό πόρο.

getWidth(): int

Επιστρέφει το πλάτος της εικόνας.

interlace(?int $interlace=null)int

Ενεργοποιεί ή απενεργοποιεί το bit interlace. Εάν το bit interlace είναι ρυθμισμένο και η εικόνα χρησιμοποιείται ως εικόνα JPEG, η εικόνα δημιουργείται ως προοδευτικό JPEG. (περισσότερα)

isTrueColor(): bool

Βρίσκει αν η εικόνα είναι truecolor. (περισσότερα)

layerEffect(int $effect)void

Ορίστε τη σημαία ανάμειξης άλφα για να χρησιμοποιήσετε εφέ διαστρωμάτωσης. (περισσότερα)

line(int $x1, int $y1, int $x2, int $y2, ImageColor $color)void

Σχεδιάζει μια γραμμή μεταξύ των δύο δοσμένων σημείων. (περισσότερα)

openPolygon(array $points, ImageColor $color)void

Σχεδιάζει ένα ανοιχτό πολύγωνο στην εικόνα. Σε αντίθεση με το polygon(), δεν χαράσσεται γραμμή μεταξύ του τελευταίου και του πρώτου σημείου. (περισσότερα)

paletteCopy(Image $source)void

Αντιγράφει την παλέτα από το $source στην εικόνα. (περισσότερα)

paletteToTrueColor(): void

Μετατρέπει μια εικόνα βασισμένη σε παλέτα, που δημιουργείται από συναρτήσεις όπως η create() σε μια εικόνα πραγματικού χρώματος, όπως η createtruecolor(). (περισσότερα)

place(Image $image, int|string $left=0, int|string $top=0, int $opacity=100)Image

Αντιγράφει το $image στην εικόνα στις συντεταγμένες $left και $top. Οι συντεταγμένες μπορούν να μεταβιβαστούν ως ακέραιοι αριθμοί σε pixels ή συμβολοσειρές σε ποσοστό (π.χ. '50%').

polygon(array $points, ImageColor $color)void

Δημιουργεί ένα πολύγωνο στην εικόνα. (περισσότερα)

rectangle(int $x1, int $y1, int $x2, int $y2, ImageColor $color)void

Δημιουργεί ένα ορθογώνιο που ξεκινά από τις καθορισμένες συντεταγμένες. (περισσότερα)

rectangleWH(int $left, int $top, int $width, int $height, ImageColor $color)void

Δημιουργεί ένα ορθογώνιο στις δεδομένες συντεταγμένες.

resize(int|string $width, int|string $height, int $flags=Image::OrSmaller)Image

Κλιμακώνει μια εικόνα, δείτε περισσότερες πληροφορίες. Οι διαστάσεις μπορούν να μεταβιβαστούν ως ακέραιοι αριθμοί σε pixels ή συμβολοσειρές σε ποσοστό (π.χ. '50%').

resolution(?int $resX=null, ?int $resY=null)mixed

Επιτρέπει τον ορισμό και τη λήψη της ανάλυσης μιας εικόνας σε DPI (κουκκίδες ανά ίντσα). Εάν δεν δοθεί καμία από τις προαιρετικές παραμέτρους, η τρέχουσα ανάλυση επιστρέφεται ως πίνακας με ευρετήριο. Αν δοθεί μόνο η τιμή $resX, η οριζόντια και η κάθετη ανάλυση καθορίζονται σε αυτή την τιμή. Εάν δίνονται και οι δύο προαιρετικές παράμετροι, η οριζόντια και η κατακόρυφη ανάλυση τίθενται σε αυτές τις τιμές, αντίστοιχα.

Η ανάλυση χρησιμοποιείται μόνο ως μεταπληροφορία όταν οι εικόνες διαβάζονται και εγγράφονται σε μορφές που υποστηρίζουν τέτοιου είδους πληροφορίες (επί του παρόντος PNG και JPEG). Δεν επηρεάζει καμία λειτουργία σχεδίασης. Η προεπιλεγμένη ανάλυση για νέες εικόνες είναι 96 DPI. (περισσότερα)

rotate(float $angle, int $backgroundColor)Image

Περιστρέφει την εικόνα χρησιμοποιώντας το δεδομένο $angle σε μοίρες. Το κέντρο περιστροφής είναι το κέντρο της εικόνας και η περιστρεφόμενη εικόνα μπορεί να έχει διαφορετικές διαστάσεις από την αρχική εικόνα. (περισσότερα)

Απαιτεί Επέκταση GD, οπότε δεν είναι σίγουρο ότι θα λειτουργήσει παντού.

save(string $file, ?int $quality=null, ?int $type=null)void

Αποθηκεύει μια εικόνα σε ένα αρχείο.

Η ποιότητα συμπίεσης κυμαίνεται στο εύρος 0..100 για τα JPEG (προεπιλογή 85), WEBP (προεπιλογή 80) και AVIF (προεπιλογή 30) και 0..9 για το PNG (προεπιλογή 9). Εάν ο τύπος δεν είναι προφανής από την επέκταση του αρχείου, μπορείτε να τον καθορίσετε χρησιμοποιώντας μία από τις σταθερές ImageType.

saveAlpha(bool $saveflag)void

Ορίζει τη σημαία που καθορίζει αν θα διατηρούνται οι πλήρεις πληροφορίες του καναλιού άλφα (σε αντίθεση με τη διαφάνεια ενός χρώματος) κατά την αποθήκευση εικόνων PNG.

Το Alphablending πρέπει να είναι απενεργοποιημένο (alphaBlending(false)) για να διατηρηθεί το κανάλι άλφα εξαρχής. (περισσότερα)

scale(int $newWidth, int $newHeight=-1, int $mode=IMG_BILINEAR_FIXED)Image

Κλιμακώνει μια εικόνα χρησιμοποιώντας τον δεδομένο αλγόριθμο παρεμβολής. (περισσότερα)

send(int $type=ImageType::JPEG, ?int $quality=null)void

Εκδίδει μια εικόνα στο πρόγραμμα περιήγησης.

Η ποιότητα συμπίεσης κυμαίνεται στο εύρος 0..100 για τα JPEG (προεπιλογή 85), WEBP (προεπιλογή 80) και AVIF (προεπιλογή 30) και 0..9 για το PNG (προεπιλογή 9).

setBrush(Image $brush)void

Ορίζει την εικόνα πινέλου που θα χρησιμοποιείται από όλες τις λειτουργίες σχεδίασης γραμμών (όπως οι line() και polygon()) όταν σχεδιάζεται με τα ειδικά χρώματα IMG_COLOR_BRUSHED ή IMG_COLOR_STYLEDBRUSHED. (περισσότερα)

setClip(int $x1, int $y1, int $x2, int $y2)void

Ορίζει το τρέχον ορθογώνιο αποκοπής, δηλαδή την περιοχή πέρα από την οποία δεν θα σχεδιάζονται εικονοστοιχεία. (περισσότερα)

setInterpolation(int $method=IMG_BILINEAR_FIXED)void

Ορίζει τη μέθοδο παρεμβολής, η οποία επηρεάζει τις μεθόδους rotate() και affine(). (περισσότερα)

setPixel(int $x, int $y, ImageColor $color)void

Σχεδιάζει ένα εικονοστοιχείο στην καθορισμένη συντεταγμένη. (περισσότερα)

setStyle(array $style)void

Ορίζει το στυλ που θα χρησιμοποιείται από όλες τις λειτουργίες σχεδίασης γραμμών (όπως οι line() και polygon()) όταν σχεδιάζονται με το ειδικό χρώμα IMG_COLOR_STYLED ή γραμμές εικόνων με χρώμα IMG_COLOR_STYLEDBRUSHED. (περισσότερα)

setThickness(int $thickness)void

Ορίζει το πάχος των γραμμών που σχεδιάζονται κατά τη σχεδίαση ορθογωνίων, πολυγώνων, τόξων κ.λπ. σε $thickness pixels. (περισσότερα)

setTile(Image $tile)void

Καθορίζει την εικόνα πλακιδίων που θα χρησιμοποιείται από όλες τις λειτουργίες πλήρωσης περιοχών (όπως οι fill() και filledPolygon()) κατά τη συμπλήρωση με το ειδικό χρώμα IMG_COLOR_TILED.

Το πλακίδιο είναι μια εικόνα που χρησιμοποιείται για να γεμίσει μια περιοχή με ένα επαναλαμβανόμενο μοτίβο. Οποιαδήποτε εικόνα μπορεί να χρησιμοποιηθεί ως πλακίδιο, και με τον καθορισμό του δείκτη διαφανούς χρώματος της εικόνας του πλακιδίου με το colorTransparent(), μπορεί να δημιουργηθεί ένα πλακίδιο που επιτρέπει σε ορισμένα τμήματα της υποκείμενης περιοχής να διαφαίνονται. (περισσότερα)

sharpen(): Image

Οξύνει λίγο την εικόνα.

Απαιτεί Επέκταση GD Bundled, οπότε δεν είναι σίγουρο ότι θα λειτουργήσει παντού.

toString(int $type=ImageType::JPEG, ?int $quality=null)string

Εξάγει μια εικόνα σε συμβολοσειρά.

Η ποιότητα συμπίεσης κυμαίνεται στο εύρος 0..100 για τα JPEG (προεπιλογή 85), WEBP (προεπιλογή 80) και AVIF (προεπιλογή 30) και 0..9 για το PNG (προεπιλογή 9).

trueColorToPalette(bool $dither, int $ncolors)void

Μετατρέπει μια εικόνα πραγματικού χρώματος σε εικόνα παλέτας. (περισσότερα)

ttfText(float $size, float $angle, int $x, int $y, ImageColor $color, string $fontFile, string $text, array $options=[])array

Γράφει το δεδομένο κείμενο στην εικόνα. (περισσότερα)