Справочник по PHP

         

Манипулирование изображениями


imageCreate

Создание пустой картинки.

Синтаксис :

int imageCreate(int x, int y)

Создает пустую картинку размером x на y точек и возвращает ее идентификатор. После того, как картинка создана, вся работа с ней осуществляется именно через этот идентификатор, по аналогии с тем, как мы работаем с файлом через его дескриптор.

Пример:

Создание новой картинки при помощи GD и вывод ее в экран браузера:

<?phpheader ("Content-type: image/png");$im = @imagecreate (50, 100)    or die ("Не удается открыть новую картинку!");$background_color = imagecolorallocate ($im, 255, 255, 255);$text_color = imagecolorallocate ($im, 233, 14, 91);imagestring ($im, 1, 5, 5,  "A Simple Text String", $text_color);imagepng ($im);?>

imageCreateFromPng

Создание рисунка из файла PNG.

Синтаксис :

int imageCreateFromPng(string filename)

Эта функция загружают изображения из файла PNG в память и возвращает его идентификатор. Как и после вызова imageCreate(), дальнейшая работа с картинкой возможна только через этот идентификатор. При загрузке с диска изображение распаковывается и храниться в память уже в неупакованном формате, для того чтобы можно было максимально быстро производить с ним различные операции, такие как масштабирование, рисование линий и т.д.

Пример:



Пример нахождения ошибки при открытии графического файла.

function LoadPNG ($imgname) {  $im = @imagecreatefrompng ($imgname); /* Attempt to open */  if (!$im) { /* See if it failed */    $im  = imagecreate (150, 30); /* Create a blank image */    $bgc = imagecolorallocate ($im, 255, 255, 255);    $tc  = imagecolorallocate ($im, 0, 0, 0);    imagefilledrectangle ($im, 0, 0, 150, 30, $bgc);    /* Output an errmsg */    imagestring ($im, 1, 5, 5, "Error loading $imgname", $tc);  }  return $im;}

imageCreateFromJpeg

Создание рисунка из файла JPEG.

Синтаксис :

int imageCreateFromJpeg(string filename)

Эта функция загружают изображения из файла в память и возвращают его идентификатор. Как и после вызова imageCreate(), дальнейшая работа с картинкой возможна только через этот идентификатор. При загрузке с диска изображение распаковывается и храниться в память уже в неупакованном формате, для того чтобы можно было максимально быстро производить с ним различные операции, такие как масштабирование, рисование линий и т.д.


imageCreateFromGif

Создание рисунка из файла GIF.

Синтаксис :

int imageCreateFromGif(string filename)

Эта функция загружают изображения из файла в память и возвращают его идентификатор. Как и после вызова imageCreate(), дальнейшая работа с картинкой возможна только через этот идентификатор. При загрузке с диска изображение распаковывается и храниться в память уже в неупакованном формате, для того чтобы можно было максимально быстро производить с ним различные операции, такие как масштабирование, рисование линий и т.д.

Стоит упомянуть, что GD начиная с версии 1.6 не поддерживает формат GIF. В связи с этим данная функция практически не используется.

imagePng

Функция выводит изображение в PNG-формате в любой браузер или в файл.

Синтаксис:

int imagePng(int im [, string filename])

Эта функция сохраняет изображение, заданное своим идентификатором и находящееся в памяти, на диск, или же выводят его в браузер.

Разумеется, вначале изображение должно быть загружено или создано при помощи функции imageCreate(), т.е. мы должны знать его идентификатор im.

Если аргумент filename

опущен, то сжатые данные в соответствующем формате выводятся прямо в стандартный выходной поток, т.е. в браузер. Нужный заголовок Content-type

при этом не выводится, ввиду чего нужно выводить его вручную при помощи Header().

Фактически, вы должны вызвать одну из трех команд, в зависимости от типа изображения:

Header("Content-type: image/png") для PNG.

Пример:

Пример использования функции imagepng():

<?php$im = imagecreatefrompng ("test.png");Header("Content-type: image/png")imagepng ($im);?>

imageJpeg

Отсылка рисунка JPEG браузеру или сохранение его в файле.

Синтаксис:

int imageJPEG(int im [, string filename [, int quality]])

Эта функция сохраняет изображение, заданное своим идентификатором и находящееся в памяти, на диск, или же выводит его в браузер.

Разумеется, вначале изображение должно быть загружено или создано при помощи функции imageCreate(), т.е. мы должны знать его идентификатор im.



Если аргумент filename

опущен, то сжатые данные в соответствующем формате выводятся прямо в стандартный выходной поток, т.е. в браузер. Нужный заголовок Content-type при этом не выводится, ввиду чего нужно выводить его вручную при помощи Header().

Фактически, вы должны вызвать одну из трех команд, в зависимости от типа изображения:

Header("Content-type: image/jpeg") для Jpeg

Третий необязательный параметр quality задает качество изображения (от 0 до 100).

<?php$im=imageCreateFromJPEG("img/file.jpg");Header("Content-type: image/jpeg");imageJPEG($im,"",30);?>

image2WBMP

Вывод изображения в браузер или файл.

Синтаксис :

int image2WBMP( resource image [, string filename [, int threshold]])

Функция выводит изображение, заданное дескриптором image, в браузер, либо в файл, имя которого задано необязательным параметром filename.

Если изображение выводится в браузер, необходимо задать его тип WBMP как image/vnd.wap.wbmp

функцией Header():

<?php$file = "php.png";$image = imagecreatefrompng($file); header("Content-type: " . image_type_to_mime_type(IMAGETYPE_WBMP));image2wbmp($image); // Вывод wbmp-картинки в браузер?>

Функция image2WBMP() доступна PHP только если версия библиотеки GD 1.8 или ниже.

imageGif

Отсылка рисунка GIF браузеру или сохранение его в файле.

Синтаксис:

int imageGIF(int im [, string filename])

Функция сохраняют изображение, заданное своим идентификатором и находящееся в памяти, на диск, или же выводят его в браузер.

Разумеется, вначале изображение должно быть загружено или создано при помощи функции imageCreate(), т.е. мы должны знать его идентификатор im.

Если аргумент filename

опущен, то сжатые данные в соответствующем формате выводятся прямо в стандартный выходной поток, т.е. в браузер. Нужный заголовок Content-type

при этом не выводится, ввиду чего нужно выводить его вручную при помощи Header().

Фактически, вы должны вызвать одну из трех команд, в зависимости от типа изображения:



Header("Content-type: image/gif").

Т.к. библиотека GD, начиная с версии 1.6, не поддерживает формат GIF, данная функция используется редко.

imageCopy

Копирование части рисунка.

Синтаксис :

int imageCopy(int dst_im, int src_im, int dst_x, int dst_y, int src_x, int src_y, int src_w, int src_h)

Функция копирует прямоугольную область начиная с позиции (src_x, src_y) шириной src_w

и высотой src_h из рисунка src_im в рисунок dst_im, придав копируемой области смещение (dst_x, dst_y).

В следующем примере будет картинка file1.png целиком скопирована в file2.png

<?php// Создаем первую картинку на основе готового изображения$im1=imageCreateFromPNG("img/file1.png");// Определяем ее размеры$size_x=imageSX($im1);$size_y=imageSY($im1);// Создаем вторую пустую картинку$im2=imageCreate($size_x,$size_y);// Копируем рисунок целиком из первого изображения во второеimageCopy($im2,$im1,0,0,0,0,$size_x,$size_y);// Сохранение скопированной картинки в файлеimagePNG($im2, "img/file2.png");?>

imageCopyResized

Копирование части рисунка с масштабированием.

Синтаксис :

int imageCopyResized(int dst_im, int src_im, int dstX, int dstY, int srcX, int srcY, int dstW, int dstH, int srcW, int srcH)

Эта функция - одна из самых мощных и универсальных. С помощью нее можно копировать изображения (или их участки), перемещать или масштабировать их.

dst_im задает идентификатор изображения, в который будет помещен результат работы функции. Это изображение должно уже быть создано или загружено и иметь надлежащие размеры.

src_im - идентификатор изображения, над которым проводится работа. Впрочем, src_im и dst_imмогут и совпадать.

Параметры srcX, srcY, srcW, srcH задают область внутри исходного изображения, над которой будет осуществлена операция - соответственно, координаты ее верхнего левого угла, ширину и высоту.

Наконец, четверка dstX, dstY, dstW, dstH задает то место на изображении dst_im, в которое будет "втиснут" указанный в предыдущей четверке прямоугольник. Заметьте, что, если ширина или высота двух прямоугольников не совпадают, то картинка автоматически будет нужным образом растянута или сжата.

В следующем примере файл file1.jpg

уменьшается вдвое и записывается в файл file2.jpg:

<?php$old = imageCreateFromJpeg("img/file1.jpg");$w = imageSX($old);$h = imageSY($old);$w_new=rounr($w/2);$h_new=round($h/2);$new = imageCreate($w_new, $h_new);imageCopyResized($new, $old, 0, 0, 0, 0, $w_new, $h_new, $w, $h);imageJpeg($new, "img/file2.jpg");imageDestroy($old);imageDestroy($new);?>

imageDestroy

Уничтожение рисунка.

Синтаксис :

int imageDestroy(int im)

Функция уничтожает дескриптор im ранее созданного рисунка (наподобие закрытия файла fclose() после открытия fopen()).


Содержание раздела