Görüntü İşleme ve GD

Giriş

PHP sadece HTML çıktı oluşturmaz. Ayrıca, GIF, PNG, JPEG, WBMP ve XPM dahil çeşitli görüntü biçemlerinde dosyalar oluşturabilir veya bunlar üzerinde değişiklik yapabilir. Dahası, PHP görüntü akımlarını doğrudan tarayıcıya gönderebilir. Bunun için PHP'nin GD kütüphanesi ile derlenmesi gerekir. Kullanılacak görüntü biçemlerine bağlı olarak başka PHP ve GD kütüphaneleri de gerektirebilir.

PHP'deki görüntü işlevleri, JPEG, GIF, PNG, SWF, TIFF ve JPEG2000 görüntülerinin boyutlarını öğrenmek için kullanılabilir.

Exif eklentesi ile JPEG ve TIFF görüntü başlıklarındaki bilgiler üzerinde çalışmak ve böylece sayısal kameralar tarafından üretilmiş temel verileri okumak mümkündür. Exif işlevleri GD kütüphanesine ihtiyaç duymaz.

Bilginize: Görüntüleri okumak, değiştirmek ve yazmak için kütüphanenin yeteneklerinin nasıl geliştirileceğini öğrenmek için gereksinimler sayfasına bakılabilir. Sayısal kameralardan aldığınız görüntülerin temel verilerini okumak için exif eklentisi gerekir.

Bilginize: getimagesize() işlevi GD eklentisini gerektirmez.

Dikkat

GD kütüphanesinin PHP paketinde gelen sürümü, sistem sürümlerinin aksine bellek ayırmak için Zend bellek yöneticisini kullanır. Bu bakımdan memory_limit uygulanmaz.

GD çeşitli biçemleri destekler. Aşağıda GD'nin desteklediği biçemler sıralanmıştır. Oku/yaz desteğinin yanında Bilgi sütununda kullanılabilirlik bilgilerine de yer verilmiştir.

**GD'nin desteklediği biçemler**
Biçem	Okuma desteği	Yazma desteği	Bilgi
JPEG	var	var
PNG	var	var
GIF	var	var
XBM	var	var
XPM	var	yok
WBMP	var	var
WebP	var	var
BMP	var	var	PHP 7.2.0 itibariyle kullanılabilir.

Yukarıdaki tabloda hem okuma hem de yazma için birçok biçem bulunması PHP'nin bunlar için destekle derlendiği anlamına gelmez. Derleme sırasında GD için hangi biçemlerin mevcut olduğunu bulmak için gd_info() işlevi kullanılabilir. Biçemlerin derleme desteği hakkında daha fazla bilgi için kurulum bölümüne bakılabilir.

Yapılandırma/Kurulum
Öntanımlı Sabitler
Örnekler
GD ve Görüntü İşlevleri
- gd_info — Kurulu GD kütüphanesi hakkında bilgi verir
- getimagesize — Bir görüntünün boyutlarını döndürür
- getimagesizefromstring — Dizgedeki görüntünün boyutunu döndürür
- image_type_to_extension — Resim türü ile ilgili dosya uzantısını döndürür
- image_type_to_mime_type — getimagesize, exif_read_data, exif_thumbnail, exif_imagetype ile döndürülen resim türü ile ilgili MIME türünü döndürür
- image2wbmp — Görüntüyü tarayıcıya veya dosyaya yazar.
- imageaffine — İsteğe bağlı bir kırpma alanı kullanarak, belirtilen görüntüye ilgin dönüşümü uygulayıp sonucu döndürür
- imageaffinematrixconcat — İki ilgin dönüşüm matrisini birleştirir
- imageaffinematrixget — İlgin dönüşüm matrisini döndürür
- imagealphablending — Bir görüntü için harmanlama kipini etkinleştirir
- imageantialias — Kenar yumuşatma işlevlerini uygulatır
- imagearc — Bir yay çizer
- imageavif — Görüntüyü tarayıcıya veya dosyaya yazar.
- imagebmp — BMP görüntüyü tarayıcıya veya dosyaya çıktılar
- imagechar — Yatay olarak bir karakter çizer
- imagecharup — Düşey olarak bir karakter çizer
- imagecolorallocate — Bir görüntü için bir renk ayırır
- imagecolorallocatealpha — Bir görüntü için alfa kanallı bir renk ayırır
- imagecolorat — Bir pikselin renk indisini döndürür
- imagecolorclosest — Belirtilen rengin en yakın benzerinin indisini döndürür
- imagecolorclosestalpha — Alfası ile birlikte belirtilen rengin en yakın benzerinin renk indisini verir
- imagecolorclosesthwb — En yakın renk sıcaklığına, beyaz ve siyahlığa sahip renk indisini verir
- imagecolordeallocate — Bir rengi tanımsız yapar
- imagecolorexact — Belirtilen rengin indisini döndürür
- imagecolorexactalpha — Alfası ile birlikte belirtilen rengin indisini verir
- imagecolormatch — Bir görüntünün paletli sürümünün renklerini gerçek renkli sürümünün renkleriyle aynı yapar
- imagecolorresolve — Belirtilen rengin veya en yakın benzerinin indisini döndürür
- imagecolorresolvealpha — Alfası ile birlikte belirtilen rengin veya en yakın benzerinin renk indisini verir
- imagecolorset — Bir palet indisi için renk tanımlar
- imagecolorsforindex — Bir renk indisinin renk bilgisini döndürür
- imagecolorstotal — Bir görüntü paletindeki renk sayısını döndürür
- imagecolortransparent — Bir rengi şeffaflaştırır
- imageconvolution — Bir konum ve katsayı ile 3x3'lük bir evrişim matrisini uygular
- imagecopy — Bir resim parçasını kopyalar
- imagecopymerge — Bir görüntüyü kopyalar ve karıştırır
- imagecopymergegray — Bir görüntüyü kopyalar ve gri tonlama ile karıştırır
- imagecopyresampled — Görüntünün bir parçasını örnekleyerek kopyalar ve boyutlandırır
- imagecopyresized — Görüntünün bir parçasını kopyalar ve boyutlandırır
- imagecreate — Yeni bir paletli görüntü oluşturur
- imagecreatefromavif — Bir dosya veya URL'den yeni bir görüntü oluşturur.
- imagecreatefrombmp — Bir dosya veya URL'den yeni bir görüntü oluşturur.
- imagecreatefromgd — Bir GD dosyasından veya URL'sinden yeni bir görüntü oluşturur
- imagecreatefromgd2 — Bir GD2 dosyasından veya URL'sinden yeni bir görüntü oluşturur
- imagecreatefromgd2part — Bir GD2 parça dosyasından veya URL'sinden yeni bir görüntü oluşturur
- imagecreatefromgif — Bir dosya veya URL'den yeni bir görüntü oluşturur.
- imagecreatefromjpeg — Bir dosya veya URL'den yeni bir görüntü oluşturur.
- imagecreatefrompng — Bir dosya veya URL'den yeni bir görüntü oluşturur.
- imagecreatefromstring — Belirtilen dizgeden yeni bir görüntü oluşturur
- imagecreatefromtga — Bir dosya veya URL'den yeni bir görüntü oluşturur.
- imagecreatefromwbmp — Bir dosya veya URL'den yeni bir görüntü oluşturur.
- imagecreatefromwebp — Bir dosya veya URL'den yeni bir görüntü oluşturur.
- imagecreatefromxbm — Bir dosya veya URL'den yeni bir görüntü oluşturur.
- imagecreatefromxpm — Bir dosya veya URL'den yeni bir görüntü oluşturur.
- imagecreatetruecolor — Yeni bir gerçek renkli görüntü oluşturur
- imagecrop — Görüntüyü belirtilen dikdörtgen ile kırpar
- imagecropauto — Mevcut kiplerden birini kullanarak görüntüyü otomatik olarak kırpar
- imagedashedline — Kesikli çizgi çizer
- imagedestroy — Bir görüntüyü bellekten siler
- imageellipse — Bir elips çizer
- imagefill — Görüntüyü boyar
- imagefilledarc — Bir yay çizer ve içini doldurur
- imagefilledellipse — İçi dolu bir elips çizer
- imagefilledpolygon — İçi dolu bir çokgen çizer
- imagefilledrectangle — İçi dolu bir dikdörtgen çizer
- imagefilltoborder — Belli bir bölgeyi belli bir renge boyar
- imagefilter — Bir görüntüye bir süzgeç uygular
- imageflip — Belirtilen kipi kullanarak görüntüyü ters çevirir
- imagefontheight — Yazı tipi piksel yüksekliğini döndürür
- imagefontwidth — Yazı tipi piksel genişliğini döndürür
- imageftbbox — Bir FreeType2 yazı tipi ile yazılacak bir metnin çerçevesini hesaplar
- imagefttext — Bir metni bir görüntüye bir FreeType 2 yazı tipini kullanarak yazar
- imagegammacorrect — Bir GD görüntüye gamma düzeltmesi uygular
- imagegd — Tarayıcıya veya bir dosyaya bir GD görüntü çıktılar
- imagegd2 — Tarayıcıya veya bir dosyaya bir GD2 görüntü çıktılar
- imagegetclip — Kırpma dikdörtgenini döndürür
- imagegetinterpolation — Ara değerleme yöntemini döndürür
- imagegif — Görüntüyü tarayıcıya veya dosyaya yazar.
- imagegrabscreen — Ekran görüntüsünü yakalar
- imagegrabwindow — Bir pencereyi yakalar
- imageinterlace — Geçişimliliği açıp kapar
- imageistruecolor — Bir görüntünün gerçek renkli olup olmadığını bulur
- imagejpeg — Görüntüyü tarayıcıya veya dosyaya yazar.
- imagelayereffect — Katmanlama etkisini kullanmak için alfa harmanlama seçeneğini ayarlar
- imageline — Bir çizgi çizer
- imageloadfont — Yeni bir bit eşlemli yazı tipi yükler
- imageopenpolygon — Açık çokgen çizer
- imagepalettecopy — Paleti bir görüntüden diğerine kopyalar
- imagepalettetotruecolor — Palet tabanlı bir görüntüyü gerçek renge dönüştürür
- imagepng — Tarayıcıya veya bir dosyaya bir PNG görüntü çıktılar
- imagepolygon — Çokgen çizer
- imagerectangle — Bir dikdörtgen çizer
- imageresolution — Görüntünün çözünürlüğünü tanımlar veya döndürür
- imagerotate — Bir görüntüyü belirtilen açıya göre döndürür
- imagesavealpha — Görüntüleri kaydederken alfa kanalı bilgisinin saklanıp saklanmayacağını belirtir
- imagescale — Görüntüyü belirtilen genişlik ve yüksekliği kullanarak oranlar
- imagesetbrush — Çizgi çizmek için fırça görüntüsü oluşturur
- imagesetclip — Kırpma dikdörtgenini tanımlar
- imagesetinterpolation — Ara değerleme yöntemini tanımlar
- imagesetpixel — Bir pikselin rengini değiştirir
- imagesetstyle — Çizgi tarzını ayarlar
- imagesetthickness — Çizgi kalınlığını ayarlar
- imagesettile — Görüntüyü doldurmak için döşemeyi etkin kılar
- imagestring — Bir dizgeyi yatay olarak yazar
- imagestringup — Bir dizgeyi 90 derece döndürülmüş olarak yazar
- imagesx — Görüntünün genişliğini döndürür
- imagesy — Görüntünün yüksekliğini döndürür
- imagetruecolortopalette — Gerçek renkli görüntüyü paletli görüntüye dönüştürür
- imagettfbbox — TrueType yazıtipi kullanılan bir metnin çerçevesini döndürür
- imagettftext — Metni görüntüye TrueType yazı tipi ile yazar
- imagetypes — Kurulu PHP'nin desteklediği görüntü türlerini döndürür
- imagewbmp — Görüntüyü tarayıcıya veya dosyaya yazar.
- imagewebp — WebP görüntüyü tarayıcıya veya dosyaya çıktılar
- imagexbm — Bir XBM görüntüyü tarayıcıya veya dosyaya çıktılar
- iptcembed — İkil IPTC verisini bir JPEG görüntünün içine gömer
- iptcparse — Bir ikil IPTC bloğunu tekil etiketlere böler
- jpeg2wbmp — Bir JPEG dosyasını WBMP dosyasına dönüştürür
- png2wbmp — Bir PNG dosyasını WBMP dosyasına dönüştürür
GdImage — GdImage sınıfı
GdFont — GdFont sınıfı

Found A Problem?

Learn How To Improve This Page • Submit a Pull Request • Report a Bug

＋add a note

User Contributed Notes 5 notes

down

kurdtpage at gmail dot com ¶

14 years ago

When using GD, please make sure of the following things:

1. The file that is used to manipulate images is saved as ANSI format and not UTF-8
2. There is no space in front of the opening tag <?php

down

mail at ecross dot nl ¶

15 years ago

hello there,
i made a function to create a gradient image.

description:
gradient(int image_width, int image_height, 
int start_red, int start_green, int start_blue, 
int end_red, int end_green, int end_blue, 
bool vertical)

function:
<?php
function gradient($image_width, $image_height,$c1_r, $c1_g, $c1_b, $c2_r, $c2_g, $c2_b, $vertical=false)
{
// first: lets type cast;
$image_width = (integer)$image_width;
$image_height = (integer)$image_height;
$c1_r = (integer)$c1_r;
$c1_g = (integer)$c1_g;
$c1_b = (integer)$c1_b;
$c2_r = (integer)$c2_r;
$c2_g = (integer)$c2_g;
$c2_b = (integer)$c2_b;
$vertical = (bool)$vertical;

// create a image
$image  = imagecreatetruecolor($image_width, $image_height); 

// make the gradient
for($i=0; $i<$image_height; $i++) 
{ 
$color_r = floor($i * ($c2_r-$c1_r) / $image_height)+$c1_r;
$color_g = floor($i * ($c2_g-$c1_g) / $image_height)+$c1_g;
$color_b = floor($i * ($c2_b-$c1_b) / $image_height)+$c1_b;

$color = ImageColorAllocate($image, $color_r, $color_g, $color_b);
imageline($image, 0, $i, $image_width, $i, $color);
} 

# Prints out all the figures and picture and frees memory 
header('Content-type: image/png'); 

if($vertical){$image = imagerotate($image, 90, 0);}
ImagePNG($image); 
imagedestroy($image); 
}
?>

down

Thomas ¶

17 years ago

You know, maybe this goes without saying, but I thought I would drop a note in here.  When developing code to resize images, it is best not to use GD.  When using the current GD methodologies, you are reading content from an image and manipulating it.  By then writing that content to a brand new file, you are losing the EXIF data.

For purposes when you want to retain EXIF data, it is recommended that you compile in and use the PECL Imagick extension.  It has great resizing methods built right in and the EXIF data is retained.

down

code at ashleyhunt dot co dot uk ¶

17 years ago

I have been looking to send the output from GD to a text string without proxying via a file or to a browser.

I have come up with a solution.

This code buffers the output between the ob_start() and ob_end() functions into ob_get_contents()

See the example below

<?php
// Create a test source image for this example
$im = imagecreatetruecolor(300, 50);
$text_color = imagecolorallocate($im, 233, 14, 91);
imagestring($im, 1, 5, 5,  'A Simple Text String', $text_color);

// start buffering
ob_start();
// output jpeg (or any other chosen) format & quality
imagejpeg($im, NULL, 85);
// capture output to string
$contents = ob_get_contents();
// end capture
ob_end_clean();

// be tidy; free up memory
imagedestroy($im);

// lastly (for the example) we are writing the string to a file
$fh = fopen("./temp/img.jpg", "a+" );
    fwrite( $fh, $contents );
fclose( $fh );
?> 

Enjoy!
Ashley

down

-1

herbert dot walde at googlemail dot com ¶

14 years ago

In case your script is using output-buffering-functions somewhere, then you have to clear the buffer first ( with ob_clear() ), before outputting an image with a function like imagepng(). 

And you should make sure that no buffer will get send after outputing an image by using the ob_end_flush()-function.

Furthermore you should check if a buffer has already been flushed somewhere before. This can be done using the headers_sent()-function.

Here is the full solution:

<?php
if(headers_sent()){
    die('Headers have been send somewhere within my script');
}

ob_clean(); //Clears the buffer

header('Content-type: image/png');
imagepng($img, NULL, 0,  NULL);

ob_end_flush(); //Now we send the header and image plus we make sure that nothing will get send from now on (including possible shutdown-functions and __destruct()-methods) till the end of page-execution
?>

＋add a note