ClipHelper.WriteClipToStream method

This method writes the clip to the specified memory stream. The stream pointer is at the end of the stream upon return from this method. On input, the stream must either be empty or TIFF or JPEG formatted. The clip is JPEG formatted if you requested JPEG compression (ClipCompressionMethod.cpmJPEG) and for all other compressions, it is TIFF formatted.

NOTE: Do not change the stream pointer while building a multi-frame TIFF to avoid losing frames or corrupting the stream.

When writing a TIFF formatted clip to an empty stream, a standard TIFF header is first written followed by the clip itself. When writing a TIFF formatted clip to a stream that already has a TIFF formatted image, the method appends the clip that is currently being taken. To avoid losing frames or corrupting the stream, do not change the stream pointer while building a multi-frame TIFF.

When writing a JPEG formatted clip, the stream must be empty or an exception will result.

This method works very well with the unmanaged ADODB.Stream class, which supports methods for saving the stream to a disk file. Be sure to open the stream in binary mode. For more information, see the MSDN documentation.

Using a ClipRegion as input allows the solution program to reuse the clip attributes defined for the current sheet in the ScanTools Plus application definition while customizing only the location and size of the form areas to clip.

Typical use case is creating multi-page TIFF images for each document. The solution creates a stream during the FormIdentified event, with a check for SheetNumber=1 which implies the start of a new document, performs clipping during the Clip event via WriteClipToStream and saves the stream to a file during the DocComplete event. If you reject the document, you should appropriately clean up the memory stream.

Valid

See ScanEventArgs and ScanningManager Events Valid Combinations.

IDL

HRESULT WriteClipToStream(

[in] ClipRegion* ClipRegion,  

[in] IStream* Stream); 

Input Parameters

See also

ClipHelper.WriteClipToStream2 method

ClipHelper.WriteClipToStream3 method

ClipHelper.WriteClipToStream4 method

Clip.WriteToStream method

Capture Image Clips under Solution Control