pxmlw6n2f/sdformat/sdf/1.6/camera.sdf

131 lines
6.7 KiB
Plaintext
Raw Normal View History

<element name="camera" required="0">
<description>These elements are specific to camera sensors.</description>
<attribute name="name" type="string" default="__default__" required="0">
<description>An optional name for the camera.</description>
</attribute>
<element name="horizontal_fov" type="double" default="1.047" min="0.1" max="6.283186" required="1">
<description>Horizontal field of view</description>
</element> <!-- End Horizontal_FOV -->
<element name="image" required="1">
<description>The image size in pixels and format.</description>
<element name="width" type="int" default="320" required="1">
<description>Width in pixels</description>
</element>
<element name="height" type="int" default="240" required="1">
<description>Height in pixels </description>
</element>
<element name="format" type="string" default="R8G8B8" required="0">
<description>(L8|R8G8B8|B8G8R8|BAYER_RGGB8|BAYER_BGGR8|BAYER_GBRG8|BAYER_GRBG8)</description>
</element>
</element> <!-- End Image -->
<element name="clip" required="1">
<description>The near and far clip planes. Objects closer or farther than these planes are not rendered.</description>
<element name="near" type="double" default=".1" min="0.0" required="1">
<description>Near clipping plane</description>
</element>
<element name="far" type="double" default="100" min="10.0" required="1">
<description>Far clipping plane</description>
</element>
</element> <!-- End Clip -->
<element name="save" required="0">
<description>Enable or disable saving of camera frames.</description>
<attribute name="enabled" type="bool" default="false" required="1">
<description>True = saving enabled</description>
</attribute>
<element name="path" type="string" default="__default__" required="1">
<description>The path name which will hold the frame data. If path name is relative, then directory is relative to current working directory.</description>
</element>
</element> <!-- End Save -->
<element name="depth_camera" required="0">
<description>Depth camera parameters</description>
<element name="output" type="string" default="depths" required="1">
<description>Type of output</description>
</element>
</element> <!-- End depth_camera -->
<element name="noise" required="0">
<description>The properties of the noise model that should be applied to generated images</description>
<element name="type" type="string" default="gaussian" required="1">
<description>The type of noise. Currently supported types are: "gaussian" (draw additive noise values independently for each pixel from a Gaussian distribution).</description>
</element>
<element name="mean" type="double" default="0.0" required="0">
<description>For type "gaussian," the mean of the Gaussian distribution from which noise values are drawn.</description>
</element>
<element name="stddev" type="double" default="0.0" required="0">
<description>For type "gaussian," the standard deviation of the Gaussian distribution from which noise values are drawn.</description>
</element>
</element> <!-- End Noise -->
<element name="distortion" required="0">
<description>Lens distortion to be applied to camera images. See http://en.wikipedia.org/wiki/Distortion_(optics)#Software_correction</description>
<element name="k1" type="double" default="0.0" required="0">
<description>The radial distortion coefficient k1</description>
</element>
<element name="k2" type="double" default="0.0" required="0">
<description>The radial distortion coefficient k2</description>
</element>
<element name="k3" type="double" default="0.0" required="0">
<description>The radial distortion coefficient k3</description>
</element>
<element name="p1" type="double" default="0.0" required="0">
<description>The tangential distortion coefficient p1</description>
</element>
<element name="p2" type="double" default="0.0" required="0">
<description>The tangential distortion coefficient p2</description>
</element>
<element name="center" type="vector2d" default="0.5 0.5" required="0">
<description>The distortion center or principal point</description>
</element>
</element> <!-- End Distortion -->
<element name="lens" required="0">
<description>Lens projection description</description>
<element name="type" type="string" default="stereographic" required="1">
<description>Type of the lens mapping. Supported values are gnomonical, stereographic, equidistant, equisolid_angle, orthographic, custom. For gnomonical (perspective) projection, it is recommended to specify a horizontal_fov of less than or equal to 90°</description>
</element>
<element name="scale_to_hfov" type="bool" default="true" required="1">
<description>If true the image will be scaled to fit horizontal FOV, otherwise it will be shown according to projection type parameters</description>
</element>
<element name="custom_function" required="0">
<description>Definition of custom mapping function in a form of r=c1*f*fun(theta/c2 + c3). See https://en.wikipedia.org/wiki/Fisheye_lens#Mapping_function</description>
<element name="c1" type="double" default="1" required="0">
<description>Linear scaling constant</description>
</element>
<element name="c2" type="double" default="1" required="0">
<description>Angle scaling constant</description>
</element>
<element name="c3" type="double" default="0" required="0">
<description>Angle offset constant</description>
</element>
<element name="f" type="double" default="1" required="0">
<description>Focal length of the optical system. Note: It's not a focal length of the lens in a common sense! This value is ignored if 'scale_to_fov' is set to true</description>
</element>
<element name="fun" type="string" default="tan" required="1">
<description>Possible values are 'sin', 'tan' and 'id'</description>
</element>
</element> <!-- End Custom Function -->
<element name="cutoff_angle" type="double" default="1.5707" min="0.0" max="3.141592653" required="0">
<description>Everything outside of the specified angle will be hidden, 90° by default</description>
</element>
<element name="env_texture_size" type="int" default="256" min="4" max="2048" required="0">
<description>Resolution of the environment cube map used to draw the world</description>
</element>
</element> <!-- End Lens -->
<include filename="frame.sdf" required="*"/>
<include filename="pose.sdf" required="0"/>
</element> <!-- End Camera -->