Real rectilinear camera

Description

../../../_images/realrectcam.jpg

Cornell box rendered with a real rectilinear camera

Instrument This instrument is a rectilinear lens camera model, with optical aberrations. It provides similar images than the Ideal rectilinear camera, with extra lens imperfections. If aberration parameters are all set to zero, it will provide the same images.

The supported aberrations are:
  • Radial : This mostly controls image distortion (pincushion or barrel)
  • Spherical
  • Coma
  • Curvature

Children Nodes

This node may have a variable number of output children with custom names.

Sensor sensor List of channels defined by a sensitivity spectrum
Output user-defined First output preset
Output user-defined Second output preset
Output user-defined

Parameters

name type description
xresolution integer Horizontal buffer resolution
yresolution integer Vertical buffer resolution
pixelfilter list The ray pixel filter
shutter real Shutter time or exposure, in seconds
wlmin real Low bound of simulation wavelength range
wlmax real High bound of simulation wavelength range
pos vec3 The camera position : center of pupils apertures, as well as principal points
forwards vec3 The camera optical axis, or view direction. Should be orthogonal to up
up vec3 The camera up axis. Should be orthogonal to forwards
focusdistance real The lens focusing distance in meters. Set to zero for infinite focus distance
autofocus boolean Set to true for setting the focus distance to the first geometry met in the forward direction
fnumber real The lens aperture F-number
focallength real The lens focal length in meters. Must be greater than 0
sensor_ar real The sensor aspect ratio. Physical width/height ratio of the recorded image, but not necessarily equal to pixel aspect ratio (xresolution/yresolution. Must be greater than 0
sensor_width real The sensor width in meters, such as 0.036 for 35mm film cameras. Must be greater than 0
aradial real The radial aberration parameter. It mainly controls lens distortion (negative for pincushion, positive for barrel)
aspherical real The spherical aberration parameter
acoma real The coma aberration parameter
acurvature real The curvature aberration parameter

Ocean XML 5.0 example

<instrument type="realrectcam" name="camera">
     <prm xresolution="512"/>
     <prm yresolution="512"/>
     <prm shutter="0.05"/>
     <prm wlmin="3.8e-007"/>
     <prm wlmax="7.8e-007"/>
     <prm pixelfilter="bilinear"/>
     <prm pos="0.337141 -0.698955 0.774228"/>
     <prm forwards="-0.309152 0.648172 -0.695915"/>
     <prm up="-0.299591 0.628127 0.718124"/>
     <prm focusdistance="1.07488"/>
     <prm autofocus="true"/>
     <prm fnumber="45"/>
     <prm focallength="0.05"/>
     <prm sensor_ar="1"/>
     <prm sensor_width="0.024"/>
     <prm aradial="-0.05"/>
     <prm aspherical="-0.002"/>
     <prm acoma="0.002"/>
     <prm acurvature="-0.002"/>
     <sensor type="ciexyz" name="sensor" y_only="false"/>
     <output type="rgbimage" name="image">
             <prm colorspace="srgb"/>
             <prm depth="8"/>
             <prm xwhite="0.31271"/>
             <prm ywhite="0.32902"/>
             <prm hcc="0.32"/>
             <prm drawinfo="false"/>
             <filter type="gain" name="filter1" enabled="true" gainev="0"/>
             <filter type="reinhardglobal" name="filter2" enabled="true" stops="1" strength="0.8"/>
     </output>
</instrument>