EarthAnchorPoint

References
Contains information about the model's position in latitude, longitude, and elevation for GIS mapping applications.

Constructors

EarthAnchorPoint

#Since v5.0
public EarthAnchorPoint()
Initializes a new instance of the EarthAnchorPoint class.

Finalizer

~EarthAnchorPoint

#
~EarthAnchorPoint()
Passively reclaims unmanaged resources when the class user did not explicitly call Dispose().

Properties

Description

#Since v5.0
public string Description { get; set; }
Gets or sets the long form of the identifying information about this location.

EarthBasepointElevation

#Since v5.0
public double EarthBasepointElevation { get; set; }
Gets or sets the point elevation on earth, in meters.

EarthBasepointElevationCoordinateSystem

#Since v8.5
public EarthCoordinateSystem EarthBasepointElevationCoordinateSystem { get; set; }
Gets or sets a value indicating the zero level convention relating to a location on Earth.

EarthBasepointElevationZero

#Since v5.0
[EditorBrowsable(EditorBrowsableState.Never)] public BasepointZero EarthBasepointElevationZero { get; set; }
obsoletePlease use EarthBasepointElevationCoordinateSystem property
Gets or sets a value indicating the zero level convention relating to a location on Earth.

EarthBasepointLatitude

#Since v5.0
public double EarthBasepointLatitude { get; set; }
Gets or sets a point latitude on earth, in degrees. +90 = north pole, 0 = equator, -90 = south pole.

EarthBasepointLongitude

#Since v5.0
public double EarthBasepointLongitude { get; set; }
Gets or sets the point longitude on earth, in degrees.

KMLOrientationHeadingAngleDegrees

#Since v7.11
public double KMLOrientationHeadingAngleDegrees { get; }
Gets Keyhole Markup Language (KML) orientation heading angle in degrees.

KMLOrientationHeadingAngleRadians

#Since v7.11
public double KMLOrientationHeadingAngleRadians { get; }
Gets Keyhole Markup Language (KML) orientation heading angle in radians.

KMLOrientationRollAngleDegrees

#Since v7.11
public double KMLOrientationRollAngleDegrees { get; }
Gets Keyhole Markup Language (KML) orientation roll angle in degrees.

KMLOrientationRollAngleRadians

#Since v7.11
public double KMLOrientationRollAngleRadians { get; }
Gets Keyhole Markup Language (KML) orientation roll angle in degrees.

KMLOrientationTiltAngleDegrees

#Since v7.11
public double KMLOrientationTiltAngleDegrees { get; }
Gets Keyhole Markup Language (KML) orientation tilt angle in degrees.

KMLOrientationTiltAngleRadians

#Since v7.11
public double KMLOrientationTiltAngleRadians { get; }
Gets Keyhole Markup Language (KML) orientation tilt angle in degrees.

ModelBasePoint

#Since v5.0
public Point3d ModelBasePoint { get; set; }
Corresponding model point in model coordinates.

ModelEast

#Since v5.0
public Vector3d ModelEast { get; set; }
Earth directions in model coordinates.

ModelNorth

#Since v5.0
public Vector3d ModelNorth { get; set; }
Earth directions in model coordinates.

Name

#Since v5.0
public string Name { get; set; }
Gets or sets the short form of the identifying information about this location.

Methods

Dispose

#Since v5.0
public void Dispose()
Actively reclaims unmanaged resources that this instance uses.

Dispose

#
protected virtual void Dispose(bool disposing)
For derived class implementers.

This method is called with argument true when class user calls Dispose(), while with argument false when the Garbage Collector invokes the finalizer, or Finalize() method.

You must reclaim all used unmanaged resources in both cases, and can use this chance to call Dispose on disposable fields if the argument is true.

Also, you must call the base virtual method within your overriding method.

disposing (bool)true if the call comes from the Dispose() method; false if it comes from the Garbage Collector finalizer.

EarthLocationIsSet

#Since v6.0
public bool EarthLocationIsSet()
Checks if the earth location is set or not.
Boolean value, true if set else false

GetEarthAnchorPlane

#Since v6.0
public Plane GetEarthAnchorPlane(out Vector3d anchorNorth)
Returns the earth anchor plane
anchorNorth (out Vector3d)
A plane value.

GetModelCompass

#Since v5.0
public Plane GetModelCompass()
Returns a plane in model coordinates whose X axis points East, Y axis points North and Z axis points Up. The origin is set to ModelBasepoint.
A plane value. This might be invalid on error.

GetModelToEarthTransform

#Since v9.0
public Transform GetModelToEarthTransform(LengthUnit modelUnits)
Gets a transformation from model coordinates to earth coordinates. This transformation assumes the model is small enough that the curvature of the earth can be ignored.
Remarks: If M is a point in model coordinates and E = model_to_earth*M, then E.x = latitude in decimal degrees E.y = longitude in decimal degrees E.z = elevation in meters above mean sea level Because the earth is not flat, there is a small amount of error when using a linear transformation to calculate oblate spherical coordinates. This error is small. If the distance from P to M is d meters, then the approximation error is latitude error <= longitude error <= elevation error <= 6379000*((1 + (d/6356000)^2)-1) meters In particular, if every point in the model is within 1000 meters of the m_model_basepoint, then the maximum approximation errors are latitude error <= longitude error <= elevation error <= 8 centimeters.
modelUnits (LengthUnit)The model length unit.
Transform on success. Invalid Transform on error.

GetModelToEarthTransform

#Since v5.0 Obsolete v9.0
public Transform GetModelToEarthTransform(UnitSystem modelUnitSystem)
Gets a transformation from model coordinates to earth coordinates. This transformation assumes the model is small enough that the curvature of the earth can be ignored.
Remarks: If M is a point in model coordinates and E = model_to_earth*M, then E.x = latitude in decimal degrees E.y = longitude in decimal degrees E.z = elevation in meters above mean sea level Because the earth is not flat, there is a small amount of error when using a linear transformation to calculate oblate spherical coordinates. This error is small. If the distance from P to M is d meters, then the approximation error is latitude error <= longitude error <= elevation error <= 6379000*((1 + (d/6356000)^2)-1) meters In particular, if every point in the model is within 1000 meters of the m_model_basepoint, then the maximum approximation errors are latitude error <= longitude error <= elevation error <= 8 centimeters.
modelUnitSystem (UnitSystem)The model unit system.
Transform on success. Invalid Transform on error.

ModelLocationIsSet

#Since v8.5
public bool ModelLocationIsSet()
Checks if the model location is set or not.
Boolean value, true if set else false