Usage of StereoPOV

Syntax and Usage of StereoPOV

Syntax

Stereoscopy utilizes two almost identical views of a given scene, one for each eye. The spacing between this two viewpoints is called Stereo Base. It corresponds to the (average) eye spacing of humans (about 65 mm), but can differ from this for gaining special effects.

In StereoPOV, the STEREO-trace function is activated by specifying one of the following three stereoscopic parameters in camera definition:

stereo_base <float>

explicitely defines the Stereo Base to be used.

window_distance <float>

places the Stereoscopic Window at the given distance with respect to the cameras location in the scene. If stereo_base is omitted, it will be guessed based on window_distance.

screen_width <float>

declares the width of the screen intended for presentation of the resulting image. Everything is scaled, so the resulting stereoscopic window machtes the given screen width (actually the stereospcopic base is inverse scaled to gain this effect)

cross_eyed

add this keyword in camera definition to gain cross-eyed output. (inverts the sign of stereo base to achieve the desired result)

Specify only window_distance and let StereoPOV do the rest, if in doubt.
(See explanations on setting up the stereo camera)

Options

For controling the operation modes there are three new .INI Options:

Stereo_Trace=Off

disables STEREO-tracing explicitly.
(to the contrary, it can be enabled only by adding a stereo_base, window_distance or screen_width to the camera definition.)

Stereo_Cache=On/Off

Activates (default) or deactivates StereoCache. If deactivated, the calculations for left and right halfimage are performed interleaved, but independently.

Stereo_Cache_Tolerance=<float>

StereoCache hit tolerance. This value defaults to 1.0, i.e. an hit occures, if the two found intersections for left and right match to within one pixel or subpixel (the latter while AAing).

Please note:

You need to give the version directive #version unofficial stereopov 0.2
All POV-ray parameters and options defining explicit pixel or column numbers, are now to be based on the size of a single half image (and not on the width of the image file produced, which is doubled).
You can't use Vista buffer while STEREO-tracing. tech info
All the other features of POV-ray are retained unmodified.

Output

Default: The two halfimages of the stereo pair are output side-by-side, left image left.
Alternative Output Format: It is very comon to swap the order of the halfimages in stereo pairs, thus making them suitable for cross-eyed viewing (left image at right side). You can convert this output to *.JPEG or *.PNG to view with a JPS-Viewer in a variety of formats (red/green, red/blue, cross-eyed, wall-eyed, interlaced)
More info on viewing. What is JPS?



StereoPOV	by Ichthyostega	home images usage download

stereo_base <float>	explicitely defines the Stereo Base to be used.
window_distance <float>	places the Stereoscopic Window at the given distance with respect to the cameras location in the scene. If `stereo_base` is omitted, it will be guessed based on `window_distance`.
screen_width <float>	declares the width of the screen intended for presentation of the resulting image. Everything is scaled, so the resulting stereoscopic window machtes the given screen width (actually the stereospcopic base is inverse scaled to gain this effect)
cross_eyed	add this keyword in camera definition to gain cross-eyed output. (inverts the sign of stereo base to achieve the desired result)

Stereo_Trace=Off	disables STEREO-tracing explicitly. (to the contrary, it can be enabled only by adding a `stereo_base`, `window_distance` or `screen_width` to the camera definition.)
Stereo_Cache=On/Off	Activates (default) or deactivates StereoCache. If deactivated, the calculations for left and right halfimage are performed interleaved, but independently.
Stereo_Cache_Tolerance=<float>
	StereoCache hit tolerance. This value defaults to 1.0, i.e. an hit occures, if the two found intersections for left and right match to within one pixel or subpixel (the latter while AAing).