imagefttext

    (PHP 4 >= 4.0.7, PHP 5, PHP 7, PHP 8)

    imagefttext — Bir metni bir görüntüye bir FreeType 2 yazı tipini kullanarak yazar

    Açıklama

    imagefttext(
        GdImage$görüntü,
        float$boyut,
        float$açı,
        int$x,
        int$y,
        int$renk,
        string$yazıtipi,
        string$metin,
        array$seçenekler = []
    ): array|false

    Bilginize:

    PHP 8.0.0 öncesinde imagefttext() işlevi imagettftext() işlevinin geliştirilmişi olup ek olarak seçenekler bağımsız değişkenine sahipti. PHP 8.0.0 ve sonrasında imagettftext() işlevi imagefttext() işlevinin takma adıdır.

    Bağımsız Değişkenler

    görüntü

    imagecreatetruecolor() gibi bir görüntü oluşturma işlevinden dönen bir GdImage nesnesi.

    boyut

    Kullanılacak yazı tipinin punto olarak boyutu.

    açı

    Derece cinsinden açı. Soldan sağa yazılan bir metnin açısı 0 derecedir. Daha büyük değerler ters saat yönünde belirtilmiş varsayılır. Örneğin 90 derecelik bir metin aşağıdan yukarı doğru yazılır.

    x

    x ve y ile belirtilen koordinatlar ilk harfin taban noktasını (kabaca harfin sol alt köşesi) tanımlar. Bu tanımlama, koordinatların harfin sol üst köşesini tanımladığı imagestring() işlevinden farklıdır. Resmin sol üst köşesinin koordinatları 0, 0'dır.

    y

    x bağımsız değişkenine bakınız.

    renk

    Renk indisi. Negatif bir renk indisi kenar yumuşatmayı kapatır. imagecolorallocate() işlevine bakınız.

    yazıtipi

    Kullanılacak FreeType2 yazı tipi dosyasının yolu.

    PHP'nin kullandığı GD kütüphanesinin sürümüne bağlı olarak, / ile başlamayan bir FreeType2 dosya ismine .ttf uzantısı eklenir ve kütüphane bu dosya ismini kütüphanede tanımlı dizinlerde arar.

    Yazı tiplerinin betikle aynı dizinde bulunduğu durumlarda herhangi bir sorun çıkmaması için aşağıdaki çözüm kullanılabilir.

    <?php
    // GD ortam değişkenini tanımlayalım
    putenv('GDFONTPATH=' . realpath('.'));

    // Kullanılacak yazı tipinin ismi (dikkat: .ttf uzantısı yok)
    $font = 'freesans';
    ?>
    metin

    Resme yerleştirilecek metin.

    seçenekler

    seçenekler için olası dizi indisleri
    AnahtarTürüAnlamı
    linespacingfloatSatırlar arasındaki boşluğu tanımlar.

    Dönen Değerler

    Metin çerçevesinin dört köşesinin koordinatlarını içeren 8 elemanlı bir dizi ile döner:

    0Sol alt köşenin X konumu
    1Sol alt köşenin Y konumu
    2Sağ alt köşenin X konumu
    3Sağ alt köşenin Y konumu
    4Sağ üst köşenin X konumu
    5Sağ üst köşenin Y konumu
    6Sol üst köşenin X konumu
    7Sol üst köşenin Y konumu

    Başarısızlık durumunda, false döner.

    Sürüm Bilgisi

    Sürüm: Açıklama
    8.0.0görüntü bağımsız değişkeninde artık bir GdImage nesnesi aktarmak gerekiyor; evvelce resource türünde geçerli bir gd değeri gerekirdi.

    Örnekler

    Örnek 1 - imagefttext() örneği

    <?php
    // 300x100 bir tuval oluşturalım
    $im = imagecreatetruecolor(300, 100);
    $red = imagecolorallocate($im, 0xFF, 0x00, 0x00);
    $black = imagecolorallocate($im, 0x00, 0x00, 0x00);

    // Artalan rengi kırmızı olsun
    imagefilledrectangle($im, 0, 0, 299, 99, $red);

    // ttf dosyamızın yolu
    $font_file = './arial.ttf';

    // 'PHP Manual' metnini 13 puntoluk yazdıralım
    imagefttext($im, 13, 0, 105, 55, $black, $font_file, 'PHP Manual');

    // Görüntüyü tarayıcıya gönderelim
    header('Content-Type: image/png');

    imagepng($im);
    imagedestroy($im);
    ?>

    Notlar

    Bilginize: Bu işlev sadece, PHP, freetype desteği (--with-freetype-dir=DİZİN seçeneği) ile derlenmişse kullanılabilir.

    Ayrıca Bakınız

    • imageftbbox() - Bir FreeType2 yazı tipi ile yazılacak bir metnin çerçevesini hesaplar
    • imagettftext() - Metni görüntüye TrueType yazı tipi ile yazar
    To Top