User manual ADOBE ATMOSPHERE

Adobe Atmosphere ® TM User Guide Adobe Atmosphere ® TM User Guide ©2003 Adobe Systems Incorporated. All rights reserved. Adobe® AtmosphereTM User Guide for Windows® If this guide is distributed with software that includes an end user agreement, this guide, as well as the software described in it, is furnished under license and may be used or copied only in accordance with the terms of such license. Except as permitted by any such license, no part of this guide may be reproduced, stored in a retrieval system, or transmitted, in any form or by any means, electronic, mechanical, recording, or otherwise, without the prior written permission of Adobe Systems Incorporated. Please note that the content in this guide is protected under copyright law even if it is not distributed with software that includes an end user license agreement. The content of this guide is furnished for informational use only, is subject to change without notice, and should not be construed as a commitment by Adobe Systems Incorporated. Adobe Systems Incorporated assumes no responsibility or liability for any errors or inaccuracies that may appear in the informational content contained in this guide. Please remember that existing artwork or images that you may want to include in your project may be protected under copyright law. The unauthorized incorporation of such material into your new work could be a violation of the rights of the copyright owner. Please be sure to obtain any permission required from the copyright owner. Any references to company names in sample templates are for demonstration purposes only and are not intended to refer to any actual organization. Adobe, the Adobe logo, Acrobat, Adobe Reader, GoLive, Illustrator, InDesign, Photoshop, Minion, and Myriad are either registered trademarks or trademarks of Adobe Systems Incorporated in the United States and/or other countries. Microsoft, DirectX, Direct3D, Windows, and Windows NT are registered trademarks of Microsoft Corporation in the U.S and/or other countries. Apple, Macintosh, and QuickTime are trademarks of Apple Computer, Inc. registered in the U.S. and other countries. QuickTime and the QuickTime logo are trademarks used under license. Pentium is a registered trademark of Intel Corporation. 3ds max is a registered trademark of Autodesk Corporation. Maya is a registered trademark of Alias Systems. SoftImage is a registered trademark of Avid Technology. LightWave is a registered trademark of NewTek. Bryce is a registered trademark of Corel Corporation. Poser and Avatar Lab are registered trademarks of Curious Labs and EGISYS AG. TrueSpace is a registered trademark of Caligari Corporation. GeForce and Quadro are either registered trademarks or trademarks NVIDIA Corporation. Radeon, Mobility, and All-In-Wonder are either registered trademarks or trademarks ATI Technologies. Macromedia and Flash are trademarks or registered trademarks of Macromedia, Inc. in the United States and/ or other countries. All other trademarks are the property of their respective owners. Contains an implementation of the LZW algorithm licensed under various patents. Adobe Systems Incorporated, 345 Park Avenue, San Jose, California 95110, USA. Notice to U.S. Government End Users. The Software and Documentation are "Commercial Items," as that term is defined at 48 C.F.R. §2.101, consisting of "Commercial Computer Software" and "Commercial Computer Software Documentation," as such terms are used in 48 C.F.R. §12.212 or 48 C.F.R. §227.7202, as applicable. Consistent with 48 C.F.R. §12.212 or 48 C.F.R. §§227.7202-1 through 227.7202-4, as applicable, the Commercial Computer Software and Commercial Computer Software Documentation are being licensed to U.S. Government end users (a) only as Commercial Items and (b) with only those rights as are granted to all other end users pursuant to the terms and conditions herein. Unpublished-rights reserved under the copyright laws of the United States. Adobe Systems Incorporated, 345 Park Avenue, San Jose, CA 95110-2704, USA. For U.S. Government End Users, Adobe agrees to comply with all applicable equal opportunity laws including, if appropriate, the provisions of Executive Order 11246, as amended, Section 402 of the Vietnam Era Veterans Readjustment Assistance Act of 1974 (38 USC 4212), and Section 503 of the Rehabilitation Act of 1973, as amended, and the regulations at 41 CFR Parts 601 through 60-60, 60-250, and 60-741. The affirmative action clause and regulations contained in the preceding sentence shall be incorporated by reference. Part Number: 90047303 (11/03) ADOBE ATMOSPHERE i User Guide Contents Chapter 1: The Atmosphere Platform Platform Features. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1 The Atmosphere Architecture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1 Why 3-D?. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5 Chapter 2: Exploring Atmosphere Environments Using the Atmosphere Player . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7 Tutorial: Visiting Atmosphere Environments at Adobe.com . . . . . . . . . . . . . .8 Tutorial: Viewing Atmosphere Environments in Photoshop Album. . . . . . .9 Tutorial: Viewing Atmosphere Environments in PDF Documents. . . . . . . 10 Navigating Atmosphere Environments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 Tutorial: Practicing Navigation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12 Using the Toolbar. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14 Tutorial: Moving to an Overhead View of the Environment . . . . . . . . . . . . 16 Working with Bookmarks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17 Tutorial: Bookmarking New Environments . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18 Understanding and Using Avatars . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18 Tutorial: Swapping Your Avatar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20 Setting Player Preferences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21 Chapter 3: Interacting with Atmosphere Environments Moving Through Portals . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27 Tutorial: Jumping Between Environments . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28 Understanding Entry Points . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29 Communicating and Collaborating with Other Visitors . . . . . . . . . . . . . . . . 29 Tutorial: Communicating with Other Users. . . . . . . . . . . . . . . . . . . . . . . . . . . . 30 Interacting with the Environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31 Using Custom Controls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34 Chapter 4: Atmosphere Overview Scene Object Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42 Chapter 5: Exploring the Interface Using the Menus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44 ii CONTENTS Learning the Toolbars. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46 Working with Palettes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49 Tutorial: Maximizing Screen Space by Docking. . . . . . . . . . . . . . . . . . . . . . . . 50 Tutorial: Positioning and Combining Palettes . . . . . . . . . . . . . . . . . . . . . . . . . 56 Using context menus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56 Using Undo and Redo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57 Customizing Atmosphere . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57 Chapter 6: Working with Files Understanding the Atmosphere Formats . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61 Opening Environment Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61 Tutorial: Viewing Sample Environments. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62 Saving Environments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63 Closing Environments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63 Importing Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63 Tutorial: Importing a Viewpoint Object . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64 Importing to Preset Palettes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65 Tutorial: Importing Wood Textures. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66 Managing Object Sets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67 Exporting Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68 Saving World Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69 Publishing. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69 Chapter 7: Views Introduction to Views . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71 Working with the View Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72 Working with the Actor Object . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74 Using the Reference Point Object . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75 Working with Views. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76 Controlling the View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80 Zooming to fit Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82 Tutorial: Viewing a Character's Good Side . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82 Chapter 8: Using Scene Objects Positioning Models as Scene Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85 Positioning Solid Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86 Adding Scripts to the Scene . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86 Using Viewpoint Objects. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86 ADOBE ATMOSPHERE iii User Guide Tutorial: Adding a Viewpoint Object to a Scene . . . . . . . . . . . . . . . . . . . . . . . 87 Tutorial: Adding a Viewpoint Object from the Object Presets palette. . . 88 Tutorial: Scaling a Viewpoint Object . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89 Converting 3-D Files for Import into Atmosphere . . . . . . . . . . . . . . . . . . . . . 91 Converting Viewpoint Objects to Surface Objects. . . . . . . . . . . . . . . . . . . . . 91 Creating Avatars . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93 Creating a Portal. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94 Positioning an Entry Point. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95 Using Anchors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96 Naming Scene Objects. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96 Locking Scene Objects. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96 Setting Visibility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97 Chapter 9: Assembling Solid Objects Understanding Solid Objects. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99 Understanding Boolean Operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100 Connectors, Welding, Constraints and Layouts . . . . . . . . . . . . . . . . . . . . . . . 101 Naming Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102 Tutorial: Creating a Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102 Learning the Primitive Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104 Triangular Slab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106 Deleting Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110 Duplicating Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110 Grouping Objects. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111 Ungrouping Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117 Locking Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117 Hiding Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118 Chapter 10: Selecting and Editing Objects Selecting Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121 Moving Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124 Editing using Connectors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126 Snapping to a Grid. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130 Tutorial: Building a Chess Board . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132 Rotating Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133 Tutorial: Tilting a Top . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134 Clearing Transformations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135 Subtracting Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135 iv CONTENTS Tutorial: Making Alphabet Letters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136 Chapter 11: Applying Colors and Textures The Appearance Editor. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139 Adding Color . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139 Tutorial: Coloring Chess Pieces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142 Adding Preset Colors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143 Texture Formats . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145 Applying Textures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145 Tutorial: Adding Textures to an Object . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146 Working with Movies and Sound . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147 Tutorial: Making a Television Come Alive. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148 Removing Textures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149 Sampling and Editing Colors and Textures . . . . . . . . . . . . . . . . . . . . . . . . . . . 149 Chapter 12: Manipulating Textures Editing Textures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151 Tutorial: Applying a texture to a single face . . . . . . . . . . . . . . . . . . . . . . . . . . 152 Tutorial: Scaling a Texture to Fit. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156 Tutorial: Creating Seamless Textures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159 Positioning Projective Textures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160 Creating Billboards . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161 Tutorial: Making a Billboard object . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161 Chapter 13: Lighting a Scene Understanding Lighting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166 Working with Emissive Surfaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167 Pre-Computed Lighting. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168 Tutorial: Making a Light Bulb . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169 Setting Light Parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170 Tutorial: Changing Scene Brightness. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173 Using Sunlight. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174 Tutorial: Coloring the Sun . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176 Using the Background as a Light Source . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176 Tutorial: Creating a Sky Cone . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177 Using Object Light Maps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178 Using Dynamic Lighting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178 Effective Lighting Techniques . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179 ADOBE ATMOSPHERE v User Guide Tutorial: Preparing Textures for Lighting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180 Chapter 14: Adding Interactivity Drag and Drop Scripting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181 Tutorial: Adding Fog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183 Defining Properties and Setting Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185 Tutorial: Adding Background Sound . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186 Adding New Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187 Associating a Script with an Object. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188 Tutorial: Making a Showroom Car Rotate . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190 Tutorial: Creating a Free Moving Soccer Ball. . . . . . . . . . . . . . . . . . . . . . . . . . 191 Linking a Script to a Script . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193 Tutorial: Starting Rotation with the onClick Script . . . . . . . . . . . . . . . . . . . . 193 Chapter 15: Publishing Testing and Debugging Environments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195 Testing the Final Environment. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196 Using World Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196 Publishing an Atmosphere Environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197 Publishing a Single Model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198 Publishing Preferences. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198 Embedding within a Web Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199 Tutorial: Adding an Atmosphere Scene to an Existing Web Page . . . . . . 199 Publishing in a PDF Document . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200 Tutorial: Adding an Atmosphere environment to a PDF Document . . . 200 Optimization Techniques . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201 Appendix A: Installing and Configuring Installing the Atmosphere Player . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203 Installing Atmosphere . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203 Using Hardware Acceleration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203 Tutorial: Helping Atmosphere Recognize Your Card . . . . . . . . . . . . . . . . . . 206 Supported Video Cards . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208 Appendix B: Keyboard Shortcuts Appendix C: Resource Libraries Textures ­ Set 1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214 vi CONTENTS Textures ­ Set 2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223 Objects ­ Set 1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227 Objects ­ Set 2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 229 Objects ­ Set 3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231 Scripts - Set 1 - Basic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232 Scripts - Set 2 - Intermediate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233 Scripts - Set 3 - Advanced . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234 Appendix D: JavaScript API Overview Introduction. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235 SceneGraph Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235 Physical Simulation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238 JavaScript Interpreter Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240 Script Context . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241 Appendix E: JavaScript API JavaScript API Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243 Utility Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243 Application. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 248 Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 248 View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 250 Button . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251 Slider . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253 PrintDevice & Object Synchronization. . . . . . . . . . . . . . . . . . . . . . . . . . 254 Math . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 257 Rotation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 257 Transform . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259 Vector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261 Effects. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263 Fog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263 Glare. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264 Sound . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265 Event Handlers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 267 CollisionEventHandler . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 267 KeyEventHandler. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 268 KeyEvent. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 270 MouseEventHandler. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 272 MouseEvent. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 274 ADOBE ATMOSPHERE vii User Guide OverlapEventHandler . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 275 Scene Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 277 Actor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 277 Anchor. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 285 Camera . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 286 EntryPoint . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 290 PhysicalModel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 291 ReferencePoint. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 302 SceneGroup. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 303 Script . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 312 SolidObject . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 315 SurfaceObject. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 321 ViewpointObject . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 325 Solid Object Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 330 Face . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 330 Primitive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332 Materials . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 336 SurfaceTexture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 336 Texture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 337 Viewpoint Object Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 339 MTSBaseObject . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 339 MTSImageStream . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 340 MTSScene. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 341 MTSGeometry. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 343 MTSInstance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 343 MTSTexture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 346 MTSInstance2d. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 347 MTSMaterial . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 350 MTSTimeElem. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 351 MTSTimeElemSWFView . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 353 Physics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 355 FastConstraintSolver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 355 AngularDashpot . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 359 Actions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 360 DragAction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 360 FluidAction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 361 MagneticAction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 362 MotorAction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 364 viii CONTENTS SingleDragAction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 365 SimpleRigidWindAction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 366 Constraints . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 367 BreakableConstraint. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 367 HingeConstraint. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 368 PointToPointConstraint . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 369 PrismaticConstraint . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 370 StiffSpringConstraint . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 371 WheelConstraint . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 373 Colophon ADOBE ATMOSPHERE 1 User Guide Chapter 1: The Atmosphere Platform Welcome to the Adobe® AtmosphereTM platform ­ revolutionary software for creating immersive 3-D multimedia rich stage sets for delivery on the web and within PDF documents. What is Atmosphere? The Adobe® AtmosphereTM platform is a completely integrated end-to-end solution for creating 3-D interactive environments, delivering them over the web or within PDF documents, and allowing users to collaborate within them. The Atmosphere embedded multimedia type gives the web or document designer the ability to present a rich variety of interactive content, including three-dimensional objects, directional sound, streaming audio and video, SWF animations, and physical behaviors, all within the context of a live theater performance. Viewers of Atmosphere environments can move and interact freely within these spaces, and collaborate with each other. Atmosphere is different from other multimedia authoring tools in that it provides all of the tools and capabilities needed to author and play back realistic, immersive experiences within a 3-D stage set. Platform Features The Atmosphere platform integrates many features into a single application: Immersion Create environments with dramatic lighting, animated 3-D objects, real-time behavior, video and audio in small files embedded in a PDF or HTML doucment. Interactivity Atmosphere users can easily create realisitc enivronments and behavior thanks to the built-in JavaScript API and integrated physics engine. Users can interact realistically with environments, objects and avatars that can behave independently or under user control. Multimedia Atmosphere supports directional sounds, streaming video and audio, SWF animations and high definition 3-D objects including animations. Collaboration Add multi-user interaction with text chat, avatar motion and gestures, shared object synchronization and message passing, without additional server software or hardware. An HTTP server is all that's required. The Atmosphere Architecture The Atmosphere platform consists of 3 parts: Atmosphere An easy to use, powerful authoring application that can be used to create, import and manipulate 3-D objects, light, sound, images, textures, video and other multimedia; attach scripted behaviors to objects and environments; and securely publish these environments to the Web or PDF. 2 CHAPTER 1 Atmosphere Player A web browser plug-in that allows users to interactively view and navigate Atmosphere environments embedded in web pages. Atmosphere Player for Adobe ReaderTM enables users to access Atmosphere environments embedded in PDF documents. Atmosphere Collaboration Server A publicly available server, which allows messaging, object synchronization and interactivity between users of Atmosphere environments. Atmosphere Player The Adobe® AtmosphereTM Player® is a free application that allows users to view, interact, and collaborate with others in environments created with Atmosphere and published online or within PDF documents. Atmosphere environments can be viewed within a web page using the Player plug-in. Web Page Integration Atmosphere Player supports communication between web page HTML, Java and JavaScript allowing web designers full control of user experience using the Player's JavaScript API. A Multimedia Experience The Atmosphere Player offers the user a rich and interactive multimedia experience without requiring a high-bandwidth connection (56K normally suffices). Atmosphere environments can also be viewed in PDF documents using Atmosphere Player for Adobe ReaderTM. ADOBE ATMOSPHERE 3 User Guide Atmosphere Player System Requirements: · · · · · · · · Intel Pentium II or faster processor Microsoft® Windows® 98SE, Windows ME, Windows 2000, Windows XP Home or Pro 64 MB of available RAM (128 MB recommended) 14 MB of available hard-disk space 16-bit color (32-Bit Color recommended) 56K modem or faster Internet connection Microsoft Internet Explorer 5.00.2614.3500 and above. Graphic Card Support: Radeon 7500 or higher, GeForce 2 or higher Atmosphere Adobe® AtmosphereTM is a professional authoring tool for assembling and creating 3-D interactive environments. This new embedded multimedia type offers a unique way to present a rich variety of interactive content, including three-dimensional objects, sound, streaming audio and video, SWF animations, and physical behaviors. Atmosphere enables the designer to easily and quickly create content using intuitive tools. Users can import objects created with other 3-D authoring applications, add texture, media, interactivity and lighting and then publish the environment for use on the web or in PDF documents. 4 CHAPTER 1 Atmosphere offers powerful, intuitive creation tools. Import Standard Formats Atmosphere supports importing 3-D assets from applications, libraries and other sources via the Viewpoint media format (MTX, MTZ). Atmosphere also supports wide range of standard graphics and multimedia formats. Scene Modeling Create objects and combine them with imported assets to build a seamless environment. Apply global appearance properties such as lighting. Texture and fog using intuitive tools. Interactivity Add interactive elements to the environment using JavaScript and a real-world physics simulation engine. Publishing Output the resulting environment in a form that can be embedded in either a web page or a PDF document. Published worlds cannot be re-opened in Atmosphere, thus securing the author's intellectual property. Atmosphere System Requirements Atmosphere, like the Atmosphere Player, can run well on a minimal system configuration, but more powerful systems will improve the authoring experience. System requirements for Atmosphere are: · · Intel® Pentium® III or faster processor Microsoft® Windows XP Home or Pro ADOBE ATMOSPHERE 5 User Guide · · · · · 128 MB of available RAM (256 MB recommended) 50 MB of available hard-disk space 1,024x768 screen resolution 16-bit color (32-Bit Color recommended) Graphic Card Support: Radeon 7500 or higher, GeForce 2 or higher i Atmosphere is only available for the Windows XP platform. Atmosphere Collaboration Server The Atmosphere Collaboration Server is a publicly available server that offers messaging and collaboration within any Atmosphere environment. The source code for the Atmosphere Collaboration Server is available at no cost under a simple license from Adobe System. Why 3-D? The Atmosphere platform is designed to make the power of immersive media rich environments available to a much wider audience than has been previously possible. The web is a very popular way for individuals and organizations to present information, but until now, it has largely been limited to the same kinds of 2-D information that can be presented on a printed page. People are accustomed to a world that has height, width and depth. Technologies like the telephone, television and the web offer only a limited lower number of dimensions. Consider the difference in trying to learn to navigate an unfamiliar place like an airport: directions given over a telephone (1-D), via a map (2-D) or by means of a video flythrough (3-D) represent successively easier ways to learn an unfamiliar space. By making it possible to easily create 3-D environments that can be navigated online, Atmosphere extends a powerful medium to a much wider audience and range of applications. 6 CHAPTER 1 ADOBE ATMOSPHERE 7 User Guide Chapter 2: Exploring Atmosphere Environments Before we turn our attention to learning how to create interactive environments in Atmosphere, let's learn how to use the Atmosphere Player. The Player is a free plug-in that allows people to view and interact with Atmosphere environments embedded in web pages and PDF documents. Using the Atmosphere Player When you installed Atmosphere, the Player was installed automatically. If you need help with Atmosphere installation, please see Appendix A, "Installing and Configuring Atmosphere." Once installed, Atmosphere environments will be loaded in the Player automatically when you navigate to a web page or open a PDF document that contains an Atmosphere .aer file. If the Player isn't installed, a dialog box will appear asking if you wish to install it. i The Atmosphere Player features support for hardware acceleration. If the Player detects a supported video card, it will enable hardware acceleration automatically. This animated spinning globe icon and a progress bar will appear as the Atmosphere environment is loading. i When the spinning globe icon disappears, the geometry for the environment has completed loading and will be displayed. Textures and multimedia files will continue to download. Opening Local Atmosphere Files In addition to Atmosphere environments that are posted online, you can also open environments that are saved locally. To open a local environment, right-click in the Player window and select File > Open from the pop-up menu. This will open a file dialog box where you can select an Atmosphere environment to open. The Player can only open and view AER files, not ATMO files. 8 CHAPTER 2 Tutorial: Visiting Atmosphere Environments at Adobe.com You can begin to explore Atmosphere environments on the Atmosphere product pages at Adobe.com. You can find these pages at www.adobe.com/products/atmosphere. To browse the Atmosphere environments at Adobe.com, follow these steps: 1 Open a web browser and enter the URL http://www.adobe.com/products/atmosphere/. 2 The Adobe Atmosphere web pages will open. Click on one of the links under the Atmosphere Showcase heading in the left column. 3 The Atmosphere environment will load within the web page if the Player is installed. If not, you will be asked if you wish install the Player. Click Yes to install the Player if necessary. Once downloaded and installed, you will be able to view the Atmosphere environment. Atmosphere environments can be viewed from within a web page. Above is an environment built using Atmosphere and showcased on the Adobe site.