|
Command
QisLib_GetHiresImageTcp
Function:
int QisLib_GetHiresImageTcp(int DPI, const unsigned char** Buffer);
Inputs:
DPI: Resolution of output image in dots per inch.
Buffer: Address of a pointer of type char*. When the function returns successfully,
this pointer would point to the image data.
Return:
success: value > 0 indicating the size of the data buffer returned via Buffer.
failure: one of the following values :
Errors:
0: Internal error occurred or no data to return.
-1: QisLib has not been initialized.
-2: No GDSII or OASIS file has been opened.
-3: An internal error occurred while generating hi-res Tiff image.
-4: File open in progress, operation not permitted.
Description:
- This function behaves similar to QisLib_GetHiresImage except that it returns a
pointer to a buffer with the Tiff image bytes instead of writing to a Tiff file.
- If the return code is greater than 0, the user can access the image data via
Buffer. The return code indicates the size of the image data, Buffer, in bytes.
- If the file open operation needs to be cancelled, call QisLib_Stop. To be able to
do so, QisLib_SetProcessEvents must be on. Also, on Unix/Linux, the program's
application context must be passed to QisLib_InitLib.
Example:
...
char* ImageDataPtr;
int Return = QisLib_GetHiresImageTcp(25400000,&ImageDataPtr);
if(Return > 0)
{
FunctionToWriteTiffFile(Return,ImageDataPtr);
}
...
References:QisLib_GetHiresImage QisLib_SetProcessEvents QisLib_Stop |