Advanced Search

Log In | Not a Member?

Contact ADC

< Previous PageNext Page > Hide TOC

Registering Movie Data Export Components

QuickTime allows more than one export ('spit') component to be registered for the same type of file and the same export source (the movie or the particular track type). This is accomplished in a way that preserves compatibility with third-party components that may have already been written using the former rules.

The Registration Mechanism

QuickTime provides a movie export component routine that returns the same information that would have been previously stored in the componentManufacturer field of the registered 'spit' components. An export-specific component flag indicates that the export component implements the new protocol. By implementing the routine, the export component’s componentManufacturer field can be used to differentiate components.

The routine is MovieExportGetSourceMediaType. This routine returns an OSType value through its mediaType parameter, which is interpreted in exactly the same way that the componentManufacturer was previously interpreted. If the export component requires a particular type of track to exist in a movie, it returns that media handler type (e.g., VideoMediaType, SoundMediaType, etc.) through the mediaType argument. If the export component works for an entire movie, it returns 0 through this parameter.

EXTERN_API( ComponentResult )

MovieExportGetSourceMediaType (MovieExportComponent  ci, OSType * mediaType);

The following component flag indicates that this routine is implemented:

movieExportMustGetSourceMediaType = 1L << 19,

If you implement the MovieExportGetSourceMediaType routine, you must register the component with this flag. Otherwise, the Movie Toolbox will not know to call the routine and will assume the older semantics for the componentManufacturer field.

Using this mechanism does not replace the need for implementing Validate in your export components. The mechanism is only used to find candidate components.

< Previous PageNext Page > Hide TOC

Did this document help you? Yes: Tell us what works for you. It’s good, but: Report typos, inaccuracies, and so forth. It wasn’t helpful: Tell us what would have helped.

	Get information on Apple products. Visit the Apple Store online or at retail locations. 1-800-MY-APPLE Copyright © 2007 Apple Inc. All rights reserved. | Terms of use | Privacy Notice