Description

This method allows the client to read an array of frames from a sequence, and place them in particular frames of an existing image. For example, the client may wish to read frames 6,10, and 12 of a sequence file, and place them in Frame locations 3,9,and 11 of the image, respectively. The two SAFEARRAY's are matched descriptor to descriptor, for example, the first array member of the stream_range array will be placed into the first array member of the image_range.

Return Type

None  

Syntax

object.ReadFrames image_range, stream_range, Flags, Destination

The ReadFrames Method syntax has these parts:

PartDescription
objectAn expression evaluating to an object of type McStream.
image_rangeRequired. A Variant value.
stream_rangeRequired. A Variant value.
FlagsRequired. A mclfLoadFlags enumeration, as described in settings.
DestinationRequired. A McImage object.

Settings

The settings for Flags are:

ConstantValueDescription
 mclfNoFlags0

Do not alter image data. This may result in a failure if the Frames are of different sizes.

 mclfStretchStreamToImage1

Resize the read frame to equal the McImage size.

 mclfCropStreamToImage2

Cut (with 0,0 coord being upper left corner) the read frame to equal the McImage size. This may result in empty regions in the right and bottom margins.