Difference between revisions of "Light modo 401 extension"

From COLLADA Public Wiki
Jump to navigation Jump to search
(Light extension info box, details, and example.)
(The sunlight child elements. (More to come...))
Line 24: Line 24:
 
|-
 
|-
 
|sid||xs:ncname||A unique symbol within the technique; one for each param.||Yes
 
|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
 
|}
 
|}
  
Line 42: Line 44:
  
 
:{| {{prettytable}}
 
:{| {{prettytable}}
|+ '''Child Elements'''
+
|+ '''Sunlight Child Elements'''
!Name||Description||type||Default||Occurrences||Named values
+
!sid||name||Description||type||Default||Occurrences||Named values
 +
|-
 +
|lightType||Light_Type||Sub-type of the light||Name||N/A||1||sun_light
 +
|-
 +
|azimuth||Azimuth||Arc of the horizon measured clockwise||float||0||1||
 +
|-
 +
|clamp||Clamp_Intensity||If intensity is clamped||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||Height (needs more details)||float||10||1||
 +
|-
 +
|lat||Latitude||Latitude in radians.||float||0.655057||1||
 +
|-
 +
|lon||Longitude||Longitude in radians.||float||-2.13456||1||
 +
|-
 +
|mapSize||Map_Size||(see docs)||float||2||1||
 +
|-
 +
|north||North||(see docs)||float||0||1||
 +
|-
 +
|radius||Radius||(see docs)||float||0.5||1||
 +
|-
 +
|spread||Spread||(see docs)||float||0||1||
 +
|-
 +
|sunPos||Sun_Position||Sun is positioned by time and location.||bool||false||1||
 +
|-
 +
|time||Time||Time of day||float||12||1||
 +
|-
 +
|timeZone||Time_Zone||Time zone||float||-8||1||
 +
|-
 +
|volumetrics||Volumetrics||If volumetric lighting is enabled.||bool||false||1||
 +
|-
 +
|vdissolve||Volumetrics_Dissolve||Percentage to fade volumetrics by.||float||0||1||
 
|-
 
|-
|param sid="lightType"||Name||The sub-type of the light.||N/A||1||See Details
+
|vsamples||Volumetric_Samples||Number of samples for volumetrics.||int||40||1||
 
|-
 
|-
|..||..||..||..||..||..
 
 
|}
 
|}
  

Revision as of 23:59, 17 August 2009

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
Sunlight Child Elements
sid name Description type Default Occurrences Named values
lightType Light_Type Sub-type of the light Name N/A 1 sun_light
azimuth Azimuth Arc of the horizon measured clockwise float 0 1
clamp Clamp_Intensity If intensity is clamped 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 Height (needs more details) float 10 1
lat Latitude Latitude in radians. float 0.655057 1
lon Longitude Longitude in radians. float -2.13456 1
mapSize Map_Size (see docs) float 2 1
north North (see docs) float 0 1
radius Radius (see docs) float 0.5 1
spread Spread (see docs) float 0 1
sunPos Sun_Position Sun is positioned by time and location. bool false 1
time Time Time of day float 12 1
timeZone Time_Zone Time zone float -8 1
volumetrics Volumetrics If volumetric lighting is enabled. bool false 1
vdissolve Volumetrics_Dissolve Percentage to fade volumetrics by. float 0 1
vsamples Volumetric_Samples Number of samples for volumetrics. int 40 1

Details

Examples

   <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="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>