int IMAPI ImgXWriteBlock (hJob, nLines, lpBits, lpInfo)

This function writes a block of bits to the export file specified by hJob.

 

Parameter	Type	Description
hJob	HANDLE	Handle identifying job (from ImgXBeginWrite).
nLines	int	Number of raster lines in this output block.
lpBits	LPSTR	Pointer to block of bits to be output.
lpInfo	LPXINFO	Points to the XINFO struct which describes the current state of this export job.

 

Return Value

The return value is IMGX_OK if the bits are exported successfully; otherwise, the return value is an ImageMan/X error code.

Comments

The given bits are written subsequent to any bits currently output -- there is no facility for writing blocks of the image out of order. Note that since the output file may be a backwards format (i.e., last line in image appears first in file, as in Windows BMP & DIB formats), you have to be careful when writing out your image in sections -- make sure you begin with the correct row (first or last, depending on the image file format). You can do this by checking the lFlags parameter of the XINFO struct for the XF_BACKWARDS flag  if this flag is set, the strips should be written from bottom to top.

 

 

---

Copyright 2008 Data Techniques, Inc. All Rights Reserved