Pair

NAME

render - Draw on an Image

SYNOPSIS

DrawInfo * CloneDrawInfo( const ImageInfo *image_info, const DrawInfo *draw_info );

void DestroyDrawInfo( DrawInfo *draw_info );

unsigned int DrawAffineImage( Image *image, const Image *composite, const AffineMatrix *affine );

unsigned int DrawClipPath( Image *image, const DrawInfo *draw_info, const char *name );

unsigned int DrawImage( Image *image, const DrawInfo *draw_info );

unsigned int DrawPatternPath( Image *image, const DrawInfo *draw_info, const char *name, Image ** pattern );

FUNCTION DESCRIPTIONS

CloneDrawInfo

CloneDrawInfo() makes a copy of the given draw info structure. If NULL is specified, a new image info structure is created initialized to default values.

The format of the CloneDrawInfo method is:

DrawInfo *CloneDrawInfo ( const ImageInfo *image_info, const DrawInfo *draw_info );

A description of each parameter follows:

image_info:
The image info.

draw_info:
The draw info.

DestroyDrawInfo

DestroyDrawInfo() deallocates memory associated with an DrawInfo structure.

The format of the DestroyDrawInfo method is:

void DestroyDrawInfo ( DrawInfo *draw_info );

A description of each parameter follows:

draw_info:
The draw info.

DrawAffineImage

DrawAffineImage() composites the source over the destination image as dictated by the affine transform.

The format of the DrawAffineImage method is:

unsigned int DrawAffineImage ( Image *image, const Image *composite, const AffineMatrix *affine );

A description of each parameter follows:

image:
The image.

image:
The composite image.

affine:
The affine transform.

DrawClipPath

DrawClipPath() draws the clip path on the image mask.

The format of the DrawClipPath method is:

unsigned int DrawClipPath ( Image *image, const DrawInfo *draw_info, const char *name );

A description of each parameter follows:

image:
The image.

draw_info:
The draw info.

name:
The name of the clip path.

DrawImage

Use DrawImage() to draw a graphic primitive on your image. The primitive may be represented as a string or filename. Precede the filename with an "at" sign ( @ ) and the contents of the file are drawn on the image. You can affect how text is drawn by setting one or more members of the draw info structure.

The format of the DrawImage method is:

unsigned int DrawImage ( Image *image, const DrawInfo *draw_info );

A description of each parameter follows:

image:
The image.

draw_info:
The draw info.

DrawPatternPath

DrawPatternPath() draws a pattern.

The format of the DrawPatternPath method is:

unsigned int DrawPatternPath ( Image *image, const DrawInfo *draw_info, const char *name, Image **pattern );

A description of each parameter follows:

image:
The image.

draw_info:
The draw info.

name:
The pattern name.

image:
The image.