Rendering > VpeRenderPictureStream

[Professional Edition and above]

Identical to VpeRenderPicture(), but renders a picture from a memory stream.

void VpeRenderPictureStream(

VpeHandle hDoc,

VpeHandle hStream,

VpeCoord width,

VpeCoord height,

LPCTSTR identifier

)

VpeHandle hDoc

Document Handle

VpeHandle hStream

The handle of the stream where the picture is read from. The stream must have been created before by calling VpeCreateMemoryStream(), and of course it must have been initialized with valid image data.

VpeCoord width, height

Can be used to compute either the width or the height by setting one value to a numeric value whilst using VFREE for the other value. Usually you will set both values to VFREE.

LPCTSTR identifier

A name for the picture. The internal image cache uses this name to distinguish images. But the image cache also computes a CRC (checksum) of the image data, so you can also leave the identifier blank (NOT NULL!). However, we do recommend to use a name if possible, so the CRC is not the only factor.

Remarks:

If you wish to use one and the same image multiple times, always provide the same stream handle (and therefore of course the same stream) as well as the same identifier, when calling this method.