All Frameworks  Object Hierarchy  This Framework  Indexes   

SWKVision (Object)

This interface manages the vision of the manikin.
It provides
access to the vision data (lines of sight, focal point...)

Property Index

ActiveLineOfSight
Returns the active line of sight, according to the vision type.
ActiveSide
Returns the vision active side.
AmbinocularAngle
Returns or sets the vision Ambinocular angle.
BinocularAngle
Returns or sets the vision Binocular angle.
CentralConeAngle
Returns or sets the vision Central cone angle.
FocalDistance
Returns or sets the focal distance, in centimeters.
FocalPointX
Returns the x coordinate (in millimeters) of the focal point.
FocalPointY
Returns the y coordinate (in millimeters) of the focal point.
FocalPointZ
Returns the z coordinate (in millimeters) of the focal point.
MonocularAngle
Returns or sets the vision Monocular angle.
PonctumProximum
Returns or sets the ponctum proximum, in centimeters.
PonctumRemotum
Returns or sets the ponctum remotum, in centimeters.
Type
Returns or sets the vision type.
VerticalBottomAngle
Returns or sets the vision Vertical Bottom angle.
VerticalTopAngle
Returns or sets the vision Vertical Top angle.

Method Index

CloseVisionWindows
Closes all open vision windows relating to the manikin on which the function is called.
LookAt
Make the manikin look at the specified position in space.
LookAtPoint
Make the manikin look at the specified position in space.
Reset
Resets all attributes of the vision to their default values.

Properties


o Property ActiveLineOfSight() As (Read Only)
Returns the active line of sight, according to the vision type.
o Property ActiveSide() As (Read Only)
Returns the vision active side.
The active line of sight is the one able to
control the two others. That is, when the active line of
sight moves, the two others update accordingly.
When setting the type, the value given must be 0, 1 or 2.
The value 0 activates the left line of sight, the value 1
activates the central line of sight, the value 2 activates
the right line of sight.
If other values are given, an error will occur.
o Property AmbinocularAngle() As
Returns or sets the vision Ambinocular angle.
This angle is always in degrees.
o Property BinocularAngle() As
Returns or sets the vision Binocular angle.
This angle is always in degrees.
o Property CentralConeAngle() As
Returns or sets the vision Central cone angle.
This angle is always in degrees.
o Property FocalDistance() As
Returns or sets the focal distance, in centimeters.
N.B.: if the value is -1.0,
then the focal distance is set to infinite.
o Property FocalPointX() As (Read Only)
Returns the x coordinate (in millimeters) of the focal point.
o Property FocalPointY() As (Read Only)
Returns the y coordinate (in millimeters) of the focal point.
o Property FocalPointZ() As (Read Only)
Returns the z coordinate (in millimeters) of the focal point.
o Property MonocularAngle() As
Returns or sets the vision Monocular angle.
This angle is always in degrees.
o Property PonctumProximum() As
Returns or sets the ponctum proximum, in centimeters. The ponctum proximum is the minimum value the focal distance can take.
o Property PonctumRemotum() As
Returns or sets the ponctum remotum, in centimeters. The ponctum remotum is the largest value that the focal distance can take. N.B.: if the value is -1.0, then the
ponctum remotum is set to infinite.
o Property Type() As
Returns or sets the vision type. (binocular, ambinocular, monocular left, monocular right or stereo.
When setting the type, the value given must be 0, 1, 2, 3, or 4
The value 0 activates the Binocular type, 1 is Ambinocular, 2 is MonocularRight, 3 is MonocularLeft, and 4 is Stereo. If other values are given, an error will occur.
o Property VerticalBottomAngle() As
Returns or sets the vision Vertical Bottom angle.
This angle is always in degrees.
o Property VerticalTopAngle() As
Returns or sets the vision Vertical Top angle.
This angle is always in degrees.

Methods


o Sub CloseVisionWindows()
Closes all open vision windows relating to the manikin on which the function is called.
o Sub LookAt( piFocalDistance,
piVAngle,
piHAngle)
Make the manikin look at the specified position in space.
This position is given by the focal distance, and two
deviation angles.
Parameters:
piFocalDistance
The focal distance (measured from the active eye), which is a horizontal straight distance, measured in centimeters.
piVAngle
The vertical angle (in radians) between the focal point and
the active eye (positive angle deviates up, negative angle deviates down).
piHAngle
The horizontal angle (in radians) between the focal
point and the active eye (positive angle deviates left, negative angle deviates right). N.B.: the manikin's eyes will move only if it is able
to reach the specified point.
o Sub LookAtPoint( piX,
piY,
piZ)
Make the manikin look at the specified position in space.
This position is given by three coordinates (expressed in millimeters)
passed to the method.

N.B.: the manikin's eyes will move only if it is able
to reach the specified point.
o Sub Reset()
Resets all attributes of the vision to their default values. This method resets the focal distance, the active line of sight, the ponctum proximum, the ponctum remotum, the field of view angles, the convergence mode, and restores the default DOF values on the three lines of sight.

Copyright © 2003, Dassault Systèmes. All rights reserved.