oracle.spatial.geometry

Class Mer

java.lang.Object

oracle.spatial.geometry.Mer

public final class Mer
extends java.lang.Object

Provides helper methods for mers stored as bare arrays, as well as an encapsulated type.

Since:

release specific (what release of product did this appear in)

Constructor Summary

Constructors

Constructor and Description
Mer(double[] arrayMer) Create a Mer from a bare array.
Mer(double[] arrayMer, boolean deepCopy) Create a Mer from a bare array.
Mer(int dim) Create a mer that contains nothing; it can be extended into a real mer.
Mer(Mer m) Copy constructor.

Method Summary

Modifier and Type	Method and Description
void	extend(double[] pt) Extend this mer to include pt.
static double[]	extend(double[] target, double[] ptMer) Extend a target MER to include a new MER or a new point.
static double[]	extend(double[] target, JPoint2DD pt) Extend a 2D target MER to include a new MER or a new point.
void	extend(JPoint2DD pt) Extend this mer to include pt.
void	extend(Mer m) Extend this mer to include m.
double[]	getArray() Returns the mer as array - changing the returned array results in undefined behavior.
double[][]	getRanges() Create and return a copy of the mer is an array of ranges, { {min x, max x}, {min y, max y}, etc.
boolean	interacts(double[] pt) Return true if pt touches or is inside this mer.
static boolean	interacts(double[] target, double[] ptMer) Test if the point or mer touches the target mer.
static boolean	interacts(double[] target, double[] ptMer, double tol) Test if the point or mer touches the target mer + tolerance.
static boolean	interacts(double[] target, JPoint2DD pt) Test if the 2D MER contains the given point.
boolean	interacts(JPoint2DD pt) Return true if pt touches or is inside this mer.
static boolean	interactsTile(double[] tileMer, JPoint2DD pt) Test if the 2D MER contains the given point, excluding the right and bottom edges of the mer.
boolean	interactsTile(JPoint2DD pt) Return true if pt is inside this mer, or touches the top or left edge.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Mer

public Mer(int dim)

Create a mer that contains nothing; it can be extended into a real mer.

Parameters:

dim -

Mer

public Mer(double[] arrayMer)

Create a Mer from a bare array. The new Mer is a deep copy of the given array. Mer(double[], boolean)

Parameters:

arrayMer -

Mer

public Mer(double[] arrayMer,
           boolean deepCopy)

Create a Mer from a bare array. The caller can specify whether a deep copy of the array is desired. Note that if deepCopy == false, behavior is undefined if arrayMer is later changed.

Parameters:

arrayMer -

deepCopy -

Mer

public Mer(Mer m)

Copy constructor.

Parameters:

m -

Method Detail

extend

public static final double[] extend(double[] target,
                                    double[] ptMer)

Extend a target MER to include a new MER or a new point. Returns the extended target MER. Both must have same dimension dim.

Parameters:

target - the mer to extend (modified by this call).

ptMer - the pt/mer to be included (if size dim, is a point; if size dim*2, is a MER).

Returns:

the input target mer, extended to include pt

extend

public static final double[] extend(double[] target,
                                    JPoint2DD pt)

Extend a 2D target MER to include a new MER or a new point. Returns the extended target MER. Both must have same dimension dim.

Parameters:

target - the 2D mer to extend (modified by this call).

pt - the pt/mer to be included (if size dim, is a point; if size dim*2, is a MER).

Returns:

the input target mer, extended to include pt

interacts

public static final boolean interacts(double[] target,
                                      double[] ptMer)

Test if the point or mer touches the target mer.

Parameters:

target -

ptMer - point if size = dim, mer if size = 2*dim

Returns:

true iff

interacts

public static final boolean interacts(double[] target,
                                      double[] ptMer,
                                      double tol)

Test if the point or mer touches the target mer + tolerance.

Parameters:

target -

ptMer -

tol - effectively expands (shrinks, if negative) the mer in all dimensions by this tolerance

Returns:

true iff

interacts

public static final boolean interacts(double[] target,
                                      JPoint2DD pt)

Test if the 2D MER contains the given point.

Parameters:

target -

pt -

Returns:

true iff

interactsTile

public static final boolean interactsTile(double[] tileMer,
                                          JPoint2DD pt)

Test if the 2D MER contains the given point, excluding the right and bottom edges of the mer. If a set of Mers tiles a region without overlapping, then a point in the region will test true for exactly one of those Mers.

Parameters:

tileMer -

pt -

Returns:

getArray

public double[] getArray()

Returns the mer as array - changing the returned array results in undefined behavior.

Returns:

the array we store the Mer in

getRanges

public double[][] getRanges()

Create and return a copy of the mer is an array of ranges, { {min x, max x}, {min y, max y}, etc. }

Returns:

extend

public final void extend(Mer m)

Extend this mer to include m.

Parameters:

m -

extend

public final void extend(JPoint2DD pt)

Extend this mer to include pt.

Parameters:

pt -

extend

public final void extend(double[] pt)

Extend this mer to include pt.

Parameters:

pt -

interacts

public final boolean interacts(double[] pt)

Return true if pt touches or is inside this mer.

Parameters:

pt -

Returns:

interacts

public final boolean interacts(JPoint2DD pt)

Return true if pt touches or is inside this mer.

Parameters:

pt -

Returns:

interactsTile

public final boolean interactsTile(JPoint2DD pt)

Return true if pt is inside this mer, or touches the top or left edge. Useful for a set of MERs that tile the plane.

Parameters:

pt -

Returns: