Overview

xxx

Functions

hCreateMetafile(filename, description, x, y)

Takes a filename and a description along with the x and y dimensions in centimeters and returns a metafile handle. The handle is for use with the other grail.ip.metafile functions.

vCloseMetafile(handle)

Closes the metafile.

vMetaDrawRect(handle, left, top, right, bottom, edge_red, edge_green, edge_blue, fill_red, fill_green, fill_blue)

Draws a rectangle to the metafile with the coordinates defined by left, top, right and bottom. In otherwords, the co-ordinates define the top-left corner an the bottom-right corners of the rectangle.

You can specify the colors you want for both the edges and the fill of the triangle using red, green and blue color specification.

vMetaDrawPie(handle, x, y, radius, start_angle, end_angle, edge_red, edge_green, edge_blue, fill_red, fill_green, fill_blue)

Draws a pie shape that inscribes a circle with its center at x and y and with the given radius. The inscribed circle will proceed from the start angle to the end angle.

You can specify the colors you want for both the edges and the fill of the pie using red, green and blue color specification.

vMetaDrawEllip(left, top, right, bottom, edge_red, edge_green, edge_blue, fill_red, fill_green, fill_blue)

Draws an ellipse based on the top-left corner and bottom-right corners of a triangle that would contain the ellipse.

You can specify the colors you want for both the edges and the fill of the ellipse using red, green and blue color specification.

vMetaDrawCircle(handle, x, y, radius, edge_red, edge_green, edge_blue, fill_red, fill_green, fill_blue)

Draws a circle centered at x and y with the given radius.

You can specify the colors you want for both the edges and the fill of the circle using red, green and blue color specification.

vMetaDrawLine(handle, x0, y0, x1, y1, edge_red, edge_green, edge_blue, fill_red, fill_green, fill_blue)

Draws a line that goes from (x0, y0) to (x1, y1).

You can specify the colors you want for both the edges and the fill of the line using red, green and blue color specification.

vMetaSetTextColor(handle, red, green, blue)

Sets the text color the red, green and blue combination specified. The handle is the handle to the metafile.

vMetaSetBackColor(handle, red, green, blue)

Sets the background color the red, green and blue combination specified. The handle is the handle to the metafile.

vMetaSetBackTrans(handle)

Sets the background of the metafile to be transparent. The handle is the handle to the metafile.

vMetaSetFont(handle, font)

Sets the font that the metafile will use. Valid values for font are one of the following strings,

• "ANSI_FIXED"
• "ANSI_VAR"
• "DEFAULT_DEVICE"
• "SYS_FIXED"
• "SYS_VAR"

If the value of font is unknown, then it will default to "ANSI_FIXED".

vMetaTextOut(handle, x, y, textheight, fontname, text)

Generates text out to the metafile.

vMetaFloodFill(handle, x, y, edge_red, edge_green, edge_blue, fill_red, fill_green, fill_blue)

Fills the target location given by x and y with the given color specifications.