abstractgridcoverage2dreader.html

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

<DD>This contains the maximum number of grid coverages in the file/stream.
 Until multi-image files are supported, this is going to be 0 or 1.
<P>
<DL>
</DL>
</DL>
<HR>

<A NAME="raster2Model"><!-- --></A><H3>
raster2Model</H3>
<PRE>
protected MathTransform <B>raster2Model</B></PRE>
<DL>
<DD>2DGridToWorld math transform.
<P>
<DL>
</DL>
</DL>
<HR>

<A NAME="crs"><!-- --></A><H3>
crs</H3>
<PRE>
protected CoordinateReferenceSystem <B>crs</B></PRE>
<DL>
<DD>crs for this coverage
<P>
<DL>
</DL>
</DL>
<HR>

<A NAME="originalEnvelope"><!-- --></A><H3>
originalEnvelope</H3>
<PRE>
protected <A HREF="../../../../../org/geotools/geometry/GeneralEnvelope.html" title="class in org.geotools.geometry">GeneralEnvelope</A> <B>originalEnvelope</B></PRE>
<DL>
<DD>Envelope read from file
<P>
<DL>
</DL>
</DL>
<HR>

<A NAME="coverageName"><!-- --></A><H3>
coverageName</H3>
<PRE>
protected <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> <B>coverageName</B></PRE>
<DL>
<DD>Coverage name
<P>
<DL>
</DL>
</DL>
<HR>

<A NAME="source"><!-- --></A><H3>
source</H3>
<PRE>
protected <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>source</B></PRE>
<DL>
<DD>Source to read from
<P>
<DL>
</DL>
</DL>
<HR>

<A NAME="hints"><!-- --></A><H3>
hints</H3>
<PRE>
protected <A HREF="../../../../../org/geotools/factory/Hints.html" title="class in org.geotools.factory">Hints</A> <B>hints</B></PRE>
<DL>
<DD>Hints used by the <A HREF="../../../../../org/geotools/data/coverage/grid/AbstractGridCoverage2DReader.html" title="class in org.geotools.data.coverage.grid"><CODE>AbstractGridCoverage2DReader</CODE></A> subclasses.
<P>
<DL>
</DL>
</DL>
<HR>

<A NAME="highestRes"><!-- --></A><H3>
highestRes</H3>
<PRE>
protected double[] <B>highestRes</B></PRE>
<DL>
<DD>Highest resolution availaible for this reader.
<P>
<DL>
</DL>
</DL>
<HR>

<A NAME="closeMe"><!-- --></A><H3>
closeMe</H3>
<PRE>
protected boolean <B>closeMe</B></PRE>
<DL>
<DD>Temp variable used in many readers.
<P>
<DL>
</DL>
</DL>
<HR>

<A NAME="gzipped"><!-- --></A><H3>
gzipped</H3>
<PRE>
protected boolean <B>gzipped</B></PRE>
<DL>
<DD>In case we are trying to read from a GZipped file this will be set to
 true.
<P>
<DL>
</DL>
</DL>
<HR>

<A NAME="originalGridRange"><!-- --></A><H3>
originalGridRange</H3>
<PRE>
protected <A HREF="../../../../../org/geotools/coverage/grid/GeneralGridRange.html" title="class in org.geotools.coverage.grid">GeneralGridRange</A> <B>originalGridRange</B></PRE>
<DL>
<DD>The original <CODE>GridRange</CODE> for the <A HREF="../../../../../org/geotools/coverage/grid/GridCoverage2D.html" title="class in org.geotools.coverage.grid"><CODE>GridCoverage2D</CODE></A> of this
 reader.
<P>
<DL>
</DL>
</DL>
<HR>

<A NAME="inStream"><!-- --></A><H3>
inStream</H3>
<PRE>
protected <A HREF="http://java.sun.com/j2se/1.4/docs/api/javax/imageio/stream/ImageInputStream.html" title="class or interface in javax.imageio.stream">ImageInputStream</A> <B>inStream</B></PRE>
<DL>
<DD>Input stream that can be used to initialize subclasses of
 <A HREF="../../../../../org/geotools/data/coverage/grid/AbstractGridCoverage2DReader.html" title="class in org.geotools.data.coverage.grid"><CODE>AbstractGridCoverage2DReader</CODE></A>.
<P>
<DL>
</DL>
</DL>
<HR>

<A NAME="overViewResolutions"><!-- --></A><H3>
overViewResolutions</H3>
<PRE>
protected double[][] <B>overViewResolutions</B></PRE>
<DL>
<DD>Resolutions avialaible through an overviews based mechanism.
<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="AbstractGridCoverage2DReader()"><!-- --></A><H3>
AbstractGridCoverage2DReader</H3>
<PRE>
public <B>AbstractGridCoverage2DReader</B>()</PRE>
<DL>
</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="setReadParams(javax.imageio.ImageReadParam, org.geotools.geometry.GeneralEnvelope, java.awt.Rectangle)"><!-- --></A><H3>
setReadParams</H3>
<PRE>
protected <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Integer.html" title="class or interface in java.lang">Integer</A> <B>setReadParams</B>(<A HREF="http://java.sun.com/j2se/1.4/docs/api/javax/imageio/ImageReadParam.html" title="class or interface in javax.imageio">ImageReadParam</A>&nbsp;readP,
                                <A HREF="../../../../../org/geotools/geometry/GeneralEnvelope.html" title="class in org.geotools.geometry">GeneralEnvelope</A>&nbsp;requestedEnvelope,
                                <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;requestedDim)
                         throws <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/IOException.html" title="class or interface in java.io">IOException</A>,
                                TransformException</PRE>
<DL>
<DD>This method is responsible for preparing the read param for doing an
 <A HREF="http://java.sun.com/j2se/1.4/docs/api/javax/imageio/ImageReader.html#read(int, javax.imageio.ImageReadParam)" title="class or interface in javax.imageio"><CODE>ImageReader.read(int, ImageReadParam)</CODE></A>.
 
 
 <p>
 This method is responsible for preparing the read param for doing an
 <A HREF="http://java.sun.com/j2se/1.4/docs/api/javax/imageio/ImageReader.html#read(int, javax.imageio.ImageReadParam)" title="class or interface in javax.imageio"><CODE>ImageReader.read(int, ImageReadParam)</CODE></A>. It sets the passed
 <A HREF="http://java.sun.com/j2se/1.4/docs/api/javax/imageio/ImageReadParam.html" title="class or interface in javax.imageio"><CODE>ImageReadParam</CODE></A> in terms of decimation on reading using the
 provided requestedEnvelope and requestedDim to evaluate the needed
 resolution. It also returns and <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Integer.html" title="class or interface in java.lang"><CODE>Integer</CODE></A> representing the index of
 the raster to be read when dealing with multipage raster.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>readP</CODE> - an instance of <A HREF="http://java.sun.com/j2se/1.4/docs/api/javax/imageio/ImageReadParam.html" title="class or interface in javax.imageio"><CODE>ImageReadParam</CODE></A> for setting the
            subsampling factors.<DD><CODE>requestedEnvelope</CODE> - the <A HREF="../../../../../org/geotools/geometry/GeneralEnvelope.html" title="class in org.geotools.geometry"><CODE>GeneralEnvelope</CODE></A> we are requesting.<DD><CODE>requestedDim</CODE> - the requested dimensions.
<DT><B>Returns:</B><DD>the index of the raster to read in the underlying data source.
<DT><B>Throws:</B>
<DD><CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/IOException.html" title="class or interface in java.io">IOException</A></CODE>
<DD><CODE>TransformException</CODE></DL>
</DD>
</DL>
<HR>

<A NAME="isScaleTranslate(org.opengis.referencing.operation.MathTransform)"><!-- --></A><H3>
isScaleTranslate</H3>
<PRE>
protected final boolean <B>isScaleTranslate</B>(MathTransform&nbsp;transform)</PRE>
<DL>
<DD>Checks the transformation is a pure scale/translate instance (using a tolerance)
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>transform</CODE> - 
<DT><B>Returns:</B><DD></DL>
</DD>
</DL>
<HR>

<A NAME="decimationOnReadingControl(java.lang.Integer, javax.imageio.ImageReadParam, double[])"><!-- --></A><H3>
decimationOnReadingControl</H3>
<PRE>
protected final void <B>decimationOnReadingControl</B>(<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Integer.html" title="class or interface in java.lang">Integer</A>&nbsp;imageChoice,
                                                <A HREF="http://java.sun.com/j2se/1.4/docs/api/javax/imageio/ImageReadParam.html" title="class or interface in javax.imageio">ImageReadParam</A>&nbsp;readP,
                                                double[]&nbsp;requestedRes)</PRE>
<DL>
<DD>This method is responsible for evaluating possible subsampling factors
 once the best resolution level has been found, in case we have support
 for overviews, or starting from the original coverage in case there are
 no overviews availaible.
 
 Anyhow this methof should not be called directly but subclasses should
 make use of the setReadParams method instead in order to transparently
 look for overviews.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>imageChoice</CODE> - <DD><CODE>readP</CODE> - <DD><CODE>requestedRes</CODE> - </DL>
</DD>
</DL>
<HR>

<A NAME="createImageCoverage(javax.media.jai.PlanarImage)"><!-- --></A><H3>
createImageCoverage</H3>
<PRE>
protected final GridCoverage <B>createImageCoverage</B>(<A HREF="http://java.sun.com/products/java-media/jai/forDevelopers/jai-apidocs/javax/media/jai/PlanarImage.html" title="class or interface in javax.media.jai">PlanarImage</A>&nbsp;image)
                                                                    throws <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/IOException.html" title="class or interface in java.io">IOException</A></PRE>
<DL>
<DD>Creates a <CODE>GridCoverage</CODE> for the provided <A HREF="http://java.sun.com/products/java-media/jai/forDevelopers/jai-apidocs/javax/media/jai/PlanarImage.html" title="class or interface in javax.media.jai"><CODE>PlanarImage</CODE></A> using
 the <A HREF="../../../../../org/geotools/data/coverage/grid/AbstractGridCoverage2DReader.html#originalEnvelope"><CODE>originalEnvelope</CODE></A> that was provided for this coverage.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>image</CODE> - contains the data for the coverage to create.
<DT><B>Returns:</B><DD>a <CODE>GridCoverage</CODE>
<DT><B>Throws:</B>
<DD><CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/IOException.html" title="class or interface in java.io">IOException</A></CODE></DL>
</DD>
</DL>
<HR>

<A NAME="createImageCoverage(javax.media.jai.PlanarImage, org.opengis.referencing.operation.MathTransform)"><!-- --></A><H3>
createImageCoverage</H3>
<PRE>
protected final GridCoverage <B>createImageCoverage</B>(<A HREF="http://java.sun.com/products/java-media/jai/forDevelopers/jai-apidocs/javax/media/jai/PlanarImage.html" title="class or interface in javax.media.jai">PlanarImage</A>&nbsp;image,
                                                 MathTransform&nbsp;raster2Model)
                                                                    throws <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/IOException.html" title="class or interface in java.io">IOException</A></PRE>
<DL>
<DD>Creates a <CODE>GridCoverage</CODE> for the provided <A HREF="http://java.sun.com/products/java-media/jai/forDevelopers/jai-apidocs/javax/media/jai/PlanarImage.html" title="class or interface in javax.media.jai"><CODE>PlanarImage</CODE></A> using
 the <A HREF="../../../../../org/geotools/data/coverage/grid/AbstractGridCoverage2DReader.html#raster2Model"><CODE>raster2Model</CODE></A> that was provided for this coverage.
 
 <p>
 This method is vital when working with coverages that have a raster to model transformation
 that is not a simple scale and translate.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>