Adobe ATMOSPHERE User manual

Adobe

®

Atmosphere

™

User Guide

Adobe

®

Atmosphere

™

User Guide

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 deﬁ 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 afﬁ 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 ﬁ 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

Deﬁ 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 Conﬁ 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 ﬁ 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

deﬁ 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 sufﬁ 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

conﬁ 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 ﬂ 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 Conﬁ 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 ﬁ 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 ﬁ 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 ﬁ le dialog box where you can select an Atmosphere environment to open.

The Player can only open and view AER ﬁ les, not ATMO ﬁ 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 ﬁ 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.

Page is loading ...

Adobe ATMOSPHERE User manual

Adobe ATMOSPHERE User manual

Related papers

Other documents