Real rectilinear camera instrument

Description

Cornell box rendered with an ideal rectilinear camera
scene file

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

sensor

Sensor : List of channels defined by a sensitivity spectrum

postprocessing

Postprocessing : The post-processing filter chain

Parameters

xresolution

int

Horizontal buffer resolution

yresolution

int

Vertical buffer resolution

pixelfilter

list

The ray pixel filter

shutter

real

Shutter time or exposure

wlmin

real

Low bound of simulation wavelength range (Since Ocean 2014 R2)

wlmax

real

High bound of simulation wavelength range (Since Ocean 2014 R2)

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

Example

<?xml version="1.0" encoding="UTF-8"?>
<oceanroot version="2.3">
<instrument type="idealrectcam" name="idealrectcam">
	<prm xresolution="512" yresolution="512"/>
	<prm pixelfilter="bilinear"/>
	<prm shutter="0.8"/>
	<prm wlmin="380E-9"/>
	<prm wlmax="780E-9"/>
	<prm pos="0.278 0.273 -0.8"/>
	<prm forwards="0 0 1"/>
	<prm up="0 1 0"/>
	<prm autofocus="true"/>
	<prm fnumber="5.6"/>
	<prm focallength="0.035"/>
	<prm sensor_ar="1"/>
	<prm sensor_width="0.025"/>
	<prm aradial="-0.05"/>
	<prm aspherical="-0.002"/>
	<prm acoma="0.002"/>
	<prm acurvature="-0.002"/>
	<sensor type="ciexyz" name="sensor"/>
	<postprocessing type="" name="postprocessing">
		<filter type="xyztorgb" name="filter1" enabled="1" xwhite="0.3127" ywhite="0.329"/>
		<filter type="gain" name="filter2" enabled="1" gainev="0"/>
		<filter type="reinhardglobal" name="filter3" enabled="1" stops="1" strength="1"/>
		<filter type="smartclamp" name="filter4" enabled="1" perceptualcolor="0.4"/>
	</postprocessing>
</instrument>
</oceanroot>

See also

Instrument types