Imager modo 401 extension

Extension information
Purpose: Custom camera imager Company(s): Luxology Product(s): modo 401 Last updated: 17 Aug 09 Contact for technical issues: [email protected]
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) Camera <!-- fill in --> (See list of specification categories)

Introduction: Describes custom cameras, include the specialized camera imager settings 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 camera, with an extended imager described in terms of an aperture size and an offset.<!-- 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)	<camera>/<imager>
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 -->

Child Elements

sid	name	Description	type	Default	Occurrences	Named values
apertureX	Film_Width	Width of the camera aperture	float	0.036	1
apertureY	Film_Height	Height of the camera aperture	float	0.024	1
offsetX	Film_Offset_X	Horizontal offset of the camera aperture	float	0	0 or 1
offsetY	Film_Offset_Y	Vertical offset of the camera aperture	float	0	0 or 1
filmFit	Film_Fit	Method for fitting the aperture	Name	fill	0 or 1	fill, horizontal, vertical, overscan

Details

If the modo 401 imager extension is present, then at a minimum, the param elements for "apertureX" and "apertureY" must be present.<!-- Additional info about kid carrier how and where to use the element (and its children), lists of additional relevant links, detailed value tables for element or attribute values, etc. -->

Examples

<!-- Really required. -->

   <library_cameras>
       <camera id="Camera-Camera" name="Camera">
           ...
           <imager>
               <technique profile="modo401">
                   <param sid="apertureX" name="Film_Width" type="float">0.036</param>
                   <param sid="apertureY" name="Film_Height" type="float">0.024</param>
                   <param sid="offsetX" name="Film_Offset_X" type="float">0</param>
                   <param sid="offsetY" name="Film_Offset_Y" type="float">0</param>
                   <param sid="filmFit" name="Film_Fit" type="Name">fill</param>
               </technique>
           </imager>
       </camera>
   </library_cameras>