All Packages  Class Hierarchy  This Package  Previous  Next  Index

Class quicktime.io.QTFile

java.lang.Object
   |
   +----java.io.File
           |
           +----quicktime.io.QTFile

public final class QTFile

extends File

implements QuickTimeLib

kDeletePermission

Permission flags used to test security accessibility of a file path

kReadPermission

Permission flags used to test security accessibility of a file path

kStandardQTFileTypes

Standard types used in get file.

kWritePermission

Permission flags used to test security accessibility of a file path

QTFile(File)

Used to return a QTFile object from a Java file object.

QTFile(String)

Used to return a QTFile object from a full path specification

checkSecurity(String, int)

This method will assume that the incoming path is a full path specification for a file and will check the security manager settings to see if the current security settings allow this file to be read from or written to.

convertToMovieFile(QTFile, int, int)

This method takes a specified file and converts it to a movie file.

convertToMovieFile(QTFile, int, int, MovieImporter)

This method takes a specified file and converts it to a movie file.

convertToMovieFile(QTFile, int, int, MovieImporter, MovieProgress)

This method takes a specified file and converts it to a movie file.

createMovieFile(int, int)

Creates a file as specified by this QTFile.

createShortcutMovieFile(int, int, int, DataRef)

Creates a short cut movie file as specified by this QTFile.

delete()

This method deletes a movie file.

fromGraphicsImporter(GraphicsImporter)

Determines the file that the graphics resides in.

fromGraphicsImporter(GraphicsImporter, QTFile, String)

Presents a dialog box letting the user save an image in a foreign file format.

fromSequenceGrabber(SequenceGrabber)

Allows you to determine the movie file that is currently assigned to a sequence grabber component.

getFSSpec(boolean, int)

Returns the byte array containing the fsspec.

newAlias(boolean)

Creates an alias record that describes the specified target.

resolveAlias(AliasHandle)

This method will take an alias and will resolve it, returning the full path name of the resolved file.

resolveAlias(boolean)

Returns the target FSSpec passed in

QuickTime::ResolveAliasFile

standardGetFilePreview(int[])

Present a standard open file panel to the user to retrieve a file.

 public static final int kStandardQTFileTypes[]

Standard types used in get file.

 public static final int kReadPermission

Permission flags used to test security accessibility of a file path

 public static final int kWritePermission

Permission flags used to test security accessibility of a file path

 public static final int kDeletePermission

Permission flags used to test security accessibility of a file path

 public QTFile(String pathName)

Used to return a QTFile object from a full path specification

Parameters:

pathName - the full path name of the file

 public QTFile(File file)

Used to return a QTFile object from a Java file object.

Parameters:

file - a java File object

 public static QTFile fromGraphicsImporter(GraphicsImporter g) throws QTException

Determines the file that the graphics resides in.

QuickTime::GraphicsImportGetDataFile

Returns:

The file that contains the graphics data.

See Also:

getDataFile

 public static GraphicsImporterInfo fromGraphicsImporter(GraphicsImporter g,
                                                         QTFile inDefaultSpec,
                                                         String prompt) throws QTException

Presents a dialog box letting the user save an image in a foreign file format.

QuickTime::GraphicsImportDoExportImageFileDialog

Parameters:

inDefaultSpec - suggests the default name for the file. If you do not want to suggest a default name, pass null.

prompt - A prompt that appears in the standard put dialog box; it may be nil, in which case a default string is used.

See Also:

doExportImageFileDialog

 public static QTFile fromSequenceGrabber(SequenceGrabber s) throws QTException

Allows you to determine the movie file that is currently assigned to a sequence grabber component.

QuickTime::SGGetDataOutput

Returns:

The QTFile movie file.

See Also:

getDataOutputFile

 public static void checkSecurity(String fileName,
                                  int permission)

This method will assume that the incoming path is a full path specification for a file and will check the security manager settings to see if the current security settings allow this file to be read from or written to. If the requested security access is dissallowed a SecurityException is thrown.

Parameters:

fileName - a full path file specification path

permission - the requested permission.

 public static QTFile resolveAlias(AliasHandle alias) throws QTException

This method will take an alias and will resolve it, returning the full path name of the resolved file. You must have read permission to the resultant file path or a SecurityException will be thrown.

QuickTime::ResolveAlias

Parameters:

alias - the alias to resolve

Returns:

the QTFile object of the resolved alias

 public static QTFile standardGetFilePreview(int fileTypes[]) throws QTException

Present a standard open file panel to the user to retrieve a file.

QuickTime::StandardGetFilePreview()

Parameters:

fileTypes - the particular file types you want the user to see. No fileTypes assumes all files. Max of 4.

Returns:

The file object.

 public final byte[] getFSSpec(boolean fileExists,
                               int permissions) throws QTIOException

Returns the byte array containing the fsspec.

Parameters:

flag - if true then the file must exist or a fnfError is thrown otherwise it is not required that the file exist

permissions - you must specify whether the file will be reading or writing.

Returns:

the byte array

 public void convertToMovieFile(QTFile outputFile,
                                int fCreator,
                                int inFlags) throws QTException

This method takes a specified file and converts it to a movie file.

QuickTime::ConvertFileToMovieFile()

Parameters:

outputFie - the destination movie file.

fCreator - Specifies the creator value for the file if it is a new one.

inFlags - Controls movie file conversion flags.

 public void convertToMovieFile(QTFile outputFile,
                                int fCreator,
                                int inFlags,
                                MovieImporter mic) throws QTException

This method takes a specified file and converts it to a movie file. The specified files must be full paths or a fnfErr exception will be thrown

QuickTime::ConvertFileToMovieFile()

Parameters:

outputFile - the destination movie file.

fCreator - Specifies the creator value for the file if it is a new one.

inFlags - Controls movie file conversion flags.

mec - Specifies the movie export component if used for translation, null otherwise.

 public void convertToMovieFile(QTFile outputFile,
                                int fCreator,
                                int flags,
                                MovieImporter mic,
                                MovieProgress mp) throws QTException

This method takes a specified file and converts it to a movie file. The specified files must be full paths or a fnfErr exception will be thrown

QuickTime::ConvertFileToMovieFile()

Parameters:

outputFile - the destination movie file.

fCreator - Specifies the creator value for the file if it is a new one.

flags - Controls movie file conversion flags.

mec - Specifies the movie export component if used for translation, null otherwise.

mp - Specifies the movie progress object or null otherwise.

 public void createMovieFile(int fCreator,
                             int flags) throws QTIOException

Creates a file as specified by this QTFile. This call will not open the created movie file.

QuickTime::CreateMovieFile()

Parameters:

pathName - specifies the complete pathName of the file that is to be created.

fCreator - Specifies the creator of the file.

flags - Specifies the behaviour when creating the file.

 public void createShortcutMovieFile(int creator,
                                     int scriptTag,
                                     int createMovieFileFlags,
                                     DataRef targetDataRef) throws QTException

Creates a short cut movie file as specified by this QTFile. A Shortcut movie just contains a data reference which refers to another movie.

QuickTime::CreateShortcutMovieFile()

Parameters:

pathName - specifies the complete pathName of the file that is to be created.

creator - Specifies the creator of the file.

scriptTag - the system script identifier

createMovieFileFlags - Specifies the behaviour when creating the file.

targetDataRef - this is a data reference to the location of the data that is referred to by the resultant movie that this call creates.

 public AliasHandle newAlias(boolean minimal) throws QTException

Creates an alias record that describes the specified target.

QuickTime::QTNewAlias

Parameters:

minimal - if true then the alias is a minimal alias.

Returns:

an AliasHandle that represents the QTFile

 public QTFile resolveAlias(boolean resolveAliasChains) throws QTIOException

Returns the target FSSpec passed in

QuickTime::ResolveAliasFile

Parameters:

resolveAliasChains - set to true if all aliases to be resolved in a chain.

 public boolean delete()

This method deletes a movie file.

QuickTime::DeleteMovieFile()

Returns:

true if the file is successfully deleted; false otherwise.

Overrides:

delete in class File

All Packages  Class Hierarchy  This Package  Previous  Next  Index