QuickTime Atoms and Resources Reference QuickTime 2006-05-23 ASSUMING THE ENTIRE RISK AS TO ITS QUALITY AND ACCURACY. Apple Inc. IN NO EVENT WILL APPLE BE LIABLE FOR DIRECT, © 2006 Apple Computer, Inc. INDIRECT, SPECIAL, INCIDENTAL, OR All rights reserved. CONSEQUENTIAL DAMAGES RESULTING FROM ANY DEFECT OR INACCURACY IN THIS DOCUMENT, even if advised of the possibility of such damages. No part of this publication may be reproduced, THE WARRANTY AND REMEDIES SET FORTH ABOVE stored in a retrieval system, or transmitted, in ARE EXCLUSIVE AND IN LIEU OF ALL OTHERS, ORAL any form or by any means, mechanical, OR WRITTEN, EXPRESS OR IMPLIED. No Apple dealer, agent, or employee is authorized to make electronic, photocopying, recording, or any modification, extension, or addition to this otherwise, without prior written permission of warranty. Apple Inc., with the following exceptions: Any Some states do not allow the exclusion or limitation person is hereby authorized to store of implied warranties or liability for incidental or consequential damages, so the above limitation or documentation on a single computer for exclusion may not apply to you. This warranty gives personal use only and to print copies of you specific legal rights, and you may also have other rights which vary from state to state. documentation for personal use provided that the documentation contains Apple’s copyright notice. The Apple logo is a trademark of Apple Inc. Use of the “keyboard” Apple logo (Option-Shift-K) for commercial purposes without the prior written consent of Apple may constitute trademark infringement and unfair competition in violation of federal and state laws. No licenses, express or implied, are granted with respect to any of the technology described in this document. Apple retains all intellectual property rights associated with the technology described in this document. This document is intended to assist application developers to develop applications only for Apple-labeled computers. Every effort has been made to ensure that the information in this document is accurate. Apple is not responsible for typographical errors. Apple Inc. 1 Infinite Loop Cupertino, CA 95014 408-996-1010 Apple, the Apple logo, ColorSync, Mac, Mac OS, QuickDraw, and QuickTime are trademarks of Apple Inc., registered in the United States and other countries. PowerPC and and the PowerPC logo are trademarks of International Business Machines Corporation, used under license therefrom. Simultaneously published in the United States and Canada. Even though Apple has reviewed this document, APPLE MAKES NO WARRANTY OR REPRESENTATION, EITHER EXPRESS OR IMPLIED, WITH RESPECT TO THIS DOCUMENT, ITS QUALITY, ACCURACY, MERCHANTABILITY, OR FITNESS FOR A PARTICULAR PURPOSE. AS A RESULT, THIS DOCUMENT IS PROVIDED “AS IS,” AND YOU, THE READER, ARE Contents Chapter 1 QuickTime Atoms and Resources Reference 5 Overview 5 Chapter 2 QuickTime Atoms 7 Atoms 7 Chapter 3 QuickTime Public Resources 93 Resources 93 'atms' 93 'avvc' 95 'avvd' 95 'cdci' 95 'cdec' 96 'cpix' 96 'dlle' 97 'mcfg' 97 'mgrp' 99 'mime'[resource] 99 'pcki' 100 'qter' 101 'rsmi' 102 'skcr' 103 'skgr' 103 'snd ' 103 'src#' 106 'stg#' 106 'stgp' 107 'stri' 108 'strn' 108 'sttg' 108 'thga' 108 'thn#' 109 'thnd' 110 'thng' 110 'thnr' 112 Document Revision History 115 3 2006-05-23 | © 2006 Apple Computer, Inc. All Rights Reserved. CONTENTS 4 2006-05-23 | © 2006 Apple Computer, Inc. All Rights Reserved. CHAPTER 1 QuickTime Atoms and Resources Reference Framework: Frameworks/QuickTime.framework Declared in QuickTime.h Overview This reference covers the API details of QuickTime atoms and public resource types. Overview 5 2006-05-23 | © 2006 Apple Computer, Inc. All Rights Reserved. CHAPTER 1 QuickTime Atoms and Resources Reference 6 Overview 2006-05-23 | © 2006 Apple Computer, Inc. All Rights Reserved. CHAPTER 2 QuickTime Atoms Atoms 0x00000000 Terminates an audio atom list. struct AudioTerminatorAtom { long size; OSType atomType; }; Fields size Discussion The size in bytes of this atom structure. atomType Discussion Constant kAudioTerminatorAtomType. Programming Info C interface file: Sound.h See Also For general information about atoms, see Inside QuickTime: QuickTime File Format. 0x00000001 A sprite property matrix atom. This is a QT leaf atom; it is not declared in the header files. You can create it with QTInsertChild using the following parameters: Fields atomType Discussion 0x00000001. data Discussion The sprite matrix property, a structure of type MatrixRecord. Parent Atom 'sprt' (page 66) Parent atom can contain only one atom of this type. See Also For general information about atoms, see Inside QuickTime: QuickTime File Format. 0x00000004 A sprite visible property atom. Atoms 7 2006-05-23 | © 2006 Apple Computer, Inc. All Rights Reserved. CHAPTER 2 QuickTime Atoms This is a QT leaf atom; it is not declared in the header files. You can create it with QTInsertChild using the following parameters: Fields atomType Discussion 0x00000004. data Discussion The sprite visible property, of type short. Parent Atom 'sprt' (page 66) Parent atom can contain only one atom of this type. See Also For general information about atoms, see Inside QuickTime: QuickTime File Format. 0x00000005 A sprite property layer atom. This is a QT leaf atom; it is not declared in the header files. You can create it with QTInsertChild using the following parameters: Fields atomType Discussion 0x00000005. data Discussion The sprite layer property, of type short. Parent Atom 'sprt' (page 66) Parent atom can contain only one atom of this type. See Also For general information about atoms, see Inside QuickTime: QuickTime File Format. 0x00000006 A sprite graphics mode property atom. This is a QT leaf atom; it is not declared in the header files. You can create it with QTInsertChild using the following parameters: Fields atomType Discussion 0x00000006. data Discussion The sprite graphics mode property. 8 Atoms 2006-05-23 | © 2006 Apple Computer, Inc. All Rights Reserved. CHAPTER 2 QuickTime Atoms Parent Atom 'sprt' (page 66) Parent atom can contain only one atom of this type. See Also For general information about atoms, see Inside QuickTime: QuickTime File Format. 0x00000064 A sprite image index atom. This is a QT leaf atom; it is not declared in the header files. You can create it with QTInsertChild using the following parameters: Fields atomType Discussion 0x00000064. data Discussion The sprite image index property, of type short. Parent Atom 'sprt' (page 66) Parent atom can contain only one atom of this type. See Also For general information about atoms, see Inside QuickTime: QuickTime File Format. 0x00000065 A sprite background color property atom. This is a QT leaf atom; it is not declared in the header files. You can create it with QTInsertChild using the following parameters: Fields atomType Discussion 0x00000065. data Discussion The sprite background color property, a structure of type RGBColor. See Also For general information about atoms, see Inside QuickTime: QuickTime File Format. 0x00000066 A sprite property offscreen bit depth atom. This is a QT leaf atom; it is not declared in the header files. You can create it with QTInsertChild using the following parameters: Fields atomType Discussion 0x00000066. Atoms 9 2006-05-23 | © 2006 Apple Computer, Inc. All Rights Reserved. CHAPTER 2 QuickTime Atoms data Discussion The sprite offscreen bit depth property, of type short. See Also For general information about atoms, see Inside QuickTime: QuickTime File Format. 0x00000067 A sprite property sample format atom. This is a QT leaf atom; it is not declared in the header files. You can create it with QTInsertChild using the following parameters: Fields atomType Discussion 0x00000067. data Discussion The sprite sample format property, of type short. See Also For general information about atoms, see Inside QuickTime: QuickTime File Format. 'AllF' User data list entry atom to play all frames. struct MoviesUserData { long size; long udType; char data[1]; }; Fields size Discussion The size in bytes of this atom structure. udType Discussion 'AllF'. data Discussion A byte indicating that all frames of video should be played, regardless of timing. Parent Atom 'udta' (page 84) Parent atom can contain only one atom of this type. Programming Info C interface file: MoviesFormat.h See Also For general information about atoms, see Inside QuickTime: QuickTime File Format. 'beha' Defines sprite behavior. 10 Atoms 2006-05-23 | © 2006 Apple Computer, Inc. All Rights Reserved. CHAPTER 2 QuickTime Atoms This is a QT container atom; it is not declared in the header files. You can create it with QTNewAtomContainer and insert it with QTInsertChild, using the following parameter: Fields atomType Discussion Value is 'beha'. Optional Child Atoms 'imag' (page 38) A sprite image atom. 'crsr' (page 20) Color custom cursor child atom. 'sstr' (page 67) Specifies the ID of a string variable, contained in a sprite track, to display in the status area of the browser. See Also For general information about atoms, see Inside QuickTime: QuickTime File Format. 'chap' Chapter or scene list track reference type atom. This is a QT leaf atom; it is not declared in the header files. You can create it with QTInsertChild using the following parameters: Fields atomType Discussion Constant kTrackReferenceChapterList, designating atom type 'chap'. data Discussion A list of track ID values (32-bit integers) specifying the related tracks. Note that a track ID value can be set to 0 to indicate an unused entry in the atom. Doing this can be more convenient than deleting the reference. Parent Atom 'tref' (page 80) Parent atom can contain only one atom of this type. See Also For general information about atoms, see Inside QuickTime: QuickTime File Format. 'clip' Defines a clipping region. struct ClippingAtom { long size; long atomType; RgnAtom aRgnClip; }; Fields size Discussion The size in bytes of this atom structure. Atoms 11 2006-05-23 | © 2006 Apple Computer, Inc. All Rights Reserved. CHAPTER 2 QuickTime Atoms atomType Discussion Constant ClipAID, designating atom type 'clip'.