AreaOfUse Class

Inherits from

GEOCALCPBW_NAMESPACE::Serializable

 

Description

The AreaOfUse class represents the valid area of use for a given coordinate reference system or coordinate transformation. In prior versions of the GeoCalc library, this object was referred to as an Envelope, and contained minimum and maximum extent points defined in the WGS84 Geodetic coordinate system. With the updates to version 7.0, an optional polygon data component has been added to the class architecture. The point definitions for both the polygon and extent points are always specified in two dimensions using WGS84 Geodetic points.

Each CoordSys, and CoordTransform  type contains an AreaOfUse object that can be used to limit the availability of objects based on the geographic area of a given dataset. It is also possible to use this object to do basic contains queries using the InBounds() method. For additional information about disabling polygon and MBR area checks inside of a GeoCalc application, please see the SetIgnorePolygonAreaOfUse() and SetIgnoreAreaOfUse() methods on the Datasource.

 

Public Constructors

Constructor

Description

CreateAreaOfUse

Creates a new instance of the AreaOfUse class

AreaOfUse

Creates a new instance of the AreaOfUse class

 

Public Methods

Method

Description

DeepCopy

Produces a deep-copy of an Envelope

get_AlwaysAccept

Indicates whether the InBounds method should always return true

get_MaxPoint

Returns the CoordPoint that defines the upper bound of this AreaOfUse

get_MinPoint

Returns the CoordPoint that defines the lower bound of this AreaOfUse

InBounds

Indicates whether the specified CoordPoint is within this AreaOfUse

set_AlwaysAccept

Sets whether the InBounds method should always return true

set_MaxPoint

Sets the CoordPoint that defines the upper bound of this AreaOfUse

set_MinPoint

Sets the CoordPoint that defines the lower bound of this AreaOfUse

ValueEquals

Compares the value of two AreaOfUse objects

get_HasPolygonDefintion

Indicates whether the current AreaOfUse contains a polygon definition

get_AOUCode

Returns the AOU code used to provide access to the current polygon data

GetCenter

Returns the center point of the current extent MBR for this AreaOfUse

GetBounds

Returns the minimum and maximum extents for the current object as Geodetic WGS84 values

 

Overloaded Operators

Operator

Description

operator=

Assigns a new value to this AreaOfUse

operator==

Compares the value of two AreaOfUse objects

operator!=

Compares the value of two AreaOfUse objects