edu.ucdavis.cstars.client.geometry

Class Geometry

java.lang.Object

com.google.gwt.core.client.JavaScriptObject

edu.ucdavis.cstars.client.geometry.Geometry

Direct Known Subclasses:

Extent, Multipoint, Point, Polygon, Polyline

public class Geometry
extends com.google.gwt.core.client.JavaScriptObject

The base class for geometry objects. This class has no constructor.

Author:

Justin Merz

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Geometry.GeometryType

Method Summary

Methods

Modifier and Type	Method and Description
static Geometry	fromJson(com.google.gwt.core.client.JavaScriptObject json) Converts the input JSON object to the appropriate esri.geometry.* object.
static Geometry	geographicToWebMercator(Geometry geometry) Converts geometry from geographic units to Web Mercator units.
static Extent	getExtentForScale(MapWidget map, int scale) Get the extent for the specified scale.
com.google.gwt.core.client.JavaScriptObject	getJson() Converts object to its ArcGIS Server JSON representation.
static java.lang.String	getJsonType(Geometry geometry) Requests the geometry type name as represented in the ArcGIS REST.
static float	getLength(Point point1, Point point2) Calculates the length of a line based on the input of two points.
static Point	getLineIntersection(Point line1start, Point line1end, Point line2start, Point line2end) Calculates the intersecting point of two lines.
static double	getScale(MapWidget map) Gets the current scale of the map.
SpatialReference	getSpatialReference() Get the spatial reference of the geometry.
Geometry.GeometryType	getType() The type of geometry.
static boolean	isClockwise(com.google.gwt.core.client.JsArray<Point> ring) Checks if a Polygon ring is clockwise.
void	setSpatialReference(SpatialReference ref) Sets the spatial reference.
com.google.gwt.core.client.JavaScriptObject	toJson() Converts object to its ArcGIS Server JSON representation.
static Geometry	toMapGeometry(Extent extent, float width, float height, Geometry mapGeometry) Converts the geometry argument to map coordinates based on the extent, width, and height of the Map.
static Point	toMapPoint(Extent extent, float width, float height, Point screenPoint) Deprecated. Deprecated at v1.1. Use toMapGeometry instead
static Geometry	toScreenGeometry(Extent extent, float width, float height, Geometry screenGeometry) Converts the geometry argument to screen coordinates based on the extent, width, and height of the Map.
static Point	toScreenPoint(Extent extent, float width, float height, Point mapPoint) Deprecated. Deprecated at v1.1. Use toScreenGeometry instead
static Geometry	webMercatorToGeographic(Geometry geometry) Converts geometry from Web Mercator units to geographic units.

Methods inherited from class com.google.gwt.core.client.JavaScriptObject

cast, createArray, createArray, createFunction, createObject, equals, hashCode, toSource, toString

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Method Detail

getSpatialReference

public final SpatialReference getSpatialReference()

Get the spatial reference of the geometry.

Returns:

SpatialReference

setSpatialReference

public final void setSpatialReference(SpatialReference ref)

Sets the spatial reference.

Parameters:

ref - - Spatial reference of the geometry.

toJson

public final com.google.gwt.core.client.JavaScriptObject toJson()

Converts object to its ArcGIS Server JSON representation.

Returns:

JavaScriptObject

getType

public final Geometry.GeometryType getType()

The type of geometry.

Returns:

GeometryType

getJson

public final com.google.gwt.core.client.JavaScriptObject getJson()

Converts object to its ArcGIS Server JSON representation.

Returns:

JavaScriptObject

fromJson

public static final Geometry fromJson(com.google.gwt.core.client.JavaScriptObject json)

Converts the input JSON object to the appropriate esri.geometry.* object.

Parameters:

json - - The JSON object.

Returns:

Geometry

geographicToWebMercator

public static final Geometry geographicToWebMercator(Geometry geometry)

Converts geometry from geographic units to Web Mercator units.

Parameters:

geometry - - The geometry to convert.

Returns:

Geometry

getExtentForScale

public static final Extent getExtentForScale(MapWidget map,
                       int scale)

Get the extent for the specified scale.

Parameters:

map - - The input map.

scale - - The input scale.

Returns:

Extent

getJsonType

public static final java.lang.String getJsonType(Geometry geometry)

Requests the geometry type name as represented in the ArcGIS REST.

Parameters:

geometry - - The ArcGIS JavaScript API geometry type to be converted.

Returns:

String

getLength

public static final float getLength(Point point1,
              Point point2)

Calculates the length of a line based on the input of two points.

Parameters:

point1 - - The beginning point.

point2 - - The ending point.

Returns:

float

getLineIntersection

public static final Point getLineIntersection(Point line1start,
                        Point line1end,
                        Point line2start,
                        Point line2end)

Calculates the intersecting point of two lines. If the lines are parallel, a null value is returned.

Parameters:

line1start - - The beginning point of the first line.

line1end - - The ending point of the first line.

line2start - - The beginning point of the second line.

line2end - - The ending point of the second line.

Returns:

Point

getScale

public static final double getScale(MapWidget map)

Gets the current scale of the map.

Parameters:

map - - The map whose scale should be calculated.

Returns:

float

isClockwise

public static final boolean isClockwise(com.google.gwt.core.client.JsArray<Point> ring)

Checks if a Polygon ring is clockwise. Returns true for clockwise and false for counterclockwise.

Parameters:

ring -

Returns:

boolean

toMapGeometry

public static final Geometry toMapGeometry(Extent extent,
                     float width,
                     float height,
                     Geometry mapGeometry)

Converts the geometry argument to map coordinates based on the extent, width, and height of the Map.

Parameters:

extent - - The current extent of the map in map coordinates.

width - - The current width of the map in map units.

height - - The current width of the map in map units.

mapGeometry - - The geometry to convert from screen to map units.

Returns:

Geometry

toMapPoint

@Deprecated
public static final Point toMapPoint(Extent extent,
                          float width,
                          float height,
                          Point screenPoint)

Deprecated. Deprecated at v1.1. Use toMapGeometry instead

toScreenGeometry

public static final Geometry toScreenGeometry(Extent extent,
                        float width,
                        float height,
                        Geometry screenGeometry)

Converts the geometry argument to screen coordinates based on the extent, width, and height of the Map.

Parameters:

extent - - The current extent of the map in map coordinates.

width - - The current width of the map in screen units.

height - - The current width of the map in screen units.

screenGeometry - - The geometry to convert from map to screen units.

Returns:

Geometry

toScreenPoint

@Deprecated
public static final Point toScreenPoint(Extent extent,
                             float width,
                             float height,
                             Point mapPoint)

Deprecated. Deprecated at v1.1. Use toScreenGeometry instead

webMercatorToGeographic

public static final Geometry webMercatorToGeographic(Geometry geometry)

Converts geometry from Web Mercator units to geographic units.

Parameters:

geometry - - The geometry to convert.

Returns:

Geometry