MontageBvr Class

A MontageBvr is an object that represents a montage behavior. 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 image behavior 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 method.

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.

For more information about behaviors, see the Behavior class.

For relevant methods and fields from the Statics class, see the following topics.

MontageBvr Methods

render Creates an image behavior that consists of a composite of all images in the montage behavior.

newUninitBvr Enables you to refer to a MontageBvr behavior before that behavior has been defined.

render

MontageBvr Class

Creates an image behavior that consists of a composite of all images in the montage behavior.

Syntax

public ImageBvr render( )

Return Value

Returns the ImageBvr object.

Remarks

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 method. If two images have the same depth, they are layered on top of each other 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.

newUninitBvr

MontageBvr Class

Enables you to refer to a MontageBvr behavior before that behavior has been defined. With this method you can create the behavior and use it in the definition of other behaviors, but not actually define its contents until some later point. (This is accomplished with the init method, which is available on all behaviors.) The system generates a run-time error if you initialize a non-uninitialized behavior, initialize an uninitialized behavior that has already been initialized, or run an initialized behavior that has not yet been initialized.

Syntax

public static MontageBvr newUninitBvr( );

Return Value

Returns the MontageBvr object.