HBGD is basically a wrapper of Thomas Boutell's GD Library version 2.x. GD Library is a powerful graphic library very useful especially under CGI environment.

HBGD actually contains almost all GD functions, more a set of functions that extends original library and a set of classes that make easier to work with this library.

Thomas Boutell's GD library actually supports these graphic formats: PNG, JPEG, GIF, Animated GIF, GD, GD2, WBMP, XBM, XPM WBMP is Wireless Bitmap, not Windows Bitmap, and it is used for WAP. It is a B&W bitmap.

HBGD actually supports PNG, JPEG, GIF, GD, WBMP The other Animated GIF, GD2, XBM and XPM are not wrapped actually.

Using this library you can, as a little example: - create an image in memory, true color or with a 256 colors palette; - load and save an image of above formats and convert it to another supported format; - draw dots, lines, dashed lines, polygons, rectangles, arcs, circles and ellipses; - fill with colors; - draw with brushes; - check a point or part or full image with a lot of query functions; - draw characters and words with internal fonts or using TrueType fonts; - write strings on a base line or on a circle line and with any angle degree; - copy, resize and rotate part or full image;

and, over this, some functions to clone, crop, zoom, rotate outside and inside.

The prefix for all functions is GD (i.e. gdImageCreate() )

You can use directly all API functions or TGD class.

NOTE: Not all functions are wrapped.

gdImageArc() is used to draw a partial ellipse centered at the given point, with the specified width and height in pixels. The arc begins at the position in degrees specified by s and ends at the position specified by e. The arc is drawn in the color specified by the last argument. A circle can be drawn by beginning from 0 degrees and ending at 360 degrees, with width and height being equal. e must be greater than s. Values greater than 360 are interpreted modulo 360.

To set the color index you have to use gdImageColorAllocate() function.

gdImageCreate() creates an empty image in memory. This image has no more than 256 colors.

gdImageCreate() returns an image pointer or NIL if unable to create the image.

gdImageCreateFromGD() creates a GD image from a file or a handle or another image in memory.

You can use one of 3 syntax:

or

or

the pImage pointer returned will be not NIL if successful and will contains a memory pointer to the GD image.

HBGD uses it's own memory to manage an image, so it is important to use this function.

gdImageCreateFromGif() creates a GIF image from a file or a handle or another image in memory.

You can use one of 3 syntax:

or

or

the pImage pointer returned will be not NIL if successful and will contains a memory pointer to the gif image.

HBGD uses it's own memory to manage an image, so it is important to use this function.

gdImageCreateFromJpeg() creates a JPEG image from a file or a handle or another image in memory.

You can use one of 3 syntax:

or

or

the pImage pointer returned will be not NIL if successful and will contains a memory pointer to the JPEG image.

HBGD uses it's own memory to manage an image, so it is important to use this function.

gdImageCreateFromPng() creates a PNG image from a file or a handle or another image in memory.

You can use one of 3 syntax:

or

or

the pImage pointer returned will be not NIL if successful and will contains a memory pointer to the png image.

HBGD uses it's own memory to manage an image, so it is important to use this function.

gdImageCreateFromWBmp() creates a WBMP image from a file or a handle or another image in memory.

You can use one of 3 syntax:

or

or

the pImage pointer returned will be not NIL if successful and will contains a memory pointer to the WBMP image.

HBGD uses it's own memory to manage an image, so it is important to use this function.

gdImageCreateTrueColor() creates an empty image in memory. This image has true colors.

gdImageCreateTrueColor() returns an image pointer or NIL if unable to create the image.

gdImageDashedLine() Draws a dashed line between two end points (x1, y1 and x2, y2) with a particular color index.

To set the color index you have to use gdImageColorAllocate() function.

gdImageFill() floods a portion of the image with the specified color, beginning at the specified point and flooding the surrounding region of the same color as the starting point. For a way of flooding a region defined by a specific border color rather than by its interior color, see gdImageFillToBorder(). The fill color can be gdTiled, resulting in a tile fill using another image as the tile. However, the tile image cannot be transparent. If the image you wish to fill with has a transparent color index, call gdImageTransparent() on the tile image and set the transparent color index to -1 to turn off its transparency.

To set the color index you have to use gdImageColorAllocate() function.

gdImageFilledArc() is used to draw a partial ellipse centered at the given point, with the specified width and height in pixels. The arc begins at the position in degrees specified by s and ends at the position specified by e. The arc is drawn in the color specified by the last argument. A circle can be drawn by beginning from 0 degrees and ending at 360 degrees, with width and height being equal. e must be greater than s. Values greater than 360 are interpreted modulo 360.

To set the color index you have to use gdImageColorAllocate() function.

Last parameter nStyle is a bitwise OR of the following possibilities:

gdArc and gdChord are mutually exclusive; gdChord just connects the starting and ending angles with a straight line, while gdArc produces a rounded edge. gdPie is a synonym for gdArc. gdNoFill indicates that the arc or chord should be outlined, not filled. gdEdged, used together with gdNoFill, indicates that the beginning and ending angles should be connected to the center; this is a good way to outline (rather than fill) a 'pie slice'

these constants are defined in gd.ch

gdImageFilledEllipse() is used to draw a filled ellipse centered at the given point, with the specified width and height in pixels.

To set the color index you have to use gdImageColorAllocate() function.

gdImageFilledPolygon() Draws a filled polygon with vertices (at least 3) with a particular color index.

To set the color index you have to use gdImageColorAllocate() function.

gdImageFilledRectangle() draws a filled rectangle between 2 points with a particular color index.

To set the color index you have to use gdImageColorAllocate() function.

gdImageFillToBorder() floods a portion of the image with the specified color, beginning at the specified point and stopping at the specified border color. For a way of flooding an area defined by the color of the starting point, see gdImageFill().

To set the color index you have to use gdImageColorAllocate() function.

gdImageGD() saves a GD image to a file or a handle.

You can use one of 2 syntax:

or

gdImageGif() saves a GIF image to a file or a handle.

You can use one of 2 syntax:

or

gdImageJpeg() saves a JPEG image to a file or a handle.

You can use one of 2 syntax:

or

gdImageLine() Draws a line between two end points (x1, y1 and x2, y2) with a particular color index.

To set the color index you have to use gdImageColorAllocate() function.

gdImageOpenPolygon() Draws an open polygon with vertices (at least 3) with a particular color index. Unlike gdImagePolygon() the endpoints of the line sequence are not connected to close the polygon.

To set the color index you have to use gdImageColorAllocate() function.

gdImagePng() saves a PNG image to a file or a handle.

You can use one of 2 syntax:

or

gdImagePolygon() Draws a closed polygon with vertices (at least 3) with a particular color index.

To set the color index you have to use gdImageColorAllocate() function.

gdImageRectangle() draws a rectangle between 2 points with a particular color index.

To set the color index you have to use gdImageColorAllocate() function.

"Antialiasing" is a process by which jagged edges associated with line drawing can be reduced by blending the foreground color with an appropriate percentage of the background, depending on how much of the pixel in question is actually within the boundaries of the line being drawn. All line-drawing functions, such as gdImageLine(), gdImageOpenPolygon() and gdImagePolygon(), will draw anti-aliased lines if the special "color" gdAntiAliased constant is used when calling them.

gdImageSetAntiAliased() is used to specify the actual foreground color to be used when drawing anti-aliased lines. You may set any color to be the foreground, however as of version 2.0.12 an alpha channel component is not supported.

Anti-aliased lines can be drawn on both true-color and palette-based images. However, attempts to draw anti-aliased lines on highly complex palette-based backgrounds may not give satisfactory results, due to the limited number of colors available in the palette. Anti-aliased line-drawing on simple backgrounds should work well with palette-based images; otherwise create or fetch a true-color image instead.

You need not take any special action when you are finished with anti-aliased line drawing.

To set the color index you have to use gdImageColorAllocate() function.

Normally, when drawing lines with the special gdAntiAliased "color," blending with the background to reduce jagged edges is the desired behavior. However, when it is desired that lines not be blended with one particular color when it is encountered in the background, the gdImageSetAntiAliasedDontBlend() function can be used to indicate the special color that the foreground should stand out more clearly against.

To set the color index you have to use gdImageColorAllocate() function.

A "brush" is an image used to draw wide, shaped strokes in another image. Just as a paintbrush is not a single point, a brush image need not be a single pixel. Any gd image can be used as a brush, and by setting the transparent color index of the brush image with gdImageColorTransparent(), a brush of any shape can be created. All line-drawing functions, such as gdImageLine(), gdImageOpenPolygon() and gdImagePolygon(), will use the current brush if the special "color" gdBrushed or gdStyledBrushed is used when calling them. gdImageSetBrush() is used to specify the brush to be used in a particular image. You can set any image to be the brush. If the brush image does not have the same color map as the first image, any colors missing from the first image will be allocated. If not enough colors can be allocated, the closest colors already available will be used. This allows arbitrary PNGs to be used as brush images. It also means, however, that you should not set a brush unless you will actually use it; if you set a rapid succession of different brush images, you can quickly fill your color map, and the results will not be optimal.

You need not take any special action when you are finished with a brush. As for any other image. You must not use the color gdBrushed if the current brush has been destroyed; you can of course set a new brush to replace it.

gdImageSetPixel() sets a pixel to a particular color index.

To set the color index you have to use gdImageColorAllocate() function.

It is often desirable to draw dashed lines, dotted lines, and other variations on a broken line. gdImageSetStyle() can be used to set any desired series of colors, including a special color that leaves the background intact, to be repeated during the drawing of a line. To use gdImageSetStyle(), create an array of integers and assign them the desired series of color values to be repeated. You can assign the special color value gdTransparent to indicate that the existing color should be left unchanged for that particular pixel (allowing a dashed line to be attractively drawn over an existing image).

Then, to draw a line using the style, use the normal gdImageLine() function with the special color value gdStyled.

The style array is copied when you set the style, so you need not be concerned with keeping the array around indefinitely. This should not break existing code that assumes styles are not copied.

You can also combine styles and brushes to draw the brush image at intervals instead of in a continuous stroke. When creating a style for use with a brush, the style values are interpreted differently: zero (0) indicates pixels at which the brush should not be drawn, while one (1) indicates pixels at which the brush should be drawn. To draw a styled, brushed line, you must use the special color value gdStyledBrushed.

A "tile" is an image used to fill an area with a repeated pattern. Any gd image can be used as a tile, and by setting the transparent color index of the tile image with gdImageColorTransparent(), a tile that allows certain parts of the underlying area to shine through can be created. All region-filling functions, such as gdImageFill() and gdImageFilledPolygon(), will use the current tile if the special "color" gdTiled is used when calling them.

gdImageSetTile() is used to specify the tile to be used in a particular image. You can set any image to be the tile. If the tile image does not have the same color map as the first image, any colors missing from the first image will be allocated. If not enough colors can be allocated, the closest colors already available will be used. This allows arbitrary PNGs to be used as tile images. It also means, however, that you should not set a tile unless you will actually use it; if you set a rapid succession of different tile images, you can quickly fill your color map, and the results will not be optimal.

You need not take any special action when you are finished with a tile. As for any other image. You must not use the color gdTiled if the current tile has been destroyed; you can of course set a new tile to replace it.

gdImageWBmp() saves a WBMP image to a file or a handle.

You can use one of 2 syntax:

or