All Packages Class Hierarchy This Package Previous Next Index
Class quicktime.app.players.MoviePlayer
java.lang.Object
|
+----quicktime.app.players.MoviePlayer
- public class MoviePlayer
- extends Object
- implements QTDrawable, Playable, AudioSpec
The MoviePlayer class allows your application to display, play and control any
QuickTime movie. The MoviePlayer
object works with the QTCanvas to be displayed in a Java AWT Container.
- See Also:
- QTCanvas, Movie
-
MoviePlayer(Movie)
- This constructor creates a MoviePlayer object given a QuickTime Movie object.
-
addedTo(Object)
- This method is called by the specified object when the instance of
the class that implements this interface is added to the object
that is the source of the interest.
-
getClip()
- This method allows you to obtain information describing a MoviePlayer's clipping regions.
-
getDisplayBounds()
- This method is called automatically via the QTCanvas object associated with
this client to set the boundary of the movie.
-
getDuration()
- Returns the duration of the media attached to the player.
-
getGWorld()
- QTCanvas calls this method to get the destination QDGraphics of its client.
-
getInitialSize()
- This method returns the original size before the transformations
specified in the returned matrix are applied.
-
getMatrix()
- This will return the client's current display transformations
-
getMovie()
- This allows you to access the contained movie controller.
-
getRate()
- Returns the current rate of the player.
-
getScale()
- Returns the time scale of the player - how many ticks per second.
-
getTime()
- Returns the current time value of the object.
-
getTimeBase()
- Returns the TimeBase of the media attached to the player.
-
getVolume()
- Returns the volume setting (0 is silent, 1 is unity gain).
-
isMuted()
- Returns the current mute status.
-
redraw(Region)
- QTCanvas calls this method when the client should redraw itself.
-
removedFrom(Object)
- This method is called by the specified object when the instance of
the class that implements this interface is removed from the object
that is the source of the interest.
-
setClip(Region)
- This method allows you to set a MoviePlayer's clipping region.
-
setDisplayBounds(QDRect)
- This method is called automatically via the QTCanvas object associated with
this client to set the boundary of the movie.
-
setGWorld(QDGraphics)
- QTCanvas calls this method to give the client the QDGraphics object it should
use to do its drawing.
-
setLocation(int, int)
- A convenience method to set the position of a QTDrawable object.
-
setMatrix(Matrix)
- This method sets the current matrix of the Transformable object to
the new matrix.
-
setMuted(boolean)
- Allows the muting of the specific channel.
-
setRate(float)
- Sets the player to the playback rate.
-
setTime(int)
- Sets the player to the time specified.
-
setVolume(float)
- Sets the volume.
MoviePlayer
public MoviePlayer(Movie mov) throws StdQTException
- This constructor creates a MoviePlayer object given a QuickTime Movie object.
- Parameters:
- mov - a Movie object
getMovie
public Movie getMovie()
- This allows you to access the contained movie controller.
addedTo
public void addedTo(Object interest)
- This method is called by the specified object when the instance of
the class that implements this interface is added to the object
that is the source of the interest.
- Parameters:
- interest - the object that is to be the source of interest for the
the object that implements this interface.
removedFrom
public void removedFrom(Object interest)
- This method is called by the specified object when the instance of
the class that implements this interface is removed from the object
that is the source of the interest.
- Parameters:
- interest - the object that was the source of interest for the
the object that implements this interface.
getGWorld
public QDGraphics getGWorld() throws StdQTException
- QTCanvas calls this method to get the destination QDGraphics of its client.
- Returns:
- a QDGraphics object or null
setGWorld
public synchronized void setGWorld(QDGraphics cgp) throws StdQTException
- QTCanvas calls this method to give the client the QDGraphics object it should
use to do its drawing. If the incoming QDGraphics is the QDGraphics.scratch then
the drawable will not be visible and can disable itself.
If a client is unable to set the graphics world it should throw an exception.
- Parameters:
- cgp - a QDGraphics object
getInitialSize
public Dimension getInitialSize() throws QTException
- This method returns the original size before the transformations
specified in the returned matrix are applied.
getMatrix
public Matrix getMatrix() throws StdQTException
- This will return the client's current display transformations
- Returns:
- the display transformations of the client
setMatrix
public void setMatrix(Matrix matrix) throws QTException
- This method sets the current matrix of the Transformable object to
the new matrix.
redraw
public final synchronized 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
setDisplayBounds
public synchronized void setDisplayBounds(QDRect bounds) throws StdQTException
- This method is called automatically via the QTCanvas object associated with
this client to set the boundary of the movie.
- Parameters:
- bounds - a QDRect object describing the boundary
setLocation
public void setLocation(int x,
int y) throws QTException
- A convenience method to set the position of a QTDrawable object.
- Parameters:
- x - the new x location
- y - the new y location
getDisplayBounds
public QDRect getDisplayBounds() throws StdQTException
- This method is called automatically via the QTCanvas object associated with
this client to set the boundary of the movie.
- Parameters:
- bounds - a QDRect object describing the boundary
setClip
public void setClip(Region theClip) throws QTException
- This method allows you to set a MoviePlayer's clipping region.
- Parameters:
- theClip - a Region that defines the player's clipping region.
getClip
public Region getClip() throws QTException
- This method allows you to obtain information describing a MoviePlayer's clipping regions.
- Returns:
- the clipping region of the entire MoviePlayer object
setTime
public void setTime(int time) throws StdQTException
- Sets the player to the time specified. This time value at this level
is a totally arbitrary value - what time that means in "real time" is
determined by the implementor of the interface, typically the scale value
will determine what a "real" time of 1 second is.
- Parameters:
- time - the new time value
getTime
public int getTime() throws StdQTException
- Returns the current time value of the object.
- Returns:
- the current time.
getDuration
public int getDuration() throws StdQTException
- Returns the duration of the media attached to the player. If
the player has no media, or does not know the duration of its media
it can return the constant kDurationUnknown.
- Returns:
- the media duration.
getTimeBase
public TimeBase getTimeBase() throws QTException
- Returns the TimeBase of the media attached to the player.
- Returns:
- the players TimeBase.
setRate
public void setRate(float rate) throws StdQTException
- Sets the player to the playback rate. Typically a rate of zero will
mean that the player is stopped, a positive value that the player
is playing forwards, a negative value that the player is playing backwards.
- Parameters:
- rate - the new playback rate.
getRate
public float getRate() throws StdQTException
- Returns the current rate of the player.
- Returns:
- the playback rate
getScale
public int getScale() throws QTException
- Returns the time scale of the player - how many ticks per second.
- Returns:
- the current scale.
getVolume
public float getVolume() throws QTException
- Returns the volume setting (0 is silent, 1 is unity gain).
- Returns:
- a float
setVolume
public void setVolume(float val) throws QTException
- Sets the volume.
- Parameters:
- val - the new volume
isMuted
public boolean isMuted() throws QTException
- Returns the current mute status.
- Returns:
- a boolean
setMuted
public void setMuted(boolean flag) throws QTException
- Allows the muting of the specific channel. When unmuted the AudioSpec object will return
to its current volume setting.
- Parameters:
- flag - turn muting on - true or off - false.
All Packages Class Hierarchy This Package Previous Next Index