====== WritePixel ======

Writes a pixel to a bitmap in a GrafCon's foreground color.

==== Synopsis ====

''%%Err WritePixel (Item bitmapItem,GrafCon *gc,Coord x, Coord y)%%''

==== Description ====

This call writes a pixel to the display of the specified bitmap. The pixel is rendered in the foreground color of the GrafCon structure. It is rendered on the column and row specified by the x and y arguments respectively.

==== Arguments ====

  * **bitmapItem** Item number of a bitmap structure.

  * **gc** Pointer to a GrafCon structure.

  * **x** Column where the pixel is to be written.

  * **y** Row where the pixel is to be written.

==== Return Value ====

The call returns 0 if successful or an error code (a negative value) if an error occurs.

GRAFERR_COORDRANGE is returned if the specified location is outside the bitmap boundaries.

==== Notes ====

The current implementation of this routine is very slow. This will change in future releases.

==== Implementation ====

Folio call implemented in Graphics folio V20.

==== Associated Files ====

graphics.h, graphics.lib