Clip.WriteToStream method

This method writes the clip to the specified 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.

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.

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 and saves the stream to a file during the DocComplete event. If you reject the document, clean up the memory stream as appropriate

IDL

HRESULT WriteToStream([in] IStream* pStream);

Input Parameters

See also

Clip.TransformOnWrite property