quicktime.std.image
Class GraphicsExporter

java.lang.Object
  |
  +--quicktime.QTObject
        |
        +--quicktime.std.comp.ComponentIdentifier
              |
              +--quicktime.std.comp.Component
                    |
                    +--quicktime.std.image.GraphicsExporter

All Implemented Interfaces:

Errors, InterfaceLib, PrimitivesLib, QuickTimeLib, com.apple.jdirect.SharedLibrary, SharedLibrary

public final class GraphicsExporter

extends Component

implements QuickTimeLib, Errors

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.

Field Summary

Fields inherited from interface quicktime.jdirect.QuickTimeLib

JDirect_MacOSX, libraryInstance, name

Fields inherited from interface quicktime.Errors

AAPNotCreatedErr, AAPNotFoundErr, abortErr, addResFailed, afpAccessDenied, afpObjectTypeErr, ASDBadForkErr, ASDBadHeaderErr, ASDEntryNotFoundErr, atomIndexInvalidErr, atomsNotOfSameTypeErr, auxiliaryExportDataUnavailable, badCallOrderErr, badChannel, badComponentInstance, badComponentSelector, badComponentType, badControllerHeight, badDataRefIndex, badDepthErr, badEditIndex, badEditList, badFileFormat, badFormat, badImageDescription, badPublicMovieAtom, badSGChannel, badTrackIndex, badUnitErr, bdNamErr, buffersTooSmall, callNotSupportedByNodeErr, cannotBeLeafAtomErr, cannotFindAtomErr, cannotMoveAttachedController, cannotSetWidthOfAttachedController, cantCreateSingleForkFile, cantDoThatInCurrentMode, cantEnableTrack, cantFindHandler, cantOpenHandler, cantPutPublicMovieAtom, cantReceiveFromSynthesizerErr, cantReceiveFromSynthesizerOSErr, cantSendToSynthesizerErr, cantSendToSynthesizerOSErr, cDepthErrInvalid, channelBusy, channelNotBusy, closErr, codecAbortErr, codecBadDataErr, codecCantQueueErr, codecCantWhenErr, codecConditionErr, codecDataVersErr, codecDisabledErr, codecDroppedFrameErr, codecErr, codecExtensionNotFoundErr, codecImageBufErr, codecNeedAccessKeyErr, codecNeedToFlushChainErr, codecNoMemoryPleaseWaitErr, codecNothingToBlitErr, codecOffscreenFailedErr, codecOpenErr, codecParameterDialogConfirm, codecScreenBufErr, codecSizeErr, codecSpoolErr, codecUnimpErr, codecWouldOffscreenErr, componentDllEntryNotFoundErr, componentDllLoadErr, componentDontRegister, componentNotCaptured, constraintReachedErr, controlErr, controllerBoundsNotExact, controllerHasFixedHeight, couldNotResolveDataRef, couldNotUseAnExistingSample, couldntGetRequiredComponent, dataAlreadyClosed, dataAlreadyOpenForWrite, dataNoDataRef, dataNotOpenForRead, dataNotOpenForWrite, destPortErr, deviceCantMeetRequest, digiUnimpErr, dInstErr, dirFulErr, dirNFErr, dRemovErr, dskFulErr, dupFNErr, duplicateAtomTypeAndIDErr, duplicateHandlerErr, editingNotAllowed, emptyPathErr, endOfDataReached, eofErr, fBsyErr, featureUnsupported, fileOffsetTooBigErr, fnfErr, grabTimeComplete, gWorldsNotSameDepthAndSizeErr, handlerNotFoundErr, illegalChannelErr, illegalChannelOSErr, illegalControllerErr, illegalControllerOSErr, illegalInstrumentErr, illegalInstrumentOSErr, illegalKnobErr, illegalKnobOSErr, illegalKnobValueErr, illegalKnobValueOSErr, illegalNoteChannelErr, illegalNoteChannelOSErr, illegalPartErr, illegalPartOSErr, illegalVoiceAllocationErr, illegalVoiceAllocationOSErr, internalComponentErr, internalQuickTimeError, invalidAtomContainerErr, invalidAtomErr, invalidAtomTypeErr, invalidChunkCache, invalidChunkNum, invalidComponentID, invalidDataRef, invalidDataRefContainer, invalidDuration, invalidEditState, invalidHandler, invalidHotSpotIDErr, invalidImageIndexErr, invalidMedia, invalidMovie, invalidNodeFormatErr, invalidNodeIDErr, invalidRect, invalidSampleDescIndex, invalidSampleDescription, invalidSampleNum, invalidSampleTable, invalidSpriteIDErr, invalidSpriteIndexErr, invalidSpritePropertyErr, invalidSpriteWorldPropertyErr, invalidTime, invalidTrack, invalidViewStateErr, ioErr, kIllegalInstrumentErr, kInvalidPartNumberErr, kQ3ErrorAcceleratorAlreadySet, kQ3ErrorAccessRestricted, kQ3ErrorAlreadyInitialized, kQ3ErrorAlreadyRendering, kQ3ErrorAttributeInvalidType, kQ3ErrorAttributeNotContained, kQ3ErrorBadDrawContext, kQ3ErrorBadDrawContextFlag, kQ3ErrorBadDrawContextType, kQ3ErrorBadStringType, kQ3ErrorBeginWriteAlreadyCalled, kQ3ErrorBeginWriteNotCalled, kQ3ErrorBoundingLoopFailed, kQ3ErrorBoundsNotStarted, kQ3ErrorCameraNotSet, kQ3ErrorController, kQ3ErrorDataNotAvailable, kQ3ErrorDegenerateGeometry, kQ3ErrorDisplayNotSet, kQ3ErrorDrawContextNotSet, kQ3ErrorEndOfContainer, kQ3ErrorEndOfFile, kQ3ErrorEndWriteNotCalled, kQ3ErrorExtensionError, kQ3ErrorFileAlreadyOpen, kQ3ErrorFileCancelled, kQ3ErrorFileIsOpen, kQ3ErrorFileModeRestriction, kQ3ErrorFileNotOpen, kQ3ErrorFileVersionExists, kQ3ErrorGeometryInsufficientNumberOfPoints, kQ3ErrorImmediateModeUnderflow, kQ3ErrorInternalError, kQ3ErrorInvalidCameraValues, kQ3ErrorInvalidData, kQ3ErrorInvalidGeometryType, kQ3ErrorInvalidHexString, kQ3ErrorInvalidMetafile, kQ3ErrorInvalidMetafileLabel, kQ3ErrorInvalidMetafileObject, kQ3ErrorInvalidMetafilePrimitive, kQ3ErrorInvalidMetafileSubObject, kQ3ErrorInvalidObject, kQ3ErrorInvalidObjectClass, kQ3ErrorInvalidObjectForGroup, kQ3ErrorInvalidObjectForPosition, kQ3ErrorInvalidObjectName, kQ3ErrorInvalidObjectType, kQ3ErrorInvalidParameter, kQ3ErrorInvalidPositionForGroup, kQ3ErrorInvalidSubObjectForObject, kQ3ErrorLastFatalError, kQ3ErrorMacintoshError, kQ3ErrorMemoryLeak, kQ3ErrorMetaHandlerRequired, kQ3ErrorNeedRequiredMethods, kQ3ErrorNoBeginGroup, kQ3ErrorNoExtensionsFolder, kQ3ErrorNonInvertibleMatrix, kQ3ErrorNonUniqueLabel, kQ3ErrorNoRecovery, kQ3ErrorNoStorageSetForFile, kQ3ErrorNoSubClassType, kQ3ErrorNothingToPop, kQ3ErrorNotInitialized, kQ3ErrorNotSupported, kQ3ErrorNULLParameter, kQ3ErrorObjectClassInUse, kQ3ErrorOutOfMemory, kQ3ErrorParameterOutOfRange, kQ3ErrorPickingLoopFailed, kQ3ErrorPickingNotStarted, kQ3ErrorPrivateExtensionError, kQ3ErrorReadLessThanSize, kQ3ErrorReadMoreThanSize, kQ3ErrorReadStateInactive, kQ3ErrorRegistrationFailed, kQ3ErrorRendererNotSet, kQ3ErrorRenderingIsActive, kQ3ErrorRenderingLoopFailed, kQ3ErrorRenderingNotStarted, kQ3ErrorScaleOfZero, kQ3ErrorSizeMismatch, kQ3ErrorSizeNotLongAligned, kQ3ErrorStartGroupRange, kQ3ErrorStateUnavailable, kQ3ErrorStorageAlreadyOpen, kQ3ErrorStorageInUse, kQ3ErrorStorageIsOpen, kQ3ErrorStorageNotOpen, kQ3ErrorStringExceedsMaximumLength, kQ3ErrorTracker, kQ3ErrorTypeAlreadyExistsAndHasObjectInstances, kQ3ErrorTypeAlreadyExistsAndHasSubclasses, kQ3ErrorTypeAlreadyExistsAndOtherClassesDependOnIt, kQ3ErrorUnimplemented, kQ3ErrorUnixError, kQ3ErrorUnknownElementType, kQ3ErrorUnknownObject, kQ3ErrorUnknownStudioType, kQ3ErrorUnmatchedEndGroup, kQ3ErrorUnresolvableReference, kQ3ErrorUnsupportedFunctionality, kQ3ErrorUnsupportedGeometryType, kQ3ErrorUnsupportedPixelDepth, kQ3ErrorValueExceedsMaximumSize, kQ3ErrorVector3DNotUnitLength, kQ3ErrorVector3DZeroLength, kQ3ErrorViewIsStarted, kQ3ErrorViewNotStarted, kQ3ErrorWin32Error, kQ3ErrorWriteStateInactive, kQ3ErrorWritingLoopFailed, kQ3ErrorWroteLessThanSize, kQ3ErrorWroteMoreThanSize, kQ3ErrorX11Error, kQ3NoticeBrightnessGreaterThanOne, kQ3NoticeDataAlreadyEmpty, kQ3NoticeDrawContextNotSetUsingInternalDefaults, kQ3NoticeFileAliasWasChanged, kQ3NoticeFileCancelled, kQ3NoticeInvalidAttenuationTypeUsingInternalDefaults, kQ3NoticeMeshEdgeIsNotBoundary, kQ3NoticeMeshEdgeVertexDoNotCorrespond, kQ3NoticeMeshInvalidVertexFacePair, kQ3NoticeMeshVertexHasNoComponent, kQ3NoticeMethodNotSupported, kQ3NoticeObjectAlreadySet, kQ3NoticeParameterOutOfRange, kQ3NoticeScaleContainsZeroEntries, kQ3NoticeSystemAlreadyInitialized, kQ3NoticeViewSyncCalledAgain, kQ3WarningExtensionNotLoading, kQ3WarningFilePointerRedefined, kQ3WarningFilePointerResolutionFailed, kQ3WarningFunctionalityNotSupported, kQ3WarningInconsistentData, kQ3WarningInternalException, kQ3WarningInvalidHexString, kQ3WarningInvalidMetafileObject, kQ3WarningInvalidObjectInGroupMetafile, kQ3WarningInvalidPaneDimensions, kQ3WarningInvalidSubObjectForObject, kQ3WarningInvalidTableOfContents, kQ3WarningLowMemory, kQ3WarningNoAttachMethod, kQ3WarningNone, kQ3WarningNonInvertibleMatrix, kQ3WarningNoObjectSupportForDrawMethod, kQ3WarningNoObjectSupportForDuplicateMethod, kQ3WarningNoObjectSupportForReadMethod, kQ3WarningNoObjectSupportForWriteMethod, kQ3WarningParameterOutOfRange, kQ3WarningPickParamOutside, kQ3WarningPossibleMemoryLeak, kQ3WarningQuaternionEntriesAreZero, kQ3WarningReadLessThanSize, kQ3WarningScaleContainsNegativeEntries, kQ3WarningScaleEntriesAllZero, kQ3WarningStringExceedsMaximumLength, kQ3WarningTypeAlreadyRegistered, kQ3WarningTypeAndMethodAlreadyDefined, kQ3WarningTypeHasNotBeenRegistered, kQ3WarningTypeIsOutOfRange, kQ3WarningTypeNewerVersionAlreadyRegistered, kQ3WarningTypeSameVersionAlreadyRegistered, kQ3WarningUnknownElementType, kQ3WarningUnknownObject, kQ3WarningUnmatchedBeginGroup, kQ3WarningUnmatchedEndGroup, kQ3WarningUnresolvableReference, kQ3WarningVector3DNotUnitLength, kQ3WarningViewTraversalInProgress, kUnspecifiedErr, limitReachedErr, lockPortBitsBadPortErr, lockPortBitsBadSurfaceErr, lockPortBitsSurfaceLostErr, lockPortBitsWindowClippedErr, lockPortBitsWindowMovedErr, lockPortBitsWindowResizedErr, matrixErr, maxSizeToGrowTooSmall, mediaTypesDontMatch, memFullErr, midiManagerAbsentErr, midiManagerAbsentOSErr, missingRequiredParameterErr, movieTextNotFoundErr, movieToolboxUninitialized, noCodecErr, noDataHandler, noDefaultDataRef, noDeviceForChannel, noDMAErr, noErr, noExportProcAvailableErr, noGlobalsErr, noMediaHandler, noMemoryNodeFailedInitialize, noMoreKeyColorsErr, noMoreRealTime, noMovieFound, nonMatchingEditState, noPathMappingErr, noPortErr, noRecordOfApp, noSoundTrackInMovieErr, noSourceTreeFoundErr, notAllowedToSaveMovieErr, notAQTVRMovieErr, noteChannelNotAllocatedErr, noteChannelNotAllocatedOSErr, notEnoughBufferSpace, notEnoughDataErr, notEnoughDiskSpaceToGrab, notEnoughHardwareErr, notEnoughMemoryToGrab, notExactMatrixErr, notExactSizeErr, notImplementedMusicErr, notImplementedMusicOSErr, notLeafAtomErr, noVideoTrackInMovieErr, nsvErr, openErr, paramErr, pathNotVerifiedErr, pathTooLongErr, permErr, pictIsOpenErr, progressProcAborted, propertyNotSupportedByNodeErr, qfcbNotCreatedErr, qfcbNotFoundErr, qtActionNotHandledErr, qtmlDllEntryNotFoundErr, qtmlDllLoadErr, qtmlUninitialized, qtNetworkAlreadyAllocatedErr, qtParamErr, qtvrLibraryLoadErr, qtvrUninitialized, queueFull, readErr, resFNotFound, resNotFound, resProblem, rgnTooBigErr, rmvResFailed, samplesAlreadyInMediaErr, scTypeNotFoundErr, selectorNotSupportedByNodeErr, seqGrabInfoNotAvailable, settingNotSupportedByNodeErr, siBadDeviceName, siBadRefNum, siBadSoundInDevice, siDeviceBusyErr, siHardDriveTooSlow, siInputDeviceErr, siInvalidCompression, siInvalidSampleRate, siInvalidSampleSize, siNoBufferSpecified, siNoSoundInHardware, siUnknownInfoType, siUnknownQuality, soundSupportNotAvailableErr, sourceNotFoundErr, staleEditState, statusErr, streamingNodeNotReadyErr, synthesizerErr, synthesizerNotRespondingErr, synthesizerNotRespondingOSErr, synthesizerOSErr, timeNotInMedia, timeNotInTrack, timeNotInViewErr, trackIDNotFound, trackNotInMovie, tuneParseErr, tuneParseOSErr, tunePlayerFullErr, tunePlayerFullOSErr, unitEmptyErr, unknownFormatErr, unresolvedComponentDLLErr, unsupportedAuxiliaryImportData, unsupportedOSErr, unsupportedProcessorErr, urlDataHFTPBadNameListErr, urlDataHFTPBadPasswordErr, urlDataHFTPBadUserErr, urlDataHFTPDataConnectionErr, urlDataHFTPFilenameErr, urlDataHFTPNeedPasswordErr, urlDataHFTPNoDirectoryErr, urlDataHFTPNoNetDriverErr, urlDataHFTPNoPasswordErr, urlDataHFTPPermissionsErr, urlDataHFTPProtocolErr, urlDataHFTPQuotaErr, urlDataHFTPServerDisconnectedErr, urlDataHFTPServerErr, urlDataHFTPShutdownErr, urlDataHFTPURLErr, urlDataHHTTPNoNetDriverErr, urlDataHHTTPProtocolErr, urlDataHHTTPRedirectErr, urlDataHHTTPURLErr, userCanceledErr, userDataItemNotFound, validInstancesExist, videoOutputInUseErr, vLckdErr, wackBadFileErr, wackBadMetaDataErr, wackForkNotFoundErr, wfFileNotFound, wPrErr, writErr

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.
boolean	getExifEnabled() Returns the current Exif export setting.
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.
QDDimension	getThumbnailDimension() Returns the current thumbnail export settings.
boolean	getThumbnailEnabled() Returns the current thumbnail export settings.
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	setExifEnabled(boolean enableExif) Sets whether or not the graphics exporter component should create Exif files.
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.
void	setThumbnailEnabled(boolean enableThumbnail, int maxThumbnailWidth, int maxThumbnailHeight) Sets whether or not the graphics exporter component should create an embedded thumbnail inside the exported file.

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

GraphicsExporter

public GraphicsExporter(int subType)
                 throws QTException

Opens the specified graphics export component,'grex', with the given subType.

QuickTime::OpenADefaultComponent

Parameters:

subType - The graphics export component sub type

Method Detail

doExport

public int doExport()
             throws StdQTException

You can use the GraphicsExportDoExport function to perform an export operation. Before calling GraphicsExportDoExport , you must specify an input image (using a GraphicsExportSetInput call) and a destination for the output image file (using a GraphicsExportSetOutput call).

QuickTime::GraphicsExportDoExport

Returns:

the actual size of the image exported

StdQTException

doStandaloneExport

public void doStandaloneExport()
                        throws QTException

If both CanTranscode and CanUseCompressor reply false , the base graphics exporter makes this call of the format-specific exporter to perform the call.

QuickTime::GraphicsExportDoStandaloneExport

QTException

setInputDataReference

public void setInputDataReference(DataRef dataRef,
                                  ImageDescription desc)
                           throws QTException

Sets the specified DataRef as the source for input images to graphics export component.

QuickTime::GraphicsExportSetInputDataReference

Parameters:

dataRef - The DataRef for input images to export component sub type

desc - the ImageDescription handle

QTException

getInputDataReference

public DataRef getInputDataReference()
                              throws QTException

Gets the DataRef of the source for input images to graphics export component.

QuickTime::GraphicsExportGetInputDataReference

Returns:

a DataRef object specifying the source of input images to the Graphics exporter.

QTException

See Also:

QTHandle.fromGraphicsExporterInput(quicktime.std.image.GraphicsExporter)

setInputFile

public void setInputFile(QTFile theFile,
                         ImageDescription desc)
                  throws QTException

Sets the specified QTFile as the source for input images to graphics export component.

QuickTime::GraphicsExportSetInputFile

Parameters:

theFile - The QTFile that points to the source of input images to export component

desc - the ImageDescription handle

QTException

getInputFile

public QTFile getInputFile()
                    throws QTException

Gets the file that is the source for input images to graphics export component.

QuickTime::GraphicsExportGetInputFile

Returns:

a QTFile object that has the source of input images to the Graphics exporter.

QTException

See Also:

quicktime.io.QTFile.fromGraphicsExporterInput

setInputHandle

public void setInputHandle(QTHandle h,
                           ImageDescription desc)
                    throws QTException

Sets the data handle as the source for input images to graphics export component.

QuickTime::GraphicsExportSetInputHandle

Parameters:

h - The data handle that points to the source of input images to export component

desc - the ImageDescription handle

QTException

getInputHandle

public QTHandle getInputHandle()
                        throws QTException

Determines the data reference that is the source for input images to graphics export component.

QuickTime::GraphicsExportGetInputHandle

Returns:

a QTHandle object that has the source of input images to the Graphics exporter.

QTException

See Also:

quicktime.std.util.QTHandle.fromGraphicsExporter

setInputPtr

public void setInputPtr(QTPointerRef p,
                        ImageDescription desc)
                 throws QTException

Sets the data handle reference as the source for input images to graphics export component.

QuickTime::GraphicsExportSetInputPtr

Parameters:

p - The pointer that points to the source of input images of export component

desc - the ImageDescription handle

QTException

getInputPtr

public QTPointerRef getInputPtr()
                         throws QTException

Determines the data reference that is the source for input images to graphics export component.

QuickTime::GraphicsExportGetInputPtr

Returns:

a QTPointerRef object that has the source of input images to the Graphics exporter.

QTException

setInputGraphicsImporter

public void setInputGraphicsImporter(GraphicsImporter grip)
                              throws QTException

Sets the GraphicsImporter as the source for input images to graphics export component.

QuickTime::GraphicsExportSetInputGraphicsImporter

Parameters:

grip - The GraphicsImporter that points to the source of input images to export component

QTException

getInputGraphicsImporter

public GraphicsImporter getInputGraphicsImporter()
                                          throws QTException

Determines the GraphicsImporter that is the source for input images to graphics export component.

QuickTime::GraphicsExportGetInputGraphicsImporter

Returns:

a GraphicsImporter object that has the source of input images to the Graphics exporter.

QTException

setInputPicture

public void setInputPicture(Pict picture)
                     throws QTException

Sets the Pict as the source for input images to graphics export component.

QuickTime::GraphicsExportSetInputPicture

Parameters:

picture - The Pict that points to the source of input images to export component

QTException

getInputPicture

public Pict getInputPicture()
                     throws QTException

Determines the Pict that is the source for input images to graphics export component.

QuickTime::GraphicsExportGetInputPicture

Returns:

a Pict object that has the source of input images to the Graphics exporter.

QTException

See Also:

quicktime.std.qd.Pict.fromGraphicsExporter

setInputGWorld

public void setInputGWorld(QDGraphics gworld)
                    throws QTException

Sets the QDGraphics as the source for input images to graphics export component.

QuickTime::GraphicsExportSetInputGWorld

Parameters:

gworld - The QDGraphics that points to the source of input images to export component

QTException

getInputGWorld

public QDGraphics getInputGWorld()
                          throws QTException

Determines the QDGraphics that is the source for input images to graphics export component.

QuickTime::GraphicsExportGetInputGWorld

Returns:

a QDGraphics object that has the source of input images to the Graphics exporter.

QTException

See Also:

quicktime.qd.QDGraphics.fromGraphicsExporter

setInputPixmap

public void setInputPixmap(QDGraphics gworld)
                    throws StdQTException

Sets the QDGraphics as the source for input images to graphics export component.

QuickTime::GraphicsExportSetInputPixmap

Parameters:

gworld - The QDGraphics that points to the source of input images to export component

StdQTException

getInputPixmap

public PixMap getInputPixmap()
                      throws QTException

Determines the QDGraphics that is the source for input images to graphics export component.

QuickTime::GraphicsExportGetInputPixmap

Returns:

a QDGraphics object that has the source of input images to the Graphics exporter.

QTException

See Also:

quicktime.qd.QDGraphics.fromGraphicsExporter

setOutputDataReference

public void setOutputDataReference(DataRef dataRef)
                            throws QTException

Used to specify destination for output images. Sets the specified DataRef as the destination for output images.

QuickTime::GraphicsExportSetOutputDataReference

Parameters:

dataRef - The DataRef for output images to export

QTException

getOutputDataReference

public DataRef getOutputDataReference()
                               throws QTException

Gets the DataRef of the destination for output images.

QuickTime::GraphicsExportGetOutputDataReference

Returns:

a DataRef object specifying the destination for output images.

QTException

See Also:

QTHandle.fromGraphicsExporterOutput(quicktime.std.image.GraphicsExporter)

setOutputFile

public void setOutputFile(QTFile theFile)
                   throws QTException

Sets the specified QTFile as the destination for output images.

QuickTime::GraphicsExportSetOutputFile

Parameters:

theFile - The QTFile that points to destination for output images.

QTException

getOutputFile

public QTFile getOutputFile()
                     throws QTException

Gets the file that is the destination for output images.

QuickTime::GraphicsExportGetOutputFile

Returns:

a QTFile object that has the destination for output images.

QTException

See Also:

quicktime.io.QTFile.fromGraphicsExporter

setOutputHandle

public void setOutputHandle(QTHandleRef h)
                     throws QTException

Sets the data handle as the destination for output images.

QuickTime::GraphicsExportSetOutputHandle

Parameters:

h - The data handle that points to the destination for output images.

QTException

getOutputHandle

public QTHandle getOutputHandle()
                         throws QTException

Determines the data reference that is the destination for output images.

QuickTime::GraphicsExportGetOutputHandle

Returns:

a QTHandle object that has the destination for output images.

QTException

See Also:

quicktime.std.util.QTHandle.fromGraphicsExporter

setOutputOffsetAndMaxSize

public void setOutputOffsetAndMaxSize(int offset,
                                      int maxSize,
                                      boolean truncateFile)
                               throws QTException

Specifies the output starting offset and maximum size limit.

QuickTime::GraphicsExportSetOutputOffsetAndMaxSize

Parameters:

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.

QTException

getOutputOffset

public int getOutputOffset()
                    throws StdQTException

Gets the output starting offset and maximum size limit.

QuickTime::GraphicsExportGetOutputOffsetAndMaxSize

Returns:

a starting offset.

StdQTException

getOutputMaxSize

public int getOutputMaxSize()
                     throws StdQTException

Gets the output starting offset and maximum size limit.

QuickTime::GraphicsExportGetOutputOffsetAndMaxSize

Returns:

maximum size limit.

StdQTException

getOutputTruncateFile

public boolean getOutputTruncateFile()
                              throws StdQTException

Gets the output starting offset and maximum size limit.

QuickTime::GraphicsExportGetOutputOffsetAndMaxSize

Returns:

maximum size limit.

StdQTException

setOutputFileTypeAndCreator

public void setOutputFileTypeAndCreator(int fileType,
                                        int fileCreator)
                                 throws QTException

Specifies the output starting offset and maximum size limit.

QuickTime::GraphicsExportSetOutputFileTypeAndCreator

Parameters:

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.

QTException

getOutputFileType

public int getOutputFileType()
                      throws QTException

Gets the Output file type.

QuickTime::GraphicsExportGetOutputFileTypeAndCreator

Returns:

fileType

QTException

getOutputFileCreator

public int getOutputFileCreator()
                         throws QTException

Gets the Output file Creator.

QuickTime::GraphicsExportGetOutputFileTypeAndCreator

Returns:

fileCreator

QTException

mayExporterReadInputData

public boolean mayExporterReadInputData()
                                 throws QTException

Used by format-specific graphics exporters when transcoding: Asks whether the image source is in a form that can be read.

QuickTime::GraphicsExportMayExporterReadInputData

return true if the exporter is allowed to read the input data

QTException

getInputDataSize

public int getInputDataSize()
                     throws QTException

Used by format-specific graphics exporters when transcoding: Returns the number of bytes of original image data that can be read.

QuickTime::GraphicsExportGetInputDataSize

Returns:

returns the size in bytes.

QTException

readInputData

public byte[] readInputData(int dataOffset,
                            int dataSize)
                     throws StdQTException

Used by format-specific graphics exporters when transcoding: Returns the number of bytes of original image data that can be read.

QuickTime::GraphicsExportReadInputData

Parameters:

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.

Returns:

the data of size datasize.

StdQTException

getInputImageDescription

public ImageDescription getInputImageDescription()
                                          throws QTException

Used by format-specific graphics exporters, especially when doing standalone export: Returns the number of bytes of original image data that can be read.

QuickTime::GraphicsExportGetInputImageDescription

Returns:

returns the ImageDescription

QTException

getInputImageDimensions

public QDRect getInputImageDimensions()
                               throws QTException

Used by format-specific graphics exporters, especially when doing standalone export: Returns the dimensions of the input image.

QuickTime::GraphicsExportGetInputImageDimensions

Returns:

Returns the rectangle that has the dimensions of the input image.

QTException

getInputImageDepth

public int getInputImageDepth()
                       throws QTException

Used by format-specific graphics exporters, especially when doing standalone export: Returns the depth of the input image.

QuickTime::GraphicsExportGetInputImageDepth

Returns:

Returns the depth of the input image..

QTException

drawInputImage

public void drawInputImage(QDGraphics gw,
                           QDRect srcRect,
                           QDRect destRect)
                    throws QTException

Used by format-specific graphics exporters, especially when doing standalone export: Draws a rectangular portion of the input image. srcRect and dstRect need not be the same width and height; you can use this function to scale the image portion. This would be useful, for example, if you were writing a graphics exporter for a multiple-resolution format.

QuickTime::GraphicsExportDrawInputImage

QTException

setInputOffsetAndLimit

public void setInputOffsetAndLimit(int offset,
                                   int limit)
                            throws QTException

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. This would be useful if, for example, the source was a JPEG image embedded within a larger file.

QuickTime::GraphicsExportSetInputOffsetAndLimit

Parameters:

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

QTException

getInputOffset

public int getInputOffset()
                   throws QTException

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. This would be useful if, for example, the source was a JPEG image embedded within a larger file.

QuickTime::GraphicsExportGetInputOffsetAndLimit

Returns:

offset of input image data

QTException

getInputLimit

public int getInputLimit()
                  throws QTException

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. This would be useful if, for example, the source was a JPEG image embedded within a larger file.

QuickTime::GraphicsExportGetInputOffsetAndLimit

Returns:

offset of the byte following the last byte of the input image data

QTException

requestSettings

public void requestSettings()
                     throws QTException

These functions are used for obtaining graphics exporter settings and displaying a settings dialog box. Some graphics exporters don't support settings dialogs, and so do not implement this call. To find out whether a graphics exporter implements this call, use CallComponentCanDo ( myGraphicsExporter , kGraphicsExportRequestSettingsSelect ).

QuickTime::GraphicsExportRequestSettings

QTException

setSettingsFromAtomContainer

public void setSettingsFromAtomContainer(AtomContainer qtAtomContainer)
                                  throws QTException

These functions are used for obtaining graphics exporter settings and displaying a settings dialog box. Sets the graphics exporter component's current configuration to match the settings in the passed atom container.

QuickTime::GraphicsExportSetSettingsFromAtomContainer

Parameters:

qtAtomContainer - A QuickTime atom container containing settings.

QTException

getSettingsAsAtomContainer

public AtomContainer getSettingsAsAtomContainer()
                                         throws QTException

These functions are used for obtaining graphics exporter settings and displaying a settings dialog box. Retrieves the current settings from the graphics exporter component

QuickTime::GraphicsExportGetSettingsAsAtomContainer

Returns:

AtomContainer containing settings.

QTException

getSettingsAsText

public QTHandle getSettingsAsText()
                           throws QTException

This function is used for obtaining graphics exporter settings and displaying a settings dialog box. Retrieves the current settings in a user-readable format.

QuickTime::GraphicsExportGetSettingsAsText

Returns:

QTHandle containing the text.

QTException

getDefaultFileNameExtension

public java.lang.String getDefaultFileNameExtension()
                                             throws QTException

Returns the suggested file name extension.

QuickTime::GraphicsExportGetDefaultFileNameExtension

Returns:

Returns the suggested file name extension.

QTException

getMIMETypeList

public AtomContainer getMIMETypeList()
                              throws QTException

Returns MIME types and other information about the graphics format.

QuickTime::GraphicsExportGetMIMETypeList

The format's name, as a string in an atom of type kMimeInfoDescriptionTag . Optionally, the MIME type, as a string in an atom of type kMimeInfoMimeTypeTag .

Returns:

Returns AtomContainer containing information about the graphics format.

QTException

getDefaultFileType

public java.lang.String getDefaultFileType()
                                    throws QTException

Returns the default file Type for the new image file format.

QuickTime::GraphicsExportGetDefaultFileTypeAndCreator

Returns:

Returns the default file Type for the new image file format

QTException

getDefaultFileCreator

public java.lang.String getDefaultFileCreator()
                                       throws QTException

Returns file creator for the new image file format.

QuickTime::GraphicsExportGetDefaultFileTypeAndCreator

Returns:

Returns file creator for the new image file format

QTException

canTranscode

public boolean canTranscode()
                     throws QTException

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.

QuickTime::GraphicsExportCanTranscode

Returns:

Returns true if current export operation can be performed by transcoding.