gridcoveragefactory.html

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

<PRE>
public <A HREF="../../../../org/geotools/coverage/grid/GridCoverage2D.html" title="class in org.geotools.coverage.grid">GridCoverage2D</A> <B>create</B>(<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/CharSequence.html" title="class or interface in java.lang">CharSequence</A>&nbsp;name,
                             <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/awt/image/WritableRaster.html" title="class or interface in java.awt.image">WritableRaster</A>&nbsp;raster,
                             Envelope&nbsp;envelope)</PRE>
<DL>
<DD>Constructs a grid coverage from the specified <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/awt/image/WritableRaster.html" title="class or interface in java.awt.image">raster</A> and
 envelope. A default color palette is built from the minimal and
 maximal values found in the raster.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>name</CODE> - The grid coverage name.<DD><CODE>raster</CODE> - The data (may be floating point numbers). <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Float.html#NaN" title="class or interface in java.lang">NaN</A>
                 values are mapped to a transparent color.<DD><CODE>envelope</CODE> - The envelope.</DL>
</DD>
</DL>
<HR>

<A NAME="create(java.lang.CharSequence, java.awt.image.WritableRaster, org.opengis.spatialschema.geometry.Envelope, double[], double[], javax.units.Unit, java.awt.Color[][], java.awt.RenderingHints)"><!-- --></A><H3>
create</H3>
<PRE>
public <A HREF="../../../../org/geotools/coverage/grid/GridCoverage2D.html" title="class in org.geotools.coverage.grid">GridCoverage2D</A> <B>create</B>(<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/CharSequence.html" title="class or interface in java.lang">CharSequence</A>&nbsp;name,
                             <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/awt/image/WritableRaster.html" title="class or interface in java.awt.image">WritableRaster</A>&nbsp;raster,
                             Envelope&nbsp;envelope,
                             double[]&nbsp;minValues,
                             double[]&nbsp;maxValues,
                             <A HREF="http://jsr-108.sourceforge.net/javadoc/javax/units/Unit.html" title="class or interface in javax.units">Unit</A>&nbsp;units,
                             <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/awt/Color.html" title="class or interface in java.awt">Color</A>[][]&nbsp;colors,
                             <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/awt/RenderingHints.html" title="class or interface in java.awt">RenderingHints</A>&nbsp;hints)</PRE>
<DL>
<DD>Constructs a grid coverage from the specified <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/awt/image/WritableRaster.html" title="class or interface in java.awt.image">raster</A> and
 envelope.
 
 See the <A HREF="../../../../org/geotools/coverage/grid/GridCoverageFactory.html#create(java.lang.CharSequence, java.awt.image.RenderedImage, org.opengis.spatialschema.geometry.Envelope, org.geotools.coverage.GridSampleDimension[], org.opengis.coverage.grid.GridCoverage[], java.util.Map)">rendered image variant</A> for a note on heuristic rules applied by this
 method.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>name</CODE> - The grid coverage name.<DD><CODE>raster</CODE> - The data (may be floating point numbers). <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Float.html#NaN" title="class or interface in java.lang">NaN</A>
                    values are mapped to a transparent color.<DD><CODE>envelope</CODE> - The grid coverage cordinates and its CRS. This envelope must have at least
                    two dimensions. The two first dimensions describe the image location along
                    <var>x</var> and <var>y</var> axis. The other dimensions are optional and
                    may be used to locate the image on a vertical axis or on the time axis.<DD><CODE>minValues</CODE> - The minimal value for each band in the raster, or 
                    for computing it automatically.<DD><CODE>maxValues</CODE> - The maximal value for each band in the raster, or 
                    for computing it automatically.<DD><CODE>units</CODE> - The units of sample values, or  if unknow.<DD><CODE>colors</CODE> - The colors to use for values from  to 
                    for each bands, or  for a default color palette. If non-null,
                    each arrays  may have any length; colors will be
                    interpolated as needed.<DD><CODE>hints</CODE> - An optional set of rendering hints, or  if none. Those hints
                    will not affect the grid coverage to be created. However, they may affect
                    the grid coverage to be returned by <code><A HREF="../../../../org/geotools/coverage/grid/GridCoverage2D.html#geophysics(boolean)"><CODE>geophysics</CODE></A>(false)</code>, i.e. the view to be used at rendering time. The
                    optional <A HREF="../../../../org/geotools/factory/Hints.html#SAMPLE_DIMENSION_TYPE"><CODE>SAMPLE_DIMENSION_TYPE</CODE></A> hint
                    specifies the <CODE>SampleDimensionType</CODE> to be used at rendering time,
                    which can be one of <CODE>UNSIGNED_8BITS</CODE>
                    or <CODE>UNSIGNED_16BITS</CODE>.<DT><B>Since:</B></DT>
  <DD>2.2</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="create(java.lang.CharSequence, java.awt.image.WritableRaster, org.opengis.referencing.crs.CoordinateReferenceSystem, org.opengis.referencing.operation.MathTransform, double[], double[], javax.units.Unit, java.awt.Color[][], java.awt.RenderingHints)"><!-- --></A><H3>
create</H3>
<PRE>
public <A HREF="../../../../org/geotools/coverage/grid/GridCoverage2D.html" title="class in org.geotools.coverage.grid">GridCoverage2D</A> <B>create</B>(<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/CharSequence.html" title="class or interface in java.lang">CharSequence</A>&nbsp;name,
                             <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/awt/image/WritableRaster.html" title="class or interface in java.awt.image">WritableRaster</A>&nbsp;raster,
                             CoordinateReferenceSystem&nbsp;crs,
                             MathTransform&nbsp;gridToCRS,
                             double[]&nbsp;minValues,
                             double[]&nbsp;maxValues,
                             <A HREF="http://jsr-108.sourceforge.net/javadoc/javax/units/Unit.html" title="class or interface in javax.units">Unit</A>&nbsp;units,
                             <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/awt/Color.html" title="class or interface in java.awt">Color</A>[][]&nbsp;colors,
                             <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/awt/RenderingHints.html" title="class or interface in java.awt">RenderingHints</A>&nbsp;hints)</PRE>
<DL>
<DD>Constructs a grid coverage from the specified <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/awt/image/WritableRaster.html" title="class or interface in java.awt.image">raster</A> and
 "<A HREF="../../../../org/geotools/coverage/grid/GeneralGridGeometry.html#getGridToCoordinateSystem()">grid to CRS</A>" transform.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>name</CODE> - The grid coverage name.<DD><CODE>raster</CODE> - The data (may be floating point numbers). <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Float.html#NaN" title="class or interface in java.lang">NaN</A>
                    values are mapped to a transparent color.<DD><CODE>crs</CODE> - The coordinate reference system. This specifies the CRS used when
                    accessing a grid coverage with the  methods.<DD><CODE>gridToCRS</CODE> - The math transform from grid to coordinate reference system.<DD><CODE>minValues</CODE> - The minimal value for each band in the raster, or 
                    for computing it automatically.<DD><CODE>maxValues</CODE> - The maximal value for each band in the raster, or 
                    for computing it automatically.<DD><CODE>units</CODE> - The units of sample values, or  if unknow.<DD><CODE>colors</CODE> - The colors to use for values from  to 
                    for each bands, or  for a default color palette. If non-null,
                    each arrays  may have any length; colors will be
                    interpolated as needed.<DD><CODE>hints</CODE> - An optional set of rendering hints, or  if none. Those hints
                    will not affect the grid coverage to be created. However, they may affect
                    the grid coverage to be returned by <code><A HREF="../../../../org/geotools/coverage/grid/GridCoverage2D.html#geophysics(boolean)"><CODE>geophysics</CODE></A>(false)</code>, i.e. the view to be used at rendering time. The
                    optional <A HREF="../../../../org/geotools/factory/Hints.html#SAMPLE_DIMENSION_TYPE"><CODE>SAMPLE_DIMENSION_TYPE</CODE></A> hint
                    specifies the <CODE>SampleDimensionType</CODE> to be used at rendering time,
                    which can be one of <CODE>UNSIGNED_8BITS</CODE>
                    or <CODE>UNSIGNED_16BITS</CODE>.</DL>
</DD>
</DL>
<HR>

<A NAME="create(java.lang.CharSequence, java.awt.image.WritableRaster, org.opengis.spatialschema.geometry.Envelope, org.geotools.coverage.GridSampleDimension[])"><!-- --></A><H3>
create</H3>
<PRE>
public <A HREF="../../../../org/geotools/coverage/grid/GridCoverage2D.html" title="class in org.geotools.coverage.grid">GridCoverage2D</A> <B>create</B>(<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/CharSequence.html" title="class or interface in java.lang">CharSequence</A>&nbsp;name,
                             <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/awt/image/WritableRaster.html" title="class or interface in java.awt.image">WritableRaster</A>&nbsp;raster,
                             Envelope&nbsp;envelope,
                             <A HREF="../../../../org/geotools/coverage/GridSampleDimension.html" title="class in org.geotools.coverage">GridSampleDimension</A>[]&nbsp;bands)</PRE>
<DL>
<DD>Constructs a grid coverage from the specified <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/awt/image/WritableRaster.html" title="class or interface in java.awt.image">raster</A>
 and envelope. This convenience constructor performs the same
 assumptions on axis order than the <A HREF="../../../../org/geotools/coverage/grid/GridCoverageFactory.html#create(java.lang.CharSequence, java.awt.image.RenderedImage, org.opengis.spatialschema.geometry.Envelope, org.geotools.coverage.GridSampleDimension[], org.opengis.coverage.grid.GridCoverage[], java.util.Map)">rendered image variant</A>.
 <p>
 The coordinate reference system is inferred from the
 supplied envelope. The envelope must have at least two dimensions. The two first dimensions
 describe the image location along <var>x</var> and <var>y</var> axis. The other dimensions
 are optional and may be used to locate the image on a vertical axis or on the time axis.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>name</CODE> - The grid coverage name.<DD><CODE>raster</CODE> - The raster.<DD><CODE>envelope</CODE> - The grid coverage cordinates.<DD><CODE>bands</CODE> - Sample dimensions for each image band, or  for default
                     sample dimensions. If non-null, then this array's length must matches
                     the number of bands in .<DT><B>Since:</B></DT>
  <DD>2.2</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="create(java.lang.CharSequence, java.awt.image.WritableRaster, org.opengis.referencing.crs.CoordinateReferenceSystem, org.opengis.referencing.operation.MathTransform, org.geotools.coverage.GridSampleDimension[])"><!-- --></A><H3>
create</H3>
<PRE>
public <A HREF="../../../../org/geotools/coverage/grid/GridCoverage2D.html" title="class in org.geotools.coverage.grid">GridCoverage2D</A> <B>create</B>(<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/CharSequence.html" title="class or interface in java.lang">CharSequence</A>&nbsp;name,
                             <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/awt/image/WritableRaster.html" title="class or interface in java.awt.image">WritableRaster</A>&nbsp;raster,
                             CoordinateReferenceSystem&nbsp;crs,
                             MathTransform&nbsp;gridToCRS,
                             <A HREF="../../../../org/geotools/coverage/GridSampleDimension.html" title="class in org.geotools.coverage">GridSampleDimension</A>[]&nbsp;bands)</PRE>
<DL>
<DD>Constructs a grid coverage from the specified <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/awt/image/WritableRaster.html" title="class or interface in java.awt.image">raster</A> and
 "<A HREF="../../../../org/geotools/coverage/grid/GeneralGridGeometry.html#getGridToCoordinateSystem()">grid to CRS</A>" transform.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>name</CODE> - The grid coverage name.<DD><CODE>raster</CODE> - The raster.<DD><CODE>crs</CODE> - The coordinate reference system. This specifies the CRS used when
                     accessing a grid coverage with the  methods. The
                     number of dimensions must matches the number of target dimensions
                     of .<DD><CODE>gridToCRS</CODE> - The math transform from grid to coordinate reference system.<DD><CODE>bands</CODE> - Sample dimensions for each image band, or  for
                     default sample dimensions. If non-null, then this array's length
                     must matches the number of bands in .<DT><B>Since:</B></DT>
  <DD>2.2</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="create(java.lang.CharSequence, java.awt.image.RenderedImage, org.opengis.spatialschema.geometry.Envelope)"><!-- --></A><H3>
create</H3>
<PRE>
public <A HREF="../../../../org/geotools/coverage/grid/GridCoverage2D.html" title="class in org.geotools.coverage.grid">GridCoverage2D</A> <B>create</B>(<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/CharSequence.html" title="class or interface in java.lang">CharSequence</A>&nbsp;name,
                             <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/awt/image/RenderedImage.html" title="class or interface in java.awt.image">RenderedImage</A>&nbsp;image,
                             Envelope&nbsp;envelope)</PRE>
<DL>
<DD>Constructs a grid coverage from the specified <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/awt/image/RenderedImage.html" title="class or interface in java.awt.image">image</A> and
 envelope. A default set of <A HREF="../../../../org/geotools/coverage/GridSampleDimension.html" title="class in org.geotools.coverage">sample
 dimensions</A> is used. The coordinate reference system
 is inferred from the supplied envelope.
 <p>
 The envelope must have at least two dimensions. The two first dimensions describe the image
 location along <var>x</var> and <var>y</var> axis. The other dimensions are optional and may
 be used to locate the image on a vertical axis or on the time axis.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>name</CODE> - The grid coverage name.<DD><CODE>image</CODE> - The image.<DD><CODE>envelope</CODE> - The grid coverage cordinates.<DT><B>Since:</B></DT>
  <DD>2.2</DD>
</DL>