quicktime.app.image
Class QTEffectPresenter

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

All Implemented Interfaces:

Compositable, Drawable, DrawingNotifier, DynamicImage, ImageSettable, ImageSpec, Listener, QTDrawable, Transformable

Deprecated. since QTJava 6.1

public class QTEffectPresenter

extends ImagePresenter

implements DynamicImage, DrawingNotifier

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:

quicktime.app.display.SWCompositor

Constructor Summary

QTEffectPresenter(QTEffect ef)
Deprecated. since QTJava 6.1

QTEffectPresenter(QTEffect ef, QDGraphics g)
Deprecated. since QTJava 6.1

Method Summary

void	addDrawingListener(DrawingListener listener) Deprecated. since QTJava 6.1
Invalidator	addedToCompositor(SWCompositor c, TwoDSprite s) Deprecated. since QTJava 6.1
void	doTransition() Deprecated. since QTJava 6.1
QTEffect	getEffect() Deprecated. since QTJava 6.1
void	redraw(Region invalidRgn) Deprecated. since QTJava 6.1
void	removedFromCompositor(SWCompositor c) Deprecated. since QTJava 6.1
void	removeDrawingListener(DrawingListener listener) Deprecated. since QTJava 6.1

Methods inherited from class quicktime.app.image.ImagePresenter

addedTo, doDraw, fromFile, fromGraphicsImporter, fromGraphicsImporterDrawer, fromGWorld, fromGWorld, fromImageSequence, fromImageSpec, fromPict, fromQTImage, getClip, getDescription, getDisplayBounds, getDSequence, getGraphicsMode, getGWorld, getImage, getInitialSize, getMatrix, getOriginalSize, isRedrawOptimised, removedFrom, removeImageData, setClip, setDisplayBounds, setGraphicsMode, setGWorld, setImageData, setImageData, setLocation, setMatrix, setRedrawOptimised, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface quicktime.app.image.Compositable

getGraphicsMode, setGraphicsMode

Methods inherited from interface quicktime.app.image.ImageSpec

getDescription, getImage

Constructor Detail

QTEffectPresenter

public QTEffectPresenter(QTEffect ef)
                  throws QTException

Deprecated. since QTJava 6.1

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

QTEffectPresenter

public QTEffectPresenter(QTEffect ef,
                         QDGraphics g)
                  throws QTException

Deprecated. since QTJava 6.1

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.

Method Detail

redraw

public void redraw(Region invalidRgn)
            throws QTException

Deprecated. since QTJava 6.1

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.

Specified by:

redraw in interface Drawable

Overrides:

redraw in class ImagePresenter

Parameters:

invalidRgn - the invalidRgn that the client should redraw

QTException

getEffect

public QTEffect getEffect()

Deprecated. since QTJava 6.1

Returns the effect that the QTEffectPresenter is presenting.

Returns:

a QTEffect class

doTransition

public void doTransition()
                  throws QTException

Deprecated. since QTJava 6.1

If the effect being presented by this Presenter is a QTTransition then this call will run the transition. If not then nothing will happen.

QTException

addedToCompositor

public Invalidator addedToCompositor(SWCompositor c,
                                     TwoDSprite s)

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.

Specified by:

addedToCompositor in interface DynamicImage

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:

quicktime.app.display.SWCompositor

removedFromCompositor

public void removedFromCompositor(SWCompositor c)

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.

Specified by:

removedFromCompositor in interface DynamicImage

Parameters:

c - the SWCompositor it is being removed from

addDrawingListener

public void addDrawingListener(DrawingListener listener)

Deprecated. since QTJava 6.1

Registers an object as a listener of the Compositor. The object will receive notification when the Compositor draws a frame

Specified by:

addDrawingListener in interface DrawingNotifier

removeDrawingListener

public void removeDrawingListener(DrawingListener listener)

Deprecated. since QTJava 6.1

Removes an object that is a listener of the Compositor. The object will no longer receive notification when the Compositor draws a frame

Specified by:

removeDrawingListener in interface DrawingNotifier