Difference between revisions of "Light modo 401 extension"

From COLLADA Public Wiki
Jump to: navigation, search
m (None)
(Undo revision 7102 by LLutz74 (talk))
 
Line 8: Line 8:
 
  | last_updated = 28 Aug 09}}
 
  | last_updated = 28 Aug 09}}
  
==<extra>/<technique profile="modo401">/<param> Elements==
+
==<extra>/<technique profile="modo401">/<param> Elements==
&lt;!--   
+
<!--   
 
           TIP: The ":" at the beginning of lines indents them.  
 
           TIP: The ":" at the beginning of lines indents them.  
 
-->
 
-->
:'''Category:''' '''(core)''' Lighting &lt;!-- fill in  --> (See [[list of specification categories]])
+
:'''Category:''' '''(core)''' Lighting <!-- fill in  --> (See [[list of specification categories]])
  
 
===Introduction===
 
===Introduction===
Describes custom light settings, including various light sub-types supported by modo 401.&lt;!-- fill in one sentence starting with a verb that describes purpose of this element -->
+
Describes custom light settings, including various light sub-types supported by modo 401.<!-- fill in one sentence starting with a verb that describes purpose of this element -->
  
 
===Concepts===
 
===Concepts===
:The modo render engine provides a general purpose collection of light settings and light sub-types, including both the basic directional, point, and spot lights specified by the common COLLADA technique, as well as more specialized light sub-types such as area lights and physically correct sunlights.&lt;!-- Background info needed to understand this element's purpose and place within COLLADA -->
+
:The modo render engine provides a general purpose collection of light settings and light sub-types, including both the basic directional, point, and spot lights specified by the common COLLADA technique, as well as more specialized light sub-types such as area lights and physically correct sunlights.<!-- Background info needed to understand this element's purpose and place within COLLADA -->
  
 
:{| {{prettytable}}
 
:{| {{prettytable}}
Line 32: Line 32:
 
|+ '''Related Elements'''
 
|+ '''Related Elements'''
 
!Parent element(s)
 
!Parent element(s)
| &lt;visual_scene>
+
| <visual_scene>
 
|-
 
|-
 
!Extra and/or Technique
 
!Extra and/or Technique
| &lt;extra>/&lt;technique profile="modo401">&lt;!-- e.g., &lt;extra type="foo">/&lt;technique profile="BAR"> -->
+
| <extra>/<technique profile="modo401"><!-- e.g., <extra type="foo">/<technique profile="BAR"> -->
 
|-
 
|-
 
!Child elements
 
!Child elements
| None &lt;!--  or state None -->
+
| None <!--  or state None -->
 
|-
 
|-
 
!Other
 
!Other
| &lt;!-- list any other relevant elements -->
+
| <!-- list any other relevant elements -->
 
|}
 
|}
  
Line 113: Line 113:
  
 
===Details===
 
===Details===
:modo 401 supports the following light sub-types, as indicated by the initial param element identified <span class="plainlinks">[http://www.thepiggybackrider.com/ <span style="color:black;font-weight:normal; text-decoration:none!important; background:none!important; text-decoration:none;/*CITATION*/">child carrier</span>]</span> by the "lightType" sid, as shown in the table, above, and also as shown in the example later in this article:&lt;!-- Additional info about how and where to use the element (and its children), lists of additional relevant links, detailed value tables for element or attribute values, etc. -->
+
:modo 401 supports the following light sub-types, as indicated by the initial param element identified by the "lightType" sid, as shown in the table, [[#Shared_Light_Param_Child_Elements|Shared Light Param Child Elements]] above, and also as shown in the example later in this article:<!-- Additional info about how and where to use the element (and its children), lists of additional relevant links, detailed value tables for element or attribute values, etc. -->
 
::* area_light
 
::* area_light
 
::* cylinder_light
 
::* cylinder_light
Line 123: Line 123:
 
:Each of these light sub-types shares common light param elements, followed by the light sub-type-specific params, as shown in the tables above.
 
:Each of these light sub-types shares common light param elements, followed by the light sub-type-specific params, as shown in the tables above.
 
===Examples===
 
===Examples===
&lt;!-- Really required. -->
+
<!-- Really required. -->
  
 
====area_light====
 
====area_light====
     &lt;library_lights>
+
     <library_lights>
         &lt;light id="Light-Area_Light" name="Area_Light">
+
         <light id="Light-Area_Light" name="Area_Light">
             &lt;technique_common>
+
             <technique_common>
                 &lt;point>
+
                 <point>
                     &lt;color sid="point_light_rgb">1 1 1&lt;/color>
+
                     <color sid="point_light_rgb">1 1 1</color>
                     &lt;quadratic_attenuation sid="quad_atten">1&lt;/quadratic_attenuation>
+
                     <quadratic_attenuation sid="quad_atten">1</quadratic_attenuation>
                 &lt;/point>
+
                 </point>
             &lt;/technique_common>
+
             </technique_common>
             &lt;extra>
+
             <extra>
                 &lt;technique profile="modo401">
+
                 <technique profile="modo401">
                     &lt;param sid="lightType" name="Light_Type" type="Name">area_light&lt;/param>
+
                     <param sid="lightType" name="Light_Type" type="Name">area_light</param>
                     &lt;param sid="render" name="Render" type="Name">default&lt;/param>
+
                     <param sid="render" name="Render" type="Name">default</param>
                     &lt;param sid="size" name="Display_Size" type="float">1&lt;/param>
+
                     <param sid="size" name="Display_Size" type="float">1</param>
                     &lt;param sid="dissolve" name="Dissolve" type="float">0&lt;/param>
+
                     <param sid="dissolve" name="Dissolve" type="float">0</param>
                     &lt;param sid="radiance" name="Radiant_Intensity" type="float">3&lt;/param>
+
                     <param sid="radiance" name="Radiant_Intensity" type="float">3</param>
                     &lt;param sid="samples" name="Samples" type="int">64&lt;/param>
+
                     <param sid="samples" name="Samples" type="int">64</param>
                     &lt;param sid="shadType" name="Shadow_Type" type="Name">raytrace&lt;/param>
+
                     <param sid="shadType" name="Shadow_Type" type="Name">raytrace</param>
                     &lt;param sid="shadRes" name="Shadow_Resolution" type="int">1024&lt;/param>
+
                     <param sid="shadRes" name="Shadow_Resolution" type="int">1024</param>
                     &lt;param sid="fast" name="Simple_Shading" type="bool">true&lt;/param>
+
                     <param sid="fast" name="Simple_Shading" type="bool">true</param>
                     &lt;param sid="width" name="Area_Width" type="float">1&lt;/param>
+
                     <param sid="width" name="Area_Width" type="float">1</param>
                     &lt;param sid="height" name="Area_Height" type="float">1&lt;/param>
+
                     <param sid="height" name="Area_Height" type="float">1</param>
                     &lt;param sid="shape" name="Area_Shape" type="Name">rectangle&lt;/param>
+
                     <param sid="shape" name="Area_Shape" type="Name">rectangle</param>
                 &lt;/technique>
+
                 </technique>
             &lt;/extra>
+
             </extra>
         &lt;/light>
+
         </light>
     &lt;/library_lights>
+
     </library_lights>
  
 
====cylinder_light====
 
====cylinder_light====
     &lt;library_lights>
+
     <library_lights>
         &lt;light id="Light-Cylinder_Light" name="Cylinder_Light">
+
         <light id="Light-Cylinder_Light" name="Cylinder_Light">
             &lt;technique_common>
+
             <technique_common>
                 &lt;point>
+
                 <point>
                     &lt;color sid="point_light_rgb">1 1 1&lt;/color>
+
                     <color sid="point_light_rgb">1 1 1</color>
                     &lt;quadratic_attenuation sid="quad_atten">1&lt;/quadratic_attenuation>
+
                     <quadratic_attenuation sid="quad_atten">1</quadratic_attenuation>
                 &lt;/point>
+
                 </point>
             &lt;/technique_common>
+
             </technique_common>
             &lt;extra>
+
             <extra>
                 &lt;technique profile="modo401">
+
                 <technique profile="modo401">
                     &lt;param sid="lightType" name="Light_Type" type="Name">cylinder_light&lt;/param>
+
                     <param sid="lightType" name="Light_Type" type="Name">cylinder_light</param>
                     &lt;param sid="render" name="Render" type="Name">default&lt;/param>
+
                     <param sid="render" name="Render" type="Name">default</param>
                     &lt;param sid="size" name="Display_Size" type="float">1&lt;/param>
+
                     <param sid="size" name="Display_Size" type="float">1</param>
                     &lt;param sid="dissolve" name="Dissolve" type="float">0&lt;/param>
+
                     <param sid="dissolve" name="Dissolve" type="float">0</param>
                     &lt;param sid="radiance" name="Radiant_Intensity" type="float">3&lt;/param>
+
                     <param sid="radiance" name="Radiant_Intensity" type="float">3</param>
                     &lt;param sid="samples" name="Samples" type="int">64&lt;/param>
+
                     <param sid="samples" name="Samples" type="int">64</param>
                     &lt;param sid="shadType" name="Shadow_Type" type="Name">raytrace&lt;/param>
+
                     <param sid="shadType" name="Shadow_Type" type="Name">raytrace</param>
                     &lt;param sid="shadRes" name="Shadow_Resolution" type="int">1024&lt;/param>
+
                     <param sid="shadRes" name="Shadow_Resolution" type="int">1024</param>
                     &lt;param sid="fast" name="Simple_Shading" type="bool">true&lt;/param>
+
                     <param sid="fast" name="Simple_Shading" type="bool">true</param>
                     &lt;param sid="length" name="Length" type="float">1&lt;/param>
+
                     <param sid="length" name="Length" type="float">1</param>
                     &lt;param sid="radius" name="Radius" type="float">0.2&lt;/param>
+
                     <param sid="radius" name="Radius" type="float">0.2</param>
                 &lt;/technique>
+
                 </technique>
             &lt;/extra>
+
             </extra>
         &lt;/light>
+
         </light>
     &lt;/library_lights>
+
     </library_lights>
  
 
====dome_light====
 
====dome_light====
     &lt;library_lights>
+
     <library_lights>
         &lt;light id="Light-Dome_Light" name="Dome_Light">
+
         <light id="Light-Dome_Light" name="Dome_Light">
             &lt;technique_common>
+
             <technique_common>
                 &lt;point>
+
                 <point>
                     &lt;color sid="point_light_rgb">1 1 1&lt;/color>
+
                     <color sid="point_light_rgb">1 1 1</color>
                     &lt;quadratic_attenuation sid="quad_atten">1&lt;/quadratic_attenuation>
+
                     <quadratic_attenuation sid="quad_atten">1</quadratic_attenuation>
                 &lt;/point>
+
                 </point>
             &lt;/technique_common>
+
             </technique_common>
             &lt;extra>
+
             <extra>
                 &lt;technique profile="modo401">
+
                 <technique profile="modo401">
                     &lt;param sid="lightType" name="Light_Type" type="Name">dome_light&lt;/param>
+
                     <param sid="lightType" name="Light_Type" type="Name">dome_light</param>
                     &lt;param sid="render" name="Render" type="Name">default&lt;/param>
+
                     <param sid="render" name="Render" type="Name">default</param>
                     &lt;param sid="size" name="Display_Size" type="float">1&lt;/param>
+
                     <param sid="size" name="Display_Size" type="float">1</param>
                     &lt;param sid="dissolve" name="Dissolve" type="float">0&lt;/param>
+
                     <param sid="dissolve" name="Dissolve" type="float">0</param>
                     &lt;param sid="radiance" name="Radiant_Intensity" type="float">3&lt;/param>
+
                     <param sid="radiance" name="Radiant_Intensity" type="float">3</param>
                     &lt;param sid="samples" name="Samples" type="int">64&lt;/param>
+
                     <param sid="samples" name="Samples" type="int">64</param>
                     &lt;param sid="shadType" name="Shadow_Type" type="Name">raytrace&lt;/param>
+
                     <param sid="shadType" name="Shadow_Type" type="Name">raytrace</param>
                     &lt;param sid="shadRes" name="Shadow_Resolution" type="int">1024&lt;/param>
+
                     <param sid="shadRes" name="Shadow_Resolution" type="int">1024</param>
                     &lt;param sid="fast" name="Simple_Shading" type="bool">true&lt;/param>
+
                     <param sid="fast" name="Simple_Shading" type="bool">true</param>
                     &lt;param sid="radius" name="Radius" type="float">10&lt;/param>
+
                     <param sid="radius" name="Radius" type="float">10</param>
                 &lt;/technique>
+
                 </technique>
             &lt;/extra>
+
             </extra>
         &lt;/light>
+
         </light>
     &lt;/library_lights>
+
     </library_lights>
  
 
====point_light====
 
====point_light====
     &lt;library_lights>
+
     <library_lights>
         &lt;light id="Light-Point_Light" name="Point_Light">
+
         <light id="Light-Point_Light" name="Point_Light">
             &lt;technique_common>
+
             <technique_common>
                 &lt;point>
+
                 <point>
                     &lt;color sid="point_light_rgb">1 1 1&lt;/color>
+
                     <color sid="point_light_rgb">1 1 1</color>
                     &lt;quadratic_attenuation sid="quad_atten">1&lt;/quadratic_attenuation>
+
                     <quadratic_attenuation sid="quad_atten">1</quadratic_attenuation>
                 &lt;/point>
+
                 </point>
             &lt;/technique_common>
+
             </technique_common>
             &lt;extra>
+
             <extra>
                 &lt;technique profile="modo401">
+
                 <technique profile="modo401">
                     &lt;param sid="lightType" name="Light_Type" type="Name">point_light&lt;/param>
+
                     <param sid="lightType" name="Light_Type" type="Name">point_light</param>
                     &lt;param sid="render" name="Render" type="Name">default&lt;/param>
+
                     <param sid="render" name="Render" type="Name">default</param>
                     &lt;param sid="size" name="Display_Size" type="float">1&lt;/param>
+
                     <param sid="size" name="Display_Size" type="float">1</param>
                     &lt;param sid="dissolve" name="Dissolve" type="float">0&lt;/param>
+
                     <param sid="dissolve" name="Dissolve" type="float">0</param>
                     &lt;param sid="radiance" name="Radiant_Intensity" type="float">3&lt;/param>
+
                     <param sid="radiance" name="Radiant_Intensity" type="float">3</param>
                     &lt;param sid="samples" name="Samples" type="int">64&lt;/param>
+
                     <param sid="samples" name="Samples" type="int">64</param>
                     &lt;param sid="shadType" name="Shadow_Type" type="Name">raytrace&lt;/param>
+
                     <param sid="shadType" name="Shadow_Type" type="Name">raytrace</param>
                     &lt;param sid="shadRes" name="Shadow_Resolution" type="int">1024&lt;/param>
+
                     <param sid="shadRes" name="Shadow_Resolution" type="int">1024</param>
                     &lt;param sid="fast" name="Simple_Shading" type="bool">true&lt;/param>
+
                     <param sid="fast" name="Simple_Shading" type="bool">true</param>
                     &lt;param sid="radius" name="Radius" type="float">0&lt;/param>
+
                     <param sid="radius" name="Radius" type="float">0</param>
                     &lt;param sid="volumetrics" name="Volumetrics" type="bool">false&lt;/param>
+
                     <param sid="volumetrics" name="Volumetrics" type="bool">false</param>
                     &lt;param sid="vdissolve" name="Volumetrics_Dissolve" type="float">0&lt;/param>
+
                     <param sid="vdissolve" name="Volumetrics_Dissolve" type="float">0</param>
                     &lt;param sid="vsamples" name="Volumetric_Samples" type="int">40&lt;/param>
+
                     <param sid="vsamples" name="Volumetric_Samples" type="int">40</param>
                     &lt;param sid="vrad" name="Volumetric_Sphere_Radius" type="float">1&lt;/param>
+
                     <param sid="vrad" name="Volumetric_Sphere_Radius" type="float">1</param>
                 &lt;/technique>
+
                 </technique>
             &lt;/extra>
+
             </extra>
         &lt;/light>
+
         </light>
     &lt;/library_lights>
+
     </library_lights>
  
 
====spot_light====
 
====spot_light====
     &lt;library_lights>
+
     <library_lights>
         &lt;light id="Light-Spot_Light" name="Spot_Light">
+
         <light id="Light-Spot_Light" name="Spot_Light">
             &lt;technique_common>
+
             <technique_common>
                 &lt;spot>
+
                 <spot>
                     &lt;color sid="spot_light_rgb">1 1 1&lt;/color>
+
                     <color sid="spot_light_rgb">1 1 1</color>
                     &lt;quadratic_attenuation sid="quad_atten">1&lt;/quadratic_attenuation>
+
                     <quadratic_attenuation sid="quad_atten">1</quadratic_attenuation>
                     &lt;falloff_angle sid="falloff_deg">45&lt;/falloff_angle>
+
                     <falloff_angle sid="falloff_deg">45</falloff_angle>
                 &lt;/spot>
+
                 </spot>
             &lt;/technique_common>
+
             </technique_common>
             &lt;extra>
+
             <extra>
                 &lt;technique profile="modo401">
+
                 <technique profile="modo401">
                     &lt;param sid="lightType" name="Light_Type" type="Name">spot_light&lt;/param>
+
                     <param sid="lightType" name="Light_Type" type="Name">spot_light</param>
                     &lt;param sid="render" name="Render" type="Name">default&lt;/param>
+
                     <param sid="render" name="Render" type="Name">default</param>
                     &lt;param sid="size" name="Display_Size" type="float">1&lt;/param>
+
                     <param sid="size" name="Display_Size" type="float">1</param>
                     &lt;param sid="dissolve" name="Dissolve" type="float">0&lt;/param>
+
                     <param sid="dissolve" name="Dissolve" type="float">0</param>
                     &lt;param sid="radiance" name="Radiant_Intensity" type="float">3&lt;/param>
+
                     <param sid="radiance" name="Radiant_Intensity" type="float">3</param>
                     &lt;param sid="samples" name="Samples" type="int">64&lt;/param>
+
                     <param sid="samples" name="Samples" type="int">64</param>
                     &lt;param sid="shadType" name="Shadow_Type" type="Name">raytrace&lt;/param>
+
                     <param sid="shadType" name="Shadow_Type" type="Name">raytrace</param>
                     &lt;param sid="shadRes" name="Shadow_Resolution" type="int">1024&lt;/param>
+
                     <param sid="shadRes" name="Shadow_Resolution" type="int">1024</param>
                     &lt;param sid="fast" name="Simple_Shading" type="bool">true&lt;/param>
+
                     <param sid="fast" name="Simple_Shading" type="bool">true</param>
                     &lt;param sid="cone" name="Cone_Angle" type="float">0.785398&lt;/param>
+
                     <param sid="cone" name="Cone_Angle" type="float">0.785398</param>
                     &lt;param sid="edge" name="Soft_Edge_Angle" type="float">0.0872665&lt;/param>
+
                     <param sid="edge" name="Soft_Edge_Angle" type="float">0.0872665</param>
                     &lt;param sid="outside" name="Outside" type="bool">false&lt;/param>
+
                     <param sid="outside" name="Outside" type="bool">false</param>
                     &lt;param sid="volumetrics" name="Volumetrics" type="bool">false&lt;/param>
+
                     <param sid="volumetrics" name="Volumetrics" type="bool">false</param>
                     &lt;param sid="vdissolve" name="Volumetrics_Dissolve" type="float">0&lt;/param>
+
                     <param sid="vdissolve" name="Volumetrics_Dissolve" type="float">0</param>
                     &lt;param sid="vsamples" name="Volumetric_Samples" type="int">40&lt;/param>
+
                     <param sid="vsamples" name="Volumetric_Samples" type="int">40</param>
                 &lt;/technique>
+
                 </technique>
             &lt;/extra>
+
             </extra>
         &lt;/light>
+
         </light>
     &lt;/library_lights>
+
     </library_lights>
  
 
====sun_light====
 
====sun_light====
     &lt;library_lights>
+
     <library_lights>
         &lt;light id="Light-Directional_Light" name="Directional_Light">
+
         <light id="Light-Directional_Light" name="Directional_Light">
             &lt;technique_common>
+
             <technique_common>
                 &lt;directional>
+
                 <directional>
                     &lt;color sid="directional_light_rgb">1 1 1&lt;/color>
+
                     <color sid="directional_light_rgb">1 1 1</color>
                 &lt;/directional>
+
                 </directional>
             &lt;/technique_common>
+
             </technique_common>
             &lt;extra>
+
             <extra>
                 &lt;technique profile="modo401">
+
                 <technique profile="modo401">
                     &lt;param sid="lightType" name="Light_Type" type="Name">sun_light&lt;/param>
+
                     <param sid="lightType" name="Light_Type" type="Name">sun_light</param>
                     &lt;param sid="render" name="Render" type="Name">default&lt;/param>
+
                     <param sid="render" name="Render" type="Name">default</param>
                     &lt;param sid="size" name="Display_Size" type="float">1&lt;/param>
+
                     <param sid="size" name="Display_Size" type="float">1</param>
                     &lt;param sid="dissolve" name="Dissolve" type="float">0&lt;/param>
+
                     <param sid="dissolve" name="Dissolve" type="float">0</param>
                     &lt;param sid="radiance" name="Radiant_Intensity" type="float">3&lt;/param>
+
                     <param sid="radiance" name="Radiant_Intensity" type="float">3</param>
                     &lt;param sid="samples" name="Samples" type="int">64&lt;/param>
+
                     <param sid="samples" name="Samples" type="int">64</param>
                     &lt;param sid="shadType" name="Shadow_Type" type="Name">raytrace&lt;/param>
+
                     <param sid="shadType" name="Shadow_Type" type="Name">raytrace</param>
                     &lt;param sid="shadRes" name="Shadow_Resolution" type="int">1024&lt;/param>
+
                     <param sid="shadRes" name="Shadow_Resolution" type="int">1024</param>
                     &lt;param sid="fast" name="Simple_Shading" type="bool">true&lt;/param>
+
                     <param sid="fast" name="Simple_Shading" type="bool">true</param>
                     &lt;param sid="azimuth" name="Azimuth" type="float">0&lt;/param>
+
                     <param sid="azimuth" name="Azimuth" type="float">0</param>
                     &lt;param sid="clamp" name="Clamp_Intensity" type="bool">true&lt;/param>
+
                     <param sid="clamp" name="Clamp_Intensity" type="bool">true</param>
                     &lt;param sid="day" name="Day" type="int">2009172&lt;/param>
+
                     <param sid="day" name="Day" type="int">2009172</param>
                     &lt;param sid="elevation" name="Elevation" type="float">0&lt;/param>
+
                     <param sid="elevation" name="Elevation" type="float">0</param>
                     &lt;param sid="haze" name="Haze" type="float">2&lt;/param>
+
                     <param sid="haze" name="Haze" type="float">2</param>
                     &lt;param sid="height" name="Height" type="float">10&lt;/param>
+
                     <param sid="height" name="Height" type="float">10</param>
                     &lt;param sid="lat" name="Latitude" type="float">0.655057&lt;/param>
+
                     <param sid="lat" name="Latitude" type="float">0.655057</param>
                     &lt;param sid="lon" name="Longitude" type="float">-2.13456&lt;/param>
+
                     <param sid="lon" name="Longitude" type="float">-2.13456</param>
                     &lt;param sid="mapSize" name="Map_Size" type="float">2&lt;/param>
+
                     <param sid="mapSize" name="Map_Size" type="float">2</param>
                     &lt;param sid="north" name="North" type="float">0&lt;/param>
+
                     <param sid="north" name="North" type="float">0</param>
                     &lt;param sid="radius" name="Radius" type="float">0.5&lt;/param>
+
                     <param sid="radius" name="Radius" type="float">0.5</param>
                     &lt;param sid="spread" name="Spread" type="float">0&lt;/param>
+
                     <param sid="spread" name="Spread" type="float">0</param>
                     &lt;param sid="sunPos" name="Sun_Position" type="bool">false&lt;/param>
+
                     <param sid="sunPos" name="Sun_Position" type="bool">false</param>
                     &lt;param sid="time" name="Time" type="float">12&lt;/param>
+
                     <param sid="time" name="Time" type="float">12</param>
                     &lt;param sid="timeZone" name="Time_Zone" type="float">-8&lt;/param>
+
                     <param sid="timeZone" name="Time_Zone" type="float">-8</param>
                     &lt;param sid="volumetrics" name="Volumetrics" type="bool">false&lt;/param>
+
                     <param sid="volumetrics" name="Volumetrics" type="bool">false</param>
                     &lt;param sid="vdissolve" name="Volumetrics_Dissolve" type="float">0&lt;/param>
+
                     <param sid="vdissolve" name="Volumetrics_Dissolve" type="float">0</param>
                     &lt;param sid="vsamples" name="Volumetric_Samples" type="int">40&lt;/param>
+
                     <param sid="vsamples" name="Volumetric_Samples" type="int">40</param>
                 &lt;/technique>
+
                 </technique>
             &lt;/extra>
+
             </extra>
         &lt;/light>
+
         </light>
     &lt;/library_lights>
+
     </library_lights>
  
 
===Status===
 
===Status===
:&lt;!-- Status can be one of: Incomplete, Complete, Released product version, Obsolete -->
+
:<!-- Status can be one of: Incomplete, Complete, Released product version, Obsolete -->
  
 
===IP Status===
 
===IP Status===
:&lt;!-- Document any known patents or other IP claims that may prohibit royalty-free implementation of the extension, or impose other constraints on implementations -->
+
:<!-- Document any known patents or other IP claims that may prohibit royalty-free implementation of the extension, or impose other constraints on implementations -->
  
 
===Dependencies===
 
===Dependencies===
:&lt;!-- List the COLLADA version(s) required by this extension as well as any other dependencies -->
+
:<!-- List the COLLADA version(s) required by this extension as well as any other dependencies -->
  
 
===Issues===
 
===Issues===
:&lt;!-- List remaining open issues, or closed issues whose resolution set a precedent or was otherwise especially interesting. Briefly describe each issue, options considered, the choice made, and the reason for that choice -->
+
:<!-- List remaining open issues, or closed issues whose resolution set a precedent or was otherwise especially interesting. Briefly describe each issue, options considered, the choice made, and the reason for that choice -->

Latest revision as of 18:06, 26 September 2011

Extension information
This article is part of the COLLADA extensions directory
Adding to the extensions directory

<extra>/<technique profile="modo401">/<param> Elements

Category: (core) Lighting (See list of specification categories)

Introduction

Describes custom light settings, including various light sub-types supported by modo 401.

Concepts

The modo render engine provides a general purpose collection of light settings and light sub-types, including both the basic directional, point, and spot lights specified by the common COLLADA technique, as well as more specialized light sub-types such as area lights and physically correct sunlights.
Attributes
Name Type Description Required?
sid xs:ncname A unique symbol within the technique; one for each param. Yes
name xs:ncname A user-friendly name for the param. No
Related Elements
Parent element(s) <visual_scene>
Extra and/or Technique <extra>/<technique profile="modo401">
Child elements None
Other

Shared Light Param Child Elements

Table of Shared Light Param Child Elements
sid name Description type Default Occurrences Named values
lightType Light_Type Sub-type of the light Name N/A 1 area_light, cylinder_light, dome_light, photometric_light, point_light, spot_light, sun_light
render Render If light contributes to the final rendered scene Name default 0 or 1 on, off, default
size Display_Size Size of the light apparatus in the 3D viewport float 1.0 0 or 1
dissolve Dissolve Amount by which light effect is faded float 0.0 0 or 1
radiance Radiant_Intensity Watts per volumetric meter float 3.0 1
samples Samples Samples used for soft edge shadows int 64 0 or 1
shadType Shadow_Type Shadow rendering method Name raytrace 0 or 1 none, raytrace, shadowmap
shadRes Shadow_Resolution Resolution of calculated deep shadow map int 1024 0 or 1
fast Simple_Shading If specular and diffuse calculated regardless of spread angle bool true 0 or 1

Sunlight Sub-type Child Elements

Table of "sun_light" Sub-type Child Elements
sid name Description type Default Occurrences Named values
azimuth Azimuth Arc of the horizon measured clockwise float 0 1
clamp Clamp_Intensity If overall brightness of the sun is limited bool true 1
day Day Year * 1000 + Day of the Year int 2009172 1
elevation Elevation Angle of altitude off the horizon float 0 1
haze Haze Amount of haze in the air float 2 1
height Height Depth of volume extending from front of light float 10 1
lat Latitude Latitude in radians float 0.655057 1
lon Longitude Longitude in radians float -2.13456 1
mapSize Map_Size Size of shadow map, in meters float 2 1
north North Offset for north direction float 0 1
radius Radius Circular region around the light, where volume effect originates float 0.5 1
spread Spread Angle to control edge softness float 0 1
sunPos Sun_Position Physical sun positioned by time and location. bool false 0 or 1
time Time Time of day float 12 0 or 1
timeZone Time_Zone Time zone float -8 0 or 1
volumetrics Volumetrics If volumetric lighting is enabled. bool false 0 or 1
vdissolve Volumetrics_Dissolve Percentage to fade volumetrics by. float 0 0 or 1
vsamples Volumetric_Samples Number of samples for volumetrics. int 40 0 or 1

Details

modo 401 supports the following light sub-types, as indicated by the initial param element identified by the "lightType" sid, as shown in the table, Shared Light Param Child Elements above, and also as shown in the example later in this article:
  • area_light
  • cylinder_light
  • dome_light
  • photometric_light
  • point_light
  • spot_light
  • sun_light
Each of these light sub-types shares common light param elements, followed by the light sub-type-specific params, as shown in the tables above.

Examples

area_light

   <library_lights>
       <light id="Light-Area_Light" name="Area_Light">
           <technique_common>
               <point>
                   <color sid="point_light_rgb">1 1 1</color>
                   <quadratic_attenuation sid="quad_atten">1</quadratic_attenuation>
               </point>
           </technique_common>
           <extra>
               <technique profile="modo401">
                   <param sid="lightType" name="Light_Type" type="Name">area_light</param>
                   <param sid="render" name="Render" type="Name">default</param>
                   <param sid="size" name="Display_Size" type="float">1</param>
                   <param sid="dissolve" name="Dissolve" type="float">0</param>
                   <param sid="radiance" name="Radiant_Intensity" type="float">3</param>
                   <param sid="samples" name="Samples" type="int">64</param>
                   <param sid="shadType" name="Shadow_Type" type="Name">raytrace</param>
                   <param sid="shadRes" name="Shadow_Resolution" type="int">1024</param>
                   <param sid="fast" name="Simple_Shading" type="bool">true</param>
                   <param sid="width" name="Area_Width" type="float">1</param>
                   <param sid="height" name="Area_Height" type="float">1</param>
                   <param sid="shape" name="Area_Shape" type="Name">rectangle</param>
               </technique>
           </extra>
       </light>
   </library_lights>

cylinder_light

   <library_lights>
       <light id="Light-Cylinder_Light" name="Cylinder_Light">
           <technique_common>
               <point>
                   <color sid="point_light_rgb">1 1 1</color>
                   <quadratic_attenuation sid="quad_atten">1</quadratic_attenuation>
               </point>
           </technique_common>
           <extra>
               <technique profile="modo401">
                   <param sid="lightType" name="Light_Type" type="Name">cylinder_light</param>
                   <param sid="render" name="Render" type="Name">default</param>
                   <param sid="size" name="Display_Size" type="float">1</param>
                   <param sid="dissolve" name="Dissolve" type="float">0</param>
                   <param sid="radiance" name="Radiant_Intensity" type="float">3</param>
                   <param sid="samples" name="Samples" type="int">64</param>
                   <param sid="shadType" name="Shadow_Type" type="Name">raytrace</param>
                   <param sid="shadRes" name="Shadow_Resolution" type="int">1024</param>
                   <param sid="fast" name="Simple_Shading" type="bool">true</param>
                   <param sid="length" name="Length" type="float">1</param>
                   <param sid="radius" name="Radius" type="float">0.2</param>
               </technique>
           </extra>
       </light>
   </library_lights>

dome_light

   <library_lights>
       <light id="Light-Dome_Light" name="Dome_Light">
           <technique_common>
               <point>
                   <color sid="point_light_rgb">1 1 1</color>
                   <quadratic_attenuation sid="quad_atten">1</quadratic_attenuation>
               </point>
           </technique_common>
           <extra>
               <technique profile="modo401">
                   <param sid="lightType" name="Light_Type" type="Name">dome_light</param>
                   <param sid="render" name="Render" type="Name">default</param>
                   <param sid="size" name="Display_Size" type="float">1</param>
                   <param sid="dissolve" name="Dissolve" type="float">0</param>
                   <param sid="radiance" name="Radiant_Intensity" type="float">3</param>
                   <param sid="samples" name="Samples" type="int">64</param>
                   <param sid="shadType" name="Shadow_Type" type="Name">raytrace</param>
                   <param sid="shadRes" name="Shadow_Resolution" type="int">1024</param>
                   <param sid="fast" name="Simple_Shading" type="bool">true</param>
                   <param sid="radius" name="Radius" type="float">10</param>
               </technique>
           </extra>
       </light>
   </library_lights>

point_light

   <library_lights>
       <light id="Light-Point_Light" name="Point_Light">
           <technique_common>
               <point>
                   <color sid="point_light_rgb">1 1 1</color>
                   <quadratic_attenuation sid="quad_atten">1</quadratic_attenuation>
               </point>
           </technique_common>
           <extra>
               <technique profile="modo401">
                   <param sid="lightType" name="Light_Type" type="Name">point_light</param>
                   <param sid="render" name="Render" type="Name">default</param>
                   <param sid="size" name="Display_Size" type="float">1</param>
                   <param sid="dissolve" name="Dissolve" type="float">0</param>
                   <param sid="radiance" name="Radiant_Intensity" type="float">3</param>
                   <param sid="samples" name="Samples" type="int">64</param>
                   <param sid="shadType" name="Shadow_Type" type="Name">raytrace</param>
                   <param sid="shadRes" name="Shadow_Resolution" type="int">1024</param>
                   <param sid="fast" name="Simple_Shading" type="bool">true</param>
                   <param sid="radius" name="Radius" type="float">0</param>
                   <param sid="volumetrics" name="Volumetrics" type="bool">false</param>
                   <param sid="vdissolve" name="Volumetrics_Dissolve" type="float">0</param>
                   <param sid="vsamples" name="Volumetric_Samples" type="int">40</param>
                   <param sid="vrad" name="Volumetric_Sphere_Radius" type="float">1</param>
               </technique>
           </extra>
       </light>
   </library_lights>

spot_light

   <library_lights>
       <light id="Light-Spot_Light" name="Spot_Light">
           <technique_common>
               <spot>
                   <color sid="spot_light_rgb">1 1 1</color>
                   <quadratic_attenuation sid="quad_atten">1</quadratic_attenuation>
                   <falloff_angle sid="falloff_deg">45</falloff_angle>
               </spot>
           </technique_common>
           <extra>
               <technique profile="modo401">
                   <param sid="lightType" name="Light_Type" type="Name">spot_light</param>
                   <param sid="render" name="Render" type="Name">default</param>
                   <param sid="size" name="Display_Size" type="float">1</param>
                   <param sid="dissolve" name="Dissolve" type="float">0</param>
                   <param sid="radiance" name="Radiant_Intensity" type="float">3</param>
                   <param sid="samples" name="Samples" type="int">64</param>
                   <param sid="shadType" name="Shadow_Type" type="Name">raytrace</param>
                   <param sid="shadRes" name="Shadow_Resolution" type="int">1024</param>
                   <param sid="fast" name="Simple_Shading" type="bool">true</param>
                   <param sid="cone" name="Cone_Angle" type="float">0.785398</param>
                   <param sid="edge" name="Soft_Edge_Angle" type="float">0.0872665</param>
                   <param sid="outside" name="Outside" type="bool">false</param>
                   <param sid="volumetrics" name="Volumetrics" type="bool">false</param>
                   <param sid="vdissolve" name="Volumetrics_Dissolve" type="float">0</param>
                   <param sid="vsamples" name="Volumetric_Samples" type="int">40</param>
               </technique>
           </extra>
       </light>
   </library_lights>

sun_light

   <library_lights>
       <light id="Light-Directional_Light" name="Directional_Light">
           <technique_common>
               <directional>
                   <color sid="directional_light_rgb">1 1 1</color>
               </directional>
           </technique_common>
           <extra>
                <technique profile="modo401">
                   <param sid="lightType" name="Light_Type" type="Name">sun_light</param>
                   <param sid="render" name="Render" type="Name">default</param>
                   <param sid="size" name="Display_Size" type="float">1</param>
                   <param sid="dissolve" name="Dissolve" type="float">0</param>
                   <param sid="radiance" name="Radiant_Intensity" type="float">3</param>
                   <param sid="samples" name="Samples" type="int">64</param>
                   <param sid="shadType" name="Shadow_Type" type="Name">raytrace</param>
                   <param sid="shadRes" name="Shadow_Resolution" type="int">1024</param>
                   <param sid="fast" name="Simple_Shading" type="bool">true</param>
                   <param sid="azimuth" name="Azimuth" type="float">0</param>
                   <param sid="clamp" name="Clamp_Intensity" type="bool">true</param>
                   <param sid="day" name="Day" type="int">2009172</param>
                   <param sid="elevation" name="Elevation" type="float">0</param>
                   <param sid="haze" name="Haze" type="float">2</param>
                   <param sid="height" name="Height" type="float">10</param>
                   <param sid="lat" name="Latitude" type="float">0.655057</param>
                   <param sid="lon" name="Longitude" type="float">-2.13456</param>
                   <param sid="mapSize" name="Map_Size" type="float">2</param>
                   <param sid="north" name="North" type="float">0</param>
                   <param sid="radius" name="Radius" type="float">0.5</param>
                   <param sid="spread" name="Spread" type="float">0</param>
                   <param sid="sunPos" name="Sun_Position" type="bool">false</param>
                   <param sid="time" name="Time" type="float">12</param>
                   <param sid="timeZone" name="Time_Zone" type="float">-8</param>
                   <param sid="volumetrics" name="Volumetrics" type="bool">false</param>
                   <param sid="vdissolve" name="Volumetrics_Dissolve" type="float">0</param>
                   <param sid="vsamples" name="Volumetric_Samples" type="int">40</param>
               </technique>
           </extra>
       </light>
   </library_lights>

Status

IP Status

Dependencies

Issues