combine.html

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

<P>
Computes a set of arbitrary linear combinations of the bands of many rendered source images,
 using a specified matrix. The matrix size (&times;) must be
 equals to the following:
 <p>
 <ul>
   <li>: the number of desired destination bands.</li>
   <li>: the total number of source bands (i.e. the
       sum of the number of source bands in all source images) plus one.</li>
 </ul>
 <p>
 The number of source bands used to determine the matrix dimensions is given by the
 following code regardless of the type of <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/awt/image/ColorModel.html" title="class or interface in java.awt.image"><CODE>ColorModel</CODE></A> the sources have:

 <blockquote><pre>
 int sourceBands = 0;
 for (int i=0; i<sources.length; i++) {
     sourceBands += sources[i].getSampleModel().getNumBands();
 }
 </blockquote></pre>
 
 The extra column in the matrix contains constant values each of which is added to the
 respective band of the destination. The transformation is therefore defined by the pseudocode:

 <blockquote><pre>
 // s = source pixel (not all from the same source image)
 // d = destination pixel
 for (int i=0; i<destBands; i++) {
     d[i] = matrix[i][sourceBands];
     for (int j=0; j<sourceBands; j++) {
         d[i] += matrix[i][j]*s[j];
     }
 }
 </blockquote></pre>

 In the special case where there is only one source, this method is equivalent to JAI's
 "<A HREF="http://java.sun.com/products/java-media/jai/forDevelopers/jai-apidocs/javax/media/jai/operator/BandCombineDescriptor.html" title="class or interface in javax.media.jai.operator"><CODE>BandCombine</CODE></A>" operation.
<P>

<P>
<DL>
<DT><B>Since:</B></DT>
  <DD>2.1</DD>
<DT><B>Author:</B></DT>
  <DD>Martin Desruisseaux, Remi Eve</DD>

<DT><B>Module:</B></DT>
<DD><CODE><B>module/coverage</B></CODE> &nbsp; (<A HREF="http://maven.geotools.fr/repository/org/geotools/gt2-coverage/"><CODE>gt2-coverage.jar</CODE></A>) (<A HREF="http://maven.geotools.fr/reports/coverage/index.html">Maven report</A>) (<A HREF="http://svn.geotools.org/geotools/tags/2.3.2/module/coverage/src/org/geotools/image/jai/Combine.java">SVN head</A>)</DD>
</DL>
<HR>

<P>
<!-- ======== NESTED CLASS SUMMARY ======== -->


<!-- =========== FIELD SUMMARY =========== -->

<A NAME="field_summary"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TD COLSPAN=2><FONT SIZE="+2">
<B>Field Summary</B></FONT></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>protected &nbsp;<A HREF="../../../../org/geotools/image/jai/CombineTransform.html" title="interface in org.geotools.image.jai">CombineTransform</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../org/geotools/image/jai/Combine.html#transform">transform</A></B></CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;The transform to apply on sample values before the linear combinaison,
 or  if none.</TD>
</TR>
</TABLE>
&nbsp;<A NAME="fields_inherited_from_class_OpImage"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
<TD><B>Fields inherited from class <A HREF="http://java.sun.com/products/java-media/jai/forDevelopers/jai-apidocs/javax/media/jai/OpImage.html" title="class or interface in javax.media.jai">OpImage</A></B></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD><CODE><A HREF="http://java.sun.com/products/java-media/jai/forDevelopers/jai-apidocs/javax/media/jai/OpImage.html#cache" title="class or interface in javax.media.jai">cache</A>, <A HREF="http://java.sun.com/products/java-media/jai/forDevelopers/jai-apidocs/javax/media/jai/OpImage.html#cobbleSources" title="class or interface in javax.media.jai">cobbleSources</A>, <A HREF="http://java.sun.com/products/java-media/jai/forDevelopers/jai-apidocs/javax/media/jai/OpImage.html#OP_COMPUTE_BOUND" title="class or interface in javax.media.jai">OP_COMPUTE_BOUND</A>, <A HREF="http://java.sun.com/products/java-media/jai/forDevelopers/jai-apidocs/javax/media/jai/OpImage.html#OP_IO_BOUND" title="class or interface in javax.media.jai">OP_IO_BOUND</A>, <A HREF="http://java.sun.com/products/java-media/jai/forDevelopers/jai-apidocs/javax/media/jai/OpImage.html#OP_NETWORK_BOUND" title="class or interface in javax.media.jai">OP_NETWORK_BOUND</A>, <A HREF="http://java.sun.com/products/java-media/jai/forDevelopers/jai-apidocs/javax/media/jai/OpImage.html#tileCacheMetric" title="class or interface in javax.media.jai">tileCacheMetric</A>, <A HREF="http://java.sun.com/products/java-media/jai/forDevelopers/jai-apidocs/javax/media/jai/OpImage.html#tileRecycler" title="class or interface in javax.media.jai">tileRecycler</A></CODE></TD>
</TR>
</TABLE>
&nbsp;<A NAME="fields_inherited_from_class_PlanarImage"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
<TD><B>Fields inherited from class <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></B></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD><CODE><A HREF="http://java.sun.com/products/java-media/jai/forDevelopers/jai-apidocs/javax/media/jai/PlanarImage.html#colorModel" title="class or interface in javax.media.jai">colorModel</A>, <A HREF="http://java.sun.com/products/java-media/jai/forDevelopers/jai-apidocs/javax/media/jai/PlanarImage.html#eventManager" title="class or interface in javax.media.jai">eventManager</A>, <A HREF="http://java.sun.com/products/java-media/jai/forDevelopers/jai-apidocs/javax/media/jai/PlanarImage.html#height" title="class or interface in javax.media.jai">height</A>, <A HREF="http://java.sun.com/products/java-media/jai/forDevelopers/jai-apidocs/javax/media/jai/PlanarImage.html#minX" title="class or interface in javax.media.jai">minX</A>, <A HREF="http://java.sun.com/products/java-media/jai/forDevelopers/jai-apidocs/javax/media/jai/PlanarImage.html#minY" title="class or interface in javax.media.jai">minY</A>, <A HREF="http://java.sun.com/products/java-media/jai/forDevelopers/jai-apidocs/javax/media/jai/PlanarImage.html#properties" title="class or interface in javax.media.jai">properties</A>, <A HREF="http://java.sun.com/products/java-media/jai/forDevelopers/jai-apidocs/javax/media/jai/PlanarImage.html#sampleModel" title="class or interface in javax.media.jai">sampleModel</A>, <A HREF="http://java.sun.com/products/java-media/jai/forDevelopers/jai-apidocs/javax/media/jai/PlanarImage.html#tileFactory" title="class or interface in javax.media.jai">tileFactory</A>, <A HREF="http://java.sun.com/products/java-media/jai/forDevelopers/jai-apidocs/javax/media/jai/PlanarImage.html#tileGridXOffset" title="class or interface in javax.media.jai">tileGridXOffset</A>, <A HREF="http://java.sun.com/products/java-media/jai/forDevelopers/jai-apidocs/javax/media/jai/PlanarImage.html#tileGridYOffset" title="class or interface in javax.media.jai">tileGridYOffset</A>, <A HREF="http://java.sun.com/products/java-media/jai/forDevelopers/jai-apidocs/javax/media/jai/PlanarImage.html#tileHeight" title="class or interface in javax.media.jai">tileHeight</A>, <A HREF="http://java.sun.com/products/java-media/jai/forDevelopers/jai-apidocs/javax/media/jai/PlanarImage.html#tileWidth" title="class or interface in javax.media.jai">tileWidth</A>, <A HREF="http://java.sun.com/products/java-media/jai/forDevelopers/jai-apidocs/javax/media/jai/PlanarImage.html#width" title="class or interface in javax.media.jai">width</A></CODE></TD>
</TR>
</TABLE>
&nbsp;
<!-- ======== CONSTRUCTOR SUMMARY ======== -->

<A NAME="constructor_summary"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TD COLSPAN=2><FONT SIZE="+2">
<B>Constructor Summary</B></FONT></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD><CODE><B><A HREF="../../../../org/geotools/image/jai/Combine.html#Combine(java.util.Vector, double[][], org.geotools.image.jai.CombineTransform, java.awt.RenderingHints)">Combine</A></B>(<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/util/Vector.html" title="class or interface in java.util">Vector</A>&nbsp;images,