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.
EatClosedCaptionDispatch.h
/* |
File: EatClosedCaptionDispatch.h |
Abstract: Dispatch routines for a QuickTime Movie Import component |
Version: 1.0 |
Disclaimer: IMPORTANT: This Apple software is supplied to you by |
Apple 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 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. |
Copyright (C) 2007 Apple Inc. All Rights Reserved. |
*/ |
/* 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 (7) |
ComponentRangeMask (7F) |
ComponentRangeBegin (0) |
ComponentError (Target) |
ComponentError (Register) |
StdComponentCall (Version) |
StdComponentCall (CanDo) |
StdComponentCall (Close) |
StdComponentCall (Open) |
ComponentRangeEnd (0) |
ComponentRangeBegin (1) |
ComponentError (0) |
ComponentError (Handle) |
ComponentCall (File) |
ComponentError (SetSampleDuration) |
ComponentError (SetSampleDescription) |
ComponentCall (SetMediaFile) |
ComponentCall (SetDimensions) |
ComponentError (SetChunkSize) |
ComponentError (SetProgressProc) |
ComponentError (SetAuxiliaryData) |
ComponentError (SetFromScrap) |
ComponentError (DoUserDialog) |
ComponentError (SetDuration) |
ComponentError (GetAuxiliaryDataType) |
ComponentCall (Validate) |
ComponentError (GetFileType) |
ComponentCall (DataRef) |
ComponentError (GetSampleDescription) |
ComponentCall (GetMIMETypeList) |
ComponentError (SetOffsetAndLimit) |
ComponentError (GetSettingsAsAtomContainer) |
ComponentError (SetSettingsFromAtomContainer) |
ComponentError (SetOffsetAndLimit64) |
ComponentError (Idle) |
ComponentCall (ValidateDataRef) |
ComponentError (GetLoadState) |
ComponentError (GetMaxLoadedTime) |
ComponentError (EstimateCompletionTime) |
ComponentError (SetDontBlock) |
ComponentError (GetDontBlock) |
ComponentError (SetIdleManager) |
ComponentError (SetNewMovieFlags) |
ComponentError (GetDestinationMediaType) |
ComponentCall (SetMediaDataRef) |
ComponentError (DoUserDialogDataRef) |
ComponentRangeEnd (1) |
Copyright © 2007 Apple Inc. All Rights Reserved. Terms of Use | Privacy Policy | Updated: 2007-11-15