ICamera.PolarUpdate Method

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 VARIANT_BOOL

Product Availability

Remarks

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.

See Also