public final class

MultiPoint

extends Geometry
implements Serializable Serializable
java.lang.Object
   ↳ com.esri.core.geometry.Geometry
     ↳ com.esri.core.geometry.MultiPoint

Class Overview

A Multipoint is a collection of points. A multipoint is a one-dimensional geometry object. Multipoints can be used to store a collection of point-based information where the order and individual identity of each point is not an essential characteristic of the point set.

Summary

[Expand]
Inherited Fields
From class com.esri.core.geometry.Geometry
Public Constructors
MultiPoint()
Creates a new empty multipoint.
Public Methods
void add(double x, double y)
Adds a point with the specified X, Y coordinates to this multipoint.
void add(MultiVertexGeometry src, int srcFrom, int srcTo)
Appends points from another multipoint at the end of this multipoint.
void add(Point point)
Adds a point multipoint.
void addAttribute(int semantics)
Adds a new attribute to the Geometry.
void applyTransformation(Transformation2D transform)
Applies 2D affine transformation in XY plane.
void copyTo(Geometry dst)
Copies this geometry to another geometry of the same type.
Geometry createInstance()
Creates an instance of an empty geometry of the same type.
void dropAllAttributes()
Drops all attributes from the Geometry with exception of POSITON.
void dropAttribute(int semantics)
Drops an attribute from the Geometry.
boolean equals(Object other)
Returns TRUE when this geometry has exactly same type, properties, and coordinates as the other geometry.
VertexDescription getDescription()
Returns the VertexDescription of this geomtry.
int getDimension()
Returns the topological dimension of the geometry object based on the geometry's type.
Point getPoint(int index)
Returns given vertex of the Geometry.
void getPoint(int index, Point ptOut)
Returns given vertex of the Geometry by value.
int getPointCount()
Returns the total vertex count in this Geometry.
int getStateFlag()
Returns the state of the geometry.
Geometry.Type getType()
Returns the geometry type.
int hashCode()
Returns a hash code value for this multipoint.
void insertPoint(int beforePointIndex, Point pt)
Inserts a point to this multipoint.
boolean isEmpty()
Indicates if the geometry object contains geometric information.
boolean isValid()
Checks whether the MultiPoint is valid.
void mergeVertexDescription(VertexDescription src)
Merges the new VertexDescription by adding missing attributes from the src.
void queryEnvelope(Envelope env)
Gets the axis aligned bounding box of the geometry.
void queryEnvelope2D(Envelope2D env)
Returns tight bbox of the Geometry in X, Y plane.
void removePoint(int pointIndex)
Removes a point from this multipoint.
void resize(int pointCount)
Resizes the multipoint to have the given size.
void setEmpty()
Sets the geometry to its original initialization state by releasing all data referenced by the geometry.
void setPoint(int index, Point pointSrc)
Sets the vertex at given index of the Geometry.
Protected Methods
Object _getImpl()
Returns implementation class of the geometry.
[Expand]
Inherited Methods
From class com.esri.core.geometry.Geometry
From class java.lang.Object

Public Constructors

public MultiPoint ()

Creates a new empty multipoint.

Public Methods

public void add (double x, double y)

Adds a point with the specified X, Y coordinates to this multipoint.

Parameters
x double: The new Point's X coordinate.
y double: The new Point's Y coordinate.

public void add (MultiVertexGeometry src, int srcFrom, int srcTo)

Appends points from another multipoint at the end of this multipoint.

Parameters
src MultiVertexGeometry: The mulitpoint to append to this multipoint.
srcFrom int: The start index in the source multipoint from which to start appending points.
srcTo int: The end index in the source multipoint right after the last point to be appended. Use -1 to indicate the rest of the source multipoint.

public void add (Point point)

Adds a point multipoint.

Parameters
point Point: The Point to be added to this multipoint.

public void addAttribute (int semantics)

Adds a new attribute to the Geometry.

public void applyTransformation (Transformation2D transform)

Applies 2D affine transformation in XY plane.

Parameters
transform Transformation2D: The affine transformation to be applied to this geometry.

public void copyTo (Geometry dst)

Copies this geometry to another geometry of the same type. The result geometry is an exact copy.

Parameters
dst Geometry

public Geometry createInstance ()

Creates an instance of an empty geometry of the same type.

Returns
Geometry

public void dropAllAttributes ()

Drops all attributes from the Geometry with exception of POSITON.

public void dropAttribute (int semantics)

Drops an attribute from the Geometry. Dropping the attribute is equivalent to setting the attribute to the default value for each vertex, However, it is faster and the result Geometry has smaller memory footprint and smaller size when persisted.

Parameters
semantics int

public boolean equals (Object other)

Returns TRUE when this geometry has exactly same type, properties, and coordinates as the other geometry.

Parameters
other Object
Returns
boolean

public VertexDescription getDescription ()

Returns the VertexDescription of this geomtry.

Returns
VertexDescription

public int getDimension ()

Returns the topological dimension of the geometry object based on the geometry's type.

Returns 0 for point and multipoint.

Returns 1 for lines and polylines.

Returns 2 for polygons and envelopes

Returns 3 for objects with volume

Returns
int Returns the integer value of the dimension of geometry.

public Point getPoint (int index)

Returns given vertex of the Geometry.

Parameters
index int
Returns
Point

public void getPoint (int index, Point ptOut)

Returns given vertex of the Geometry by value.

Parameters
index int
ptOut Point

public int getPointCount ()

Returns the total vertex count in this Geometry.

Returns
int

public int getStateFlag ()

Returns the state of the geometry. The stateFlag value changes with changes applied to this geometry. This allows the user to keep track of the geometry's state.

Returns
int The state of the geometry.

public Geometry.Type getType ()

Returns the geometry type.

Returns
Geometry.Type Returns the geometry type.

public int hashCode ()

Returns a hash code value for this multipoint.

Returns
int

public void insertPoint (int beforePointIndex, Point pt)

Inserts a point to this multipoint.

Parameters
beforePointIndex int: The index right before the new point to insert.
pt Point: The point to insert.

public boolean isEmpty ()

Indicates if the geometry object contains geometric information. IsEmpty returns true when the geometry object does not contain geometric information beyond its original initialization state.

Returns
boolean boolean Returns true if this geometry is empty.

public boolean isValid ()

Checks whether the MultiPoint is valid. It is valid if the point count is greater than 0.

Returns
boolean true if the MultiPoint is valid

public void mergeVertexDescription (VertexDescription src)

Merges the new VertexDescription by adding missing attributes from the src. The Geometry will have a union of the current and the src descriptions.

Parameters
src VertexDescription

public void queryEnvelope (Envelope env)

Gets the axis aligned bounding box of the geometry.

Parameters
env Envelope: The envelope to return the result in.

public void queryEnvelope2D (Envelope2D env)

Returns tight bbox of the Geometry in X, Y plane.

Parameters
env Envelope2D

public void removePoint (int pointIndex)

Removes a point from this multipoint.

Parameters
pointIndex int: The index of the point to be removed.

public void resize (int pointCount)

Resizes the multipoint to have the given size.

Parameters
pointCount int: - The number of points in this multipoint.

public void setEmpty ()

Sets the geometry to its original initialization state by releasing all data referenced by the geometry.

public void setPoint (int index, Point pointSrc)

Sets the vertex at given index of the Geometry.

Parameters
index int: The index of the vertex being changed.
pointSrc Point: The Point instance to set given vertex attributes from. The pointSrc can not be empty.
The method throws if the pointSrc is not of the Point type.
The attributes, that are present in the pointSrc and missing in this Geometry, will be added to the Geometry.
The vertex attributes missing in the pointSrc but present in the Geometry will be set to the default values (see VertexDescription::GetDefaultValue).

Protected Methods

protected Object _getImpl ()

Returns implementation class of the geometry. Subclass overrides this method.

Returns
Object