This document is archived and information here might be outdated. Recommended version. |
Updates the observer's location by given polar increments.
[Visual Basic .NET] Public Sub PolarUpdate ( _ ByVal distanceFactor As Double, _ ByVal dAzimuth As Double, _ ByVal dInclination As Double, _ ByVal bLimitInclination As Boolean _ )
[C#] public void PolarUpdate ( double distanceFactor, double dAzimuth, double dInclination, bool bLimitInclination );
[C++]
HRESULT PolarUpdate(
double distanceFactor,
double dAzimuth,
double dInclination,
VARIANT_BOOL bLimitInclination
);
[C++]
Parameters distanceFactor [in]
distanceFactor is a parameter of type double dAzimuth [in]
dAzimuth is a parameter of type double dInclination [in]
dInclination is a parameter of type double bLimitInclination [in]
bLimitInclination is a parameter of type bool
The observer will be moved by the values specified in the arguments:
The distanceFactor resets the current ViewingDistance (distance between observer and target) by multiplying it by the given factor.
dAzimuth is added to the current azimuth.
dInclination is added to the current inclination. If the resulting inclination doesn't fall between -89.9 and 89.9 it will be reset so that it does unless bLimitInclination is set to False.
bLimitInclination when set to True ensures the modified inclination doesn't fall outside the -89.9 to 89.9 limit. If set to False and the limit is exceeded the azimuth will be changed 180 degrees and the UpDirection will be flipped.