SoCameraInteractorZoom Method |
Zoom - Makes the scene appear larger or smaller.
Namespace: OIV.Inventor.ViewerComponents
Sets the camera's heightAngle field (for a perspective camera) or height field (for an orthographic camera) to the specified value. For a perspective camera, the value is in radians and the default is 0.785398. For an orthographic camera the value is in World Coordinates and the default is 2.
Conceptually, zoom means approximately the same thing as it does for a real camera - changing the "focal length" of the lens. Making the heightAngle (or height) larger corresponds to using a wide-angle lens, so the scene appears smaller. Making the heightAngle (or height) smaller corresponds to using a telephoto lens, so the scene appears larger.
NOTE: For a perspective camera, we strongly recommend implementing the visual effect of "zoom" by moving the camera closer to, or farther away from, the scene (see OIV.Inventor.ViewerComponents.SoCameraInteractor.Dolly(System.Single)). Very small and very large values of heightAngle can produce undesirable results.