Open CASCADE Technology
6.5.4
|
This class allows the definition of the manner in
which an observer looks at the visualised scene.
It defines a coordinate system called VRC
(View Reference Coordinates) with 3 axes U,V,N
Summary of 3D View Orientation --
--
The view orientation transformation defines --
the relationship between World Coordinates --
(WC) and View Reference Coordinates (VRC) --
--
To define a view orientation transformation --
you must define : --
--
The View Reference Point (VRP) --
The View Plane Normal (VPN) --
The View Up Vector (VUP). --
Optionally, it is possible to specify anisotropic
(axial) scale factors. This allows to scale the scene
using individual scale values along each coordinate axis.
#include <Visual3d_ViewOrientation.hxx>
Public Member Functions | |
DEFINE_STANDARD_ALLOC | Visual3d_ViewOrientation () |
Creates a VRC coordinate system. VRP : Origin of the VRC coordinate system. (default value : 0.0, 0.0, 0.0) VPN : Vector normal to the plane of visualisation. (default value : 0.0, 0.0, 1.0) VUP : Vector for which the projection in the plane of visualisation defines the axis V of a VRC coordinate system. (default value : 0.0, 1.0, 0.0) | |
Visual3d_ViewOrientation (const Graphic3d_Vertex &VRP, const Graphic3d_Vector &VPN, const Graphic3d_Vector &VUP) | |
Creates a VRC coordinate system. VRP : Origin of the VRC coordinate system. VPN : Vector normal to the plane of visualisation. VUP : Vector for which the projection in the plane of visualisation defines the axis V of a VRC coordinate system. This vector can be likened to the vertical of the observer. Warning: Raises ViewOrientationDefinitionError if <VPN> is null. if <VUP> is null. if <VPN> and <VUP> are parallel. | |
Visual3d_ViewOrientation (const Graphic3d_Vertex &VRP, const Graphic3d_Vector &VPN, const Standard_Real Twist) | |
Creates a VRC coordinate system. VRP : Origin of VRC coordinate system. VPN : Normal vector to the plane of visualisation. Twist : Angle in radians of the V axis in the VRC coordinate system with the projection in the plane of visualisation of the Zm axis in the model space. Warning: Raises ViewOrientationDefinitionError if <VPN> is null. | |
Visual3d_ViewOrientation (const Graphic3d_Vertex &VRP, const Standard_Real Azim, const Standard_Real Inc, const Standard_Real Twist) | |
Creates a VRC coordinate system. VRP : Origin of the VRC coordinate system. Azim : Angle in radians of the plane of visualisation with the XmYm plane of the model space. Inc : Angle in radians of the plane of visualisation with the YmZm plane of the model space. Twist : Angle in radians of the V axis in the VRC coordinate system with the projection in the plane of visualisation of the Zm axis in the model space. Warning: Raises ViewOrientationDefinitionError | |
void | SetViewReferencePlane (const Graphic3d_Vector &VPN) |
Modifies the plane of visualisation defined by a normal vector. Category: Methods to modify the class definition Warning: Raises ViewOrientationDefinitionError if <VPN> is null. | |
void | SetViewReferencePoint (const Graphic3d_Vertex &VRP) |
Modifies the origin of the VRC coordinate system | |
void | SetViewReferenceUp (const Graphic3d_Vector &VUP) |
Modifies the vertical of the observer. Category: Methods to modify the class definition Warning: Raises ViewOrientationDefinitionError if <VUP> is null. | |
void | SetAxialScale (const Standard_Real Sx, const Standard_Real Sy, const Standard_Real Sz) |
Sets axial scale factors of the view | |
void | SetCustomModelViewMatrix (const Handle< TColStd_HArray2OfReal > &Mat) |
Sets custom MODELVIEW matrix for the OpenGl context | |
Standard_Real | Twist () const |
Returns the angle in radians of the V axis in the VRC coordinate system with the projection in the plane of visualisation of the Zm axis in the model space. | |
Graphic3d_Vector | ViewReferencePlane () const |
Returns the normal to the plane of projection. | |
Graphic3d_Vertex | ViewReferencePoint () const |
Returns origin of the VRC coordinate system. | |
Graphic3d_Vector | ViewReferenceUp () const |
Returns the vertical of the observer. | |
void | AxialScale (Standard_Real &Sx, Standard_Real &Sy, Standard_Real &Sz) const |
Returns current values of the axial scale factors. | |
Standard_Boolean | IsCustomMatrix () const |
Returns whether the custom MODELVIEW matrix is used. |
Visual3d_ViewOrientation::Visual3d_ViewOrientation | ( | const Graphic3d_Vertex & | VRP, |
const Graphic3d_Vector & | VPN, | ||
const Graphic3d_Vector & | VUP | ||
) |
Visual3d_ViewOrientation::Visual3d_ViewOrientation | ( | const Graphic3d_Vertex & | VRP, |
const Graphic3d_Vector & | VPN, | ||
const Standard_Real | Twist | ||
) |
Visual3d_ViewOrientation::Visual3d_ViewOrientation | ( | const Graphic3d_Vertex & | VRP, |
const Standard_Real | Azim, | ||
const Standard_Real | Inc, | ||
const Standard_Real | Twist | ||
) |
void Visual3d_ViewOrientation::AxialScale | ( | Standard_Real & | Sx, |
Standard_Real & | Sy, | ||
Standard_Real & | Sz | ||
) | const |
void Visual3d_ViewOrientation::SetAxialScale | ( | const Standard_Real | Sx, |
const Standard_Real | Sy, | ||
const Standard_Real | Sz | ||
) |
void Visual3d_ViewOrientation::SetCustomModelViewMatrix | ( | const Handle< TColStd_HArray2OfReal > & | Mat | ) |
Standard_Real Visual3d_ViewOrientation::Twist | ( | ) | const |