Retired Document
Important: This sample code may not represent best practices for current development. The project may use deprecated symbols and illustrate technologies and techniques that are no longer recommended.
EI_GraphicsExport/EI_GraphicsExportDispatch.h
/* |
File: EI_GraphicsExportDispatch.h |
Description: QuickTime graphics importer component |
Author: QuickTime Engineering, QuickTime DTS |
Copyright: © Copyright 2003 Apple Computer, Inc. All rights reserved. |
Disclaimer: IMPORTANT: This Apple software is supplied to you by Apple Computer, Inc. |
("Apple") in consideration of your agreement to the following terms, and your |
use, installation, modification or redistribution of this Apple software |
constitutes acceptance of these terms. If you do not agree with these terms, |
please do not use, install, modify or redistribute this Apple software. |
In consideration of your agreement to abide by the following terms, and subject |
to these terms, Apple grants you a personal, non-exclusive license, under AppleÕs |
copyrights in this original Apple software (the "Apple Software"), to use, |
reproduce, modify and redistribute the Apple Software, with or without |
modifications, in source and/or binary forms; provided that if you redistribute |
the Apple Software in its entirety and without modifications, you must retain |
this notice and the following text and disclaimers in all such redistributions of |
the Apple Software. Neither the name, trademarks, service marks or logos of |
Apple Computer, Inc. may be used to endorse or promote products derived from the |
Apple Software without specific prior written permission from Apple. Except as |
expressly stated in this notice, no other rights or licenses, express or implied, |
are granted by Apple herein, including but not limited to any patent rights that |
may be infringed by your derivative works or by other works in which the Apple |
Software may be incorporated. |
The Apple Software is provided by Apple on an "AS IS" basis. APPLE MAKES NO |
WARRANTIES, EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION THE IMPLIED |
WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY AND FITNESS FOR A PARTICULAR |
PURPOSE, REGARDING THE APPLE SOFTWARE OR ITS USE AND OPERATION ALONE OR IN |
COMBINATION WITH YOUR PRODUCTS. |
IN NO EVENT SHALL APPLE BE LIABLE FOR ANY SPECIAL, INDIRECT, INCIDENTAL OR |
CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE |
GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) |
ARISING IN ANY WAY OUT OF THE USE, REPRODUCTION, MODIFICATION AND/OR DISTRIBUTION |
OF THE APPLE SOFTWARE, HOWEVER CAUSED AND WHETHER UNDER THEORY OF CONTRACT, TORT |
(INCLUDING NEGLIGENCE), STRICT LIABILITY OR OTHERWISE, EVEN IF APPLE HAS BEEN |
ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. |
Change History (most recent first): |
<1> 04/22/03 dts first file |
*/ |
/* A Quick Course in ComponentDispatchHelper.c |
ComponentRangeCount |
The number (0 based) of discrete, continuous ranges of selectors that are used in the macro. The |
'range shift' & 'range mask' determine the size of the range. |
ComponentRangeShift |
ComponentRangeMask |
The mask == 2^shift -1. This is used to define size of the range of selectors. |
For ImageCodecs as an example, the ranges are in size of 0x100: |
Range 0 = -0xFF to -0x01 Standard Component Calls |
Range 1 = 0x000 to 0x0FF Generic codecs |
Range 2 = 0x100 to 0x1FF Specific to QT Photo JPEG codecs |
Range 3 = 0x200 to 0x2FF Base Decompressor Client codecs |
Range 4 = 0x300 to 0x3FF Effect codecs |
ComponentRangeBegin & ComponentRangeEnd |
Use these macros to bracket the start/stop of each range of selectors. First range use (0), for the Nth |
range use (N-1). |
ComponentRangeUnused |
Used to skip a range of selectors. |
ComponentSelectorOffset |
Since the 'default' selectors are negative numbers, an offset must be specified. For example, if the first |
default selector supported was kComponentUnregisterSelect (-7), then the offset would have to be 7. |
StdComponentCall |
Used to dispatch to one of the standard compoenent routines, such as Open(), Close(), Register(), etc. that |
are implemented in the component. |
ComponentError |
Returns an error without trying to do anything. Use this for the selectors that will NEVER be implmented |
or delegated. Additionally, it can be used to fill in a 'blank' in a range of selectors to get the range |
continuous. For example, if there were selectors that corresponded to 10,11,12, 14, but NO 13, merely put |
ComponentError (0) between the selectors for 12 & 14. |
ComponentNoError |
Returns 'noErr' without trying to do anything. |
ComponentDelegate |
Delagates the call to the specified delagate component. |
ComponentCall |
This dispatches to the appropriate routine in that is implemented in the component. |
ComponentComment |
Allows comments to be placed in the big macro. |
*/ |
ComponentSelectorOffset (6) |
ComponentRangeCount (1) |
ComponentRangeShift (8) |
ComponentRangeMask (FF) |
ComponentStorageType (Ptr) |
ComponentDelegateByteOffset (8) |
ComponentRangeBegin (0) |
StdComponentCall (Target) |
ComponentError (Register) |
StdComponentCall (Version) |
StdComponentCall (CanDo) |
StdComponentCall (Close) |
StdComponentCall (Open) |
ComponentRangeEnd (0) |
ComponentRangeBegin (1) |
ComponentError (0) |
ComponentDelegate (DoExport) |
ComponentDelegate (CanTranscode) |
ComponentDelegate (DoTranscode) |
ComponentDelegate (CanUseCompressor) |
ComponentDelegate (DoUseCompressor) |
ComponentCall (DoStandaloneExport) |
ComponentCall (GetDefaultFileTypeAndCreator) |
ComponentCall (GetDefaultFileNameExtension) |
ComponentCall (GetMIMETypeList) |
ComponentDelegate (IsTranscodePossibleFromCurrentInput) |
ComponentDelegate (RequestSettings) |
ComponentDelegate (SetSettingsFromAtomContainer) |
ComponentDelegate (GetSettingsAsAtomContainer) |
ComponentDelegate (GetSettingsAsText) |
ComponentDelegate (SetDontRecompress) |
ComponentDelegate (GetDontRecompress) |
ComponentDelegate (SetInterlaceStyle) |
ComponentDelegate (GetInterlaceStyle) |
ComponentDelegate (SetMetaData) |
ComponentDelegate (GetMetaData) |
ComponentDelegate (SetTargetDataSize) |
ComponentDelegate (GetTargetDataSize) |
ComponentDelegate (SetCompressionMethod) |
ComponentDelegate (GetCompressionMethod) |
ComponentDelegate (SetCompressionQuality) |
ComponentDelegate (GetCompressionQuality) |
ComponentDelegate (SetResolution) |
ComponentDelegate (GetResolution) |
ComponentDelegate (SetDepth) |
ComponentDelegate (GetDepth) |
ComponentDelegate (SetColorTable) |
ComponentDelegate (GetColorTable) |
ComponentDelegate (SetColorSyncProfile) |
ComponentDelegate (GetColorSyncProfile) |
ComponentDelegate (SetProgressProc) |
ComponentDelegate (GetProgressProc) |
ComponentDelegate (SetInputDataReference) |
ComponentDelegate (GetInputDataReference) |
ComponentDelegate (SetInputFile) |
ComponentDelegate (GetInputFile) |
ComponentDelegate (SetInputHandle) |
ComponentDelegate (GetInputHandle) |
ComponentDelegate (SetInputPtr) |
ComponentDelegate (GetInputPtr) |
ComponentDelegate (SetInputGraphicsImporter) |
ComponentDelegate (GetInputGraphicsImporter) |
ComponentDelegate (SetInputPicture) |
ComponentDelegate (GetInputPicture) |
ComponentDelegate (SetInputGWorld) |
ComponentDelegate (GetInputGWorld) |
ComponentDelegate (SetInputPixmap) |
ComponentDelegate (GetInputPixmap) |
ComponentDelegate (SetInputOffsetAndLimit) |
ComponentDelegate (GetInputOffsetAndLimit) |
ComponentDelegate (MayExporterReadInputData) |
ComponentDelegate (GetInputDataSize) |
ComponentDelegate (ReadInputData) |
ComponentDelegate (GetInputImageDescription) |
ComponentDelegate (GetInputImageDimensions) |
ComponentDelegate (GetInputImageDepth) |
ComponentDelegate (DrawInputImage) |
ComponentDelegate (SetOutputDataReference) |
ComponentDelegate (GetOutputDataReference) |
ComponentDelegate (SetOutputFile) |
ComponentDelegate (GetOutputFile) |
ComponentDelegate (SetOutputHandle) |
ComponentDelegate (GetOutputHandle) |
ComponentDelegate (SetOutputOffsetAndMaxSize) |
ComponentDelegate (GetOutputOffsetAndMaxSize) |
ComponentDelegate (SetOutputFileTypeAndCreator) |
ComponentDelegate (GetOutputFileTypeAndCreator) |
ComponentDelegate (WriteOutputData) |
ComponentDelegate (SetOutputMark) |
ComponentDelegate (GetOutputMark) |
ComponentDelegate (ReadOutputData) |
ComponentDelegate (SetThumbnailEnabled) |
ComponentDelegate (GetThumbnailEnabled) |
ComponentDelegate (SetExifEnable) |
ComponentDelegate (GetExifEnabled) |
ComponentDelegate (SetInputCGImage) |
ComponentDelegate (GetInputCGImage) |
ComponentDelegate (SetInputCGBitmapContext) |
ComponentDelegate (GetInputCGBitmapContext) |
ComponentDelegate (SetFlags) |
ComponentDelegate (GetFlags) |
ComponentRangeEnd (1) |
Copyright © 2010 Apple Inc. All Rights Reserved. Terms of Use | Privacy Policy | Updated: 2010-05-17