home *** CD-ROM | disk | FTP | other *** search
/ Stars of Shareware: Raytrace & Morphing / SOS-RAYTRACE.ISO / programm / 3dstudio / ipas / light.doc < prev    next >
Encoding:
Text File  |  1994-04-18  |  8.5 KB  |  170 lines
  1. README.TXT file for LIGHT_I.PXP
  2. A Shareware Lighting Utilities Program
  3.  
  4. To install LIGHT, copy the file LIGHT_I.PXP into your 3D Studio process
  5. directory, typically C:\3DS3\PROCESS.  The program is accessible from the 3D
  6. Editor by pressing F12 and choosing LIGHT from the list.
  7.  
  8. LIGHT provides the following functions: Light Style, Light Arrays, and Light
  9. Delete By Name.
  10.  
  11. LIGHT STYLES:
  12.   This function allows you to update existing lights in your scene with 
  13. new properties.  To do this, modify an existing light using the
  14. standard 3ds lighting adjust routines (Lights/Omni/Adjust, 
  15. Lights/Spot/Adjust...  This 'Prototype Light' will function as the 
  16. prototype for adjusting other lights.  Any or all properties of this light
  17. may be assigned to any other light in the scene.  In this way, the 
  18. 'Prototype Light' defines a 'Light Style'.
  19.  
  20. To test it out, load the test drawing LT-TEST.3DS provided in the Zip file.
  21.  
  22. -Adjust one of the lights, perhaps changing its color and Multiplier status.
  23. You might also turn it off, as this will make it easy to see the updated
  24. lights.  Note the name of the light.  This will be your 'Prototype'.
  25.  
  26. - Run LIGHT from the PXP loader pulldown (or press F12).  The main menu will
  27. come up.  Choose the Update radio button and then click "Next" or press ENTER.
  28.  
  29. - The 'Prototype for Update' dialog comes up, presenting you with a list of
  30. existing lights in the scene.  Choose the light you just updated (the 
  31. Prototype) and select "Next".
  32.  
  33. - Now the 'Choose the Lights to Update' dialog comes up.  This dialog is used
  34. to tag lights you wish to modify.  You may tag/untag by 3 methods:
  35.    1) Click on the name in the list.
  36.    2) Use the Tag/Untag buttons with wildcard characters * and ?.  This will 
  37.       tag/untag all lights that match the pattern.
  38.    3) Use the 'Quick Find' feature.  Click in the CYAN window above the 
  39.       Quick Find text. The window shows "----------" indicating you have not
  40.       made a selection yet.  Type characters which uniquely identify light
  41.       names in the list.  Quick Find will locate the first light in the list
  42.       whose name matches the entire sequence you have typed so far.  When you
  43.       have typed enough characters to locate the light you want, press the 
  44.       Spacebar or ENTER and the light will be tagged (or untagged). 
  45.       If you make an error and find an incorrect light, press ESC
  46.       to start over.  You may also invoke the quick find from the keyboard
  47.       by typing ~ (the tilde character).
  48. Note: If you pick an Omni light as the Prototype, only Omni lights show up 
  49. in the lights to alter list.  (Only lights of the same type are presented).
  50.  
  51. - Once you have selected all the lights to update, you are presented with
  52. the 'Parameters to Copy from the Prototype' dialog.  Via buttons, select 
  53. the properties of the prototype light you wish to copy to the lights you 
  54. have tagged.  Any properties you select get copied to each previously 
  55. tagged light.  Properties you did not select are left unaltered.
  56.  
  57. The options for Properties to Copy are:
  58.  
  59. [On/Off] -      If the Source if off, the tagged lights will be off.If the 
  60.                 source was on, the tagged lights will be on...
  61. [Color] -       Color of light
  62. [Exclude] -     Object Exclusion List
  63. [Multiplier] -  'Brightness factor' of light
  64. [Atten/Range] - Both Attenuation On/Off and light Range settings
  65. [Location] -    X/Y/Z coordinate of source
  66. [Shadows] -     All the shadow parameters: Cast Shadow On/Off, Mapped or
  67.                 Raytraced shadows, Bias value, Map size, Sample Range.
  68. [Cone/Ho/Fo] -  Cone visibility, Hotspot angle, Falloff angle
  69. [Target Pt] -   X/Y/Z location of spotlight target point of source.
  70. [Rect/Circ] -   Shape of hotspot/falloff areas.
  71. [Roll/Aspect] - Both the bank angle and aspect ratio.
  72. [Overshoot] -   Overshoot On/Off
  73. [Projector] -   Projector light On/Off and Image File (if On).
  74.  
  75. While in the dialog, if you forget the meaning of any of these, you can
  76. use 3ds style Alt-Mouseclick help.  A brief message will popup describing
  77. that button.  (This is also available on the main menu buttons.)
  78.  
  79. Note:  The Location parameter (and Target Pt for spotlights) control the 
  80. actual X/Y/Z location of the light in the scene.  If you select one of these
  81. options, all the tagged lights will be moved to the same location as the
  82. Prototype.  At times this may be handy, but at times it may be disasterous.
  83. You are given ample warning however!
  84.  
  85. Once you choose OK, and answer Yes to the confirmation prompt, all the tagged
  86. lights are update with the parameters you've choosen.  Do a Lights/Omni(Spot)/
  87. Adjust and check it out...
  88.  
  89. Two other functions are available which help support light styles:
  90. Light Array, and Light Delete.
  91.  
  92. LIGHT ARRAY:
  93. This function allows you to create both rectangular and polar (circular) 
  94. arrays of lights.  
  95.  
  96. Choose the Array function from the main menu, and select the prototype light.
  97. Again, this defines the style of all the created lights.  A dialog will be 
  98. presented for both types of arrays.  Choose the Radio button which 
  99. corresponds to the type of array you want to create. Note: This is fairly
  100. easy to forget.  You may find yourself just filling in the parameters, so
  101. be sure to check the type of array you want.
  102.  
  103. For rectangular arrays, you specify Width, Depth and Height
  104. Counts.  These represent the number of lights along that dimension of the 
  105. scene.  You also specify Width, Depth and Height Spacing.  This is the 
  106. center to center spacing of the lights.  The following example coordinate
  107. formats demonstrate what is available for the spacing parameters.
  108.  
  109. 2        (This would indicate 2 of whatever units you are in (", ', CM or M))
  110. 2.0"     (2 inches...)
  111. 5'2"
  112. 5'2-3/8" (Seperate the fraction from the whole number with the '-' sign)
  113. 5/32'    (3ds's denominator is not relevent.  Use whatever you need).
  114. 525.125'
  115.  
  116. Polar arrays use a Source light at the Center of the array.  The created lights
  117. are generated at a user defined plane and radius from this center point.
  118. The dialog prompts for the following values: Number of items (total number of
  119. lights to create), Radius (same formats as the spacing parameter described
  120. above), Construction Plane (Top/Front/Side).  This parameter lets you array
  121. the lights horizontally (Top plane), or vertically aligned with the Front 
  122. viewport (Front plane), or vertically aligned with the Side viewport (Side 
  123. plane).  The depth along the axis perpendicular to the plane is defined by
  124. where the source lights is along that axis.  Thus, if you want to create
  125. an array of lights parallel to the ground plane, 8' in the air, with 
  126. an overall diameter of 40', you would create your prototype light 8' high,
  127. and positioned wherever you need the center of the array.  Then specify
  128. the Top plane and a radius of 20'0".  You are also able to enter a start
  129. angle (0.0 degrees is to the right, along the horizontal axis).  Positive
  130. rotation is counter clockwise.  The final parameter is Angle to Fill.  If 
  131. set for 360 degrees, a complete circular array is generated.  For Spotlights,
  132. you can select the Rotate Spotlights button.  If off, all the spotlights
  133. retain their original orientation as they go around the circle.  If set to
  134. On, all the spotlight targets point toward the source light location.  The
  135. depth along the axis perpendicular to the construction plane is not altered.
  136. Experiment a bit with this, and you'll see what happens!
  137.  
  138. For both rectangular and polar arrays, a name prefix is requested.  You may 
  139. type up to 8 characters.  If you leave this field blank, the default prefix 
  140. is the name of the Prototype light for the array.  All created lights are
  141. named with the prefix and numbered sequentially.
  142.  
  143. LIGHT DELETE BY NAME:
  144.  
  145. This function uses the same 'Choose Lights' dialog box as described
  146. above.  Choose the lights you wish to delete and press OK.  After a 
  147. confirmation prompt, they are deleted.
  148.  
  149. SHAREWARE:
  150.  
  151. If you find this program useful to you, please register your copy.  Provide me
  152. with your Name, Address and Compuserve User ID.  I'm keeping a database of
  153. registered users and will inform those in the database when program updates
  154. are available.  Except for any major bug fixes, I do not plan to post any
  155. updated code, so if you want updates with new features, please register.
  156.  
  157. To register, send a check in the amount of $35.00 to:
  158.  
  159. Mark Meier
  160. 650 Hidden Valley #212
  161. Ann Arbor, Michigan 48104
  162.  
  163. If you have ideas for new features or changes to existing ones, please
  164. let me know.  Also, if you find any bugs, then certainly let me know!
  165.  
  166. Thanks and enjoy the program,
  167.  
  168. Mark Meier
  169. CIS: 76330,3402
  170.