imaq1394PlotDC

Format

rval = imaq1394PlotDC (GUIHNDL deviceContext, void *buffer, unsigned long srcX, unsigned long srcY, unsigned long cols, unsigned long rows, unsigned long dstX, unsigned Long dstY, unsigned long flags);

Purpose

Plots a buffer to a window given a device context. Use this function to easily display a buffer after it is acquired.

Parameters

Parameter	Type	Description
deviceContext	GUIHNDL	A device context in which to plot the image.
buffer	void *	A pointer to an area of memory containing a video frame buffer.
srcX	unsigned long	The left offset in the buffer to start plotting.
srcY	unsigned long	The top offset in the buffer to start plotting.
cols	unsigned long	The number of columns in the image.
rows	unsigned long	The number of rows in the image.
dstX	unsigned long	The left position to start plotting in the window.
dstY	unsigned long	The top position to start plotting in the window.
flags	unsigned long	The display property with the following constants: IMG1394_PLOT_INVERT: Invert the picture IMG1394_PLOT_COLOR_RGB24: Display a RGB 24-bit color image IMG1394_PLOT_COLOR_RGB32: Display a RGB 32-bit color image IMG1394_PLOT_MONO_8: Display an 8-bit grayscale image IMG1394_PLOT_MONO_10: Display a 10-bit grayscale image IMG1394_PLOT_MONO_12: Display a 12-bit grayscale image IMG1394_PLOT_MONO_14: Display a 14-bit grayscale image IMG1394_PLOT_MONO_16: Display a 16-bit grayscale image IMG1394_PLOT_MONO_32: Display a 32-bit grayscale image

Return Value

On success, this function returns IMG1394_ERR_GOOD. On failure, this function returns an error code. You can obtain a more detailed error message with imaq1394ShowError.