Difference between revisions of "Light modo 401 extension"

From COLLADA Public Wiki
Jump to: navigation, search
(added new template sections. needs update.)
m (None)
Line 8: Line 8:
 
  | last_updated = 28 Aug 09}}
 
  | last_updated = 28 Aug 09}}
  
==<extra>/<technique profile="modo401">/<param> Elements==
+
==&lt;extra>/&lt;technique profile="modo401">/&lt;param> Elements==
<!--   
+
&lt;!--   
 
           TIP: The ":" at the beginning of lines indents them.  
 
           TIP: The ":" at the beginning of lines indents them.  
 
-->
 
-->
:'''Category:''' '''(core)''' Lighting <!-- fill in  --> (See [[list of specification categories]])
+
:'''Category:''' '''(core)''' Lighting &lt;!-- fill in  --> (See [[list of specification categories]])
  
 
===Introduction===
 
===Introduction===
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 -->
+
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 -->
  
 
===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.<!-- 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.&lt;!-- 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)
| <visual_scene>
+
| &lt;visual_scene>
 
|-
 
|-
 
!Extra and/or Technique
 
!Extra and/or Technique
| <extra>/<technique profile="modo401"><!-- e.g., <extra type="foo">/<technique profile="BAR"> -->
+
| &lt;extra>/&lt;technique profile="modo401">&lt;!-- e.g., &lt;extra type="foo">/&lt;technique profile="BAR"> -->
 
|-
 
|-
 
!Child elements
 
!Child elements
| None <!--  or state None -->
+
| None &lt;!--  or state None -->
 
|-
 
|-
 
!Other
 
!Other
| <!-- list any other relevant elements -->
+
| &lt;!-- 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 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. -->
+
: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. -->
 
::* 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===
<!-- Really required. -->
+
&lt;!-- Really required. -->
  
 
====area_light====
 
====area_light====
     <library_lights>
+
     &lt;library_lights>
         <light id="Light-Area_Light" name="Area_Light">
+
         &lt;light id="Light-Area_Light" name="Area_Light">
             <technique_common>
+
             &lt;technique_common>
                 <point>
+
                 &lt;point>
                     <color sid="point_light_rgb">1 1 1</color>
+
                     &lt;color sid="point_light_rgb">1 1 1&lt;/color>
                     <quadratic_attenuation sid="quad_atten">1</quadratic_attenuation>
+
                     &lt;quadratic_attenuation sid="quad_atten">1&lt;/quadratic_attenuation>
                 </point>
+
                 &lt;/point>
             </technique_common>
+
             &lt;/technique_common>
             <extra>
+
             &lt;extra>
                 <technique profile="modo401">
+
                 &lt;technique profile="modo401">
                     <param sid="lightType" name="Light_Type" type="Name">area_light</param>
+
                     &lt;param sid="lightType" name="Light_Type" type="Name">area_light&lt;/param>
                     <param sid="render" name="Render" type="Name">default</param>
+
                     &lt;param sid="render" name="Render" type="Name">default&lt;/param>
                     <param sid="size" name="Display_Size" type="float">1</param>
+
                     &lt;param sid="size" name="Display_Size" type="float">1&lt;/param>
                     <param sid="dissolve" name="Dissolve" type="float">0</param>
+
                     &lt;param sid="dissolve" name="Dissolve" type="float">0&lt;/param>
                     <param sid="radiance" name="Radiant_Intensity" type="float">3</param>
+
                     &lt;param sid="radiance" name="Radiant_Intensity" type="float">3&lt;/param>
                     <param sid="samples" name="Samples" type="int">64</param>
+
                     &lt;param sid="samples" name="Samples" type="int">64&lt;/param>
                     <param sid="shadType" name="Shadow_Type" type="Name">raytrace</param>
+
                     &lt;param sid="shadType" name="Shadow_Type" type="Name">raytrace&lt;/param>
                     <param sid="shadRes" name="Shadow_Resolution" type="int">1024</param>
+
                     &lt;param sid="shadRes" name="Shadow_Resolution" type="int">1024&lt;/param>
                     <param sid="fast" name="Simple_Shading" type="bool">true</param>
+
                     &lt;param sid="fast" name="Simple_Shading" type="bool">true&lt;/param>
                     <param sid="width" name="Area_Width" type="float">1</param>
+
                     &lt;param sid="width" name="Area_Width" type="float">1&lt;/param>
                     <param sid="height" name="Area_Height" type="float">1</param>
+
                     &lt;param sid="height" name="Area_Height" type="float">1&lt;/param>
                     <param sid="shape" name="Area_Shape" type="Name">rectangle</param>
+
                     &lt;param sid="shape" name="Area_Shape" type="Name">rectangle&lt;/param>
                 </technique>
+
                 &lt;/technique>
             </extra>
+
             &lt;/extra>
         </light>
+
         &lt;/light>
     </library_lights>
+
     &lt;/library_lights>
  
 
====cylinder_light====
 
====cylinder_light====
     <library_lights>
+
     &lt;library_lights>
         <light id="Light-Cylinder_Light" name="Cylinder_Light">
+
         &lt;light id="Light-Cylinder_Light" name="Cylinder_Light">
             <technique_common>
+
             &lt;technique_common>
                 <point>
+
                 &lt;point>
                     <color sid="point_light_rgb">1 1 1</color>
+
                     &lt;color sid="point_light_rgb">1 1 1&lt;/color>
                     <quadratic_attenuation sid="quad_atten">1</quadratic_attenuation>
+
                     &lt;quadratic_attenuation sid="quad_atten">1&lt;/quadratic_attenuation>
                 </point>
+
                 &lt;/point>
             </technique_common>
+
             &lt;/technique_common>
             <extra>
+
             &lt;extra>
                 <technique profile="modo401">
+
                 &lt;technique profile="modo401">
                     <param sid="lightType" name="Light_Type" type="Name">cylinder_light</param>
+
                     &lt;param sid="lightType" name="Light_Type" type="Name">cylinder_light&lt;/param>
                     <param sid="render" name="Render" type="Name">default</param>
+
                     &lt;param sid="render" name="Render" type="Name">default&lt;/param>
                     <param sid="size" name="Display_Size" type="float">1</param>
+
                     &lt;param sid="size" name="Display_Size" type="float">1&lt;/param>
                     <param sid="dissolve" name="Dissolve" type="float">0</param>
+
                     &lt;param sid="dissolve" name="Dissolve" type="float">0&lt;/param>
                     <param sid="radiance" name="Radiant_Intensity" type="float">3</param>
+
                     &lt;param sid="radiance" name="Radiant_Intensity" type="float">3&lt;/param>
                     <param sid="samples" name="Samples" type="int">64</param>
+
                     &lt;param sid="samples" name="Samples" type="int">64&lt;/param>
                     <param sid="shadType" name="Shadow_Type" type="Name">raytrace</param>
+
                     &lt;param sid="shadType" name="Shadow_Type" type="Name">raytrace&lt;/param>
                     <param sid="shadRes" name="Shadow_Resolution" type="int">1024</param>
+
                     &lt;param sid="shadRes" name="Shadow_Resolution" type="int">1024&lt;/param>
                     <param sid="fast" name="Simple_Shading" type="bool">true</param>
+
                     &lt;param sid="fast" name="Simple_Shading" type="bool">true&lt;/param>
                     <param sid="length" name="Length" type="float">1</param>
+
                     &lt;param sid="length" name="Length" type="float">1&lt;/param>
                     <param sid="radius" name="Radius" type="float">0.2</param>
+
                     &lt;param sid="radius" name="Radius" type="float">0.2&lt;/param>
                 </technique>
+
                 &lt;/technique>
             </extra>
+
             &lt;/extra>
         </light>
+
         &lt;/light>
     </library_lights>
+
     &lt;/library_lights>
  
 
====dome_light====
 
====dome_light====
     <library_lights>
+
     &lt;library_lights>
         <light id="Light-Dome_Light" name="Dome_Light">
+
         &lt;light id="Light-Dome_Light" name="Dome_Light">
             <technique_common>
+
             &lt;technique_common>
                 <point>
+
                 &lt;point>
                     <color sid="point_light_rgb">1 1 1</color>
+
                     &lt;color sid="point_light_rgb">1 1 1&lt;/color>
                     <quadratic_attenuation sid="quad_atten">1</quadratic_attenuation>
+
                     &lt;quadratic_attenuation sid="quad_atten">1&lt;/quadratic_attenuation>
                 </point>
+
                 &lt;/point>
             </technique_common>
+
             &lt;/technique_common>
             <extra>
+
             &lt;extra>
                 <technique profile="modo401">
+
                 &lt;technique profile="modo401">
                     <param sid="lightType" name="Light_Type" type="Name">dome_light</param>
+
                     &lt;param sid="lightType" name="Light_Type" type="Name">dome_light&lt;/param>
                     <param sid="render" name="Render" type="Name">default</param>
+
                     &lt;param sid="render" name="Render" type="Name">default&lt;/param>
                     <param sid="size" name="Display_Size" type="float">1</param>
+
                     &lt;param sid="size" name="Display_Size" type="float">1&lt;/param>
                     <param sid="dissolve" name="Dissolve" type="float">0</param>
+
                     &lt;param sid="dissolve" name="Dissolve" type="float">0&lt;/param>
                     <param sid="radiance" name="Radiant_Intensity" type="float">3</param>
+
                     &lt;param sid="radiance" name="Radiant_Intensity" type="float">3&lt;/param>
                     <param sid="samples" name="Samples" type="int">64</param>
+
                     &lt;param sid="samples" name="Samples" type="int">64&lt;/param>
                     <param sid="shadType" name="Shadow_Type" type="Name">raytrace</param>
+
                     &lt;param sid="shadType" name="Shadow_Type" type="Name">raytrace&lt;/param>
                     <param sid="shadRes" name="Shadow_Resolution" type="int">1024</param>
+
                     &lt;param sid="shadRes" name="Shadow_Resolution" type="int">1024&lt;/param>
                     <param sid="fast" name="Simple_Shading" type="bool">true</param>
+
                     &lt;param sid="fast" name="Simple_Shading" type="bool">true&lt;/param>
                     <param sid="radius" name="Radius" type="float">10</param>
+
                     &lt;param sid="radius" name="Radius" type="float">10&lt;/param>
                 </technique>
+
                 &lt;/technique>
             </extra>
+
             &lt;/extra>
         </light>
+
         &lt;/light>
     </library_lights>
+
     &lt;/library_lights>
  
 
====point_light====
 
====point_light====
     <library_lights>
+
     &lt;library_lights>
         <light id="Light-Point_Light" name="Point_Light">
+
         &lt;light id="Light-Point_Light" name="Point_Light">
             <technique_common>
+
             &lt;technique_common>
                 <point>
+
                 &lt;point>
                     <color sid="point_light_rgb">1 1 1</color>
+
                     &lt;color sid="point_light_rgb">1 1 1&lt;/color>
                     <quadratic_attenuation sid="quad_atten">1</quadratic_attenuation>
+
                     &lt;quadratic_attenuation sid="quad_atten">1&lt;/quadratic_attenuation>
                 </point>
+
                 &lt;/point>
             </technique_common>
+
             &lt;/technique_common>
             <extra>
+
             &lt;extra>
                 <technique profile="modo401">
+
                 &lt;technique profile="modo401">
                     <param sid="lightType" name="Light_Type" type="Name">point_light</param>
+
                     &lt;param sid="lightType" name="Light_Type" type="Name">point_light&lt;/param>
                     <param sid="render" name="Render" type="Name">default</param>
+
                     &lt;param sid="render" name="Render" type="Name">default&lt;/param>
                     <param sid="size" name="Display_Size" type="float">1</param>
+
                     &lt;param sid="size" name="Display_Size" type="float">1&lt;/param>
                     <param sid="dissolve" name="Dissolve" type="float">0</param>
+
                     &lt;param sid="dissolve" name="Dissolve" type="float">0&lt;/param>
                     <param sid="radiance" name="Radiant_Intensity" type="float">3</param>
+
                     &lt;param sid="radiance" name="Radiant_Intensity" type="float">3&lt;/param>
                     <param sid="samples" name="Samples" type="int">64</param>
+
                     &lt;param sid="samples" name="Samples" type="int">64&lt;/param>
                     <param sid="shadType" name="Shadow_Type" type="Name">raytrace</param>
+
                     &lt;param sid="shadType" name="Shadow_Type" type="Name">raytrace&lt;/param>
                     <param sid="shadRes" name="Shadow_Resolution" type="int">1024</param>
+
                     &lt;param sid="shadRes" name="Shadow_Resolution" type="int">1024&lt;/param>
                     <param sid="fast" name="Simple_Shading" type="bool">true</param>
+
                     &lt;param sid="fast" name="Simple_Shading" type="bool">true&lt;/param>
                     <param sid="radius" name="Radius" type="float">0</param>
+
                     &lt;param sid="radius" name="Radius" type="float">0&lt;/param>
                     <param sid="volumetrics" name="Volumetrics" type="bool">false</param>
+
                     &lt;param sid="volumetrics" name="Volumetrics" type="bool">false&lt;/param>
                     <param sid="vdissolve" name="Volumetrics_Dissolve" type="float">0</param>
+
                     &lt;param sid="vdissolve" name="Volumetrics_Dissolve" type="float">0&lt;/param>
                     <param sid="vsamples" name="Volumetric_Samples" type="int">40</param>
+
                     &lt;param sid="vsamples" name="Volumetric_Samples" type="int">40&lt;/param>
                     <param sid="vrad" name="Volumetric_Sphere_Radius" type="float">1</param>
+
                     &lt;param sid="vrad" name="Volumetric_Sphere_Radius" type="float">1&lt;/param>
                 </technique>
+
                 &lt;/technique>
             </extra>
+
             &lt;/extra>
         </light>
+
         &lt;/light>
     </library_lights>
+
     &lt;/library_lights>
  
 
====spot_light====
 
====spot_light====
     <library_lights>
+
     &lt;library_lights>
         <light id="Light-Spot_Light" name="Spot_Light">
+
         &lt;light id="Light-Spot_Light" name="Spot_Light">
             <technique_common>
+
             &lt;technique_common>
                 <spot>
+
                 &lt;spot>
                     <color sid="spot_light_rgb">1 1 1</color>
+
                     &lt;color sid="spot_light_rgb">1 1 1&lt;/color>
                     <quadratic_attenuation sid="quad_atten">1</quadratic_attenuation>
+
                     &lt;quadratic_attenuation sid="quad_atten">1&lt;/quadratic_attenuation>
                     <falloff_angle sid="falloff_deg">45</falloff_angle>
+
                     &lt;falloff_angle sid="falloff_deg">45&lt;/falloff_angle>
                 </spot>
+
                 &lt;/spot>
             </technique_common>
+
             &lt;/technique_common>
             <extra>
+
             &lt;extra>
                 <technique profile="modo401">
+
                 &lt;technique profile="modo401">
                     <param sid="lightType" name="Light_Type" type="Name">spot_light</param>
+
                     &lt;param sid="lightType" name="Light_Type" type="Name">spot_light&lt;/param>
                     <param sid="render" name="Render" type="Name">default</param>
+
                     &lt;param sid="render" name="Render" type="Name">default&lt;/param>
                     <param sid="size" name="Display_Size" type="float">1</param>
+
                     &lt;param sid="size" name="Display_Size" type="float">1&lt;/param>
                     <param sid="dissolve" name="Dissolve" type="float">0</param>
+
                     &lt;param sid="dissolve" name="Dissolve" type="float">0&lt;/param>
                     <param sid="radiance" name="Radiant_Intensity" type="float">3</param>
+
                     &lt;param sid="radiance" name="Radiant_Intensity" type="float">3&lt;/param>
                     <param sid="samples" name="Samples" type="int">64</param>
+
                     &lt;param sid="samples" name="Samples" type="int">64&lt;/param>
                     <param sid="shadType" name="Shadow_Type" type="Name">raytrace</param>
+
                     &lt;param sid="shadType" name="Shadow_Type" type="Name">raytrace&lt;/param>
                     <param sid="shadRes" name="Shadow_Resolution" type="int">1024</param>
+
                     &lt;param sid="shadRes" name="Shadow_Resolution" type="int">1024&lt;/param>
                     <param sid="fast" name="Simple_Shading" type="bool">true</param>
+
                     &lt;param sid="fast" name="Simple_Shading" type="bool">true&lt;/param>
                     <param sid="cone" name="Cone_Angle" type="float">0.785398</param>
+
                     &lt;param sid="cone" name="Cone_Angle" type="float">0.785398&lt;/param>
                     <param sid="edge" name="Soft_Edge_Angle" type="float">0.0872665</param>
+
                     &lt;param sid="edge" name="Soft_Edge_Angle" type="float">0.0872665&lt;/param>
                     <param sid="outside" name="Outside" type="bool">false</param>
+
                     &lt;param sid="outside" name="Outside" type="bool">false&lt;/param>
                     <param sid="volumetrics" name="Volumetrics" type="bool">false</param>
+
                     &lt;param sid="volumetrics" name="Volumetrics" type="bool">false&lt;/param>
                     <param sid="vdissolve" name="Volumetrics_Dissolve" type="float">0</param>
+
                     &lt;param sid="vdissolve" name="Volumetrics_Dissolve" type="float">0&lt;/param>
                     <param sid="vsamples" name="Volumetric_Samples" type="int">40</param>
+
                     &lt;param sid="vsamples" name="Volumetric_Samples" type="int">40&lt;/param>
                 </technique>
+
                 &lt;/technique>
             </extra>
+
             &lt;/extra>
         </light>
+
         &lt;/light>
     </library_lights>
+
     &lt;/library_lights>
  
 
====sun_light====
 
====sun_light====
     <library_lights>
+
     &lt;library_lights>
         <light id="Light-Directional_Light" name="Directional_Light">
+
         &lt;light id="Light-Directional_Light" name="Directional_Light">
             <technique_common>
+
             &lt;technique_common>
                 <directional>
+
                 &lt;directional>
                     <color sid="directional_light_rgb">1 1 1</color>
+
                     &lt;color sid="directional_light_rgb">1 1 1&lt;/color>
                 </directional>
+
                 &lt;/directional>
             </technique_common>
+
             &lt;/technique_common>
             <extra>
+
             &lt;extra>
                 <technique profile="modo401">
+
                 &lt;technique profile="modo401">
                     <param sid="lightType" name="Light_Type" type="Name">sun_light</param>
+
                     &lt;param sid="lightType" name="Light_Type" type="Name">sun_light&lt;/param>
                     <param sid="render" name="Render" type="Name">default</param>
+
                     &lt;param sid="render" name="Render" type="Name">default&lt;/param>
                     <param sid="size" name="Display_Size" type="float">1</param>
+
                     &lt;param sid="size" name="Display_Size" type="float">1&lt;/param>
                     <param sid="dissolve" name="Dissolve" type="float">0</param>
+
                     &lt;param sid="dissolve" name="Dissolve" type="float">0&lt;/param>
                     <param sid="radiance" name="Radiant_Intensity" type="float">3</param>
+
                     &lt;param sid="radiance" name="Radiant_Intensity" type="float">3&lt;/param>
                     <param sid="samples" name="Samples" type="int">64</param>
+
                     &lt;param sid="samples" name="Samples" type="int">64&lt;/param>
                     <param sid="shadType" name="Shadow_Type" type="Name">raytrace</param>
+
                     &lt;param sid="shadType" name="Shadow_Type" type="Name">raytrace&lt;/param>
                     <param sid="shadRes" name="Shadow_Resolution" type="int">1024</param>
+
                     &lt;param sid="shadRes" name="Shadow_Resolution" type="int">1024&lt;/param>
                     <param sid="fast" name="Simple_Shading" type="bool">true</param>
+
                     &lt;param sid="fast" name="Simple_Shading" type="bool">true&lt;/param>
                     <param sid="azimuth" name="Azimuth" type="float">0</param>
+
                     &lt;param sid="azimuth" name="Azimuth" type="float">0&lt;/param>
                     <param sid="clamp" name="Clamp_Intensity" type="bool">true</param>
+
                     &lt;param sid="clamp" name="Clamp_Intensity" type="bool">true&lt;/param>
                     <param sid="day" name="Day" type="int">2009172</param>
+
                     &lt;param sid="day" name="Day" type="int">2009172&lt;/param>
                     <param sid="elevation" name="Elevation" type="float">0</param>
+
                     &lt;param sid="elevation" name="Elevation" type="float">0&lt;/param>
                     <param sid="haze" name="Haze" type="float">2</param>
+
                     &lt;param sid="haze" name="Haze" type="float">2&lt;/param>
                     <param sid="height" name="Height" type="float">10</param>
+
                     &lt;param sid="height" name="Height" type="float">10&lt;/param>
                     <param sid="lat" name="Latitude" type="float">0.655057</param>
+
                     &lt;param sid="lat" name="Latitude" type="float">0.655057&lt;/param>
                     <param sid="lon" name="Longitude" type="float">-2.13456</param>
+
                     &lt;param sid="lon" name="Longitude" type="float">-2.13456&lt;/param>
                     <param sid="mapSize" name="Map_Size" type="float">2</param>
+
                     &lt;param sid="mapSize" name="Map_Size" type="float">2&lt;/param>
                     <param sid="north" name="North" type="float">0</param>
+
                     &lt;param sid="north" name="North" type="float">0&lt;/param>
                     <param sid="radius" name="Radius" type="float">0.5</param>
+
                     &lt;param sid="radius" name="Radius" type="float">0.5&lt;/param>
                     <param sid="spread" name="Spread" type="float">0</param>
+
                     &lt;param sid="spread" name="Spread" type="float">0&lt;/param>
                     <param sid="sunPos" name="Sun_Position" type="bool">false</param>
+
                     &lt;param sid="sunPos" name="Sun_Position" type="bool">false&lt;/param>
                     <param sid="time" name="Time" type="float">12</param>
+
                     &lt;param sid="time" name="Time" type="float">12&lt;/param>
                     <param sid="timeZone" name="Time_Zone" type="float">-8</param>
+
                     &lt;param sid="timeZone" name="Time_Zone" type="float">-8&lt;/param>
                     <param sid="volumetrics" name="Volumetrics" type="bool">false</param>
+
                     &lt;param sid="volumetrics" name="Volumetrics" type="bool">false&lt;/param>
                     <param sid="vdissolve" name="Volumetrics_Dissolve" type="float">0</param>
+
                     &lt;param sid="vdissolve" name="Volumetrics_Dissolve" type="float">0&lt;/param>
                     <param sid="vsamples" name="Volumetric_Samples" type="int">40</param>
+
                     &lt;param sid="vsamples" name="Volumetric_Samples" type="int">40&lt;/param>
                 </technique>
+
                 &lt;/technique>
             </extra>
+
             &lt;/extra>
         </light>
+
         &lt;/light>
     </library_lights>
+
     &lt;/library_lights>
  
 
===Status===
 
===Status===
:<!-- Status can be one of: Incomplete, Complete, Released product version, Obsolete -->
+
:&lt;!-- Status can be one of: Incomplete, Complete, Released product version, Obsolete -->
  
 
===IP Status===
 
===IP Status===
:<!-- Document any known patents or other IP claims that may prohibit royalty-free implementation of the extension, or impose other constraints on implementations -->
+
:&lt;!-- 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===
:<!-- List the COLLADA version(s) required by this extension as well as any other dependencies -->
+
:&lt;!-- List the COLLADA version(s) required by this extension as well as any other dependencies -->
  
 
===Issues===
 
===Issues===
:<!-- 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 -->
+
:&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 -->

Revision as of 06:13, 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

<!--

         TIP: The ":" at the beginning of lines indents them. 

-->

Category: (core) Lighting <!-- fill in --> (See list of specification categories)

Introduction

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

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 -->
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"><!-- e.g., <extra type="foo">/<technique profile="BAR"> -->
Child elements None <!-- or state None -->
Other <!-- list any other relevant elements -->

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 child carrier by the "lightType" sid, as shown in the table, 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
  • 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

<!-- Really required. -->

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

<!-- Status can be one of: Incomplete, Complete, Released product version, Obsolete -->

IP Status

<!-- Document any known patents or other IP claims that may prohibit royalty-free implementation of the extension, or impose other constraints on implementations -->

Dependencies

<!-- List the COLLADA version(s) required by this extension as well as any other dependencies -->

Issues

<!-- 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 -->