DirectAnimation Animated Header --DAMontage Class DirectAnimation Animated Header --DAMontage Class* Microsoft DirectAnimation SDK
*Index  *Topic Contents
*Previous Topic: DAMicrophone Class
*Next Topic: DANumber Class

DAMontage Class


A DAMontage object represents a montage that can be animated. A montage is a stack of images in which each image has an explicit depth. Images with larger Z-values are always in front of images with smaller z-values. Rendering a montage creates a new DAImage that is a composite of the images in the montage. The composite is created by overlaying the montage's images by order of depth and applying the same overlay rules as defined by the Overlay function in the DAStatics class.

Because the depth of an image in a montage can vary over time, rendering the montage at different points in time can produce different images in different orders.

This class inherits from the DABehavior class.

DAMontage Functions

bullet1.gifRender


Render

DAMontage Class

Creates a DAImage object that consists of a composite of all images in the DAMontage object. The composite is created by overlaying the montage's images in order of Z-values, with the largest Z-value on top, and applying the same overlay rules as defined by the Overlay function in the DAImage class. If two images have the same depth, they are overlayed in the order in which they were added to the montage. The bounding box of a rendered montage is simply the union of the bounding boxes of all the images comprising that montage.

montageObj.Render

Return Values

Returns the DAImage object.

Relevant Functions from the DAStatics Class

The following functions are defined in the DAStatics class and are most relevant to objects of type DAMontage.

lib.ImageMontageAnim(image, depth)

lib.ImageMontage(image, depth)

lib.UnionMontage(m1, m2)

Relevant Properties from the DAStatics Class

The following properties are defined in the DAStatics class and are most relevant to objects of type DAMontage.

lib.EmptyMontage

© 1998 Microsoft Corporation. All rights reserved. Terms of Use.

*Top of Page