<< Click to Display Table of Contents >> Navigation:  Picture Functions > PictureStream

[Professional Edition and above]

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

method VpeCoord VPE.PictureStream(

TVPEStream stream,

VpeCoord Left,

VpeCoord Top,

VpeCoord Right,

VpeCoord Bottom,

string Identifier

)

TVPEStream stream

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

VpeCoord Left, Top, Right, Bottom

position and dimensions

string 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 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.