Adobe 65036570 User Guide - Page 382

ADOBE DIRECTOR 11.0 371 User Guide Lights and cameras have the same transform methods and parent-child properties as models and groups. Lights and cameras can be added, deleted, cloned, moved, and rotated in the same ways as models and groups. You can access their names, parents, children, and other properties in the same way you would with models and groups. However, there are some important differences, which arise from the specific roles that lights and cameras play in the 3D world. Light properties Use the following properties to work with lights: Property Name name parent child.count transform userData type color Access Get Get and set Get Get and set Get and set Get and set Get and set Description Default Unique name of this light. If the light was exported from a 3D modeling package, the name is the name assigned there. None The model, light, camera, or group that is this light's parent. If the light has no parent, it cannot contribute light. Group ("World") Number of the light's immediate children (no 0 grandchildren). Transform object representing light's position relative to its parent's transform. The transform.position gives the relative position; transform.rotation gives the relative rotation. Whichever transform is required to represent the light's position and orientation in space. A property list associated with this light. The list defaults to the properties assigned in the 3D modeling tool, but users can add or delete properties at any time. Properties assigned in 3D modeling tool The type of light. Must be one of the following: None #ambient: applied to all sides of the model #directional: applied to those parts of the light facing the light's direction. Distance to the light isn't important. #point: Like a bare light bulb, omnidirectional and illuminating all parts of the model facing the light. #spot: Like a spotlight, casting light on model parts that face it, with brighter illumination the closer the model is. Similar to #directional, except that the apparent distance from the light is taken into account. Color object defining color and intensity. Ranges color(191,191, from color(255,255,255), which is pure white to 191) color(0,0,0), which is no light at all.