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