pointarray2d.html

Geotools是一个开源的Java GIS工具包,可利用它来开发符合标准的地理信息系统。Geotools提供了OGC(Open Geospatial Consortium)规范的一个实现来作为他们的

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Reverts all coordinate points order in this array. </TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../org/geotools/geometry/array/PointArray2D.html#set(int, org.opengis.spatialschema.geometry.DirectPosition)">set</A></B>(int&nbsp;index,
    DirectPosition&nbsp;position)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Sets the point at the given index. </TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>abstract &nbsp;<A HREF="../../../../org/geotools/geometry/array/PointArray2D.html" title="class in org.geotools.geometry.array">PointArray2D</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../org/geotools/geometry/array/PointArray2D.html#subarray(int, int)">subarray</A></B>(int&nbsp;lower,
         int&nbsp;upper)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns an array that share the points in this array from point  inclusive
 to  exclusive. </TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;float[]</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../org/geotools/geometry/array/PointArray2D.html#toFloatArray()">toFloatArray</A></B>()</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns a copy of all (<var>x</var>,<var>y</var>) coordinates in this array.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>abstract &nbsp;void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../org/geotools/geometry/array/PointArray2D.html#toFloatArray(org.geotools.geometry.array.ArrayData, float)">toFloatArray</A></B>(<A HREF="../../../../org/geotools/geometry/array/ArrayData.html" title="class in org.geotools.geometry.array">ArrayData</A>&nbsp;dest,
             float&nbsp;resolutionSquared)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Appends (<var>x</var>,<var>y</var>) coordinates to the specified destination array.
 </TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/awt/Shape.html" title="class or interface in java.awt">Shape</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../org/geotools/geometry/array/PointArray2D.html#toShape(java.awt.geom.AffineTransform)">toShape</A></B>(<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/awt/geom/AffineTransform.html" title="class or interface in java.awt.geom">AffineTransform</A>&nbsp;transform)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns this  as a <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/awt/Shape.html" title="class or interface in java.awt">shape</A>.  </TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../org/geotools/geometry/array/PointArray2D.html#toString()">toString</A></B>()</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns a string representation of this array. </TD>
</TR>
</TABLE>
&nbsp;<A NAME="methods_inherited_from_class_Object"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
<TD><B>Methods inherited from class <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html" title="class or interface in java.lang">Object</A></B></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD><CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html#clone()" title="class or interface in java.lang">clone</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html#finalize()" title="class or interface in java.lang">finalize</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html#getClass()" title="class or interface in java.lang">getClass</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html#notify()" title="class or interface in java.lang">notify</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html#notifyAll()" title="class or interface in java.lang">notifyAll</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html#wait()" title="class or interface in java.lang">wait</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html#wait(long)" title="class or interface in java.lang">wait</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html#wait(long, int)" title="class or interface in java.lang">wait</A></CODE></TD>
</TR>
</TABLE>
&nbsp;
<P>

<!-- ============ FIELD DETAIL =========== -->


<!-- ========= CONSTRUCTOR DETAIL ======== -->

<A NAME="constructor_detail"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TD COLSPAN=1><FONT SIZE="+2">
<B>Constructor Detail</B></FONT></TD>
</TR>
</TABLE>

<A NAME="PointArray2D()"><!-- --></A><H3>
PointArray2D</H3>
<PRE>
protected <B>PointArray2D</B>()</PRE>
<DL>
<DD>Constructs a new array.
<P>
</DL>

<!-- ============ METHOD DETAIL ========== -->

<A NAME="method_detail"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TD COLSPAN=1><FONT SIZE="+2">
<B>Method Detail</B></FONT></TD>
</TR>
</TABLE>

<A NAME="getDimension()"><!-- --></A><H3>
getDimension</H3>
<PRE>
public final int <B>getDimension</B>()</PRE>
<DL>
<DD>Returns the dimensionality of the coordinates in this array, which is always 2.
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE>getDimension</CODE> in interface <CODE>PointArray</CODE></DL>
</DD>
<DD><DL>
</DL>
</DD>
</DL>
<HR>

<A NAME="getCoordinateReferenceSystem()"><!-- --></A><H3>
getCoordinateReferenceSystem</H3>
<PRE>
public CoordinateReferenceSystem <B>getCoordinateReferenceSystem</B>()</PRE>
<DL>
<DD>Returns the coordinate reference system of this array. The default implementation returns
 , which means that this point array is usually included in a larger geometry
 object and its CRS is implicitly assumed to take on the value of the containing object's
 coordinate reference system. Subclasses may override this method if they want to specify
 a non-null CRS.
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE>getCoordinateReferenceSystem</CODE> in interface <CODE>PointArray</CODE></DL>
</DD>
<DD><DL>
</DL>
</DD>
</DL>
<HR>

<A NAME="length()"><!-- --></A><H3>
length</H3>
<PRE>
public abstract int <B>length</B>()</PRE>
<DL>
<DD>Returns the number of points in this array.
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE>length</CODE> in interface <CODE>PointArray</CODE></DL>
</DD>
<DD><DL>
</DL>
</DD>
</DL>
<HR>

<A NAME="getMemoryUsage()"><!-- --></A><H3>
getMemoryUsage</H3>
<PRE>
public abstract long <B>getMemoryUsage</B>()</PRE>
<DL>
<DD>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 
 return values. Furthermore, this method does not take in account the extra bytes
 generated by Java Virtual Machine for each objects.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>

<DT><B>Returns:</B><DD>An <em>estimation</em> of memory usage in bytes.</DL>
</DD>
</DL>
<HR>

<A NAME="get(int, org.opengis.spatialschema.geometry.DirectPosition)"><!-- --></A><H3>
get</H3>
<PRE>
public DirectPosition <B>get</B>(int&nbsp;index,
                          DirectPosition&nbsp;dest)
                                                      throws <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/IndexOutOfBoundsException.html" title="class or interface in java.lang">IndexOutOfBoundsException</A></PRE>
<DL>
<DD>Gets a copy of the coordinates at the particular location in this .
 If the  argument is non-null, that object will be populated with the value
 from the array.
 <p>
 <strong>Warning:</strong> the default implementation is slow. Avoid this method (use
 the <A HREF="../../../../org/geotools/geometry/array/PointArray2D.html#iterator(int)">iterator</A> instead), unless the  subclass
 implements the <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/util/RandomAccess.html" title="class or interface in java.util"><CODE>RandomAccess</CODE></A> interface.
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE>get</CODE> in interface <CODE>PointArray</CODE></DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>index</CODE> - The location in the array, from 0 inclusive to the array
               <A HREF="../../../../org/geotools/geometry/array/PointArray2D.html#length()">length</A> exclusive.<DD><CODE>dest</CODE> - An optionnaly pre-allocated direct position. If non-null, its
         associated CRS must be null
         or compatible with <A HREF="../../../../org/geotools/geometry/array/PointArray2D.html#getCoordinateReferenceSystem()">this array CRS</A>. For
         performance reason, it will not be verified unless assertions are enabled.
<DT><B>Returns:</B><DD>The  argument, or a new object if  was null.
<DT><B>Throws:</B>
<DD><CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/IndexOutOfBoundsException.html" title="class or interface in java.lang">IndexOutOfBoundsException</A></CODE> - if the index is out of bounds.</DL>
</DD>
</DL>
<HR>

<A NAME="set(int, org.opengis.spatialschema.geometry.DirectPosition)"><!-- --></A><H3>
set</H3>
<PRE>
public void <B>set</B>(int&nbsp;index,
                DirectPosition&nbsp;position)
         throws <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/IndexOutOfBoundsException.html" title="class or interface in java.lang">IndexOutOfBoundsException</A>,
                <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/UnsupportedOperationException.html" title="class or interface in java.lang">UnsupportedOperationException</A></PRE>
<DL>
<DD>Sets the point at the given index. The default implementation always throw an
 <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/UnsupportedOperationException.html" title="class or interface in java.lang"><CODE>UnsupportedOperationException</CODE></A>.
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE>set</CODE> in interface <CODE>PointArray</CODE></DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>index</CODE> - The location in the array, from 0 inclusive to the array
         <A HREF="../../../../org/geotools/geometry/array/PointArray2D.html#length()">length</A> exclusive.<DD><CODE>position</CODE> - The point to set at the given location in this array.
<DT><B>Throws:</B>
<DD><CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/IndexOutOfBoundsException.html" title="class or interface in java.lang">IndexOutOfBoundsException</A></CODE> - if the index is out of bounds.
<DD><CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/UnsupportedOperationException.html" title="class or interface in java.lang">UnsupportedOperationException</A></CODE> - if this array is immutable, or if this operation
         is not supported for some other reason (e.g. the data are compressed).</DL>
</DD>
</DL>
<HR>

<A NAME="positions()"><!-- --></A><H3>
positions</H3>
<PRE>
public <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/util/List.html" title="class or interface in java.util">List</A> <B>positions</B>()</PRE>
<DL>
<DD>Returns a view of the points in this array as a list of positions.
 The list is backed by this , so changes to the point array are
 reflected in the list, and vice-versa.
 <p>
 Note that random access may be costly in some implementations. If the returned list
 doesn't implement the <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/util/RandomAccess.html" title="class or interface in java.util"><CODE>RandomAccess</CODE></A> interface, then consider avoiding the
 <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/util/List.html#get(int)" title="class or interface in java.util"><CODE>List.get(int)</CODE></A> method. Favor the <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/util/List.html#iterator()" title="class or interface in java.util">list iterator</A> instead.
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE>positions</CODE> in interface <CODE>PointArray</CODE></DL>
</DD>
<DD><DL>

<DT><B>Returns:</B><DD>The list of positions in this array.</DL>
</DD>
</DL>
<HR>

<A NAME="iterator(int)"><!-- --></A><H3>
iterator</H3>
<PRE>
public abstract <A HREF="../../../../org/geotools/geometry/array/PointIterator.html" title="class in org.geotools.geometry.array">PointIterator</A> <B>iterator</B>(int&nbsp;index)
                                throws <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/IndexOutOfBoundsException.html" title="class or interface in java.lang">IndexOutOfBoundsException</A></PRE>
<DL>
<DD>Returns an iterator over the point coordinates.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>index</CODE> - Index of the first point to returns in the iteration, from 0 inclusive
         to the array <A HREF="../../../../org/geotools/geometry/array/PointArray2D.html#length()">length</A> exclusive.
<DT><B>Returns:</B><DD>The iterator.
<DT><B>Throws:</B>
<DD><CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/IndexOutOfBoundsException.html" title="class or interface in java.lang">IndexOutOfBoundsException</A></CODE> - if the index is out of bounds.</DL>
</DD>
</DL>
<HR>

<A NAME="getBounds2D()"><!-- --></A><H3>
getBounds2D</H3>
<PRE>
public <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/awt/geom/Rectangle2D.html" title="class or interface in java.awt.geom">Rectangle2D</A> <B>getBounds2D</B>()</PRE>
<DL>
<DD>Returns the bounding box of all <var>x</var> and <var>y</var> ordinates. If this array
 is empty, then this method returns . The default implementation iterates
 through all coordinates provided by <A HREF="../../../../org/geotools/geometry/array/PointIterator.html" title="class in org.geotools.geometry.array"><CODE>PointIterator</CODE></A>. Subclasses should override
 this method with a more efficient implementation.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
</DL>
</DD>
</DL>
<HR>

<A NAME="subarray(int, int)"><!-- --></A><H3>
subarray</H3>
<PRE>
public abstract <A HREF="../../../../org/geotools/geometry/array/PointArray2D.html" title="class in org.geotools.geometry.array">PointArray2D</A> <B>subarray</B>(int&nbsp;lower,