Rendering > RenderPictureStream

[Professional Edition and above]

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

method void VPE.RenderPictureStream(

TVPEStream stream,

VpeCoord Width,

VpeCoord Height,

string Identifier

)

TVPEStream stream

The stream-object where the picture is read from. The stream must have been created before by calling CreateMemoryStream(), 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.

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.

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.