This function instructs D-Type Direct Color Rasterizer to render the current scene to the memory surface that was supplied to dcRasterizerIni. Before rendering, the function automatically closes any previously opened contour.
In order for this function to generate any visible output, the scene must be first constructed by calling D-Type Direct Color Rasterizer's scene construction functions (dcRasterizerMoveTo, dcRasterizerMoveToFrac, dcRasterizerLineTo, dcRasterizerLineToFrac, dcRasterizerBSplineTo, dcRasterizerBSplineToFrac, dcRasterizerBezierTo, dcRasterizerBezierToFrac, dcRasterizerMultiSegment, dcRasterizerMultiSegmentFrac).
Parameter | Description |
---|---|
dcr |
Handle of the previously created D-Type Direct Color Rasterizer instance. |
format |
Specifies the format, or number of bits-per-pixel, of the surface. See below for details. |
subformat |
Color configuration of the pixel. See below for details. |
reserved |
Reserved for future use. Must be set to 0. |
The format parameter specifies the number of bits-per-pixel and is used to calculate the amount of memory needed for the surface; subformat defines the configuration of a single pixel.
The following table illustrates the pixel configuration currently supported by D-Type Direct Color Rasterizer.
Format (bits-per-pixel) | Subformat | Description |
---|---|---|
8 | 0 |
gggggggg |
8 | 1 |
TTTTTTTT |
8 | 2 |
gggggggg |
8 | 3 |
gggggggg |
8 | 4 |
gggggggg |
8 | 5 |
gggggggg |
8 | 10 |
gggggggg |
8 | 12 |
gggggggg |
8 | 13 |
gggggggg |
8 | 14 |
gggggggg |
8 | 15 |
gggggggg |
24 | 0 |
BBBBBBBB GGGGGGGG RRRRRRRR |
32 | 0 |
BBBBBBBB GGGGGGGG RRRRRRRR xxxxxxxx |
32 | 1 |
xxxxxxxx BBBBBBBB GGGGGGGG RRRRRRRR |
Legend: Note 1: RGB and alpha values are stored only for pixels that are actually rendered by D-Type. Your application must ensure that the surface is cleared with appropriate values before rendering. |