|
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
| SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||
java.lang.Object
|
+--quicktime.QTObject
|
+--quicktime.std.comp.ComponentIdentifier
|
+--quicktime.std.comp.Component
|
+--quicktime.std.image.GraphicsExporter
Graphics exporter components provide a standard interface for exporting graphics to image files in a variety of formats. QuickTime selects a graphic exporter component based on the desired output format, such as TIFF or PNG. Different image formats support a wide range of configurable features, such as depth, resolution and compression quality. This class implements methods for a corresponding QuickTime ComponentInstance structure. refer to GraphicsExportComponent in QuickTime The base exporter communicates with data handler components to negotiate access to image file data. If necessary, it calls the Image Compression Manager to perform compression operations. There are three modes that format-specific exporters can operate in: - Transcode. Data is transferred from one image file to another without decompressing and recompressing. (The data may be modified along the way, if appropriate.) - Using a Compressor. The graphics exporter provides an atom container identifying which compressor to use, and any settings to be passed to that compressor. - Standalone Export. The graphics exporter component does all the work itself, without using an image compressor.
| Fields inherited from interface quicktime.jdirect.QuickTimeLib |
JDirect_MacOSX, libraryInstance, name |
| Constructor Summary | |
GraphicsExporter(int subType)
Opens the specified graphics export component,'grex', with the given subType. |
|
| Method Summary | |
boolean |
canTranscode()
Format-specific exporters may delegate this call; the base graphics exporter's implementation gives a reply of false .Use this call to ask a graphics exporter whether it can transcode the current input with the current settings. |
GECompressorInfo |
canUseCompressor()
The base graphics exporter makes this call of the format-specific graphics exporter to ask whether the current export operation should be done by using an image compressor. |
int |
doExport()
You can use the GraphicsExportDoExport function to perform an export operation. |
void |
doStandaloneExport()
If both CanTranscode and CanUseCompressor reply false , the base graphics exporter makes this call of the format-specific exporter to perform the call. |
void |
doTranscode()
The base graphics exporter makes this call of the format-specific graphics exporter to perform a transcoding export. |
ImageDescription |
doUseCompressor(AtomContainer ac)
The base graphics exporter makes this call of the format-specific graphics exporter to ask whether the current export operation should be done by using an image compressor. |
void |
drawInputImage(QDGraphics gw,
QDRect srcRect,
QDRect destRect)
Used by format-specific graphics exporters, especially when doing standalone export: Draws a rectangular portion of the input image. |
int |
getCompressionMethod()
Defines the compression method to use. |
int |
getCompressionQuality()
Defines the compression quality to use. |
java.lang.String |
getDefaultFileCreator()
Returns file creator for the new image file format. |
java.lang.String |
getDefaultFileNameExtension()
Returns the suggested file name extension. |
java.lang.String |
getDefaultFileType()
Returns the default file Type for the new image file format. |
int |
getDepth()
Defines the depth to use. |
boolean |
getDontRecompress()
Requests that the original compressed data not be decompressed and recompressed, but be copied (possibly with modifications) through to the output file. |
int |
getHorizontalResolution()
Gets the resolution to saved and stored. |
DataRef |
getInputDataReference()
Gets the DataRef of the source for input images to graphics export component. |
int |
getInputDataSize()
Used by format-specific graphics exporters when transcoding: Returns the number of bytes of original image data that can be read. |
QTFile |
getInputFile()
Gets the file that is the source for input images to graphics export component. |
GraphicsImporter |
getInputGraphicsImporter()
Determines the GraphicsImporter that is the source for input images to graphics export component. |
QDGraphics |
getInputGWorld()
Determines the QDGraphics that is the source for input images to graphics export component. |
QTHandle |
getInputHandle()
Determines the data reference that is the source for input images to graphics export component. |
int |
getInputImageDepth()
Used by format-specific graphics exporters, especially when doing standalone export: Returns the depth of the input image. |
ImageDescription |
getInputImageDescription()
Used by format-specific graphics exporters, especially when doing standalone export: Returns the number of bytes of original image data that can be read. |
QDRect |
getInputImageDimensions()
Used by format-specific graphics exporters, especially when doing standalone export: Returns the dimensions of the input image. |
int |
getInputLimit()
Only applicable when the input is a data reference, file, handle or ptr: Specifies the portion of an input data reference, file, handle or pointer that a graphics exporter is permitted to read. |
int |
getInputOffset()
Only applicable when the input is a data reference, file, handle or ptr: Specifies the portion of an input data reference, file, handle or pointer that a graphics exporter is permitted to read. |
Pict |
getInputPicture()
Determines the Pict that is the source for input images to graphics export component. |
PixMap |
getInputPixmap()
Determines the QDGraphics that is the source for input images to graphics export component. |
QTPointerRef |
getInputPtr()
Determines the data reference that is the source for input images to graphics export component. |
int |
getInterlaceStyle()
Returns the interlace style. |
UserData |
getMetaData()
Returns supplemental data, such as textual copyright information. |
AtomContainer |
getMIMETypeList()
Returns MIME types and other information about the graphics format. |
DataRef |
getOutputDataReference()
Gets the DataRef of the destination for output images. |
QTFile |
getOutputFile()
Gets the file that is the destination for output images. |
int |
getOutputFileCreator()
Gets the Output file Creator. |
int |
getOutputFileType()
Gets the Output file type. |
QTHandle |
getOutputHandle()
Determines the data reference that is the destination for output images. |
int |
getOutputMaxSize()
Gets the output starting offset and maximum size limit. |
int |
getOutputOffset()
Gets the output starting offset and maximum size limit. |
boolean |
getOutputTruncateFile()
Gets the output starting offset and maximum size limit. |
AtomContainer |
getSettingsAsAtomContainer()
These functions are used for obtaining graphics exporter settings and displaying a settings dialog box. |
QTHandle |
getSettingsAsText()
This function is used for obtaining graphics exporter settings and displaying a settings dialog box. |
int |
getTargetDataSize()
Specifies a desired maximum data size and asks for a quality that does not exceed that size. |
int |
getVerticalResolution()
Defines the compression quality to use. |
byte[] |
GraphicsExportReadOutputData(int dataOffset,
int dataSize)
This function is used by format-specific graphics exporters to write output data. |
void |
GraphicsExportWriteOutputData(byte[] data,
int dataSize)
This function is used by format-specific graphics exporters to write output data. |
boolean |
mayExporterReadInputData()
Used by format-specific graphics exporters when transcoding: Asks whether the image source is in a form that can be read. |
byte[] |
readInputData(int dataOffset,
int dataSize)
Used by format-specific graphics exporters when transcoding: Returns the number of bytes of original image data that can be read. |
void |
requestSettings()
These functions are used for obtaining graphics exporter settings and displaying a settings dialog box. |
void |
setCompressionMethod(int compressionMethod)
Defines the compression method to use. |
void |
setCompressionQuality(int spatialQuality)
Defines the compression quality. |
void |
setDepth(int depth)
Defines the depth to use. |
void |
setDontRecompress(boolean dontRecompress)
Requests that the original compressed data not be decompressed and recompressed, but be copied (possibly with modifications) through to the output file. |
void |
setInputDataReference(DataRef dataRef,
ImageDescription desc)
Sets the specified DataRef as the source for input images to graphics export component. |
void |
setInputFile(QTFile theFile,
ImageDescription desc)
Sets the specified QTFile as the source for input images to graphics export component. |
void |
setInputGraphicsImporter(GraphicsImporter grip)
Sets the GraphicsImporter as the source for input images to graphics export component. |
void |
setInputGWorld(QDGraphics gworld)
Sets the QDGraphics as the source for input images to graphics export component. |
void |
setInputHandle(QTHandle h,
ImageDescription desc)
Sets the data handle as the source for input images to graphics export component. |
void |
setInputOffsetAndLimit(int offset,
int limit)
Only applicable when the input is a data reference, file, handle or ptr: Specifies the portion of an input data reference, file, handle or pointer that a graphics exporter is permitted to read. |
void |
setInputPicture(Pict picture)
Sets the Pict as the source for input images to graphics export component. |
void |
setInputPixmap(QDGraphics gworld)
Sets the QDGraphics as the source for input images to graphics export component. |
void |
setInputPtr(QTPointerRef p,
ImageDescription desc)
Sets the data handle reference as the source for input images to graphics export component. |
void |
setInterlaceStyle(int interlaceStyle)
Defines the interlace style. |
void |
setMetaData(UserData userData)
Defines supplemental data, such as textual copyright information. |
void |
setOutputDataReference(DataRef dataRef)
Used to specify destination for output images. |
void |
setOutputFile(QTFile theFile)
Sets the specified QTFile as the destination for output images. |
void |
setOutputFileTypeAndCreator(int fileType,
int fileCreator)
Specifies the output starting offset and maximum size limit. |
void |
setOutputHandle(QTHandleRef h)
Sets the data handle as the destination for output images. |
void |
setOutputOffsetAndMaxSize(int offset,
int maxSize,
boolean truncateFile)
Specifies the output starting offset and maximum size limit. |
void |
setResolution(int horizontalResolution,
int verticalResolution)
Defines the resolution to save and store. |
void |
setSettingsFromAtomContainer(AtomContainer qtAtomContainer)
These functions are used for obtaining graphics exporter settings and displaying a settings dialog box. |
void |
setTargetDataSize(int targetDataSize)
Defines a desired maximum data size and asks for a quality that does not exceed that size. |
| Methods inherited from class quicktime.std.comp.Component |
count |
| Methods inherited from class quicktime.std.comp.ComponentIdentifier |
find, find, getInfo, toString |
| Methods inherited from class quicktime.QTObject |
disposeQTObject, equals, ID |
| Methods inherited from class java.lang.Object |
getClass, hashCode, notify, notifyAll, wait, wait, wait |
| Constructor Detail |
public GraphicsExporter(int subType)
throws QTException
subType - The graphics export component sub type| Method Detail |
public int doExport()
throws StdQTException
public void doStandaloneExport()
throws QTException
public void setInputDataReference(DataRef dataRef,
ImageDescription desc)
throws QTException
dataRef - The DataRef for input images to export component sub typedesc - the ImageDescription handle
public DataRef getInputDataReference()
throws QTException
QTHandle.fromGraphicsExporterInput(quicktime.std.image.GraphicsExporter)
public void setInputFile(QTFile theFile,
ImageDescription desc)
throws QTException
theFile - The QTFile that points to the source of input images to export componentdesc - the ImageDescription handle
public QTFile getInputFile()
throws QTException
quicktime.io.QTFile.fromGraphicsExporterInput
public void setInputHandle(QTHandle h,
ImageDescription desc)
throws QTException
h - The data handle that points to the source of input images to export componentdesc - the ImageDescription handle
public QTHandle getInputHandle()
throws QTException
quicktime.std.util.QTHandle.fromGraphicsExporter
public void setInputPtr(QTPointerRef p,
ImageDescription desc)
throws QTException
p - The pointer that points to the source of input images of export componentdesc - the ImageDescription handle
public QTPointerRef getInputPtr()
throws QTException
public void setInputGraphicsImporter(GraphicsImporter grip)
throws QTException
grip - The GraphicsImporter that points to the source of input images to export component
public GraphicsImporter getInputGraphicsImporter()
throws QTException
public void setInputPicture(Pict picture)
throws QTException
picture - The Pict that points to the source of input images to export component
public Pict getInputPicture()
throws QTException
quicktime.std.qd.Pict.fromGraphicsExporter
public void setInputGWorld(QDGraphics gworld)
throws QTException
gworld - The QDGraphics that points to the source of input images to export component
public QDGraphics getInputGWorld()
throws QTException
quicktime.qd.QDGraphics.fromGraphicsExporter
public void setInputPixmap(QDGraphics gworld)
throws StdQTException
gworld - The QDGraphics that points to the source of input images to export component
public PixMap getInputPixmap()
throws QTException
quicktime.qd.QDGraphics.fromGraphicsExporter
public void setOutputDataReference(DataRef dataRef)
throws QTException
dataRef - The DataRef for output images to export
public DataRef getOutputDataReference()
throws QTException
QTHandle.fromGraphicsExporterOutput(quicktime.std.image.GraphicsExporter)
public void setOutputFile(QTFile theFile)
throws QTException
theFile - The QTFile that points to destination for output images.
public QTFile getOutputFile()
throws QTException
quicktime.io.QTFile.fromGraphicsExporter
public void setOutputHandle(QTHandleRef h)
throws QTException
h - The data handle that points to the destination for output images.
public QTHandle getOutputHandle()
throws QTException
quicktime.std.util.QTHandle.fromGraphicsExporter
public void setOutputOffsetAndMaxSize(int offset,
int maxSize,
boolean truncateFile)
throws QTException
offset - The byte offset of the image data from the beginning of the data reference.maxSize - A value describing the maximum size limit.truncateFile - A Boolean value specifying whether to truncate the file.
public int getOutputOffset()
throws StdQTException
public int getOutputMaxSize()
throws StdQTException
public boolean getOutputTruncateFile()
throws StdQTException
public void setOutputFileTypeAndCreator(int fileType,
int fileCreator)
throws QTException
fileType - The file type for the new image file, such as `JPEG' .fileCreator - The file creator for the new image file. This parameter may be 0, in which case a default file
creator for this file type is used.
public int getOutputFileType()
throws QTException
public int getOutputFileCreator()
throws QTException
public boolean mayExporterReadInputData()
throws QTException
public int getInputDataSize()
throws QTException
public byte[] readInputData(int dataOffset,
int dataSize)
throws StdQTException
dataPtr - the pointer to receive the input data.dataOffset - The offset of the image data within the source image data. The function begins reading image
data from this offset.dataSize - The number of bytes of image data to read.
public ImageDescription getInputImageDescription()
throws QTException
public QDRect getInputImageDimensions()
throws QTException
public int getInputImageDepth()
throws QTException
public void drawInputImage(QDGraphics gw,
QDRect srcRect,
QDRect destRect)
throws QTException
public void setInputOffsetAndLimit(int offset,
int limit)
throws QTException
offset - The byte offset of the input image data from the beginning of the data reference.limit - The offset of the byte following the last byte of the input image data. (If you do not need to apply any limit unsigned int -1
public int getInputOffset()
throws QTException
public int getInputLimit()
throws QTException
public void requestSettings()
throws QTException
public void setSettingsFromAtomContainer(AtomContainer qtAtomContainer)
throws QTException
qtAtomContainer - A QuickTime atom container containing settings.
public AtomContainer getSettingsAsAtomContainer()
throws QTException
public QTHandle getSettingsAsText()
throws QTException
public java.lang.String getDefaultFileNameExtension()
throws QTException
public AtomContainer getMIMETypeList()
throws QTException
public java.lang.String getDefaultFileType()
throws QTException
public java.lang.String getDefaultFileCreator()
throws QTException
public boolean canTranscode()
throws QTException
public void doTranscode()
throws QTException
public GECompressorInfo canUseCompressor()
throws QTException
AtomContainer.fromGraphicsExporterCompressor(quicktime.std.image.GraphicsExporter)
public ImageDescription doUseCompressor(AtomContainer ac)
throws QTException
public void setDontRecompress(boolean dontRecompress)
throws QTException
dontRecompress - true if not allowed to recompressor.
public boolean getDontRecompress()
throws QTException
public void setInterlaceStyle(int interlaceStyle)
throws QTException
interlaceStyle - A value describing the style of the image data .
public int getInterlaceStyle()
throws QTException
public void setMetaData(UserData userData)
throws QTException
userData - object .
public UserData getMetaData()
throws QTException
UserData.fromGraphicsExporter(quicktime.std.image.GraphicsExporter)
public void setTargetDataSize(int targetDataSize)
throws QTException
targetDataSize - A value describing the maximum size of the image data in bytes.
public int getTargetDataSize()
throws QTException
public void setCompressionMethod(int compressionMethod)
throws QTException
compressionMethod - A value describing the compression algorithm to be used by the graphics exporter.
public int getCompressionMethod()
throws QTException
public void setCompressionQuality(int spatialQuality)
throws QTException
spatialQuality - The currently specified quality value
public int getCompressionQuality()
throws QTException
public void setResolution(int horizontalResolution,
int verticalResolution)
throws QTException
spatialQuality - The currently specified quality value
public int getHorizontalResolution()
throws QTException
public int getVerticalResolution()
throws QTException
public void setDepth(int depth)
throws QTException
A - value describing the depth of the image data as an OSType specifying the pixel format.
public int getDepth()
throws QTException
public void GraphicsExportWriteOutputData(byte[] data,
int dataSize)
throws StdQTException
data - block containing the data.dataSize - The number of bytes of image data to write.
public byte[] GraphicsExportReadOutputData(int dataOffset,
int dataSize)
throws StdQTException
dataOffset - The offset of the image data within the data reference. The function begins reading image data from this offset.dataSize - The number of bytes of image data to read.
|
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
| SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||