Skip to content

# PDFGeospatialMeasure

Namespace: O2S.Components.PDF4NET.Spatial

Defines a geospatial measure.

    public class PDFGeospatialMeasure : PDFMeasure

Inheritance Object → PDFMeasure → PDFGeospatialMeasure

Remarks

The geospatial measure defines the relationship between points or regions in the two dimensional PDF object space and points or regions with respect to an underlying model of the earth.

## Constructors

### PDFGeospatialMeasure()

Initializes a new PDFGeospatialMeasure object.

    public PDFGeospatialMeasure()

## Properties

### Bounds

Gets or sets the map bounds.

    public PDFPoint[] Bounds { get; set; }

Property Value

PDFPoint[]
An array of points that describes the bounds of an area for which geospatial transformations are valid.

Remarks

For maps, this bounding polygon is known as a neatline. These points (x and y) are expressed relative to a unit square that describes the bounds associated with a PDFViewport, PDFFormXObject or PDFImage.

### CoordinateSystem

Gets or sets the coordinate system.

    public PDFCoordinateSystem CoordinateSystem { get; set; }

Property Value

PDFCoordinateSystem
A projected or geographic coordinate system object.

### DisplayCoordinateSystem

Gets or sets the display coordinate system.

    public PDFCoordinateSystem DisplayCoordinateSystem { get; set; }

Property Value

PDFCoordinateSystem
A projected or geographic coordinate system that shall be used for the display of position values, such as latitude and longitude.

### GeographicPoints

Gets or sets the geographic points.

    public PDFPoint[] GeographicPoints { get; set; }

Property Value

PDFPoint[]
An array of points in geographic space as degrees of latitude and longitude, respectively.

Remarks

These values shall be based on the geographic coordinate system described PDFGeospatialMeasure.CoordinateSystem.

### LocalPoints

Gets or sets the local points.

    public PDFPoint[] LocalPoints { get; set; }

Property Value

PDFPoint[]
An array of points in a 2D unit square.

Remarks

The unit square is mapped to the rectangular bounds of the PDFViewport, PDFFormXObject or PDFImage that contains the measure object.
This array shall contain the same number of points as the PDFGeospatialMeasure.GeographicPoints array; each point is the unit square object position corresponding to the geospatial position in the PDFGeospatialMeasure.GeographicPoints array.

### PreferredAngularDisplayUnit

Gets or sets the preferred unit for displaying angles.

    public PDFPreferredDisplayUnit PreferredAngularDisplayUnit { get; set; }

Property Value

PDFPreferredDisplayUnit
The preferred unit for displaying angles.

Remarks

Only these values are supported for this property: PDFPreferredDisplayUnit.Degree and PDFPreferredDisplayUnit.Grad.

### PreferredAreaDisplayUnit

Gets or sets the preferred unit for displaying areas.

    public PDFPreferredDisplayUnit PreferredAreaDisplayUnit { get; set; }

Property Value

PDFPreferredDisplayUnit
The preferred unit for displaying areas.

Remarks

Only these values are supported for this property: PDFPreferredDisplayUnit.SquareMetre, PDFPreferredDisplayUnit.Hectare, PDFPreferredDisplayUnit.SquareKilometre, PDFPreferredDisplayUnit.SquareUSFoot, PDFPreferredDisplayUnit.Acre and PDFPreferredDisplayUnit.SquareMile.

### PreferredDistanceDisplayUnit

Gets or sets the preferred unit for displaying distances.

    public PDFPreferredDisplayUnit PreferredDistanceDisplayUnit { get; set; }

Property Value

PDFPreferredDisplayUnit
The preferred unit for displaying distances.

Remarks

Only these values are supported for this property: PDFPreferredDisplayUnit.Metre, PDFPreferredDisplayUnit.Kilometre, PDFPreferredDisplayUnit.Foot, PDFPreferredDisplayUnit.USFoot, PDFPreferredDisplayUnit.Mile and PDFPreferredDisplayUnit.NauticalMile.