Package org.geotools.gce.geotiff

Class GeoTiffWriteParams

Object
IIOParam
ImageWriteParam
GeoToolsWriteParams
GeoTiffWriteParams
public class GeoTiffWriteParams extends GeoToolsWriteParams
Subclass of GeoToolsWriteParams the allows the user to specify parameters to control the process of writing out a GeoTiff file through standards ImageWriteParam (with possible extensions).

This class allows the user to control the output tile size for the GeoTiff file we are going to create as well as the possible compression.

An example of usage of this parameters is as follows: 

 
                //getting a format
                final GeoTiffFormat format = new GeoTiffFormat();

                //getting the write parameters
                final GeoTiffWriteParams wp = new GeoTiffWriteParams();

                //setting compression to LZW
                wp.setCompressionMode(GeoTiffWriteParams.MODE_EXPLICIT);
                wp.setCompressionType("LZW");
                wp.setCompressionQuality(0.75F);

                //setting the tile size to 256X256
                wp.setTilingMode(GeoToolsWriteParams.MODE_EXPLICIT);
                wp.setTiling(256, 256);

                //setting the write parameters for this geotiff
                final ParameterValueGroup params = format.getWriteParameters();
                params.parameter(
                                AbstractGridFormat.GEOTOOLS_WRITE_PARAMS.getName().toString())
                                .setValue(wp);

                //get a reader to the input File
                GridCoverageReader reader = new GeoTiffReader(inFile, null);
                GridCoverageWriter writer = null;
                GridCoverage2D gc = null;
                if (reader != null) {

                        // reading the coverage
                        gc = (GridCoverage2D) reader.read();
                                if (gc != null) {
                                        final File writeFile = new File(new StringBuffer(writedir
                                                        .getAbsolutePath()).append(File.separatorChar)
                                                        .append(gc.getName().toString()).append(".tiff")
                                                        .toString());
                                        writer = format.getWriter(writeFile);
                                        writer.write(gc, (GeneralParameterValue[]) params.values()
                                .toArray(new GeneralParameterValue[1]));
                        }
Since:
2.3.x
Author:
Simone Giannecchini

  • Constructor Details

    • GeoTiffWriteParams

      public GeoTiffWriteParams()
      Default constructor.

  • Method Details

    • setForceToBigTIFF

      public void setForceToBigTIFF(boolean forceToBigTIFF)

    • isForceToBigTIFF

      public boolean isForceToBigTIFF()

    • getColorConverter

      public TIFFColorConverter getColorConverter()
      Returns the current TIFFColorConverter object that will be used to perform color conversion when writing the image, or null if none is set.
      Returns:
      a TIFFColorConverter object, or null.
      See Also:

    • getPhotometricInterpretation

      public int getPhotometricInterpretation()
      Returns the current value that will be written to the Photometricinterpretation tag. This method should only be called if a value has been set using the setColorConverter method.
      Returns:
      an int to be used as the value of the PhotometricInterpretation tag.
      Throws:
      IllegalStateException - if no value is set.
      See Also:

    • getTIFFCompressor

      public TIFFCompressor getTIFFCompressor()
      Returns the TIFFCompressor that is currently set to be used by the ImageWriter to encode each image strip or tile, or null if none has been set.
      Returns:
      compressor the TIFFCompressor to be used for encoding, or null if none has been set (allowing the writer to choose its own).
      Throws:
      IllegalStateException - if the compression mode is not MODE_EXPLICIT.
      See Also:

    • isCompressionLossless

      public boolean isCompressionLossless()
      Overrides:
      isCompressionLossless in class GeoToolsWriteParams

    • setColorConverter

      public void setColorConverter(TIFFColorConverter colorConverter, int photometricInterpretation)
      Sets the TIFFColorConverter object describing the color space to which the input data should be converted for storage in the input stream. In addition, the value to be written to the PhotometricInterpretation tag is supplied.
      Parameters:
      colorConverter - a TIFFColorConverter object, or null.
      photometricInterpretation - the value to be written to the PhotometricInterpretation tag in the root IFD.
      See Also:

    • setTIFFCompressor

      public void setTIFFCompressor(TIFFCompressor compressor)
      Sets the TIFFCompressor object to be used by the ImageWriter to encode each image strip or tile. A value of null allows the writer to choose its own TIFFCompressor.

      Note that invoking this method is not sufficient to set the compression type: setCompressionType() must be invoked explicitly for this purpose. The following code illustrates the correct procedure: 

       TIFFImageWriteParam writeParam;
 TIFFCompressor compressor;
 writeParam.setCompressionMode(writeParam.MODE_EXPLICIT);
 writeParam.setTIFFCompressor(compressor);
 writeParam.setCompressionType(compressor.getCompressionType());
      If compressionType is set to a value different from that supported by the TIFFCompressor then the compressor object will not be used.

      If the compression type supported by the supplied TIFFCompressor is not among those in compressionTypes, then it will be appended to this array after removing any previously appended compression type. If compressor is null this will also cause any previously appended type to be removed from the array.

      Parameters:
      compressor - the TIFFCompressor to be used for encoding, or null to allow the writer to choose its own.
      Throws:
      IllegalStateException - if the compression mode is not MODE_EXPLICIT.
      See Also:

    • unsetColorConverter

      public void unsetColorConverter()
      Removes any currently set ColorConverter object and PhotometricInterpretation tag value.
      See Also: