imgPlotDC
- Updated2023-02-21
- 1 minute(s) read
imgPlotDC
Usage
rval imgPlotDC(GUIHNDL dc, const void* buffer, uInt32 leftBufOffset, uInt32 topBufOffset, uInt32 xsize, uInt32 ysize, uInt32 xpos, uInt32 ypos, uInt32 flags);
Purpose
Plots a buffer to a device context given a device context handle.
Parameters
| Name | Type | Direction |
| dc | GUIHNDL | input |
| buffer | const void* | input |
| leftBufOffset | uInt32 | input |
| topBufOffset | uInt32 | input |
| xsize | uInt32 | input |
| ysize | uInt32 | input |
| xpos | uInt32 | input |
| ypos | uInt32 | input |
| flags | uInt32 | input |
| rval | Int32 | output |
Parameter Discussion
dc: native Windows device context in which to draw.
buffer: image to plot.
leftBufOffset: left offset into the image to start plotting.
topBufOffset: top offset into the buffer to start plotting.
xsize: width of the image, in pixels.
ysize: number of lines in the image.
xpos: left position to start plotting in the window.
ypos: top position to start plotting in the window.
flags: sets the display property. flags is used with the following constants:
| IMGPLOT_INVERT | Specifies to invert the image when plotted. |
| IMGPLOT_MONO_8 | Specifies a 8-bit monochrome image. |
| IMGPLOT_MONO_10 | Specifies a 10-bit monochrome image. |
| IMGPLOT_MONO_12 | Specifies a 12-bit monochrome image. |
| IMGPLOT_MONO_14 | Specifies a 14-bit monochrome image. |
| IMGPLOT_MONO_16 | Specifies a 16-bit monochrome image. |
| IMGPLOT_COLOR_HSL32 | Specifies a 32-bit color HSL image. |
| IMGPLOT_COLOR_RGB32 | Specifies a 32-bit color RGB image. |
Return Value
This function returns 0 on success. On failure, this function returns an error code. For information about the error code, call imgShowError.