Command
QisLib_SetImageSize

QisLib_SetImageSize

Function:
	int QisLib_SetImageSize(unsigned int XRes, unsigned int YRes, unsigned long*
		PixmapHandle); [Unix/Linux only]
	int QisLib_SetImageSize(unsigned int XRes, unsigned int YRes); [Windows only]

Inputs:
	XRes: X Resolution of the desired image in pixels
	YRes: Y Resolution of the desired image in pixels
	PixmapHandle: Address of a buffer to retrieve QisLib's pixmap handle [Unix/Linux only]

Return:
	success:0
	failure: one of the following values :

Errors:
	1: 'DisplayHandle' parameter of QisLib_InitLib is NULL, operation not permitted.
	-1: QisLib has not been initialized.
	-2: Internal error occurred while resizing image.

Description:
	- Use this function to set the image size in pixels for the images generated by
	QisLib_Redraw, QisLib_GetImage and QisLib_ZoomHome.
	- When QisLib_SetDrawWindowID is active, use this function to inform QisLib about the
	size of the user program's drawing area.
	- When QisLib_SetDrawWindowID is active (the user's program wants QisLib to draw
	directly to it's drawing area), use this function to tell QIS about the size of the
	user program's drawing area.
	- The default image size is 800x600 but the user program should specify the image
	size.
	- On Unix/Linux, when this function is called, QisLib returns a handle to a drawable
	of type Drawable, Window or Pixmap via the 'PixmapHandle' parameter as long as both
	the user program and QisLib use the same DISPLAY and visual of same depth. If the
	'PixmapHandle' parameter is NULL, no such handle is returned. The user program can
	use this handle to get the image using X server API. The size of this drawing area
	depends on the QisLib_SetImageSize parameters. The image can be copied directly from
	QisLib to the user program's drawing area using XCopyArea.
	- On Unix/Linux, this function will not work if the 'DisplayHandle' parameter to
	QisLib_InitLib is set to NULL.

Note:
	- When QisLib_SetDrawWindowID is active (the user's program wants QisLib to draw
	directly to it's drawing area), a valid pixmap will still be returned via
	PixmapHandle, however the data in that pixmap will be invalid. Hence, when
	QisLib_SetDrawWindowID is active, using PixmapHandle to access the QisLib pixmap is
	discouraged.