abstractcoverage.html

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

<DD>Returns a set of records of feature attribute values for the specified direct position. The
 parameter  is a sequence of feature attribute names each of which identifies a
 field of the range type. If  is null, the operation shall return a value for
 every field of the range type. Otherwise, it shall return a value for each field included in
 . If the direct position passed is not in the domain of the coverage, then an
 exception is thrown. If the input direct position falls within two or more geometric objects
 within the domain, the operation shall return records of feature attribute values computed
 according to the <A HREF="../../../org/geotools/coverage/AbstractCoverage.html#getCommonPointRule()">common point rule</A>.
 <P>
 <B>NOTE:</B> Normally, the operation will return a single record of feature attribute values.
 <p>
 <strong>This method is not yet implemented.</strong>
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE>evaluate</CODE> in interface <CODE>Coverage</CODE></DL>
</DD>
<DD><DL>
<DT><B>Since:</B></DT>
  <DD>2.3</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="evaluate(org.opengis.spatialschema.geometry.DirectPosition, boolean[])"><!-- --></A><H3>
evaluate</H3>
<PRE>
public boolean[] <B>evaluate</B>(DirectPosition&nbsp;coord,
                          boolean[]&nbsp;dest)
                   throws CannotEvaluateException</PRE>
<DL>
<DD>Returns a sequence of boolean values for a given point in the coverage. A
 value for each sample dimension is included in the sequence. The default
 interpolation type used when accessing grid values for points which fall
 between grid cells is nearest neighbor. The CRS of the point is the same
 as the grid coverage
 <A HREF="../../../org/geotools/coverage/AbstractCoverage.html#getCoordinateReferenceSystem()">coordinate reference system</A>.
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE>evaluate</CODE> in interface <CODE>Coverage</CODE></DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>coord</CODE> - The coordinate point where to evaluate.<DD><CODE>dest</CODE> - An array in which to store values, or  to create a
            new array.
<DT><B>Returns:</B><DD>The  array, or a newly created array if 
         was null.
<DT><B>Throws:</B>
<DD><CODE>CannotEvaluateException</CODE> - if the values can't be computed at the specified coordinate.
             More specifically, <CODE>PointOutsideCoverageException</CODE> is
             thrown if the evaluation failed because the input point has
             invalid coordinates. This exception may also be throws if the
             coverage data type can't be converted to  by
             an identity or widening conversion. Subclasses may relax this
             constraint if appropriate.</DL>
</DD>
</DL>
<HR>

<A NAME="evaluate(org.opengis.spatialschema.geometry.DirectPosition, byte[])"><!-- --></A><H3>
evaluate</H3>
<PRE>
public byte[] <B>evaluate</B>(DirectPosition&nbsp;coord,
                       byte[]&nbsp;dest)
                throws CannotEvaluateException</PRE>
<DL>
<DD>Returns a sequence of byte values for a given point in the coverage. A
 value for each sample dimension is included in the sequence. The default
 interpolation type used when accessing grid values for points which fall
 between grid cells is nearest neighbor. The CRS of the point is the same
 as the coverage <A HREF="../../../org/geotools/coverage/AbstractCoverage.html#getCoordinateReferenceSystem()">coordinate
 reference system</A>.
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE>evaluate</CODE> in interface <CODE>Coverage</CODE></DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>coord</CODE> - The coordinate point where to evaluate.<DD><CODE>dest</CODE> - An array in which to store values, or  to create a
            new array.
<DT><B>Returns:</B><DD>The  array, or a newly created array if 
         was null.
<DT><B>Throws:</B>
<DD><CODE>CannotEvaluateException</CODE> - if the values can't be computed at the specified coordinate.
             More specifically, <CODE>PointOutsideCoverageException</CODE> is
             thrown if the evaluation failed because the input point has
             invalid coordinates. This exception may also be throws if the
             coverage data type can't be converted to  by an
             identity or widening conversion. Subclasses may relax this
             constraint if appropriate.</DL>
</DD>
</DL>
<HR>

<A NAME="evaluate(org.opengis.spatialschema.geometry.DirectPosition, int[])"><!-- --></A><H3>
evaluate</H3>
<PRE>
public int[] <B>evaluate</B>(DirectPosition&nbsp;coord,
                      int[]&nbsp;dest)
               throws CannotEvaluateException</PRE>
<DL>
<DD>Returns a sequence of integer values for a given point in the coverage. A
 value for each sample dimension is included in the sequence. The default
 interpolation type used when accessing grid values for points which fall
 between grid cells is nearest neighbor. The CRS of the point is the same
 as the coverage <A HREF="../../../org/geotools/coverage/AbstractCoverage.html#getCoordinateReferenceSystem()">coordinate
 reference system</A>.
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE>evaluate</CODE> in interface <CODE>Coverage</CODE></DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>coord</CODE> - The coordinate point where to evaluate.<DD><CODE>dest</CODE> - An array in which to store values, or  to create a
            new array.
<DT><B>Returns:</B><DD>The  array, or a newly created array if 
         was null.
<DT><B>Throws:</B>
<DD><CODE>CannotEvaluateException</CODE> - if the values can't be computed at the specified coordinate.
             More specifically, <CODE>PointOutsideCoverageException</CODE> is
             thrown if the evaluation failed because the input point has
             invalid coordinates. This exception may also be throws if the
             coverage data type can't be converted to  by an
             identity or widening conversion. Subclasses may relax this
             constraint if appropriate.</DL>
</DD>
</DL>
<HR>

<A NAME="evaluate(org.opengis.spatialschema.geometry.DirectPosition, float[])"><!-- --></A><H3>
evaluate</H3>
<PRE>
public float[] <B>evaluate</B>(DirectPosition&nbsp;coord,
                        float[]&nbsp;dest)
                 throws CannotEvaluateException</PRE>
<DL>
<DD>Returns a sequence of float values for a given point in the coverage. A
 value for each sample dimension is included in the sequence. The default
 interpolation type used when accessing grid values for points which fall
 between grid cells is nearest neighbor. The CRS of the point is the same
 as the coverage
 <A HREF="../../../org/geotools/coverage/AbstractCoverage.html#getCoordinateReferenceSystem()">coordinate reference system</A>.
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE>evaluate</CODE> in interface <CODE>Coverage</CODE></DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>coord</CODE> - The coordinate point where to evaluate.<DD><CODE>dest</CODE> - An array in which to store values, or  to create a
            new array.
<DT><B>Returns:</B><DD>The  array, or a newly created array if 
         was null.
<DT><B>Throws:</B>
<DD><CODE>CannotEvaluateException</CODE> - if the values can't be computed at the specified coordinate.
             More specifically, <CODE>PointOutsideCoverageException</CODE> is
             thrown if the evaluation failed because the input point has
             invalid coordinates. This exception may also be throws if the
             coverage data type can't be converted to  by an
             identity or widening conversion. Subclasses may relax this
             constraint if appropriate.</DL>
</DD>
</DL>
<HR>

<A NAME="evaluate(org.opengis.spatialschema.geometry.DirectPosition, double[])"><!-- --></A><H3>
evaluate</H3>
<PRE>
public double[] <B>evaluate</B>(DirectPosition&nbsp;coord,
                         double[]&nbsp;dest)
                  throws CannotEvaluateException</PRE>
<DL>
<DD>Returns a sequence of double values for a given point in the coverage. A
 value for each sample dimension is included in the sequence. The default
 interpolation type used when accessing grid values for points which fall
 between grid cells is nearest neighbor. The CRS of the point is the same
 as the grid coverage coordinate system.
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE>evaluate</CODE> in interface <CODE>Coverage</CODE></DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>coord</CODE> - The coordinate point where to evaluate.<DD><CODE>dest</CODE> - An array in which to store values, or  to create a
            new array.
<DT><B>Returns:</B><DD>The  array, or a newly created array if 
         was null.
<DT><B>Throws:</B>
<DD><CODE>CannotEvaluateException</CODE> - if the values can't be computed at the specified coordinate.
             More specifically, <CODE>PointOutsideCoverageException</CODE> is
             thrown if the evaluation failed because the input point has
             invalid coordinates. This exception may also be throws if the
             coverage data type can't be converted to  by an
             identity or widening conversion. Subclasses may relax this
             constraint if appropriate.</DL>
</DD>
</DL>
<HR>

<A NAME="evaluateInverse(org.opengis.util.Record)"><!-- --></A><H3>
evaluateInverse</H3>
<PRE>
public <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/util/Set.html" title="class or interface in java.util">Set</A> <B>evaluateInverse</B>(Record&nbsp;v)</PRE>
<DL>
<DD>Returns a set of domain objects for the specified record of feature
 attribute values. Normally, this method returns the set of objects
 in the domain that are associated with values equal to those in the input record. However,
 the operation may return other objects derived from those in the
 domain, as specified by the application schema.
 <p>
 <B>Example:</B> The  operation could return a set
 of contours derived from the feature attribute values associated with the
 grid points of a grid coverage.
 <p>
 <strong>This method is not yet implemented.</strong>
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE>evaluateInverse</CODE> in interface <CODE>Coverage</CODE></DL>
</DD>
<DD><DL>
<DT><B>Since:</B></DT>
  <DD>2.3</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="getRenderableImage(int, int)"><!-- --></A><H3>
getRenderableImage</H3>
<PRE>
public <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/awt/image/renderable/RenderableImage.html" title="class or interface in java.awt.image.renderable">RenderableImage</A> <B>getRenderableImage</B>(int&nbsp;xAxis,
                                          int&nbsp;yAxis)</PRE>
<DL>
<DD>Returns 2D view of this grid coverage as a renderable image. This method
 allows interoperability with Java2D.
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE>getRenderableImage</CODE> in interface <CODE>Coverage</CODE></DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>xAxis</CODE> - Dimension to use for the <var>x</var> display axis.<DD><CODE>yAxis</CODE> - Dimension to use for the <var>y</var> display axis.
<DT><B>Returns:</B><DD>A 2D view of this grid coverage as a renderable image.</DL>
</DD>
</DL>
<HR>

<A NAME="show(int, int)"><!-- --></A><H3>
show</H3>
<PRE>
public void <B>show</B>(int&nbsp;xAxis,
                 int&nbsp;yAxis)</PRE>
<DL>
<DD><B>Deprecated.</B>&nbsp;<I>Use <A HREF="../../../org/geotools/coverage/AbstractCoverage.html#show(java.lang.String, int, int)"><CODE>show(String, int, int)</CODE></A>.</I>
<P>
<DD>Display this coverage in a windows. This convenience method is used for debugging purpose.
 The exact appareance of the windows and the tools provided may changes in future versions.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>xAxis</CODE> - Dimension to use for the <var>x</var> display axis.<DD><CODE>yAxis</CODE> - Dimension