Command
QisLib_ZoomHome

QisLib_ZoomHome


Function:
	int QisLib_ZoomHome(CQisWindow* Window, int* ImageSize, const char** ImageBuffer, int
	ClearDrawWindow);

Inputs:
	Window :Address of buffer to retrieve window extents corresponding to the image.
	ImageSize :Address of buffer to retrieve the size of the buffer pointed to by
	ImageBuffer in bytes.
	ImageBuffer :Address of pointer of type char*. When the function returns successfully,
	this pointer will point to the image data or may be invalid depending on certain
	conditions.
	ClearDrawWindow :Instructs QisLib to clear the drawing area before a redraw when
	QisLib_SetDrawWindowID is turned on. It can be _QIS_ON (On) or _QIS_OFF (Off).

Return:
	success: 0
	special: 1 indicates that drawing finished successfully but no image was returned via
	ImageBuffer.(QisLib_SetImageFormat is off or QisLib_SetDrawWindowID is on)
	failure: one of the following values:

Errors:
	-1: QisLib has not been initialized. On Unix/Linux, this error could also mean that
	the DisplayHandle parameter of QisLib_InitLib has been set to NULL.
	-2: File open in progress, operation not permitted.

Description:
	- This function draws an image corresponding to the home view of the extents of the
	currently opened cell.
	- This function behaves exactly as QisLib_Redraw with 2 execptions:
	1. The current window is changed and set to the extents of the currently opened
	cell. This is similar to calling QisLib_SetWindow.
	2. If QisLib_SetDrawWindowID is off, the home view is remembered for faster
	response. When QisLib_ZoomHome is called, it simply returns this remembered image
	and therefore appears to be nearly instantaneous. However, the home view is redrawn
	when one of the following functions is called:
	- QisLib_Redraw
	- QisLib_SetImageSize
	- QisLib_OpenStructure
	- QisLib_SetBackgroundColor
	However if QisLib_SetDrawWindowID is on, QisLib_ZoomHome behaves exactly like
	QisLib_Redraw. Therefore it will not be instantaneous.

References:
QisLib_SetImageFormat
QisLib_Redraw
CQisWindow
QisLib_SetDrawWindowID
QisLib_OpenStructure