Syntax

[C/C++:]
void gViewRotate(int plane, float angle, float dist);

[F90:]
subroutine gViewRotate(plane, angle, dist)

integer, intent(in) :: plane
real, intent(in) :: angle,dist

Arguments

plane
Plane in which rotation is to take place

= GYZPLANE,

YZ plane

= GXZPLANE,

XZ plane

= GXYPLANE,

XY plane

angle
Angle of rotation in degrees

dist
Distance from eye position to centre of rotation

Description

The routine gViewRotate() calculates a new eye position such that the line of sight is rotated about a point of distance dist along the view direction from the eye position. The line of sight is rotated by the specified angle in the specified plane. A positive rotation is anticlockwise when looking at the positive side of the plane.

Rotating the line of sight has the side-effect or modifying the view-up direction in most circumstances.

If plane is not in range or if the current view has no perspective defined, an error message is output and no further action is taken.

See Also

gViewRotate Usage
gSetViewUpDirection

---