Picture Functions > VpePictureStream

[Professional Edition and above]

Identical to VpePicture(), but imports a picture from a memory stream.

VpeCoord VpePictureStream(

VpeHandle hDoc,

VpeHandle hStream,

VpeCoord x,

VpeCoord y,

VpeCoord x2,

VpeCoord y2,

LPCTSTR identifier

)

VpeHandle hDoc

Document Handle

VpeHandle hStream

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

VpeCoord x, y, x2, y2

position and dimensions

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.

Returns:

the bottom coordinate (y2) of the inserted image

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.

VPE offers several methods to attach an object's position to margins and relative to the position of previously inserted objects. In addition Text, Rich Text and Picture objects are able to compute their dimensions automatically depending on their visual content.
For details please see "Dynamic Positioning" in the Programmer's Manual.