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