clarify stereo properties

This commit is contained in:
David Rose 2008-11-19 16:36:03 +00:00
parent 1c083d02a1
commit 444f18c1c8

View File

@ -587,7 +587,11 @@ get_nodal_point() const {
// display region. It only has an effect on a
// PerspectiveLens.
//
// Also see set_interocular_distance(), which relates.
// The left eye and the right eye are each offset along
// the X axis by half of this distance, so that this
// parameter specifies the total distance between them.
//
// Also see set_convergence_distance(), which relates.
////////////////////////////////////////////////////////////////////
void Lens::
set_interocular_distance(float interocular_distance) {
@ -615,12 +619,22 @@ get_interocular_distance() const {
////////////////////////////////////////////////////////////////////
// Function: Lens::set_convergence_distance
// Access: Published
// Description: Sets the distance between the left and right eyes of
// a stereo camera. This distance is used to apply a
// stereo effect when the lens is rendered on a stereo
// display region. It only has an effect on a
// Description: Sets the distance between between the camera plane
// and the point in the distance that the left and right
// eyes are both looking at. This distance is used to
// apply a stereo effect when the lens is rendered on a
// stereo display region. It only has an effect on a
// PerspectiveLens.
//
// This parameter must be greater than 0, but may be as
// large as you like. It controls the degree to which
// the two eyes are directed inwards towards each other,
// which is a normal property of stereo vision.
// Normally this should be set to the distance from the
// camera to the area of interest in your scene. If you
// want to simulate parallel stereo, set this value to a
// very large number.
//
// Also see set_interocular_distance(), which relates.
////////////////////////////////////////////////////////////////////
void Lens::