All Packages  Class Hierarchy  This Package  Previous  Next  Index

Class quicktime.std.qtcomponents.MovieImporter

java.lang.Object
   |
   +----quicktime.QTObject
           |
           +----quicktime.std.comp.ComponentIdentifier
                   |
                   +----quicktime.std.comp.Component
                           |
                           +----quicktime.std.qtcomponents.MovieImporter

public final class MovieImporter
extends Component
implements QuickTimeLib
Assists in importing movie data. The MovieImporter implements methods for a corresponding QuickTime ComponentInstance structure. Refer to Movie Data Exchange in QuickTime


Constructor Index

 o MovieImporter()
Opens the specified movie import component,'eat ', with any subType.
 o MovieImporter(ComponentIdentifier)
Given a component identifier it opens the specified component.
 o MovieImporter(DataRef, int)
This returns an appropriate instance of the MovieImporter for the DataRef object.
 o MovieImporter(DataRef, int, String)
This returns an appropriate instance of the MovieImporter for the DataRef object.
 o MovieImporter(int)
Opens the specified movie import component,'eat ', with the given subType.

Method Index

 o doUserDialog(QTFile)
Allows an application to request that your component display its user dialog box.
 o doUserDialog(QTHandleRef)
Specifies the use of.
 o fromDataRef(DataRef, Movie, Track, int, int)
Determines information revelant to the movie import component.
 o fromFile(QTFile, Movie, Track, int, int)
Allows the MovieToolbox to import data from a file using the movie import component.
 o fromHandle(QTHandleRef, Movie, Track, int, int)
Allows the MovieToolbox to import data from a handle using the movie import component.
 o fromTrack(Track)
Looks on the System scrap to find out if it can translate any of the track data into a movie.
 o getAuxiliaryDataType()
Determines the data type for the component.
 o getFileType()
Determines the file type for the component.
 o getImportSettingsFromAtomContainer()
Retrieves the current settings from the movie import component..
 o getMediaType()
Determines the media type of the component.
 o getMIMETypeList()
Returns a list of MIME types supported by the movie import component.
 o getSampleDescription()
Determines the sample description of the component.
 o removeProgressProc()
This method removes a MovieProgress callback for the MovieImporter.
 o setAuxiliaryData(QTHandleRef, int)
Specifies the handle and its type for the component.
 o setChunkSize(int)
Specifies the size to allocate for the component.
 o setDimensions(float, float)
Specifies the dimensions for the component.
 o setDuration(int)
Specifies the duration for the component.
 o setFromScrap(boolean)
Specifies the scrap for the component.
 o setImportSettingsFromAtomContainer(AtomContainer)
Sets the movie import componentŐs current configuration from the passed settings data.
 o setMediaFile(AliasHandle)
Allows an application to specify a media file that is to receive the imported movie data.
 o setOffsetAndLimit(int, int)
NO QT DOCUMENTATION.
 o setProgressProc(MovieProgress)
This method establishes a MovieProgress object for the MovieImporter that will be called for you by the Movie Toolbox whenever it has to do a lengthy movie import process with this MovieImporter

QuickTime::MovieImportSetProgressProc

 o setSampleDescription(SampleDescription, int)
Specifies the SampleDescription and media type for the component.
 o setSampleDuration(int, int)
Specifies the duration for the component.
 o validate(QTFile)
Determines the validity of the file to be imported.
 o validate(QTHandleRef)
Determines the validity of the data in the handle to be imported.

Constructors

 o MovieImporter
 public MovieImporter() throws QTException
Opens the specified movie import component,'eat ', with any subType.

QuickTime::OpenADefaultComponent

 o MovieImporter
 public MovieImporter(int subType) throws QTException
Opens the specified movie import component,'eat ', with the given subType.

QuickTime::OpenADefaultComponent

Parameters:
subType - The movie import component sub type
 o MovieImporter
 public MovieImporter(ComponentIdentifier comp) throws QTException
Given a component identifier it opens the specified component. The component type must be 'eat ' or an exception will be thrown as it is not a MovieImporter.

QuickTime::OpenAComponent

Parameters:
comp - the component identifier to open
 o MovieImporter
 public MovieImporter(DataRef dataRef,
                      int flags) throws StdQTException
This returns an appropriate instance of the MovieImporter for the DataRef object.

QuickTime::GetMovieImporterForDataRef()

Parameters:
dr - the DataRef from which the movie importer is made
flags - flags that control the kinds of importer components that are searched by this call
Returns:
an instance of the MovieImporter component
 o MovieImporter
 public MovieImporter(DataRef dataRef,
                      int flags,
                      String fileExt) throws QTException
This returns an appropriate instance of the MovieImporter for the DataRef object.

QuickTime::GetMovieImporterForDataRef()

Parameters:
dr - the DataRef from which the movie importer is made
flags - flags that control the kinds of importer components that are searched by this call
fileExt - file extension for the source of the data. This is useful to provide the importer as a guide for it to know about the data format.
Returns:
an instance of the MovieImporter component

Methods

 o fromTrack
 public static MovieImporter fromTrack(Track t) throws StdQTException
Looks on the System scrap to find out if it can translate any of the track data into a movie.

QuickTime::IsScrapMovie()

See Also:
isScrapMovie
 o fromFile
 public MovieImportInfo fromFile(QTFile fileIn,
                                 Movie theMovie,
                                 Track targetTrack,
                                 int atTime,
                                 int inFlags) throws QTException
Allows the MovieToolbox to import data from a file using the movie import component.

QuickTime::MovieImportFile

Parameters:
fileIn - Specifies the source file to the importing data.
theMovie - Specifies the movie to receive the data.
targetTrack - Specifies the track to receive the data, if to be recipent, then inFlags use movieImportMustUseTrack.
atTime - Specifies the start time of the movie time base to place the imported data.
inFlags - Specifies the control flags governing the operation.
Returns:
The results pertinent to the operation.
 o fromHandle
 public MovieImportInfo fromHandle(QTHandleRef dataRef,
                                   Movie theMovie,
                                   Track targetTrack,
                                   int atTime,
                                   int inFlags) throws QTException
Allows the MovieToolbox to import data from a handle using the movie import component.

QuickTime::MovieImportHandle

Parameters:
dataRef - Specifies the handle to the importing data.
theMovie - Specifies the movie to receive the data.
targetTrack - Specifies the track to receive the data, if to be recipent, then inFlags use movieImportMustUseTrack.
atTime - Specifies the start time of the movie time base to place the imported data.
inFlags - Specifies the control flags governing the operation.
Returns:
The results pertinent to the operation.
 o fromDataRef
 public MovieImportInfo fromDataRef(DataRef dataRef,
                                    Movie theMovie,
                                    Track targetTrack,
                                    int atTime,
                                    int inFlags) throws QTException
Determines information revelant to the movie import component. The info kept are the track used, time value added, and flags describing the operation.

QuickTime::MovieImportDataRef

Parameters:
dataRef - Specifies the data reference.
theMovie - Specifies the movie.
targetTrack - Specifies the track to receive the data, if to be recipent, then inFlags use movieImportMustUseTrack.
atTime - Specifies the start time of the movie time base.
inFlags - Specifies the flags in for the operation.
Returns:
The results returned from the query operation.
 o setSampleDuration
 public void setSampleDuration(int duration,
                               int scale) throws StdQTException
Specifies the duration for the component.

QuickTime::MovieImportSetSampleDuration

Parameters:
duration - Specifies the time base.
scale - Specifies the time base scale.
 o setSampleDescription
 public void setSampleDescription(SampleDescription desc,
                                  int mediaType) throws StdQTException
Specifies the SampleDescription and media type for the component.

QuickTime::MovieImportSetSampleDescription

Parameters:
desc - Specifies the sample description.
mediaType - Specifies the media type.
 o setMediaFile
 public void setMediaFile(AliasHandle alias) throws QTException
Allows an application to specify a media file that is to receive the imported movie data.

QuickTime::MovieImportSetMediaFile

Parameters:
alias - the media file that is to receive the imported movie data.
 o setDimensions
 public void setDimensions(float width,
                           float height) throws StdQTException
Specifies the dimensions for the component.

QuickTime::MovieImportSetDimensions

Parameters:
width - Specifies the width.
height - Specifies the height.
 o setChunkSize
 public void setChunkSize(int chunkSize) throws StdQTException
Specifies the size to allocate for the component.

QuickTime::MovieImportSetChunkSize

Parameters:
chunkSize - Specifies the size.
 o setProgressProc
 public void setProgressProc(MovieProgress mp) throws StdQTException
This method establishes a MovieProgress object for the MovieImporter that will be called for you by the Movie Toolbox whenever it has to do a lengthy movie import process with this MovieImporter

QuickTime::MovieImportSetProgressProc

Parameters:
mp - the MovieProgress object, or null for no progress object
 o removeProgressProc
 public void removeProgressProc() throws StdQTException
This method removes a MovieProgress callback for the MovieImporter.

QuickTime::MovieImportSetProgressProc

Parameters:
mp - the MovieProgress object, or null for no progress object
 o setAuxiliaryData
 public void setAuxiliaryData(QTHandleRef data,
                              int handleType) throws StdQTException
Specifies the handle and its type for the component.

QuickTime::MovieImportSetAuxiliaryData

Parameters:
data - Specifies the data handle.
handleType - Specifies the handle type.
 o setFromScrap
 public void setFromScrap(boolean fromScrap) throws StdQTException
Specifies the scrap for the component.

QuickTime::MovieImportSetFromScrap

Parameters:
fromScrap - Specifies weather to use the scrap manager.
 o doUserDialog
 public boolean doUserDialog(QTFile fileIn) throws QTException
Allows an application to request that your component display its user dialog box.

QuickTime::MovieImportDoUserDialog

Parameters:
fileIn - Specifies the source file.
Returns:
True, if the user canceled the operation, false otherwise.
 o doUserDialog
 public boolean doUserDialog(QTHandleRef theData) throws QTException
Specifies the use of.

QuickTime::MovieImportDoUserDialog

Parameters:
theData - Specifies the data handle.
Returns:
True, if the user canceled the operation, false otherwise.
 o setDuration
 public void setDuration(int duration) throws StdQTException
Specifies the duration for the component.

QuickTime::MovieImportSetDuration

Parameters:
duration - Specifies the time base duration.
 o getAuxiliaryDataType
 public int getAuxiliaryDataType() throws StdQTException
Determines the data type for the component.

QuickTime::MovieImportGetAuxiliaryDataType

Returns:
The handle type.
 o validate
 public boolean validate(QTFile fileIn) throws QTException
Determines the validity of the file to be imported.

QuickTime::MovieImportValidate

Parameters:
fileIn - Specifies the source file.
Returns:
True, if the handle data or file from stream is valid, otherwise false.
 o validate
 public boolean validate(QTHandleRef theData) throws QTException
Determines the validity of the data in the handle to be imported.

QuickTime::MovieImportValidate

Parameters:
theData - Specifies the data handle.
Returns:
True, if the handle data or file from stream is valid, otherwise false.
 o getFileType
 public int getFileType() throws StdQTException
Determines the file type for the component.

QuickTime::MovieImportGetFileType

Returns:
The file type.
 o getSampleDescription
 public SampleDescription getSampleDescription() throws StdQTException
Determines the sample description of the component.

QuickTime::MovieImportGetSampleDescription

Returns:
The sample description.
 o getMediaType
 public int getMediaType() throws StdQTException
Determines the media type of the component.

QuickTime::MovieImportGetSampleDescription

Returns:
The media type.
 o getMIMETypeList
 public AtomContainer getMIMETypeList() throws StdQTException
Returns a list of MIME types supported by the movie import component.

QuickTime::MovieImportGetMIMETypeList

Returns:
an AtomContainer that contains a list of MIME types
 o setOffsetAndLimit
 public void setOffsetAndLimit(int offset,
                               int limit) throws StdQTException
NO QT DOCUMENTATION.

QuickTime::MovieImportSetOffsetAndLimit

Parameters:
offset - the offset within the source data from which to start importing
limit - how many bytes from the offset to import.
 o setImportSettingsFromAtomContainer
 public void setImportSettingsFromAtomContainer(AtomContainer settings) throws StdQTException
Sets the movie import componentŐs current configuration from the passed settings data.

QuickTime::MovieImportSetSettingsFromAtomContainer

Parameters:
Contains - a QT atom container reference to the settings.
 o getImportSettingsFromAtomContainer
 public AtomContainer getImportSettingsFromAtomContainer() throws StdQTException
Retrieves the current settings from the movie import component..

QuickTime::MovieImportGetSettingsAsAtomContainer

Returns:
an AtomContainer with the current settings.

All Packages  Class Hierarchy  This Package  Previous  Next  Index