HOOPS/3dGS I.M. Interface

     << Back      Full Index      Forward >>


Draw_DC_Mapped8_Rasters


Functions

void Draw_DC_Mapped8_Rasters (HT_Rendition *nr, HT_DC_Point *start, HT_DC_Point *end, int rowbytes, void **rasters)
void Draw_DC_Mapped16_Rasters (HT_Rendition *nr, HT_DC_Point *start, HT_DC_Point *end, int rowbytes, void **rasters)
void Draw_DC_RGB32_Rasters (HT_Rendition *nr, HT_DC_Point *start, HT_DC_Point *end, int rowbytes, void **rasters)

Function Documentation

void Draw_DC_Mapped8_Rasters HT_Rendition *  nr,
HT_DC_Point *  start,
HT_DC_Point *  end,
int  rowbytes,
void **  rasters
 

Draws a raster of a specific visual type.

Parameters:
nr - Rendition. Passed by reference.
start - Device coordinates of upper-left pixel of raster on the screen. Passed by reference.
end - Device coordinates of pixel at lower-right. Passed by reference.
rowbytes - Number of bytes in a row, including whatever padding is necessary to satisfy alignment requirements for row starts. The padding will usually, but not always, be zero.
rasters - Pointer to data array

DETAILS

HIC_Draw_DC_Bit_Raster() draws a single scan line determined by the bits in the data array. That is, start and end should have the same y-coordinate, otherwise the result is unpredictable. The number of pixels is implied by start and end (namely, 1+end->x-start->x). rasters points to an array of bytes, each containing the bits to be written to eight consecutive pixels on a scan line, with the least significant bit representing the left-most pixel. A one bit means the bright color, a zero bit the dark color. The pixel corresponding to the first bit of the first byte need not be on an eight-pixel boundary. If the number of pixels (as determined by the difference between the x-coordinates of end and start) is not a multiple of eight, then some of the bits of the last byte will be discarded.

HIC_Draw_DC_Gray8_Rasters() draws an image specified by an array of eight-bit gray scale values. The number of rows is determined by the difference between the y coordinates of end and start, and the number of columns by the difference between the x coordinates. The number of bytes in the rasters array should be the product of the number of rows and the number of columns, and the bytes should be arranged in natural scan order.

HIC_Draw_DC_Mapped8_Rasters() draws an image specified by an array of eight-bit color indices into the current color map. The number of rows is determined by the difference between the y coordinates of end and start, and the number of columns by the difference between the x coordinates. The number of bytes in the rasters array should be the product of the number of rows and the number of columns, and the bytes should be arranged in natural scan order.

HIC_Draw_DC_Mapped16_Rasters() draws an image specified by an array of 16-bit color indices into the current color map. The number of rows is determined by the difference between the y coordinates of end and start, and the number of columns by the difference between the x coordinates. The number of short words in the rasters array should be the product of the number of rows and the number of columns, and the bytes should be arranged in natural scan order.

HIC_Draw_DC_RGB32_Rasters() draws an image specified by an array of 32-bit words, each giving a pixel color in the platform-dependent four-byte color format. The number of rows is determined by the difference between the y coordinates of end and start, and the number of columns by the difference between the x coordinates. The number of long words in the rasters array should be the product of the number of rows and the number of columns. The long words should be arranged in natural scan order.

NOTES

These routines are <u>not entirely device-independent. Each should be called only for devices with the corresponding visual type.

</u>Note the singular form of the name HIC_Draw_DC_Bit_Raster() , as opposed to the plural form of the other functions, which is to indicate that it draws only a single scan line.

RESTRICTIONS

See also:

void Draw_DC_Mapped16_Rasters HT_Rendition *  nr,
HT_DC_Point *  start,
HT_DC_Point *  end,
int  rowbytes,
void **  rasters
 

CAN'T DETERMINE DESCRIPTION FOR THIS VARIANT.

Parameters:
nr - Rendition. Passed by reference.
start - Device coordinates of upper-left pixel of raster on the screen. Passed by reference.
end - Device coordinates of pixel at lower-right. Passed by reference.
rowbytes - Number of bytes in a row, including whatever padding is necessary to satisfy alignment requirements for row starts. The padding will usually, but not always, be zero.
rasters - Pointer to data array

DETAILS

No additional details. See Draw_DC_Mapped8_Rasters()

void Draw_DC_RGB32_Rasters HT_Rendition *  nr,
HT_DC_Point *  start,
HT_DC_Point *  end,
int  rowbytes,
void **  rasters
 

CAN'T DETERMINE DESCRIPTION FOR THIS VARIANT.

Parameters:
nr - Rendition. Passed by reference.
start - Device coordinates of upper-left pixel of raster on the screen. Passed by reference.
end - Device coordinates of pixel at lower-right. Passed by reference.
rowbytes - Number of bytes in a row, including whatever padding is necessary to satisfy alignment requirements for row starts. The padding will usually, but not always, be zero.
rasters - Pointer to data array

DETAILS

No additional details. See Draw_DC_Mapped8_Rasters()
Main Index

HOOPS/3dGS I.M. Interface

     << Back      Full Index      Forward >>