org.geotools.renderer.array
Class PointArray

java.lang.Object
  org.geotools.renderer.array.PointArray

All Implemented Interfaces:

java.io.Serializable

Direct Known Subclasses:

DefaultArray, GenericArray, JTSArray

Deprecated. Replaced by org.geotools.geometry.array.PointArray2D as part of the port of J2D-renderer to the new GO-1 based API. Note that it is not possible to mix J2D-renderer classes with GO-1 rendering engine. Migration from J2D-renderer to the GO-1 API will requires the replacement of all deprecated classes together. Because the new GO-1 rendering engine is a work in progress, see GEOT-776 in order to determine if enough functionalites have been ported for yours need.

public abstract class PointArray

extends java.lang.Object

implements java.io.Serializable

Classe de base des classes enveloppant un tableau de points (x,y). Les acc?s aux ?l?ments de ce tableaux ne peuvent pas ?tre fait de fa?on al?atoires. Ils doivent obligatoirement passer par un it?rateur retourn? par iterator(int). Cette limitation est n?cessaire pour faciliter l'impl?mentation de certains algorithmes de compression des donn?es.

Note sur le vocabulaire employ?: Dans la documentation de cette classe, le terme point se r?f?re ? une paire de coordonn?es (x,y) tandis que le terme coordonn?e se r?f?re ? une seule valeur x ou y (en fran?ais, "ordonn?e" est plut?t utilis? pour la coordonn?e le long de l'axe des y, la coordonn?e le long de l'axe des x ?tant l'abscisse). Pour un point situ? ? l'index i, les coordonn?es x et y correspondantes se trouvent aux index 2*i et 2*i+1 respectivement.

Version:

$Id: PointArray.java 17672 2006-01-19 00:25:55Z desruisseaux $

Author:

Martin Desruisseaux

See Also:

DefaultArray, GenericArray, JTSArray, DefaultArray.getInstance(float[], int, int, boolean), Renderer, MapPane, Serialized Form

Constructor Summary

protected

PointArray() Deprecated. Construct a new array.

Method Summary

abstract int	count() Deprecated. Returns the number of points in this array.
boolean	equals(java.lang.Object that) Deprecated. Indique si cet objet est identique ? l'objet sp?cifi?.
boolean	equals(PointArray that) Deprecated. Indique si ce tableau est identique au tableau sp?cifi?.
java.awt.geom.Rectangle2D	getBounds2D() Deprecated. Returns the bounding box of all x and y ordinates.
PointArray	getFinal(CompressionLevel level) Deprecated. Retourne un tableau immutable qui contient les m?mes donn?es que celui-ci.
abstract java.awt.geom.Point2D	getFirstPoint(java.awt.geom.Point2D point) Deprecated. Returns the first point in this array.
abstract java.awt.geom.Point2D	getLastPoint(java.awt.geom.Point2D point) Deprecated. Returns the last point in this array.
abstract long	getMemoryUsage() Deprecated. Returns an estimation of memory usage in bytes.
int	hashCode() Deprecated. Retourne un code repr?sentant cet objet.
abstract PointArray	insertAt(int index, float[] toMerge, int lower, int upper, boolean reverse) Deprecated. Ins?re les donn?es (x,y) du tableau toMerge sp?cifi?.
PointArray	insertAt(int index, PointArray toMerge, boolean reverse) Deprecated. Ins?re tous les points de toMerge dans le tableau this.
abstract PointIterator	iterator(int index) Deprecated. Returns an iterator object that iterates along the point coordinates.
abstract PointArray	reverse() Deprecated. Renverse l'ordre de tous les points compris dans ce tableau.
abstract PointArray	subarray(int lower, int upper) Deprecated. Retourne un tableau enveloppant les m?mes points que le tableau courant, mais des index lower inclusivement jusqu'? upper exclusivement.
float[]	toArray() Deprecated. Retourne une copie de toutes les coordonn?es (x,y) de ce tableau.
abstract void	toArray(ArrayData dest, float resolution2) Deprecated. Append (x,y) coordinates to the specified destination array.
java.awt.Shape	toShape(java.awt.geom.AffineTransform transform) Deprecated. Returns this PointArray as a shape.
java.lang.String	toString() Deprecated. Retourne une cha?ne de caract?res repr?sentant ce tableau.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

PointArray

protected PointArray()

Deprecated.

Construct a new array.

Method Detail

count

public abstract int count()

Deprecated.

Returns the number of points in this array.

getMemoryUsage

public abstract long getMemoryUsage()

Deprecated.

Returns an estimation of memory usage in bytes. This method is for information purpose only. The memory used by this array may be shared with an other array, resulting in a total memory consumption lower than the sum of getMemoryUsage() return values. Furthermore, this method do not take in account the extra bytes generated by Java Virtual Machine for each objects.

Returns:

An estimation of memory usage in bytes.

getFirstPoint

public abstract java.awt.geom.Point2D getFirstPoint(java.awt.geom.Point2D point)

Deprecated.

Returns the first point in this array. If point is null, a new Point2D object is allocated and then the result is stored in this object. In either case point, which contains the first point, is returned for convenience.

Parameters:

point - The object in which to store the first point, or null.

Returns:

point or a new Point2D, which contains the first point.

getLastPoint

public abstract java.awt.geom.Point2D getLastPoint(java.awt.geom.Point2D point)

Deprecated.

Returns the last point in this array. If point is null, a new Point2D object is allocated and then the result is stored in this object. In either case point, which contains the last point, is returned for convenience.

Parameters:

point - The object in which to store the last point, or null.

Returns:

point or a new Point2D, which contains the last point.

iterator

public abstract PointIterator iterator(int index)

Deprecated.

Returns an iterator object that iterates along the point coordinates.

Parameters:

index - Index of the first point to returns in the iteration.

Returns:

The iterator.

getBounds2D

public java.awt.geom.Rectangle2D getBounds2D()

Deprecated.

Returns the bounding box of all x and y ordinates. If this array is empty, then this method returns null. The default implementation iterates through all coordinates provided by PointIterator.

subarray

public abstract PointArray subarray(int lower,
                                    int upper)

Deprecated.

Retourne un tableau enveloppant les m?mes points que le tableau courant, mais des index lower inclusivement jusqu'? upper exclusivement. Si le sous-tableau ne contient aucun point (c'est-?-dire si lower==upper), alors cette m?thode retourne null.

Parameters:

lower - Index du premier point ? prendre en compte.

upper - Index suivant celui du dernier point ? prendre en compte.

insertAt

public final PointArray insertAt(int index,
                                 PointArray toMerge,
                                 boolean reverse)

Deprecated.

Ins?re tous les points de toMerge dans le tableau this. Si le drapeau reverse ? la valeur true, alors les points de toMerge seront copi?es en ordre inverse.

Parameters:

index - Index ? partir d'o? ins?rer les points dans ce tableau. Le point ? cet index ainsi que tous ceux qui le suivent seront d?cal?s vers des index plus ?lev?s.

toMerge - Tableau de points ? ins?rer. Ses valeurs seront copi?es.

insertAt

public abstract PointArray insertAt(int index,
                                    float[] toMerge,
                                    int lower,
                                    int upper,
                                    boolean reverse)

Deprecated.

Ins?re les donn?es (x,y) du tableau toMerge sp?cifi?. Si le drapeau reverse ? la valeur true, alors les points de toMerge seront copi?es en ordre inverse.

Parameters:

index - Index ? partir d'o? ins?rer les points dans ce tableau. Le point ? cet index ainsi que tous ceux qui le suivent seront d?cal?s vers des index plus ?lev?s.

toMerge - Tableau de coordonn?es (x,y) ? ins?rer dans ce tableau de points. Ses valeurs seront copi?es.

lower - Index de la premi?re coordonn?e de toMerge ? copier dans ce tableau.

upper - Index suivant celui de la derni?re coordonn?e de toMerge ? copier.

reverse - true s'il faut inverser l'ordre des points de toMerge lors de la copie. Cette inversion ne change pas l'ordre (x,y) des coordonn?es de chaque points.

Returns:

this si l'insertion ? pu ?tre faite sur place, ou un autre tableau si ?a n'a pas ?t? possible.

reverse

public abstract PointArray reverse()

Deprecated.

Renverse l'ordre de tous les points compris dans ce tableau.

Returns:

this si l'inversion a pu ?tre faite sur-place, ou un autre tableau si ?a n'a pas ?t? possible.

getFinal

public PointArray getFinal(CompressionLevel level)

Deprecated.

Retourne un tableau immutable qui contient les m?mes donn?es que celui-ci. Apr?s l'appel de cette m?thode, toute tentative de modification (avec les m?thodes insertAt(int, org.geotools.renderer.array.PointArray, boolean) ou reverse()) vont retourner un autre tableau de fa?on ? ne pas modifier le tableau immutable.

Parameters:

level - The compression level, or null if no compression is wanted.

Returns:

Tableau immutable et ?ventuellement compress?, this si ce tableau r?pondait d?j? aux conditions ou null si ce tableau ne contient aucune donn?e.

toArray

public abstract void toArray(ArrayData dest,
                             float resolution2)

Deprecated.

Append (x,y) coordinates to the specified destination array. The destination array will be filled starting at index ArrayData.length. If resolution2 is greater than 0, then points that are closer than sqrt(resolution2) from previous one will be skiped.

Parameters:

resolution2 - The minimum squared distance desired between points.

Task:

REVISIT: Current implementations compute distance using Pythagoras formulas, which is okay for projected coordinates but not right for geographic (longitude / latitude) coordinates. This is not a real problem when the rendering CS is the same than the data CS, since the decimation performed here target specifically the rendering device (the important thing is that distances look okay to user's eyes). However, it may be a problem when the rendering CS is different, since points that are equidistant in the data CS may not be equidistant in the rendering CS.

toArray

public final float[] toArray()

Deprecated.

Retourne une copie de toutes les coordonn?es (x,y) de ce tableau.

toShape

public final java.awt.Shape toShape(java.awt.geom.AffineTransform transform)

Deprecated.

Returns this PointArray as a shape. This shape is not designed for map rendering. It is rather a debugging tool, as well as a convenient way to draw lines in some simple context (e.g. Plot2D).

Parameters:

transform - An optional transform to apply on coordinates, or null if none.

Returns:

The lines in this PointArray as a Java2D shape.

toString

public final java.lang.String toString()

Deprecated.

Retourne une cha?ne de caract?res repr?sentant ce tableau. Cette cha?ne contiendra le nom de la classe utilis?e, le nombre de points ainsi que les points de d?part et d'arriv?.

equals

public final boolean equals(PointArray that)

Deprecated.

Indique si ce tableau est identique au tableau sp?cifi?. Deux tableaux seront consid?r?s identiques s'ils contiennent les m?mes points dans le m?me ordre.

equals

public final boolean equals(java.lang.Object that)

Deprecated.

Indique si cet objet est identique ? l'objet sp?cifi?. Cette m?thode consid?re deux objets identiques si that est d'une classe d?riv?e de PointArray et si les deux tableaux contiennent les m?mes points dans le m?me ordre.

hashCode

public final int hashCode()

Deprecated.

Retourne un code repr?sentant cet objet.