Fisheye camera¶
Description¶

Cornell box rendered with a fisheye camera (Equisolid projection)¶
This instrument is a camera with a circular fisheye lens, representing a 180° field of view over a circular image.
The following fisheye projections are available:
Equisolid : \(2*f*sin(\theta/2)\)
Equidistant : \(f*\theta\)
Stereographic : \(2*f*tan(\theta/2)\)
Orthographic : \(f*sin(\theta)\)
The focal length of the lens is automatically calculated to fit the width of the circular image inside the rectangular buffer.
Children Nodes¶
This node may have a variable number of output children with custom names.
List of channels defined by a sensitivity spectrum |
|
First output preset |
|
Second output preset |
|
… |
Parameters¶
name |
type |
description |
---|---|---|
xresolution |
integer |
Horizontal buffer resolution |
yresolution |
integer |
Vertical buffer resolution |
shutter |
real |
Shutter time or exposure, in seconds |
wlmin |
real |
Low bound of simulation wavelength range |
wlmax |
real |
High bound of simulation wavelength range |
projection |
list |
The fisheye prohjection, can be equisolid, equidistant, stereographic or orthographic |
pixelfilter |
list |
The ray pixel filter |
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 |
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 |
Ocean XML 5.0 example¶
<instrument type="fisheyecam" name="fisheye">
<prm xresolution="512"/>
<prm yresolution="512"/>
<prm shutter="0.8"/>
<prm wlmin="3.8e-007"/>
<prm wlmax="7.8e-007"/>
<prm pixelfilter="bilinear"/>
<prm projection="equisolid"/>
<prm pos="0.278 0.273 0"/>
<prm forwards="0 0 1"/>
<prm up="0 1 0"/>
<prm focusdistance="2"/>
<prm autofocus="true"/>
<prm fnumber="5.6"/>
<prm sensor_ar="1"/>
<prm sensor_width="0.025"/>
<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>