| GEOS SDK TechDocs | | GrDestroyBitmap() ... | GrDrawLine() ...

---

GrDrawCurve()

void	GrDrawCurve(
        GStateHandle		gstate,				/* GState to draw to */
        const	Point	*points);				/* array of four Points */

Draw a Bezier curve.

Include: graphics.h

GrDrawCurveTo()

void	GrDrawCurveTo(
        GStateHandle		gstate,				/* GState to draw to */
        const	Point	*points);			/* array of three Points */

Draw a Bezier curve, using the current postion as the first point.

Include: graphics.h

GrDrawEllipse()

void	GrDrawEllipse(
        GStateHandle		gstate,			/* GState to draw to */
        sword		left,			/* bounding box bounds */
        sword		top,
        sword		right,
        sword		bottom);

Draw an ellipse, defined by its bounding box.

Include: graphics.h

GrDrawGString()

GSRetType GrDrawGString(
        GStateHandle		gstate,					/* GState to draw to */
        Handle		gstringToDraw,					/* GString to draw */
        sword		x,					/* point at which to draw */
        sword		y,
        GSControl 		flags,					/* GSControl record */
        GStringElement		* lastElement);					/* pointer to empty structure */

Draw a graphics string. The passed control flag allows drawing to stop upon encountering certain kinds of drawing elements. If this causes the drawing to stop in mid-string, then the routine will provide a pointer to the next GStringElement to be played.

• You must provide a GState to draw to. You may wish to call GrSaveState() on the GState before drawing the GString (and call GrRestoreState() afterwards). If you will draw anything else to this GState after the GString, you must call GrDestroyGString() on the GString, and pass this GState's handle as the gstate argument so that GrDestroyGString() can clean up the GState.
• You must provide a GString to draw. The GString must be properly loaded (probably by means of GrLoadGString() ).
• You can provide a pair of coordinates at which to draw the GString. The graphics system will translate the coordinate system by these coordinates before carrying out the graphics commands stored in the GString.
• You can provide a GSControl argument which requests that the system stop drawing the GString when it encounters a certain type of GString element. If the GString interpreter encounters one of these elements, it will immediately stop drawing. The GString will remember where it stopped drawing. If you call GrDrawGString() with that same GString, it will continue drawing where you left off.
• You must provide a pointer to an empty GStringElement structure. GrDrawGString() will return a value here when it is finished drawing. If the GString has stopped drawing partway through due to a passed GSControl , the returned GStringElement value will tell you what sort of command was responsible for halting drawing. For instance, if you had instructed GrDrawGString() to halt on an `output' element (GrDraw...() or GrFill...() commands), then when GrDrawGString() returns, you would check the value returned to see what sort of output element was present.

Include: gstring.h

GrDrawGStringAtCP()

GSRetType GrDrawGStringAtCP(
        GStateHandle		gstate,					/* GState to draw to */
        GStringeHandle		gstringToDraw,					/* GString to draw */
        GSControl 		flags,					/* GSControl flags */
        GStringElement 		* lastElement);					/* last element to draw */

Draw a graphics string as GrDrawGString() , above, except that drawing takes place at the current position.

• You must provide a GState to draw to. You may wish to call GrSaveState() on the GState before drawing the GString (and call GrRestoreState() afterwards). If you will draw anything else to this GState after the GString, you must call GrDestroyGString() on the GString, and pass this GState's handle as the gstate argument so that GrDestroyGString() can clean up the GState.
• You must provide a GString to draw. The GString must be properly loaded (probably by means of GrLoadGString() ).
• You can provide a GSControl argument which requests that the system stop drawing the GString when it encounters a certain type of GString element. If the GString interpreter encounters one of these elements, it will immediately stop drawing. The GString will remember where it stopped drawing. If you call GrDrawGString() with that same GString, it will continue drawing where you left off.
• You must provide a pointer to an empty GStringElement structure. GrDrawGString() will return a value here when it is finished drawing. If the GString has stopped drawing partway through due to a passed GSControl , the returned GStringElement value will tell you what sort of command was responsible for halting drawing. For instance, if you had instructed GrDrawGString() to halt on an `output' element (GrDraw...() or GrFill...() commands), then when GrDrawGString() returns, you would check the value returned to see what sort of output element was present.

Include: gstring.h

GrDrawHLine()

void	GrDrawHLine(
        GStateHandle		gstate,			/* GState to draw to */
        sword		x1,			/* first horizontal coordinate */
        sword		y,			/* vertical position of line */
        sword		x2);			/* second horizontal coordinate */

Draw a horizontal line.

Include: graphics.h

GrDrawHLineTo()

void	GrDrawHLineTo(
        GStateHandle		gstate,			/* GState to draw to */
        sword		x);			/* ending horizontal coordinate */

Draw a horizontal line starting from the current position.

Include: graphics.h

GrDrawHugeBitmap()

void	GrDrawHugeBitmap(
        GStateHandle		gstate,			/* GState to draw to */
        sword		x			/* Point at which to draw */
        sword		y,
        VMFileHandle 		vmFile,			/* VM File holding HugeArray */
        VMBlockHandle 		vmBlk);			/* VM block of HugeArray */

Draw a bitmap that resides in a HugeArray.

Include: graphics.h

See Also: GrDrawBitmap(), GrDrawHugeBitmapAtCP(), GrDrawHugeImage().

GrDrawHugeBitmapAtCP()

void	GrDrawHugeBitmapAtCP(
        GStateHandle		gstate,			/* GState to draw to */
        VMFileHandle	 	vmFile,			/* VM file containing HugeArray */
        VMBlockHandle 		vmBlk);			/* VM block containing HugeArray */

As GrDrawHugeBitmap() , above, except that the bitmap is drawn at the current position.

Include: graphics.h

See Also: GrDrawBitmapAtCP(), GrDrawHugeBitmap().

. Note that the bitmap will be

GrDrawHugeImage()

void	GrDrawHugeImage(
        GStateHandle 		gstate,			/* GState to draw to */
        sword		x			/* point at which to draw */
        sword		y,
        ImageFlags 		flags,
        VMFileHandle 		vmFile,			/* VM file holding HugeArray */
        VMBlockHandle 		vmBlk);			/* VM block holding HugeArray */

Draw a bitmap that resides in a HugeArray drawn on an assumption of one device pixel per bitmap pixel. The bitmap will not draw rotated or scaled. Depending on the value of the flags argument, the bitmap may be expanded so that a square of device pixels displays each bitmap pixel.

Include: graphics.h

See Also: GrDrawImage(), GrDrawHugeBitmapAtCP().

GrDrawImage()

void	GrDrawImage(
        GStateHandle 		gstate,			/* GState to draw to */
        sword		x			/* point at which to draw */
        sword		y,
        ImageFlags 		flags,			
        const Bitmap 		* bm);			/* pointer to bitmap */

Draw a bitmap. Note that the bitmap will be drawn on an assumption of one device pixel per bitmap pixel. The bitmap will not draw rotated or scaled. Depending on the value of the flags argument, the bitmap may be expanded so that a square of device pixels displays each bitmap pixel.

Include: graphics.h

See Also: GrDrawHugeImage(), GrDrawBitmap().