Package org.esa.snap.core.util.geotiff

Class IIOUtils

java.lang.Object
org.esa.snap.core.util.geotiff.IIOUtils
public class IIOUtils extends Object

  • Method Details

    • readImage

      public static IIOImage readImage(File input) throws IOException
      Returns a BufferedImage as the result of decoding a supplied File with an ImageReader chosen automatically from among those currently registered. The File is wrapped in an ImageInputStream. If no registered ImageReader claims to be able to readImage the resulting stream, null is returned.

      The current cache settings from getUseCacheand getCacheDirectory will be used to control caching in the ImageInputStream that is created.

      Note that there is no readImage method that takes a filename as a String; use this method instead after creating a File from the filename.

      This methods does not attempt to locate ImageReaders that can readImage directly from a File; that may be accomplished using IIORegistry and ImageReaderSpi.

      Parameters:
      input - a File to readImage from.
      Returns:
      a BufferedImage containing the decoded contents of the input, or null.
      Throws:
      IllegalArgumentException - if input is null.
      IOException - if an error occurs during reading.

    • readImage

      public static IIOImage readImage(ImageInputStream stream) throws IOException
      Returns a BufferedImage as the result of decoding a supplied ImageInputStream with an ImageReader chosen automatically from among those currently registered. If no registered ImageReader claims to be able to readImage the stream, null is returned.
      Parameters:
      stream - an ImageInputStream to readImage from.
      Returns:
      a BufferedImage containing the decoded contents of the input, or null.
      Throws:
      IllegalArgumentException - if stream is null.
      IOException - if an error occurs during reading.

    • writeImage

      public static boolean writeImage(IIOImage iioImage, String formatName, File output) throws IOException
      Writes an image using an arbitrary ImageWriter that supports the given format to a File. If there is already a File present, its contents are discarded.
      Parameters:
      iioImage - the image data to be written.
      formatName - a String containg the informal name of the format.
      output - a File to be written to.
      Returns:
      false if no appropriate writer is found.
      Throws:
      IllegalArgumentException - if any parameter is null.
      IOException - if an error occurs during writing.

    • writeImage

      public static boolean writeImage(IIOImage iioImage, String formatName, ImageOutputStream output) throws IOException
      Writes an image using the an arbitrary ImageWriter that supports the given format to an ImageOutputStream. The image is written to the ImageOutputStream starting at the current stream pointer, overwriting existing stream data from that point forward, if present.
      Parameters:
      iioImage - the image data to be written.
      formatName - a String containg the informal name of the format.
      output - an ImageOutputStream to be written to.
      Returns:
      false if no appropriate writer is found.
      Throws:
      IllegalArgumentException - if any parameter is null.
      IOException - if an error occurs during writing.

    • getImageWriter

      public static ImageWriter getImageWriter(ImageTypeSpecifier imageType, String imageFormatName)
      Gets an image writer suitable to be used for the given image type and image format.
      Parameters:
      imageType - the type of the image to be written later
      imageFormatName - the image format name, e.g. "TIFF"
      Returns:
      a suitable image writer, or null if no writer is found

    • getImageWriter

      public static ImageWriter getImageWriter(ImageTypeSpecifier imageType, String imageFormatName, String metadataFormatName)
      Gets an image writer suitable to be used for the given image type, image format and metadata format.
      Parameters:
      imageType - the type of the image to be written later
      imageFormatName - the image format name, e.g. "TIFF"
      metadataFormatName - the metadata format name, e.g. "com_sun_media_imageio_plugins_tiff_image_1.0", or null
      Returns:
      a suitable image writer, or null if no writer is found

    • getXML

      public static String getXML(IIOMetadata metadata)