(PHP 3, PHP 4, PHP 5)
imagettftext -- Γράψτε κείμενο στην εικόνα χρησιμοποιώτας TrueType γραμματοσειρά
Η συνάρτηση imagettftext() σχεδιάζει το string
text
στην εικόνα
image
, ξεκινώντας από το σημείο με συντεταγμένες
x
, y
(πάνω αριστερά είναι το σημείο 0, 0), με
γωνία angle
, χρησιμοποιώντας το χρώμα
color
, και την TrueType γραμματοσειρά
fontfile
. Εξαρτάται από την έκδοση της GD βιβλιοθήκης
που χρησιμοποιεί η PHP, το ότι αν η παράμετρος fontfile
δεν
ξεκινάει με μία '/', το '.ttf' θα προστεθεί στο όνομα του αρχείου και η βιβλιοθήκη θα
προσπαθήσει να να ψάξει αυτό το αρχείο σε ένα καθορισμένο από τη βιβλιοθήκη font path.
Οι συντεταγμένες που δίνονται από τις x
,
y
προσδιορίζει το αρχικό σημείο του πρώτου χαρακτήρα (προσεγγιστικά η κάτω αριστερή γωνία του χαρακτήρα). Οι παράμετροι αυτοί διαφέρουν από αυτές της συνάρτησης imagestring(), όπου οι x,
y προσδιορίζουν την πάνε δεξιά γωνία του πρώτου χαρακτήρα.
Η παράμετρος angle
δίνεται σε μοίρες, με τις 0 να αναπαριστούν το διάβασμα από αριστερά προς τα δεξιά (3 o'clock κατεύθυνση), και τις υψηλότερες τιμές να αναπαριστούν
την αντίθετη με την αριστερόστροφη περιστροφή. (π.χ., μία τιμή
90 μοιρών θα είχε ως αποτελέσμα το από κάτω προς τα πάνω διάβασμα του κειμένου).
Η παράμετρος fontfile
είναι το path της TrueType γραμματοσειράς
που επιθυμείτε να χρησιμοποιείσετε.
Η παράμετρος text
είναι το text string που μπορεί να περιλαμβάνει
UTF-8 ακολουθίες χαρακτήρων (του τύπου: {) για να προσπελάσετε χαρακτήρες
μίας γραμματοσειράς μετά τους πρώτους 255.
Η παράμετρος color
είναι ο δείκτης χρώματος. Η χρήση του αρνητικού δείκτη ενός χρώματος έχει ως αποτέλεσμα να απενεργοποιείται το antialiasing.
Η παράμετρος imagettftext() επιστρέφει ένα array με 8 στοιχεία, που αναπαριστούν τα τέσσερα σημεία που υλοποιούν το bounding box του κειένου. Η σειρά των σημείων είναι: κάτω αριστερά, κάτω δεξιά, πάνω δεξιά, κάτω αριστερά. Τα σημεία είναι σχετικά με το κείμενο και άσχετα με την angle, έτσι το "πάνω αριστερά" σημαίνει την πάνω αριστερή γωνία όπως βλέπετε το κείμενο οριζόντια.
Το ακόλουθο script θα παράξει ένα μαύρου χρώματος GIF 400x30 pixels, με το κείμενο "Testing..." σε άσπρο χρώμα και με γραμματοσειρά Arial.
Η συνάρτηση αυτή χρειάζεται την GD και την FreeType βιβλιοθήκη.
Ανατρέξτε επίσης στην imagettfbbox().