generalenvelope.html

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

<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="getCoordinateReferenceSystem(org.opengis.spatialschema.geometry.Envelope)"><!-- --></A><H3>
getCoordinateReferenceSystem</H3>
<PRE>
public static CoordinateReferenceSystem <B>getCoordinateReferenceSystem</B>(Envelope&nbsp;envelope)</PRE>
<DL>
<DD>Returns the coordinate reference system from an arbitrary envelope, or 
 if unknown. This method performs some sanity checking for ensuring that the envelope
 CRS is consistent.
 <p>
 <strong>NOTE:</strong> This method may be removed in a future version if GeoAPI 2.1
 provides a  method.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Since:</B></DT>
  <DD>2.3</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="getCoordinateReferenceSystem()"><!-- --></A><H3>
getCoordinateReferenceSystem</H3>
<PRE>
public final CoordinateReferenceSystem <B>getCoordinateReferenceSystem</B>()</PRE>
<DL>
<DD>Returns the coordinate reference system in which the coordinates are given.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>

<DT><B>Returns:</B><DD>The coordinate reference system, or .</DL>
</DD>
</DL>
<HR>

<A NAME="setCoordinateReferenceSystem(org.opengis.referencing.crs.CoordinateReferenceSystem)"><!-- --></A><H3>
setCoordinateReferenceSystem</H3>
<PRE>
public void <B>setCoordinateReferenceSystem</B>(CoordinateReferenceSystem&nbsp;crs)
                                  throws MismatchedDimensionException</PRE>
<DL>
<DD>Set the coordinate reference system in which the coordinate are given.
 Note: this method <strong>do not</strong> reproject the envelope.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>crs</CODE> - The new coordinate reference system, or .
<DT><B>Throws:</B>
<DD><CODE>MismatchedDimensionException</CODE> - if the specified CRS doesn't have the expected
         number of dimensions.</DL>
</DD>
</DL>
<HR>

<A NAME="getDimension()"><!-- --></A><H3>
getDimension</H3>
<PRE>
public final int <B>getDimension</B>()</PRE>
<DL>
<DD>Returns the number of dimensions.
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE>getDimension</CODE> in interface <CODE>Envelope</CODE></DL>
</DD>
<DD><DL>
</DL>
</DD>
</DL>
<HR>

<A NAME="getLowerCorner()"><!-- --></A><H3>
getLowerCorner</H3>
<PRE>
public DirectPosition <B>getLowerCorner</B>()</PRE>
<DL>
<DD>A coordinate position consisting of all the <A HREF="../../../org/geotools/geometry/GeneralEnvelope.html#getMinimum(int)">minimal ordinates</A>
 for each dimension for all points within the .
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE>getLowerCorner</CODE> in interface <CODE>Envelope</CODE></DL>
</DD>
<DD><DL>

<DT><B>Returns:</B><DD>The lower corner.</DL>
</DD>
</DL>
<HR>

<A NAME="getUpperCorner()"><!-- --></A><H3>
getUpperCorner</H3>
<PRE>
public DirectPosition <B>getUpperCorner</B>()</PRE>
<DL>
<DD>A coordinate position consisting of all the <A HREF="../../../org/geotools/geometry/GeneralEnvelope.html#getMaximum(int)">maximal ordinates</A>
 for each dimension for all points within the .
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE>getUpperCorner</CODE> in interface <CODE>Envelope</CODE></DL>
</DD>
<DD><DL>

<DT><B>Returns:</B><DD>The upper corner.</DL>
</DD>
</DL>
<HR>

<A NAME="getCenter()"><!-- --></A><H3>
getCenter</H3>
<PRE>
public DirectPosition <B>getCenter</B>()</PRE>
<DL>
<DD>A coordinate position consisting of all the <A HREF="../../../org/geotools/geometry/GeneralEnvelope.html#getCenter(int)">middle ordinates</A>
 for each dimension for all points within the .
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Since:</B></DT>
  <DD>2.3</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="getMinimum(int)"><!-- --></A><H3>
getMinimum</H3>
<PRE>
public final double <B>getMinimum</B>(int&nbsp;dimension)</PRE>
<DL>
<DD>Returns the minimal ordinate along the specified dimension.
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE>getMinimum</CODE> in interface <CODE>Envelope</CODE></DL>
</DD>
<DD><DL>
</DL>
</DD>
</DL>
<HR>

<A NAME="getMaximum(int)"><!-- --></A><H3>
getMaximum</H3>
<PRE>
public final double <B>getMaximum</B>(int&nbsp;dimension)</PRE>
<DL>
<DD>Returns the maximal ordinate along the specified dimension.
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE>getMaximum</CODE> in interface <CODE>Envelope</CODE></DL>
</DD>
<DD><DL>
</DL>
</DD>
</DL>
<HR>

<A NAME="getCenter(int)"><!-- --></A><H3>
getCenter</H3>
<PRE>
public final double <B>getCenter</B>(int&nbsp;dimension)</PRE>
<DL>
<DD>Returns the center ordinate along the specified dimension.
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE>getCenter</CODE> in interface <CODE>Envelope</CODE></DL>
</DD>
<DD><DL>
</DL>
</DD>
</DL>
<HR>

<A NAME="getLength(int)"><!-- --></A><H3>
getLength</H3>
<PRE>
public final double <B>getLength</B>(int&nbsp;dimension)</PRE>
<DL>
<DD>Returns the envelope length along the specified dimension.
 This length is equals to the maximum ordinate minus the
 minimal ordinate.
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE>getLength</CODE> in interface <CODE>Envelope</CODE></DL>
</DD>
<DD><DL>
</DL>
</DD>
</DL>
<HR>

<A NAME="getLength(int, javax.units.Unit)"><!-- --></A><H3>
getLength</H3>
<PRE>
public double <B>getLength</B>(int&nbsp;dimension,
                        <A HREF="http://jsr-108.sourceforge.net/javadoc/javax/units/Unit.html" title="class or interface in javax.units">Unit</A>&nbsp;unit)
                 throws <A HREF="http://jsr-108.sourceforge.net/javadoc/javax/units/ConversionException.html" title="class or interface in javax.units">ConversionException</A></PRE>
<DL>
<DD>Returns the envelope length along the specified dimension, in terms of the given units.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>unit</CODE> - The unit for the return value.
<DT><B>Returns:</B><DD>The length in terms of the given unit.
<DT><B>Throws:</B>
<DD><CODE><A HREF="http://jsr-108.sourceforge.net/javadoc/javax/units/ConversionException.html" title="class or interface in javax.units">ConversionException</A></CODE> - if the length can't be converted to the specified units.<DT><B>Since:</B></DT>
  <DD>2.2</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="setRange(int, double, double)"><!-- --></A><H3>
setRange</H3>
<PRE>
public void <B>setRange</B>(int&nbsp;dimension,
                     double&nbsp;minimum,
                     double&nbsp;maximum)</PRE>
<DL>
<DD>Set the envelope's range along the specified dimension.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>dimension</CODE> - The dimension to set.<DD><CODE>minimum</CODE> - The minimum value along the specified dimension.<DD><CODE>maximum</CODE> - The maximum value along the specified dimension.</DL>
</DD>
</DL>
<HR>

<A NAME="setEnvelope(org.geotools.geometry.GeneralEnvelope)"><!-- --></A><H3>
setEnvelope</H3>
<PRE>
public void <B>setEnvelope</B>(<A HREF="../../../org/geotools/geometry/GeneralEnvelope.html" title="class in org.geotools.geometry">GeneralEnvelope</A>&nbsp;envelope)
                 throws MismatchedDimensionException</PRE>
<DL>
<DD>Set this envelope to the same coordinate values than the specified envelope.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>envelope</CODE> - The new envelope to copy coordinates from.
<DT><B>Throws:</B>
<DD><CODE>MismatchedDimensionException</CODE> - if the specified envelope doesn't have the expected
         number of dimensions.<DT><B>Since:</B></DT>
  <DD>2.2</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="setToInfinite()"><!-- --></A><H3>
setToInfinite</H3>
<PRE>
public void <B>setToInfinite</B>()</PRE>
<DL>
<DD>Sets the lower corner to <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Double.html#NEGATIVE_INFINITY" title="class or interface in java.lang">negative infinity</A>
 and the upper corner to <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Double.html#POSITIVE_INFINITY" title="class or interface in java.lang">positive infinity</A>.
 The <A HREF="../../../org/geotools/geometry/GeneralEnvelope.html#getCoordinateReferenceSystem(org.opengis.spatialschema.geometry.Envelope)">coordinate reference system</A> (if any)
 stay unchanged.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Since:</B></DT>
  <DD>2.2</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="isInfinite()"><!-- --></A><H3>
isInfinite</H3>
<PRE>
public boolean <B>isInfinite</B>()</PRE>
<DL>
<DD>Returns  if at least one ordinate has an
 <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Double.html#isInfinite()" title="class or interface in java.lang">infinite</A> value.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Since:</B></DT>
  <DD>2.2</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="setToNull()"><!-- --></A><H3>
setToNull</H3>
<PRE>
public void <B>setToNull</B>()</PRE>
<DL>
<DD>Sets all ordinate values to <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Double.html#NaN" title="class or interface in java.lang">NaN</A>. The
 <A HREF="../../../org/geotools/geometry/GeneralEnvelope.html#getCoordinateReferenceSystem(org.opengis.spatialschema.geometry.Envelope)">coordinate reference system</A> (if any) stay
 unchanged.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Since:</B></DT>
  <DD>2.2</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="isNull()"><!-- --></A><H3>
isNull</H3>
<PRE>
public boolean <B>isNull</B>()</PRE>
<DL>
<DD>Returns  if at least one ordinate value is not <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Double.html#NaN" title="class or interface in java.lang">NaN</A>. The
  check is a little bit different than <A HREF="../../../org/geotools/geometry/GeneralEnvelope.html#isEmpty()"><CODE>isEmpty()</CODE></A> since it returns
  for a partially initialized envelope, while  returns
  only after all dimensions have been initialized. More specifically, the