[ Main Menu ] [ Extension Tools Menu ] [ Professional Edition Menu ]

<iIMAGESETBRUSH> Tag


<iIMAGESETBRUSH
NAME=""
BRUSH=""
[TILE="<true | false>"] (false)
>

Usage 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 image can be used as a brush and by setting the transparent color index of the brush a brush of any shape can be created. The iIMAGELINE tag will use the current brush if the special "color" gdBrushed or gdStyledBrushed is used when calling them. See iIMAGESETSTYLE
iIMAGESETBRUSH 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 GIFs 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 if you will not be using the brush image for any further purpose you should call iIMAGEDESTROY
If TILE is set to TRUE then the following applies: 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 a tile that allows certain parts of the underlying area to shine through can be created. The region-filling function iIMAGEFILL will use the current tile if the special "color" gdTiled is used when calling them.
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 GIFs 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


Top