generalgridgeometry.html

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

<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="GeneralGridGeometry(org.opengis.coverage.grid.GridRange, org.opengis.referencing.operation.MathTransform, org.opengis.referencing.crs.CoordinateReferenceSystem)"><!-- --></A><H3>
GeneralGridGeometry</H3>
<PRE>
public <B>GeneralGridGeometry</B>(GridRange&nbsp;gridRange,
                           MathTransform&nbsp;gridToCRS,
                           CoordinateReferenceSystem&nbsp;crs)
                    throws MismatchedDimensionException,
                           <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/IllegalArgumentException.html" title="class or interface in java.lang">IllegalArgumentException</A></PRE>
<DL>
<DD>Constructs a new grid geometry from a math transform
 mapping pixel center. This is the most general
 constructor, the one that gives the maximal control over the grid geometry to be created.
<P>
<DT><B>Parameters:</B><DD><CODE>gridRange</CODE> - The valid coordinate range of a grid coverage, or  if none.<DD><CODE>gridToCRS</CODE> - The math transform which allows for the transformations from grid
                  coordinates (pixel's <em>center</em>) to real world earth coordinates.
                  May be , but this is not recommanded.<DD><CODE>crs</CODE> - The coordinate reference system for the "real world" coordinates, or
                   if unknown. This CRS is given to the
                  <A HREF="../../../../org/geotools/coverage/grid/GeneralGridGeometry.html#getEnvelope()">envelope</A>.
<DT><B>Throws:</B>
<DD><CODE>MismatchedDimensionException</CODE> - if the math transform or the CRS doesn't have
         consistent dimensions.
<DD><CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/IllegalArgumentException.html" title="class or interface in java.lang">IllegalArgumentException</A></CODE> - if the math transform can't transform coordinates
         in the domain of the specified grid range.<DT><B>Since:</B></DT>
  <DD>2.2</DD>
</DL>
<HR>

<A NAME="GeneralGridGeometry(org.opengis.coverage.grid.GridRange, org.opengis.spatialschema.geometry.Envelope)"><!-- --></A><H3>
GeneralGridGeometry</H3>
<PRE>
public <B>GeneralGridGeometry</B>(GridRange&nbsp;gridRange,
                           Envelope&nbsp;userRange)
                    throws MismatchedDimensionException</PRE>
<DL>
<DD>Constructs a new grid geometry from an envelope. An <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/awt/geom/AffineTransform.html" title="class or interface in java.awt.geom">affine transform</A> will be computed automatically from the specified
 envelope using heuristic rules described in <A HREF="../../../../org/geotools/referencing/operation/builder/GridToEnvelopeMapper.html" title="class in org.geotools.referencing.operation.builder"><CODE>GridToEnvelopeMapper</CODE></A> javadoc.
 More specifically, heuristic rules are applied for:
 <p>
 <ul>
   <li><A HREF="../../../../org/geotools/referencing/operation/builder/GridToEnvelopeMapper.html#getSwapXY()">axis swapping</A></li>
   <li><A HREF="../../../../org/geotools/referencing/operation/builder/GridToEnvelopeMapper.html#getReverseAxis()">axis reversal</A></li>
 </ul>
<P>
<DT><B>Parameters:</B><DD><CODE>gridRange</CODE> - The valid coordinate range of a grid coverage.<DD><CODE>userRange</CODE> - The corresponding coordinate range in user coordinate. This rectangle must
                  contains entirely all pixels, i.e. the rectangle's upper left corner must
                  coincide with the upper left corner of the first pixel and the rectangle's
                  lower right corner must coincide with the lower right corner of the last
                  pixel.
<DT><B>Throws:</B>
<DD><CODE>MismatchedDimensionException</CODE> - if the grid range and the envelope doesn't have
         consistent dimensions.<DT><B>Since:</B></DT>
  <DD>2.2</DD>
</DL>
<HR>

<A NAME="GeneralGridGeometry(org.opengis.coverage.grid.GridRange, org.opengis.spatialschema.geometry.Envelope, boolean[], boolean)"><!-- --></A><H3>
GeneralGridGeometry</H3>
<PRE>
public <B>GeneralGridGeometry</B>(GridRange&nbsp;gridRange,
                           Envelope&nbsp;userRange,
                           boolean[]&nbsp;reverse,
                           boolean&nbsp;swapXY)
                    throws MismatchedDimensionException</PRE>
<DL>
<DD>Constructs a new grid geometry from an envelope. This convenience
 constructor delegates the work to <A HREF="../../../../org/geotools/referencing/operation/builder/GridToEnvelopeMapper.html" title="class in org.geotools.referencing.operation.builder"><CODE>GridToEnvelopeMapper</CODE></A>; see its javadoc for details.
 <p>
 If this convenience constructor do not provides suffisient control on axis order or reversal,
 then an affine transform shall be created explicitly and the grid geometry shall be created
 using the <A HREF="../../../../org/geotools/coverage/grid/GeneralGridGeometry.html#GeneralGridGeometry(org.opengis.coverage.grid.GridRange, org.opengis.referencing.operation.MathTransform, org.opengis.referencing.crs.CoordinateReferenceSystem)">constructor expecting a math transform</A> argument.
<P>
<DT><B>Parameters:</B><DD><CODE>gridRange</CODE> - The valid coordinate range of a grid coverage.<DD><CODE>userRange</CODE> - The corresponding coordinate range in user coordinate. This envelope must
                  contains entirely all pixels, i.e. the envelope's upper left corner must
                  coincide with the upper left corner of the first pixel and the envelope's
                  lower right corner must coincide with the lower right corner of the last
                  pixel.<DD><CODE>reverse</CODE> - Tells for each axis in <cite>user</cite> space whatever or not its direction
                  should be reversed. A  value reverse no axis. Callers will
                  typically set  to  in order to reverse the
                  <var>y</var> axis direction.<DD><CODE>swapXY</CODE> - If , then the two first axis will be interchanged. Callers will
                  typically set this argument to  when the geographic coordinate
                  system has axis in the (<var>y</var>,<var>x</var>) order. The 
                  parameter then apply to axis after the swap.
<DT><B>Throws:</B>
<DD><CODE>MismatchedDimensionException</CODE> - if the grid range and the envelope doesn't have
         consistent dimensions.<DT><B>Since:</B></DT>
  <DD>2.2</DD>
</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="getTransform(org.opengis.coverage.grid.GridRange, org.opengis.spatialschema.geometry.Envelope, boolean[], boolean, boolean)"><!-- --></A><H3>
getTransform</H3>
<PRE>
public static MathTransform <B>getTransform</B>(GridRange&nbsp;gridRange,
                                         Envelope&nbsp;userRange,
                                         boolean[]&nbsp;reverse,
                                         boolean&nbsp;swapXY,
                                         boolean&nbsp;halfPix)
                                                                    throws MismatchedDimensionException</PRE>
<DL>
<DD><B>Deprecated.</B>&nbsp;<I>Replaced by <A HREF="../../../../org/geotools/referencing/operation/builder/GridToEnvelopeMapper.html" title="class in org.geotools.referencing.operation.builder"><CODE>GridToEnvelopeMapper</CODE></A>.</I>
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>

<DT><B>Throws:</B>
<DD><CODE>MismatchedDimensionException</CODE><DT><B>Since:</B></DT>
  <DD>2.3</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="getTransform(org.opengis.coverage.grid.GridRange, org.opengis.spatialschema.geometry.Envelope, boolean)"><!-- --></A><H3>
getTransform</H3>
<PRE>
public static MathTransform <B>getTransform</B>(GridRange&nbsp;gridRange,
                                         Envelope&nbsp;userRange,
                                         boolean&nbsp;halfPix)
                                                                    throws MismatchedDimensionException</PRE>
<DL>
<DD><B>Deprecated.</B>&nbsp;<I>Replaced by <A HREF="../../../../org/geotools/referencing/operation/builder/GridToEnvelopeMapper.html" title="class in org.geotools.referencing.operation.builder"><CODE>GridToEnvelopeMapper</CODE></A>.</I>
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>

<DT><B>Throws:</B>
<DD><CODE>MismatchedDimensionException</CODE><DT><B>Since:</B></DT>
  <DD>2.3</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="reverse(org.opengis.referencing.cs.CoordinateSystem)"><!-- --></A><H3>
reverse</H3>
<PRE>
public static boolean[] <B>reverse</B>(CoordinateSystem&nbsp;cs)</PRE>
<DL>
<DD><B>Deprecated.</B>&nbsp;<I>Use <A HREF="../../../../org/geotools/referencing/cs/AbstractCS.html#swapAndScaleAxis(org.opengis.referencing.cs.CoordinateSystem, org.opengis.referencing.cs.CoordinateSystem)"><CODE>AbstractCS.swapAndScaleAxis(org.opengis.referencing.cs.CoordinateSystem, org.opengis.referencing.cs.CoordinateSystem)</CODE></A> instead.</I>
<P>
<DD>Applies heuristic rules in order to determine which axis should be reversed.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Since:</B></DT>
  <DD>2.3</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="swapXY(org.opengis.referencing.cs.CoordinateSystem)"><!-- --></A><H3>
swapXY</H3>
<PRE>
public static boolean <B>swapXY</B>(CoordinateSystem&nbsp;cs)</PRE>
<DL>
<DD><B>Deprecated.</B>&nbsp;<I>Use <A HREF="../../../../org/geotools/referencing/cs/AbstractCS.html#swapAndScaleAxis(org.opengis.referencing.cs.CoordinateSystem, org.opengis.referencing.cs.CoordinateSystem)"><CODE>AbstractCS.swapAndScaleAxis(org.opengis.referencing.cs.CoordinateSystem, org.opengis.referencing.cs.CoordinateSystem)</CODE></A> instead
             or <CODE>org.geotools.referencing.operation.matrix.XMatrixTransform#getSwapXY</CODE>
             instead.</I>
<P>
<DD>Applies heuristic rules in order to determine if the two first axis should be interchanged.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Since:</B></DT>
  <DD>2.3</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="getDimension()"><!-- --></A><H3>
getDimension</H3>
<PRE>
public int <B>getDimension</B>()</PRE>
<DL>
<DD>Returns the number of dimensions.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
</DL>
</DD>
</DL>
<HR>

<A NAME="getCoordinateReferenceSystem()"><!-- --></A><H3>
getCoordinateReferenceSystem</H3>
<PRE>
public CoordinateReferenceSystem <B>getCoordinateReferenceSystem</B>()
                                                                                   throws <A HREF="../../../../org/geotools/coverage/grid/InvalidGridGeometryException.html" title="class in org.geotools.coverage.grid">InvalidGridGeometryException</A></PRE>
<DL>
<DD>Returns the "real world" coordinate reference system.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>

<DT><B>Returns:</B><DD>The coordinate reference system (never ).
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../../org/geotools/coverage/grid/InvalidGridGeometryException.html" title="class in org.geotools.coverage.grid">InvalidGridGeometryException</A></CODE> - if this grid geometry has no CRS (i.e.
         <code><A HREF="../../../../org/geotools/coverage/grid/GeneralGridGeometry.html#isDefined(int)">isDefined</A>(<A HREF="../../../../org/geotools/coverage/grid/GeneralGridGeometry.html#CRS">CRS</A>)</code>
         returned ).<DT><B>Since:</B></DT>
  <DD>2.2</DD>
<DT><B>See Also:</B><DD><A HREF="../../../../org/geotools/coverage/grid/GridGeometry2D.html#getCoordinateReferenceSystem2D()"><CODE>GridGeometry2D.getCoordinateReferenceSystem2D()</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="getEnvelope()"><!-- --></A><H3>
getEnvelope</H3>
<PRE>
public Envelope <B>getEnvelope</B>()
                                                        throws <A HREF="../../../../org/geotools/coverage/grid/InvalidGridGeometryException.html" title="class in org.geotools.coverage.grid">InvalidGridGeometryException</A></PRE>
<DL>
<DD>Returns the bounding box of "real world" coordinates for this grid geometry. This envelope is
 the <A HREF="../../../../org/geotools/coverage/grid/GeneralGridGeometry.html#getGridRange()">grid range</A> <A HREF="../../../../org/geotools/coverage/grid/GeneralGridGeometry.html#getGridToCoordinateSystem()">transformed</A>
 to the "real world" coordinate system.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>

<DT><B>Returns:</B><DD>The bounding box in "real world" coordinates (never ).
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../../org/geotools/coverage/grid/InvalidGridGeometryException.html" title="class in org.geotools.coverage.grid">InvalidGridGeometryException</A></CODE> - if this grid geometry has no envelope (i.e.
         <code><A HREF="../../../../org/geotools/coverage/grid/GeneralGridGeometry.html#isDefined(int)">isDefined</A>(<A HREF="../../../../org/geotools/coverage/grid/GeneralGridGeometry.html#ENVELOPE">ENVELOPE</A>)</code>
         returned ).<DT><B>See Also:</B><DD><A HREF="../../../../org/geotools/coverage/grid/GridGeometry2D.html#getEnvelope2D()"><CODE>GridGeometry2D.getEnvelope2D()</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="getEnvelope(org.opengis.coverage.grid.GridRange, org.opengis.referencing.operation.MathTransform, org.opengis.referencing.crs.CoordinateReferenceSystem, boolean)"><!-- --></A><H3>
getEnvelope</H3>
<PRE>