All Packages Class Hierarchy This Package Previous Next Index
Class quicktime.std.movies.media.DataRef
java.lang.Object
|
+----quicktime.QTObject
|
+----quicktime.util.QTHandleRef
|
+----quicktime.util.QTHandle
|
+----quicktime.std.movies.media.DataRef
- public final class DataRef
- extends QTHandle
- implements QuickTimeLib
The DataRef class implements the data reference structure of the Movie Toolbox.
-
DataRef(AliasHandle)
- This constructor creates a DataRef that represents an AliasHandle.
-
DataRef(QTFile)
- This constructor creates a DataRef that represents a QTFile.
-
DataRef(QTHandleRef)
- This constructor creates a DataRef that references the given QTHandle
so the dataRefType is a handle DataRef ('hndl').
-
DataRef(QTHandleRef, int, String)
- This constructor creates a DataRef that references the given QTHandle
so the dataRefType is a handle DataRef ('hndl').
-
DataRef(String)
- This constructor creates a DataRef that represents any URL.
-
fromMedia(Media, int)
- This method returns a copy of a specified data reference.
-
fromMovie(Movie)
- This method allows your application to get the default data reference for the movie.
-
fromSequenceGrabber(SequenceGrabber)
- Determines the data reference that is currently assigned to a sequence grabber component.
-
getAttributes()
- This method returns the data reference attributes.
-
getType()
- This method returns the data reference type.
-
getUniversalResourceLocator()
-
Returns a string representating the location of this object.
DataRef
public DataRef(String url) throws QTException
- This constructor creates a DataRef that represents any URL.
If there is no DataHandler for this URL an invalidDataRef exception is thrown
- Parameters:
- url - the URL that is used to create a DataReference.
DataRef
public DataRef(QTFile f) throws QTException
- This constructor creates a DataRef that represents a QTFile.
- Parameters:
- file - the QTFile that is used to create a DataReference.
DataRef
public DataRef(AliasHandle a) throws IOException, QTException
- This constructor creates a DataRef that represents an AliasHandle.
- Parameters:
- a - the AliasHandle that is reference by this DataRef.
DataRef
public DataRef(QTHandleRef handle) throws QTException
- This constructor creates a DataRef that references the given QTHandle
so the dataRefType is a handle DataRef ('hndl').
- Parameters:
- handle - Specifies the data (a handle) that this reference should point to.
DataRef
public DataRef(QTHandleRef handle,
int hintFlag,
String hintString) throws QTException
- This constructor creates a DataRef that references the given QTHandle
so the dataRefType is a handle DataRef ('hndl'). Hints can be given to
QuickTime (and should if at all possible) about the format of the data
that is contained within the handle. Hints can take one of three forms
- MIME Type -> kDataRefMimeTypeTag
- MacOS File Type -> kDataRefQTFileTypeTag
- File extension -> kDataRefFileExtensionTag
The preferred usage is to pass in either the MacOS File Type (which will also work on non-MacOS platforms)
or the MIME type information. The File extension is a more arbitrary indicator and should be the least
referred to. If the hint information is not specified a paramErr exception is thrown
- Parameters:
- handle - Specifies the data (a handle) that this reference should point to.
- hintFlag - describes the hint data that is used
- hintString - contains the hint information
fromMovie
public static DataRef fromMovie(Movie m) throws QTException
- This method allows your application to get the default data reference for the movie.
QuickTime::GetMovieDefaultDataRef()
- Returns:
- a DataRef object specifiying the default data reference for the movie.
- See Also:
- getDefaultDataRef
fromSequenceGrabber
public static DataRef fromSequenceGrabber(SequenceGrabber sg) throws StdQTException
- Determines the data reference that is currently assigned to a sequence grabber component.
QuickTime::SGGetDataRef
- Returns:
- the dataRef
- See Also:
- getDataRef
fromMedia
public static DataRef fromMedia(Media m,
int index) throws QTException
- This method returns a copy of a specified data reference.
QuickTime::GetMediaDataRef()
- Parameters:
- index - Identifies the data reference.
- Returns:
- a copy of a specified data reference.
- See Also:
- getDataRef
getType
public int getType()
- This method returns the data reference type.
- Returns:
- the data reference type.
getAttributes
public int getAttributes()
- This method returns the data reference attributes.
- Returns:
- the data reference attributes.
getUniversalResourceLocator
public String getUniversalResourceLocator() throws QTException
- Returns a string representating the location of this object. If the DataRef points
to a File or URL the path will be printed, if not then an empty string is returned.
All Packages Class Hierarchy This Package Previous Next Index