Page is loading ...
Adobe
®
Atmosphere
™
User Guide
Adobe
®
Atmosphere
™
User Guide
©2003 Adobe Systems Incorporated. All rights reserved.
Adobe® Atmosphere™ 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 defi ned 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 60-
1 through 60-60, 60-250, and 60-741. The affi rmative 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 fi t 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
Defi ning 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 Confi guring
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® Atmosphere™ 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® Atmosphere™ 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 fi les 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
defi nition 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 Reader™ 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® Atmosphere™ 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 suffi ces). Atmosphere environments can also be viewed in
PDF documents using Atmosphere Player for Adobe Reader™.
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® Atmosphere™ 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
confi guration, 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 fl y-
through (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 Confi guring 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 fi le. 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 fi les 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 fi le dialog box where you can select an Atmosphere environment to open.
The Player can only open and view AER fi les, not ATMO fi les.
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 fi nd
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.
/
