QuickTime 4.1 Apple Technical Publications January 2000 Apple Computer, Inc. Apple, the Apple logo, FireWire, Mac, LIMITED WARRANTY ON MEDIA AND © 2000 Apple Computer, Inc. Macintosh, and QuickTime are REPLACEMENT All rights reserved. trademarks of Apple Computer, Inc., ALL IMPLIED WARRANTIES ON THIS No part of this publication or the registered in the United States and other MANUAL, INCLUDING IMPLIED software described in it may be countries. WARRANTIES OF MERCHANTABILITY reproduced, stored in a retrieval system, The QuickTime logo is a trademark of AND FITNESS FOR A PARTICULAR or transmitted, in any form or by any Apple Computer, Inc. PURPOSE, ARE LIMITED IN DURATION means, mechanical, electronic, Adobe, Acrobat, Photoshop, and TO NINETY (90) DAYS FROM THE DATE photocopying, recording, or otherwise, PostScript are trademarks of Adobe OF DISTRIBUTION OF THIS PRODUCT. without prior written permission of Systems Incorporated or its subsidiaries Even though Apple has reviewed this Apple Computer, Inc., except in the and may be registered in certain manual, APPLE MAKES NO WARRANTY normal use of the software or to make a jurisdictions. OR REPRESENTATION, EITHER EXPRESS backup copy of the software or Flash is a trademark of Macromedia OR IMPLIED, WITH RESPECT TO THIS documentation. The same proprietary Incorporated. MANUAL, ITS QUALITY, ACCURACY, and copyright notices must be affixed to MacPaint is a trademark of Apple MERCHANTABILITY, OR FITNESS FOR A any permitted copies as were affixed to Computer, Inc., registered in the U.S. PARTICULAR PURPOSE. AS A RESULT, the original. This exception does not and other countries. THIS MANUAL IS DISTRIBUTED “AS IS,” allow copies to be made for others, AND YOU ARE ASSUMING THE ENTIRE whether or not sold, but all of the Helvetica and Palatino are registered trademarks of Linotype-Hell AG and/or RISK AS TO ITS QUALITY AND material purchased (with all backup ACCURACY. copies) may be sold, given, or loaned to its subsidiaries. another person. Under the law, copying Indeo and Intel are registered IN NO EVENT WILL APPLE BE LIABLE includes translating into another trademarks of Intel. FOR DIRECT, INDIRECT, SPECIAL, language or format. You may use the ITC Zapf Dingbats is a registered INCIDENTAL, OR CONSEQUENTIAL software on any computer owned by trademark of International Typeface DAMAGES RESULTING FROM ANY you, but extra copies cannot be made for Corporation. DEFECT OR INACCURACY IN THIS this purpose. MANUAL, even if advised of the possibility of such damages. The Apple logo is a trademark of Apple PowerPC and the PowerPC logo are Computer, Inc. Use of the “keyboard” trademarks of International Business THE WARRANTY AND REMEDIES SET Apple logo (Option-Shift-K) for Machines Corporation, used under FORTH ABOVE ARE EXCLUSIVE AND IN commercial purposes without the prior license therefrom. LIEU OF ALL OTHERS, ORAL OR written consent of Apple may constitute WRITTEN, EXPRESS OR IMPLIED. No trademark infringement and unfair Apple dealer, agent, or employee is competition in violation of federal and Simultaneously published in the United authorized to make any modification, state laws. States and Canada. extension, or addition to this warranty. No licenses, express or implied, are Printed in the United States of America. Some states do not allow the exclusion or granted with respect to any of the limitation of implied warranties or liability technology described in this book. for incidental or consequential damages, so Apple retains all intellectual property the above limitation or exclusion may not rights associated with the technology apply to you. This warranty gives you described in this book. Every effort has specific legal rights, and you may also have been made to ensure that the other rights which vary from state to state. information in this manual is accurate. Apple is not responsible for printing or clerical errors. Apple Computer, Inc. 1 Infinite Loop Cupertino, CA 95014 408-996-1010 Contents Summary of Changes and Enhancements 9 SMIL Support 11 SMIL Usage 11 A Simple Sequence 12 A Sequence with HREF, Region and Background Text 13 QuickTime SMIL Extensions 14 Namespace Specification 15 SMIL Root Element Attributes 15 Media Object Attributes 17 Anchor-Tag and A-Tag Attributes 19 References 19 SMIL Importer Implementation 20 How It Works 20 Not Instantiating Media at Import Time 20 A New Movie Media Track 21 Movie Media Track Usage 21 Movie Media Handler 22 Sample Description 22 Sample Format 22 New Movie Media Handler APIs 28 New Movie Media Handler APIs to Handle Data References 30 Movie Media Handler Tasks 31 Using the Streaming Media Handler 32 A Note to Authors of Media Handlers 32 Support for Data URLs 33 URLs in Text Tracks 35 New Embed Tags 35 URLSUBSTITUTE Embed Tag 36 How It Works 36 AUTOHREF Embed Tag 37 3 QTSRCDONTUSEBROWSER Embed Tag 37 Support for an HTML Importer 37 How It Works 38 Additional Notes 39 Support for HTTP Streaming 40 New HTTP Streaming Functionality 40 Additional Cookie Support 42 64-bit File Offset Support for Mac OS 9 43 New Features For Creating More Interactive Movies 44 Introducing Embedded Movies 44 Creating New Types of QuickTime Movies 44 Using Embedded Movies 45 Dynamically Loading New Embedded Movies from URLs 46 Triggering Wired Actions When an Embedded Movie is Loaded 47 Targeting Elements of Embedded Movies with All Existing Wired Actions 47 New Movie Track and Movie Wired Actions 49 New Wired QT Event 50 Extended Wired Operand Functionality 50 Wired Actions and JavaScript 50 Added Flash Support 51 New Target Type Atoms for Hierarchical Movies 51 Example #1 53 Example #2 53 New Movie Property Atom Toolbox Routines 54 New Movie Controller Actions 54 Custom Wired Actions 55 Custom Action Handler Usage 56 Authoring Custom Wired Actions 57 Extension to Wired Movie Format: Executing Custom Actions 57 New Wired Actions 57 New Wired Operands 58 4 Writing a Custom Action Handler Component 58 The Action Being Executed 60 Fetching the Parameters 60 API Additions 62 Support for Playback of VBR Audio 62 Changes to Graphics Importers 62 New Anchor Data Reference 63 A New Data Handler Routine 63 Support for M3U Playlists and .CEL Files 64 JavaScript Support 64 Movie Commands 64 Movie Properties 65 Track Properties 72 Sprite Track Properties 72 QuickTime VR Movie Properties 73 Plug-in Properties 73 QuickTime Properties 74 Sample JavaScript Usage 75 Introduction of Asynchronous Movie Loading 77 A Change in the Loading Model 79 GetMovieStatus Updated 81 Other API Additions 82 Support for Playback of VBR Audio 82 Background 82 VBR-Supported Features 83 New Sound Manager APIs 83 Working with SoundConverterFillBuffer 86 Writing the SoundConverterFillBufferData Routine 88 Sound.h Updated 89 SoundMediaGetSource 89 API Changes 89 ExtendedSoundComponentData 90 ExtendedSoundParamBlock 91 ExtendedScheduledSoundHeader 92 5 Changes to QuickTime for Java 95 Deprecation of AWT Dependencies 95 A New Event Model and Suite of New Classes 96 New Mouse Controllers 97 New DragAdaptor and TranslateMatrix Classes 97 The quicktime.app.ui Package 98 New QTButton Sample Code 98 Support for QuickTime 4 APIs 98 New Additions 99 Support for Text Drawing 99 AppleScript Support 100 QuickTime Player Standard Suite terms 100 The close command 101 The count command 101 The exists command 102 The open command 102 The print command 103 The quit command 103 The save command 103 QuickTime Player Suite terms 104 The can export command 104 The export command 105 The find command 107 The open location command 107 The play command 108 The present command 108 The rewind command 109 The select command 109 The select all command 109 The select none command 110 The step backward command 110 The step forward command 110 The stop command 111 QuickTime Player Classes 111 The annotation class 111 The application class 113 The favorite class 115 6 The file class 116 The internet location class 117 The movie class 117 The track class 122 The window class 125 7 8 What’s New in QuickTime 4.1 1 This document provides you with a list of changes from QuickTime 4 to QuickTime 4.1, as well as new features and capabilities available in this software release. It is intended to supplement the information provided in the QuickTime 4 API Reference. If you are a QuickTime API-level developer or a QuickTime content creator or provider, you should read this document. For QuickTime developer documentation, refer to <http://www.apple.com/ quicktime/developers/>. For complete QuickTime API documentation, refer to <http:// developer.apple.com/techpubs/quicktime/qtdevdocs/RM/frameset.htm>. Summary of Changes and Enhancements 1 The primary focus of the QuickTime 4.1 release is to provide advertising insertion capability for QuickTime content providers and firewall support for QuickTime end users. A number of additional features and enhancements have also been included in this release. These are intended to benefit both content providers and end users. In brief, QuickTime 4.1 includes the following changes: I Added 64-bit file support for Mac OS 9, which enables recording and playback of movie files larger than 2 gigabytes (2G) on Mac OS 9. I Added support for Synchronized Multimedia Integration Language (SMIL), a simple, text-based format defined by W3C <http://www.w3.org/TR/ REC-smil/> which lets you create presentations out of diverse media elements –– any media that QuickTime supports. Content providers can now Summary of Changes and Enhancements 9 RELEASE 1.0 What’s New in QuickTime 4.1 insert advertising content in a sequence of streams, using QuickTime 4.1’s implementation of the SMIL standard. I Added the capability of movies to embed other movies as a track, which means that movies may now contain other movies which may have independent clocks. This is accomplished by means of a new Movie Media Handler API.