Ideal rectilinear camera instrument

From Eclat-Digital Ocean 2014 Documentation
Jump to: navigation, search
instrument-2014.png

Description

Cornell box rendered with an ideal rectilinear camera
scene file

This instrument is a simple camera model, describing a perfect rectilinear lens with no aberrations, flat front lens, identical principal points and pupils centers. This is the most common camera model used in CG.


Children nodes

sensor-2014.png sensor
Sensor : List of channels defined by a sensitivity spectrum
postprocessing-2014.png 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

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