OperationDescriptor describing the "BandMerge" operation. The BandMerge operation takes two or more rendered or renderable images, and performs the merging of all the image bands inside a singular multibanded image. Each source image should be non-null. The number of bands of the destination image is the sum of those of all source images.
All the bands of source images are ordered in the order given in a ParameterBlock. If image1 has three bands and image2 has one band, the merged image has 4 bands. Three grayscale images can be used to merge into an RGB image in this way. If No Data values are present, then the user can define an array of {@link Range} objects(each one for an image) for the No Data and a double valuecalled "destination" no data which will be set instead of the old No data value. If the array length is smaller than that of the input images, then the first Range object is taken. If a ROI object is used, then it is taken into account during calculations. If the user wants to do a backward mapping from the destination pixels to each source image pixel, then he must add a parameter called "transformations". This parameter is a List of the transformations to perform on each image. Note that the list size must be equal to that of the sources, because each transformation must be related to only one image. The user should remember that these transformations have to map from the destination image to the source image and not the opposite. If this transformations are not used, then the input images must have the same bounds. The destination image bound is the intersection of the source image bounds. If the sources don't intersect, the destination will have a width and height of 0. If the transformations are present, then an optional Layout can be used to set the destination image bound.
| Name | Value |
|---|---|
| GlobalName | BandMergeOp |
| LocalName | BandMergeOp |
| Vendor | "org.geotools" |
| Description | Operation used for merging multiple images into a single multibanded image. |
| DocURL | Not Defined |
| Version | 1.0 | arg0Desc | NoData values. | arg1Desc | Destination No Data value. | arg2Desc | Transformations List. | arg3Desc | ROI object to use. |
| Name | Class Type | Default Value |
|---|---|---|
| noData | Range[] | null |
| destinationNoData | Double | 0 |
| transformations | java.util.List | null |
| roi | javax.media.jai.ROI | null |
@see javax.media.jai.OperationDescriptor @author Nicola Lagomarsini, GeoSolutions S.A.S.
| |