Главная страница о компиляторе

Описание функций gd*()

Функции gd* предназначены для генерации графических примитивов (прямоугольники, окружности, линии и т.п. ) и обработки файлов графических форматов PNG,JPEG,... Оригинальная документация самой библиотеки libgd
класс gdImage

imagePtr=gdImageCreate(xSize, ySize)

Создает в памяти графический образ размером xSize * ySize, возвращает указатель на графический образ imagePtr, который в последствии используется во всех других функциях.

imagePtr=gdImageCreateFromPNG(filename)
imagePtr=gdImageCreateFromGD(filename)
imagePtr=gdImageCreateFromGD2(filename)
imagePtr=gdImageCreateFromXBM(filename)
imagePtr=gdImageCreateFromJPEG(filename)

Зачитывает образ из файла соотвествующего формата.

imagePtr=gdImageCreateFromXPM(filename)
На сегодняшний день этот формат не удалось заставить работать - он тянет за собой кучу X11 библиотек и конца им не видно :) Может она и заработает когда clip будет генерить X-Windows программы.

imagePtr=gdImageCreateFromFILE(filename[, typeFile])

Зачитывает образ из файла с указанием нужного типа формата.
Поддерживаются типы файлов:
	#define	GDFILE_PNG	1
	#define	GDFILE_GD	2
	#define GDFILE_GD2	3
	#define GDFILE_XBM	4
 

По умолчанию GDFILE_PNG. Типы описаны в include/gdinfo.ch

gdImageDestroy(imagePtr)

Уничтожает графический образ.

gdImagePNG(imagePtr, filename)
gdImageGD(imagePtr, filename)
gdImageGD2(imagePtr, filename)
gdImageJPEG(imagePtr, filename)

Записывает графический образ imagePtr в файл filename в соответсвующем формате. Расширения файла указывать обязательно.

gdImageToFile(imagePtr, filename[, typeFile])

Записывает графический образ imagePtr в файл filename в формате typeFile. по умолчанию тип файла - GDFILE_PNG. Типы описаны в include/gdinfo.ch

color_index=gdColorCreate(imagePtr, Red, Green, Blue)

Резервирует и возвращает номер цвета (color_index) для заказанной палитры RGB. Если лимит в 256 цветов уже выбран, то подбирает ближайший похожий и возращает индекс поборанного цвета.

gdColorTransparent(imagePtr, color_index)

Устанавливает цвет прозрачности изображения.

gdImageInterlace(imagePtr, interlaced)

Устанавливает черезстрочную "развертку".

gdImageCompare(imagePtr1, imagePtr2)

Сравнивает два образа побитно.

gdColorInfo(imagePtr, infoIndex, color_index)

Возвращает различную информацию о цветовых значениях
infoIndex может принимать значения:
GDINFO_COLORSTOTAL
GDINFO_TRANSPARENT
GDINFO_INTERLACED
GDINFO_COLORRED
GDINFO_COLORGREEN
GDINFO_COLORBLUE
GDINFO_SIZEX
GDINFO_SIZEY
Эти значения описаны в gdinfo.ch

gdImageGetPixel(imagePtr, x_coord, y_coord)

Возвращает индекс цвета в указанной точке

gdImageSetPixel(imagePtr, x_coord, y_coord, color_index)

Рисует точку указанным цветом color_index

gdImageBoundsSafe(imagePtr,x_coord,y_coord)

Определяет находится ли указанная точка внутри образа или находится за границами образа.

gdImageLine(imagePtr, x1, y1, x2, y2, color_index)

Рисует линию указанным цветом

gdImageDashedLine(imagePtr, x1, y1, x2, y2, color_index)

Рисует прерывистую линию указанным цветом

gdImageRectangle(imagePtr, x1, y1, x2, y2, color_index)

Рисует прямоугольник указанным цветом

gdImageFilledRectangle(imagePtr, x1, y1, x2, y2, color_index)

Рисует прямоугольник заполненный указанным цветом

gdImageArc(imagePtr, cx, cy, width, high, startangle, endangle, color_index)

Рисует круг, эллипс или дугу с центром cx, cy цветом color_index и радиусом width по оси Х и high по оси Y, начиная с угла startangle и заканчивая endangle.

gdImageFilledArc(imagePtr, cx, cy, width, high, color_index)

Рисует заполненный круг или эллипс с центром cx, cy цветом color_index и радиусом width по оси Х и high по оси Y.

gdImageFill(imagePtr, x, y, color_index)

Заполняет цветом color_index начиная с точки (x,y) в пределах цветовой границы

gdImageFillToBorder(imagePtr, x, y, bordercolor, color_index)

Заполняет цветом color_index регион с граничным цветом bordercolor начиная с точки (x,y)

gdImagePolygon(imagePtr, {{x1,y1}, {x2,y2}, ...{xn,yn}}, color_index)

Рисует область(регион) по указанным координатам цветом color_index

gdImageFilledPolygon(imagePtr, {{x1,y1}, {x2,y2}, ...{xn,yn}}, color_index)

Рисует заполненную область(регион) по указанным координатам цветом color_index

gdImageSetBrush(imagePtr, imagePtrBrush)

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

gdImageSetTile(imagePtr, imagePtrTile)

Устанавливает изображение, которым будут пльзоваться fill-функции.

gdImageSetStYle(imagePtr, colorsArray)

Устанавливает стиль прорисовки прерывистых и т.п. линий. В colorsArray надо набить цвета каждой точки, из которых будет состоять прерывистая линия. А также можно использовать специальные цвета описанные в gdinfo.ch
GDSTYLE_STYLED
GDSTYLE_BRUSHED
GDSTYLE_STYLEDBRUSHED
GDSTYLE_TILED
GDSTYLE_TRANSPARENT

gdImageChar(imagePtr, str, x, y, color_index, fontPtr)
gdImageCharUP(imagePtr, str, x, y, color_index, fontPtr)
gdImageString(imagePtr, str, x, y, color_index, fontPtr)
gdImageStringUP(imagePtr, str, x, y, color_index, fontPtr)

Рисует изображение символа или строки str фонтом fontPtr цветом color_index, который может иметь одно из описанных в gdinfo.ch значений.
GDFONT_GIANT
GDFONT_LARGE
GDFONT_NEDIUMBOLD
GDFONT_SMALL
GDFONT_TINY
Функции gdImageCharUp() и gdImageStringUp() рисуют символ или строку, повернутую на 270 градусов.

gdImageCharRotate(imagePtr, str, x, y, color_index, fontPtr, angle)
gdImageStringRotate(imagePtr, str, x, y, color_index, fontPtr, angle)

Выводит строку или символ str под углом angle цветом color_index и размером fontPtr (см. include/gdinfo.ch)

gdImageCharVector(imagePtr, str, x, y, angle, color_index, fontSize)
gdImageStringVector(imagePtr, str, x, y, angle, color_index, fontSize)

Выводит строку или символ str под нужным углом angle в векторной графике с размером fontSize (не путайте с fontPtr) и цветом color_index.

gdImageSector(imagePtr, cx, cy, width, high, startangle, endangle, color_index)
gdImageFilledSector(imagePtr, cx, cy, width, high, startangle, endangle, color_index)

Рисует сектор с центром cx, cy цветом color_index и радиусом width по оси Х и high по оси Y, начиная с угла startangle и заканчивая endangle.

gdImageTruncSector(imagePtr, cx, cy, width, high, widthtr, hightr, startangle, endangle, color_index)
gdImageFilledTruncSector(imagePtr, cx, cy, width, high, widthtr, hightr, startangle, endangle, color_index)

Рисует усеченный сектор с центром cx, cy и внешним радиусом width по оси Х и high по оси Y, и внутренним widthtr (X) hightr (Y), цветом color_index, начиная с угла startangle и заканчивая endangle.
Главная страница о компиляторе
© Ю.Хныкин, uri@itk.ru, 2000