All Packages  Class Hierarchy  This Package  Previous  Next  Index

Class quicktime.app.image.QTEffectPresenter

java.lang.Object
   |
   +----quicktime.app.image.ImagePresenter
           |
           +----quicktime.app.image.QTEffectPresenter

public class QTEffectPresenter
extends ImagePresenter
implements DynamicImage
The QTEffectPresenter is used to present typically a QTFilter or QTTransition as a member of a SWCompositor. It will create an Invalidator based on whether the effect is a single or multi-framed effect and the Invalidator will redraw the effect based on the effect's current isRedrawing value. If the effect is redrawn then the TwoDSprite that is presenting the effect in the SWCompositor will be invalidated to update the image it is presenting.

See Also:
SWCompositor

Constructor Index

 o QTEffectPresenter(QTEffect)
Create a QTEffectPresenter from the supplied effect.
 o QTEffectPresenter(QTEffect, QDGraphics)
Create a QTEffectPresenter from the supplied effect.

Method Index

 o addedToCompositor(SWCompositor, TwoDSprite)
Returns an object that invalidates a sprite.
 o getEffect()
Returns the effect that the QTEffectPresenter is presenting.
 o redraw(Region)
QTCanvas calls this method when the client should redraw itself.
 o removedFromCompositor(SWCompositor)
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.

Constructors

 o QTEffectPresenter
 public QTEffectPresenter(QTEffect ef) throws QTException
Create a QTEffectPresenter from the supplied effect. The effect will be rendered into a default offscreen QDGraphics and the pixel data of the QDGraphics buffer becomes the image data that this presenter presents.

Parameters:
ef - the effect that is rendered
 o QTEffectPresenter
 public QTEffectPresenter(QTEffect ef,
                          QDGraphics g) throws QTException
Create a QTEffectPresenter from the supplied effect. The effect will be rendered into the supplied offscreen QDGraphics and the pixel data of the QDGraphics buffer becomes the image data that this presenter presents.

Parameters:
ef - the effect that is rendered
g - the offscreen QDGraphics that the effect is rendered into.

Methods

 o redraw
 public void redraw(Region invalidRgn) throws QTException
QTCanvas calls this method when the client should redraw itself. If the canvas is able to discern that only a part of the client's drawing area needs to be redrawn - then this area shall be passed in using the invalidRgn. Otherwise this will be null in which case the client should redraw itself entirely.

Parameters:
invalidRgn - the invalidRgn that the client should redraw
Overrides:
redraw in class ImagePresenter
 o getEffect
 public QTEffect getEffect()
Returns the effect that the QTEffectPresenter is presenting.

Returns:
a QTEffect class
 o addedToCompositor
 public Invalidator addedToCompositor(SWCompositor c,
                                      TwoDSprite s)
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
See Also:
SWCompositor
 o removedFromCompositor
 public void removedFromCompositor(SWCompositor c)
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

All Packages  Class Hierarchy  This Package  Previous  Next  Index