Optics modo 401 extension: Difference between revisions

From COLLADA Public Wiki
Jump to navigation Jump to search
← Older edit
More modo 401 optics param descriptions.
m date
 
(5 intermediate revisions by the same user not shown)
Line 5: Line 5:
  | product2 =
  | product2 =
  | product3 =
  | product3 =
  | contact_email = customer_support@luxology.com
  | contact_email = customer_service@luxology.com
  | last_updated = 17 Aug 09}}
  | last_updated = 21 Aug 09}}


==<extra>/<technique profile="modo401">/<param> Elements==
==<extra>/<technique profile="modo401">/<param> Elements==
Line 46: Line 46:
|+ '''Child Elements'''
|+ '''Child Elements'''
!sid||name||Description||type||Default||Occurrences||Named values
!sid||name||Description||type||Default||Occurrences||Named values
|-
|targetID||Target_Node_ID||ID of the item targeted by this camera||Name|| ||0 or 1||
|-
|targetEnable||Target_Enable||If targeting is enabled||bool||false||0 or 1||
|-
|targetFocus||Target_Focus||If camera focus is linked to target distance||bool||false||0 or 1||
|-
|target||Target_Distance||Distance at which camera should focus on target||float||5.0||0 or 1||
|-
|targetRoll||Target_Roll||Angular offset from target along look axis||float||0||0 or 1||
|-
|-
|projType||Projection_Type||Optical projection type||Name||persp||1||persp, ortho, spherical
|projType||Projection_Type||Optical projection type||Name||persp||1||persp, ortho, spherical
Line 67: Line 77:
|convDist||Convergence_Distance||Distance at which stereo imagers converge||float||1||0 or 1||
|convDist||Convergence_Distance||Distance at which stereo imagers converge||float||1||0 or 1||
|}
|}
===Details===
===Details===
:<!-- 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. -->
:The target-related params should only appear if the initial targetID param is present, as those channels are only available for cameras which have a target set. The target-related channels are added during scene load only when a targetID is found.<!-- 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. -->


===Examples===
===Examples===
Line 84: Line 95:
                 </technique_common>
                 </technique_common>
                 <technique profile="modo401">
                 <technique profile="modo401">
                    <param sid="targetID" name="Target_Node_ID" type="Name">Geometry-MeshNode</param>
                    <param sid="targetEnable" name="Target_Enable" type="bool">true</param>
                    <param sid="targetFocus" name="Target_Focus" type="bool">true</param>
                    <param sid="target" name="Target_Distance" type="float">5</param>
                    <param sid="targetRoll" name="Target_Roll" type="float">1</param>
                     <param sid="projType" name="Projection_Type" type="Name">persp</param>
                     <param sid="projType" name="Projection_Type" type="Name">persp</param>
                     <param sid="focalLen" name="Focal_Length" type="float">0.05</param>
                     <param sid="focalLen" name="Focal_Length" type="float">0.05</param>

Latest revision as of 22:00, 21 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) Camera (See list of specification categories)
Introduction: Describes custom cameras, include the specialized spherical camera sub-type supported by modo 401.

Concepts

The modo render engine provides a general purpose camera, including perspective and orthographic optics as specified by the common COLLADA technique, as well as a specialized spherical camera.
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>/<optics>
Extra and/or Technique <extra>/<technique profile="modo401">
Child elements None
Other
Child Elements
sid name Description type Default Occurrences Named values
targetID Target_Node_ID ID of the item targeted by this camera Name 0 or 1
targetEnable Target_Enable If targeting is enabled bool false 0 or 1
targetFocus Target_Focus If camera focus is linked to target distance bool false 0 or 1
target Target_Distance Distance at which camera should focus on target float 5.0 0 or 1
targetRoll Target_Roll Angular offset from target along look axis float 0 0 or 1
projType Projection_Type Optical projection type Name persp 1 persp, ortho, spherical
focalLen Focal_Length Distance from center of lens to focal point float 0.05 1
distort Lens_Distortion Amount of lens distortion float 0 0 or 1
squeeze Lens_Squeeze Horizontal lens squeeze float 1.0 0 or 1
focusDist Focus_Distance Distance at which image is in focus float 4 0 or 1
fStop F-Stop Focal length divided by effective aperture diameter float 4 0 or 1
blurLen Blur_Length Length of blur float 0.5 0 or 1
blurOff Blur_Offset Offset of blur float 0 0 or 1
ioDist Interocular_Distance Distance between stereo imagers float 0.065 0 or 1
convDist Convergence_Distance Distance at which stereo imagers converge float 1 0 or 1

Details

The target-related params should only appear if the initial targetID param is present, as those channels are only available for cameras which have a target set. The target-related channels are added during scene load only when a targetID is found.

Examples

   <library_cameras>
       <camera id="Camera-Camera" name="Camera">
           <optics>
               <technique_common>
                   <perspective>
                       <xfov sid="HFOV">39.5978</xfov>
                       <yfov sid="YFOV">26.9915</yfov>
                       <znear sid="near_clip">0.01</znear>
                       <zfar sid="far_clip">10000</zfar>
                   </perspective>
               </technique_common>
               <technique profile="modo401">
                   <param sid="targetID" name="Target_Node_ID" type="Name">Geometry-MeshNode</param>
                   <param sid="targetEnable" name="Target_Enable" type="bool">true</param>
                   <param sid="targetFocus" name="Target_Focus" type="bool">true</param>
                   <param sid="target" name="Target_Distance" type="float">5</param>
                   <param sid="targetRoll" name="Target_Roll" type="float">1</param>
                   <param sid="projType" name="Projection_Type" type="Name">persp</param>
                   <param sid="focalLen" name="Focal_Length" type="float">0.05</param>
                   <param sid="distort" name="Lens_Distortion" type="float">0</param>
                   <param sid="squeeze" name="Lens_Squeeze" type="float">1</param>
                   <param sid="focusDist" name="Focus_Distance" type="float">4</param>
                   <param sid="fStop" name="F-Stop" type="float">4</param>
                   <param sid="blurLen" name="Blur_Length" type="float">0.5</param>
                   <param sid="blurOff" name="Blur_Offset" type="float">0</param>
                   <param sid="ioDist" name="Interocular_Distance" type="float">0.065</param>
                   <param sid="convDist" name="Convergence_Distance" type="float">1</param>
               </technique>
           </optics>
       </camera>
   </library_cameras>
Retrieved from "https://wikis.khronos.org/collada/index.php?title=Optics_modo_401_extension&oldid=6592"