|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object | +--quicktime.app.image.ImagePresenter | +--quicktime.app.players.MoviePresenter
The MoviePresenter is used to present typically a movie as a member of a SWCompositor. It will create an Invalidator to innvalidate its TwoDSprite that is presenting the movie in the SWCompositor when the movie redraws.
Outside of the use in the SWCompositor this Presenter also gives the ability to apply a GraphicsMode to the overall output of a movie and can be used also for easy manipulation and control of a movie's display characteristics, location and transformations. For example if you are moving a movie around the screen (for example bouncing it around) you will get better performance of the visual output using a MoviePresenter than doing these kinds of activities with a standard MoviePlayer presentation.
It uses the MovieDrawingComplete callback to either invalidate its presenting TwoDSprite or to redraw itself to the destination QDGraphics.
quicktime.app.display.SWCompositor
Field Summary | |
protected TwoDSprite |
spritePresenter
|
Fields inherited from interface quicktime.app.players.Playable |
kDurationUnknown |
Constructor Summary | |
MoviePresenter(Movie m)
Create a MoviePresenter with the supplied movie. |
|
MoviePresenter(Movie m,
QDGraphics g)
Create a MoviePresenter with the supplied movie. |
Method Summary | |
void |
addDrawingListener(DrawingListener listener)
Registers an object as a listener of the MoviePlayer. |
Invalidator |
addedToCompositor(SWCompositor c,
TwoDSprite s)
Returns an object that invalidates a sprite. |
int |
execute(Movie m)
Implements the execute method on the MovieDrawingComplete interface. |
int |
getDuration()
Returns the duration of the media attached to the player. |
Movie |
getMovie()
Return the movie that is being presented. |
QDGraphics |
getOffscreenBuffer()
Returns the offscreen buffer that the movie of the MoviePresenter is drawing into. |
float |
getRate()
Returns the current rate of the Timeable object. |
int |
getScale()
Returns the time scale of the player - how many ticks per second. |
int |
getTime()
Returns the current time value of the object. |
TimeBase |
getTimeBase()
Returns the current time base that provides the time foundation of this object. |
float |
getVolume()
Returns the volume setting (0 is silent, 1 is unity gain). |
boolean |
isMuted()
Returns the current mute status. |
boolean |
isPresenting()
Returns true if the MoviePresenter is presenting its movie to a destination QDGraphics. |
void |
movieChanged()
If an application requires the MoviePresenter to explicitly invalidate its TwoDSprite Presenter, or redraw its offscreen image due to some change in the Movie (other than normal playback of the Movie) then it should signify this by calling this method. |
void |
redraw(Region invalidRgn)
QTCanvas calls this method when the client should redraw itself. |
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. |
void |
removeDrawingListener(DrawingListener listener)
Removes an object that is a listener of the MoviePlayer. |
void |
setGWorld(QDGraphics cgp)
QTCanvas calls this method to give the client the QDGraphics object it should use to do its drawing. |
void |
setMuted(boolean flag)
Allows the muting of the specific channel. |
void |
setRate(float rate)
Sets the Timeable's playback rate. |
void |
setTime(int time)
Sets the player to the time specified. |
void |
setVolume(float val)
Sets the volume. |
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, 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 |
Field Detail |
protected TwoDSprite spritePresenter
Constructor Detail |
public MoviePresenter(Movie m) throws QTException
m
- the movie that is renderedpublic MoviePresenter(Movie m, QDGraphics g) throws QTException
m
- the movie that is renderedg
- the offscreen QDGraphics that the effect is rendered into.Method Detail |
public void setGWorld(QDGraphics cgp) throws QTException
setGWorld
in class ImagePresenter
cgp
- a QDGraphics objectpublic boolean isPresenting()
public int execute(Movie m)
The callback will be triggered as a result of a call to Movie.task and is fired whenever the Movie draws to its internal QDGraphics - the offscreen buffer that the presenter presents.
execute
in interface MovieDrawingComplete
m
- the Movie that is presented by this presenterpublic Movie getMovie()
public QDGraphics getOffscreenBuffer()
public void redraw(Region invalidRgn) throws QTException
redraw
in class ImagePresenter
invalidRgn
- the invalidRgn that the client should redrawpublic TimeBase getTimeBase() throws QTException
getTimeBase
in interface Timeable
public void setRate(float rate) throws QTException
setRate
in interface Timeable
rate
- the new playback rate.public float getRate() throws QTException
getRate
in interface Timeable
public void setTime(int time) throws QTException
setTime
in interface Playable
time
- the new time valuepublic int getTime() throws QTException
getTime
in interface Playable
public int getDuration() throws QTException
getDuration
in interface Playable
public int getScale() throws QTException
getScale
in interface Playable
public float getVolume() throws QTException
getVolume
in interface AudioSpec
public void setVolume(float val) throws QTException
setVolume
in interface AudioSpec
val
- the new volumepublic boolean isMuted() throws QTException
isMuted
in interface AudioSpec
public void setMuted(boolean flag) throws QTException
setMuted
in interface AudioSpec
flag
- turn muting on - true or off - false.public void movieChanged()
Thus a potential usage of this method is if the MoviePresenter is presenting a QuickTime VR movie that has no real time line, and has programatically changed some characteristic of the display of the Movie. In which case it needs to inform the MoviePresenter that the Movie has changed and it should do the appropriate invalidation or redraw.
public Invalidator addedToCompositor(SWCompositor c, TwoDSprite s) throws QTException
The Invalidators provided with objects that implement the DynamicImage interface will execute at the scale and period of the Compositor when they are created.
addedToCompositor
in interface DynamicImage
c
- the Compositor in which the DynamicImage is a members
- the TwoDSprite that is presenting the DynamicImage's image in
the Compositor. This is the sprite that must be invalidated.quicktime.app.display.SWCompositor
public void removedFromCompositor(SWCompositor c) throws QTException
removedFromCompositor
in interface DynamicImage
c
- the SWCompositor it is being removed frompublic void addDrawingListener(DrawingListener listener)
addDrawingListener
in interface DrawingNotifier
quicktime.app.display.DrawingNotifier
source
- the object that is to be the source of interest for the
the Listener object.public void removeDrawingListener(DrawingListener listener)
removeDrawingListener
in interface DrawingNotifier
quicktime.app.display.DrawingNotifier
source
- the object that is to be the source of interest for the
the Listener object.
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |