quicktime.app.image
Interface DynamicImage

All Superinterfaces:

Compositable, ImageSpec

All Known Implementing Classes:

CompositableEffect, DSequenceFromMemory, MoviePresenter, QTEffectPresenter, QTImageDrawer, SWCompositor, UIElement

Deprecated. since QTJava 6.1

public interface DynamicImage

extends Compositable

This class enables members of SWCompositors that present an image which changes to explicitly invalidate the TwoDSprite that is their presenter in the SWCompositor. This is a requirement of the SWCompositor due to efficiencies in the composit cycle.

See Also:

quicktime.app.display.SWCompositor

Method Summary

Invalidator	addedToCompositor(SWCompositor c, TwoDSprite s) Deprecated. since QTJava 6.1
void	removedFromCompositor(SWCompositor c) Deprecated. since QTJava 6.1

Methods inherited from interface quicktime.app.image.Compositable

getGraphicsMode, setGraphicsMode

Methods inherited from interface quicktime.app.image.ImageSpec

getDescription, getImage

Method Detail

addedToCompositor

public Invalidator addedToCompositor(SWCompositor c,
                                     TwoDSprite s)
                              throws QTException

Deprecated. since QTJava 6.1

Returns an object that invalidates a sprite. When a DynamicImage is a member of a SWompositor and the DynamicImage presents a changing image (for example a movie), the TwoDSprite that presents that image in the SWCompositor must be invalidated so that it will redraw the Sprites image in the next composit cycle. The Invalidator object is used to perform this function by the SWCompositor if the object itself cannot perform the invalidation. Can return null if the DynamicImage does not require the SWCompositor to invalidate it (or the object is in a state where its image won't change).

The Invalidators provided with objects that implement the DynamicImage interface will execute at the scale and period of the Compositor when they are created.

Parameters:

c - the Compositor in which the DynamicImage is a member

s - the TwoDSprite that is presenting the DynamicImage's image in the Compositor. This is the sprite that must be invalidated.

Returns:

an Invalidator or null if invalidation is not required

QTException

See Also:

quicktime.app.display.SWCompositor

removedFromCompositor

public void removedFromCompositor(SWCompositor c)
                           throws QTException

Deprecated. since QTJava 6.1

When a dynamic image class is removed from a SWCompositor this method is called to allow the class to cleanup any of the invalidation processes it had established in the addedToCompositor call.

Parameters:

c - the SWCompositor it is being removed from

QTException