gridgeometry2d.html

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

</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;CoordinateReferenceSystem</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../org/geotools/coverage/grid/GridGeometry2D.html#getCoordinateReferenceSystem2D()">getCoordinateReferenceSystem2D</A></B>()</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns the two-dimensional part of this grid geometry CRS. </TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;<A HREF="../../../../org/geotools/geometry/Envelope2D.html" title="class in org.geotools.geometry">Envelope2D</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../org/geotools/coverage/grid/GridGeometry2D.html#getEnvelope2D()">getEnvelope2D</A></B>()</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns the two-dimensional bounding box for the coverage domain in coordinate reference
 system coordinates. </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/Rectangle.html" title="class or interface in java.awt">Rectangle</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../org/geotools/coverage/grid/GridGeometry2D.html#getGridRange2D()">getGridRange2D</A></B>()</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns the two-dimensional part of the <A HREF="../../../../org/geotools/coverage/grid/GeneralGridGeometry.html#getGridRange()">grid range</A>
 as a rectangle.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;MathTransform2D</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../org/geotools/coverage/grid/GridGeometry2D.html#getGridToCoordinateSystem2D()">getGridToCoordinateSystem2D</A></B>()</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<B>Deprecated.</B>&nbsp;<I>Renamed as <A HREF="../../../../org/geotools/coverage/grid/GridGeometry2D.html#getGridToCRS2D()"><CODE>getGridToCRS2D()</CODE></A>.</I></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;MathTransform</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../org/geotools/coverage/grid/GridGeometry2D.html#getGridToCRS(org.opengis.metadata.spatial.PixelOrientation)">getGridToCRS</A></B>(PixelOrientation&nbsp;orientation)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns a math transform mapping the specified pixel part.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;MathTransform2D</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../org/geotools/coverage/grid/GridGeometry2D.html#getGridToCRS2D()">getGridToCRS2D</A></B>()</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns a math transform for the two dimensional part. </TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;MathTransform2D</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../org/geotools/coverage/grid/GridGeometry2D.html#getGridToCRS2D(org.opengis.metadata.spatial.PixelOrientation)">getGridToCRS2D</A></B>(PixelOrientation&nbsp;orientation)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns a math transform for the two dimensional part. </TD>
</TR>
</TABLE>
&nbsp;<A NAME="methods_inherited_from_class_GeneralGridGeometry"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
<TD><B>Methods inherited from class <A HREF="../../../../org/geotools/coverage/grid/GeneralGridGeometry.html" title="class in org.geotools.coverage.grid">GeneralGridGeometry</A></B></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD><CODE><A HREF="../../../../org/geotools/coverage/grid/GeneralGridGeometry.html#getCoordinateReferenceSystem()">getCoordinateReferenceSystem</A>, <A HREF="../../../../org/geotools/coverage/grid/GeneralGridGeometry.html#getDimension()">getDimension</A>, <A HREF="../../../../org/geotools/coverage/grid/GeneralGridGeometry.html#getEnvelope()">getEnvelope</A>, <A HREF="../../../../org/geotools/coverage/grid/GeneralGridGeometry.html#getEnvelope(org.opengis.coverage.grid.GridRange, org.opengis.referencing.operation.MathTransform, org.opengis.referencing.crs.CoordinateReferenceSystem, boolean)">getEnvelope</A>, <A HREF="../../../../org/geotools/coverage/grid/GeneralGridGeometry.html#getGridRange()">getGridRange</A>, <A HREF="../../../../org/geotools/coverage/grid/GeneralGridGeometry.html#getGridToCoordinateSystem()">getGridToCoordinateSystem</A>, <A HREF="../../../../org/geotools/coverage/grid/GeneralGridGeometry.html#getGridToCRS()">getGridToCRS</A>, <A HREF="../../../../org/geotools/coverage/grid/GeneralGridGeometry.html#getGridToCRS(org.opengis.referencing.datum.PixelInCell)">getGridToCRS</A>, <A HREF="../../../../org/geotools/coverage/grid/GeneralGridGeometry.html#getTransform(org.opengis.coverage.grid.GridRange, org.opengis.spatialschema.geometry.Envelope, boolean)">getTransform</A>, <A HREF="../../../../org/geotools/coverage/grid/GeneralGridGeometry.html#getTransform(org.opengis.coverage.grid.GridRange, org.opengis.spatialschema.geometry.Envelope, boolean[], boolean, boolean)">getTransform</A>, <A HREF="../../../../org/geotools/coverage/grid/GeneralGridGeometry.html#hashCode()">hashCode</A>, <A HREF="../../../../org/geotools/coverage/grid/GeneralGridGeometry.html#isDefined(int)">isDefined</A>, <A HREF="../../../../org/geotools/coverage/grid/GeneralGridGeometry.html#reverse(org.opengis.referencing.cs.CoordinateSystem)">reverse</A>, <A HREF="../../../../org/geotools/coverage/grid/GeneralGridGeometry.html#swapXY(org.opengis.referencing.cs.CoordinateSystem)">swapXY</A>, <A HREF="../../../../org/geotools/coverage/grid/GeneralGridGeometry.html#toString()">toString</A></CODE></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 =========== -->

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

<A NAME="gridDimensionX"><!-- --></A><H3>
gridDimensionX</H3>
<PRE>
public final int <B>gridDimensionX</B></PRE>
<DL>
<DD>The first () and second () dimensions of
 <A HREF="../../../../org/geotools/coverage/grid/GeneralGridGeometry.html#getGridRange()">grid range</A> with length
 greater than 1. Those (<var>x</var>, <var>y</var>) dimensions are usually 0 and 1
 respectively.
<P>
<DL>
</DL>
</DL>
<HR>

<A NAME="gridDimensionY"><!-- --></A><H3>
gridDimensionY</H3>
<PRE>
public final int <B>gridDimensionY</B></PRE>
<DL>
<DD>The first () and second () dimensions of
 <A HREF="../../../../org/geotools/coverage/grid/GeneralGridGeometry.html#getGridRange()">grid range</A> with length
 greater than 1. Those (<var>x</var>, <var>y</var>) dimensions are usually 0 and 1
 respectively.
<P>
<DL>
</DL>
</DL>
<HR>

<A NAME="axisDimensionX"><!-- --></A><H3>
axisDimensionX</H3>
<PRE>
public final int <B>axisDimensionX</B></PRE>
<DL>
<DD>The (<A HREF="../../../../org/geotools/coverage/grid/GridGeometry2D.html#gridDimensionX"><CODE>gridDimensionX</CODE></A>, <A HREF="../../../../org/geotools/coverage/grid/GridGeometry2D.html#gridDimensionY"><CODE>gridDimensionY</CODE></A>) dimensions in the envelope space.
 They are the (<var>x</var>, <var>y</var>) dimensions after the
 <A HREF="../../../../org/geotools/coverage/grid/GeneralGridGeometry.html#getGridToCoordinateSystem()">grid to CRS</A> transform.
 Those dimensions are usually 0 and 1 respectively.
<P>
<DL>
</DL>
</DL>
<HR>

<A NAME="axisDimensionY"><!-- --></A><H3>
axisDimensionY</H3>
<PRE>
public final int <B>axisDimensionY</B></PRE>
<DL>
<DD>The (<A HREF="../../../../org/geotools/coverage/grid/GridGeometry2D.html#gridDimensionX"><CODE>gridDimensionX</CODE></A>, <A HREF="../../../../org/geotools/coverage/grid/GridGeometry2D.html#gridDimensionY"><CODE>gridDimensionY</CODE></A>) dimensions in the envelope space.
 They are the (<var>x</var>, <var>y</var>) dimensions after the
 <A HREF="../../../../org/geotools/coverage/grid/GeneralGridGeometry.html#getGridToCoordinateSystem()">grid to CRS</A> transform.
 Those dimensions are usually 0 and 1 respectively.
<P>
<DL>
</DL>
</DL>

<!-- ========= 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="GridGeometry2D(org.opengis.coverage.grid.GridRange, org.opengis.referencing.operation.MathTransform, org.opengis.referencing.crs.CoordinateReferenceSystem)"><!-- --></A><H3>
GridGeometry2D</H3>
<PRE>
public <B>GridGeometry2D</B>(GridRange&nbsp;gridRange,
                      MathTransform&nbsp;gridToCRS,
                      CoordinateReferenceSystem&nbsp;crs)
               throws <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/IllegalArgumentException.html" title="class or interface in java.lang">IllegalArgumentException</A>,
                      MismatchedDimensionException</PRE>
<DL>
<DD>Constructs a new grid geometry from a math transform. The arguments are passed unchanged
 to 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)">super-class constructor</A>. However, they must obey to one
 additional constraint: only two dimensions in the grid range can have a
 length larger than 1.
<P>
<DT><B>Parameters:</B><DD><CODE>gridRange</CODE> - The valid coordinate range of a grid coverage, or  if none.
         The lowest valid grid coordinate is zero for <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/awt/image/BufferedImage.html" title="class or interface in java.awt.image"><CODE>BufferedImage</CODE></A>, but may
         be non-zero for arbitrary <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/awt/image/RenderedImage.html" title="class or interface in java.awt.image"><CODE>RenderedImage</CODE></A>. A grid with 512 cells can have a
         minimum coordinate of 0 and maximum of 512, with 511 as the highest valid index.<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.<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 and 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  has more than 2 dimensions with
         a length larger than 1, or 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>
<DT><B>See Also:</B><DD><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/awt/image/RenderedImage.html#getMinX()" title="class or interface in java.awt.image"><CODE>RenderedImage.getMinX()</CODE></A>, 
<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/awt/image/RenderedImage.html#getMinY()" title="class or interface in java.awt.image"><CODE>RenderedImage.getMinY()</CODE></A>, 
<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/awt/image/RenderedImage.html#getWidth()" title="class or interface in java.awt.image"><CODE>RenderedImage.getWidth()</CODE></A>, 
<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/awt/image/RenderedImage.html#getHeight()" title="class or interface in java.awt.image"><CODE>RenderedImage.getHeight()</CODE></A></DL>
<HR>

<A NAME="GridGeometry2D(org.opengis.coverage.grid.GridRange, org.opengis.spatialschema.geometry.Envelope)"><!-- --></A><H3>
GridGeometry2D</H3>
<PRE>
public <B>GridGeometry2D</B>(GridRange&nbsp;gridRange,
                      Envelope&nbsp;userRange)
               throws <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/IllegalArgumentException.html" title="class or interface in java.lang">IllegalArgumentException</A>,
                      MismatchedDimensionException</PRE>
<DL>
<DD>Constructs a new grid geometry from an envelope. This constructors applies the same heuristic
 rules than the <A HREF="../../../../org/geotools/coverage/grid/GeneralGridGeometry.html#GeneralGridGeometry(org.opengis.coverage.grid.GridRange, org.opengis.spatialschema.geometry.Envelope)">super-class constructor</A>. However, they must obey to one additional constraint: only two
 dimensions in the grid range can have a length larger than
 1.
<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.
<DT><B>Throws:</B>
<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  has more than 2 dimensions with
         a length larger than 1.
<DD><CODE>MismatchedDimensionException</CODE> - if the grid range and the CRS doesn't have
         consistent dimensions.<DT><B>Since:</B></DT>
  <DD>2.2</DD>
</DL>
<HR>

<A NAME="GridGeometry2D(org.opengis.coverage.grid.GridRange, org.opengis.spatialschema.geometry.Envelope, boolean[], boolean)"><!-- --></A><H3>
GridGeometry2D</H3>
<PRE>
public <B>GridGeometry2D</B>(GridRange&nbsp;gridRange,
                      Envelope&nbsp;userRange,
                      boolean[]&nbsp;reverse,
                      boolean&nbsp;swapXY)
               throws <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/IllegalArgumentException.html" title="class or interface in java.lang">IllegalArgumentException</A>,
                      MismatchedDimensionException</PRE>
<DL>
<DD>Constructs a new grid geometry from an envelope. The argument are passed unchanged to the
 <A HREF="../../../../org/geotools/coverage/grid/GeneralGridGeometry.html#GeneralGridGeometry(org.opengis.coverage.grid.GridRange, org.opengis.spatialschema.geometry.Envelope, boolean[], boolean)">super-class constructor</A>. However, they must obey to one additional constraint:
 only two dimensions in the grid range can have a length
 larger than 1.
<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.<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.<DD><CODE>swapXY</CODE> - If , then the two first axis will be interchanged.
<DT><B>Throws:</B>
<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  has more than 2 dimensions with
         a length larger than 1.
<DD><CODE>MismatchedDimensionException</CODE> - if the grid range and the CRS doesn't have
         consistent dimensions.<DT><B>Since:</B></DT>
  <DD>2.2</DD>
</DL>
<HR>

<A NAME="GridGeometry2D(java.awt.Rectangle, java.awt.geom.Rectangle2D)"><!-- --></A><H3>
GridGeometry2D</H3>
<PRE>
public <B>GridGeometry2D</B>(<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/awt/Rectangle.html" title="class or interface in java.awt">Rectangle</A>&nbsp;gridRange,
                      <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>&nbsp;userRange)</PRE>
<DL>
<DD>Constructs a new two-dimensional grid geometry. A math transform will be computed
 automatically with an inverted <var>y</var> axis (i.e.  and
  are assumed to have <var>y</var> axis in opposite direction).