boofcv.io.image

Class UtilImageIO

java.lang.Object

boofcv.io.image.UtilImageIO

public class UtilImageIO
extends java.lang.Object

Class for loading and saving images.

Constructor Summary

Constructors

Constructor and Description
UtilImageIO()

Method Summary

Methods

Modifier and Type	Method and Description
static java.awt.image.BufferedImage	loadImage(java.lang.String fileName) A function that load the specified image.
static <T extends boofcv.struct.image.ImageSingleBand> T	loadImage(java.lang.String fileName, java.lang.Class<T> imageType) Loads the image and converts into the specified image type.
static java.awt.image.BufferedImage	loadImage(java.net.URL fileName) A function that load the specified image.
static java.util.List<java.awt.image.BufferedImage>	loadImages(java.lang.String directory, java.lang.String regex) Loads all the image in the specified directory which match the provided regex
static boofcv.struct.image.ImageUInt8	loadPGM_U8(java.io.InputStream inputStream, boofcv.struct.image.ImageUInt8 storage) Loads a PGM image from an InputStream.
static boofcv.struct.image.ImageUInt8	loadPGM_U8(java.lang.String fileName, boofcv.struct.image.ImageUInt8 storage) Loads a PGM image from an InputStream.
static java.awt.image.BufferedImage	loadPGM(java.io.InputStream inputStream, java.awt.image.BufferedImage storage) Loads a PGM image from an InputStream.
static java.awt.image.BufferedImage	loadPGM(java.lang.String fileName, java.awt.image.BufferedImage storage) Loads a PGM image from a file.
static boofcv.struct.image.MultiSpectral<boofcv.struct.image.ImageUInt8>	loadPPM_U8(java.io.InputStream inputStream, boofcv.struct.image.MultiSpectral<boofcv.struct.image.ImageUInt8> storage, org.ddogleg.struct.GrowQueue_I8 temp) Reads a PPM image file directly into a MultiSpectral image.
static boofcv.struct.image.MultiSpectral<boofcv.struct.image.ImageUInt8>	loadPPM_U8(java.lang.String fileName, boofcv.struct.image.MultiSpectral<boofcv.struct.image.ImageUInt8> storage, org.ddogleg.struct.GrowQueue_I8 temp) Reads a PPM image file directly into a MultiSpectral image.
static java.awt.image.BufferedImage	loadPPM(java.io.InputStream inputStream, java.awt.image.BufferedImage storage) Loads a PPM image from an InputStream.
static java.awt.image.BufferedImage	loadPPM(java.lang.String fileName, java.awt.image.BufferedImage storage) Loads a PPM image from a file.
static void	saveImage(java.awt.image.BufferedImage img, java.lang.String fileName)
static void	savePGM(boofcv.struct.image.ImageUInt8 gray, java.lang.String fileName) Saves an image in PGM format.
static void	savePPM(boofcv.struct.image.MultiSpectral<boofcv.struct.image.ImageUInt8> rgb, java.lang.String fileName, org.ddogleg.struct.GrowQueue_I8 temp) Saves an image in PPM format.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

UtilImageIO

public UtilImageIO()

Method Detail

loadImage

public static java.awt.image.BufferedImage loadImage(java.lang.String fileName)

A function that load the specified image. If anything goes wrong it returns a null.

loadImages

public static java.util.List<java.awt.image.BufferedImage> loadImages(java.lang.String directory,
                                                      java.lang.String regex)

Loads all the image in the specified directory which match the provided regex

Parameters:

directory - File directory

regex - Regex used to match file names

Returns:

List of found images.

loadImage

public static java.awt.image.BufferedImage loadImage(java.net.URL fileName)

A function that load the specified image. If anything goes wrong it returns a null.

loadImage

public static <T extends boofcv.struct.image.ImageSingleBand> T loadImage(java.lang.String fileName,
                                                          java.lang.Class<T> imageType)

Loads the image and converts into the specified image type.

Parameters:

fileName - Path to image file.

imageType - Type of image that should be returned.

Returns:

The image or null if the image could not be loaded.

saveImage

public static void saveImage(java.awt.image.BufferedImage img,
             java.lang.String fileName)

loadPPM

public static java.awt.image.BufferedImage loadPPM(java.lang.String fileName,
                                   java.awt.image.BufferedImage storage)
                                            throws java.io.IOException

Loads a PPM image from a file.

Parameters:

fileName - Location of PPM image

storage - (Optional) Storage for output image. Must be the width and height of the image being read. Better performance of type BufferedImage.TYPE_INT_RGB. If null or width/height incorrect a new image will be declared.

Returns:

The read in image

Throws:

java.io.IOException

loadPGM

public static java.awt.image.BufferedImage loadPGM(java.lang.String fileName,
                                   java.awt.image.BufferedImage storage)
                                            throws java.io.IOException

Loads a PGM image from a file.

Parameters:

fileName - Location of PGM image

storage - (Optional) Storage for output image. Must be the width and height of the image being read. Better performance of type BufferedImage.TYPE_BYTE_GRAY. If null or width/height incorrect a new image will be declared.

Returns:

The read in image

Throws:

java.io.IOException

loadPPM

public static java.awt.image.BufferedImage loadPPM(java.io.InputStream inputStream,
                                   java.awt.image.BufferedImage storage)
                                            throws java.io.IOException

Loads a PPM image from an InputStream.

Parameters:

inputStream - InputStream for PPM image

storage - (Optional) Storage for output image. Must be the width and height of the image being read. Better performance of type BufferedImage.TYPE_INT_RGB. If null or width/height incorrect a new image will be declared.

Returns:

The read in image

Throws:

java.io.IOException

loadPGM

public static java.awt.image.BufferedImage loadPGM(java.io.InputStream inputStream,
                                   java.awt.image.BufferedImage storage)
                                            throws java.io.IOException

Loads a PGM image from an InputStream.

Parameters:

inputStream - InputStream for PGM image

storage - (Optional) Storage for output image. Must be the width and height of the image being read. Better performance of type BufferedImage.TYPE_BYTE_GRAY. If null or width/height incorrect a new image will be declared.

Returns:

The read in image

Throws:

java.io.IOException

loadPPM_U8

public static boofcv.struct.image.MultiSpectral<boofcv.struct.image.ImageUInt8> loadPPM_U8(java.lang.String fileName,
                                                                           boofcv.struct.image.MultiSpectral<boofcv.struct.image.ImageUInt8> storage,
                                                                           org.ddogleg.struct.GrowQueue_I8 temp)
                                                                                    throws java.io.IOException

Reads a PPM image file directly into a MultiSpectral image. To improve performance when reading many images, the user can provide work space memory in the optional parameters

Parameters:

fileName - Location of PPM file

storage - (Optional) Where the image is written in to. Will be resized if needed. If null or the number of bands isn't 3, a new instance is declared.

temp - (Optional) Used internally to store the image. Can be null.

Returns:

The image.

Throws:

java.io.IOException

loadPPM_U8

public static boofcv.struct.image.MultiSpectral<boofcv.struct.image.ImageUInt8> loadPPM_U8(java.io.InputStream inputStream,
                                                                           boofcv.struct.image.MultiSpectral<boofcv.struct.image.ImageUInt8> storage,
                                                                           org.ddogleg.struct.GrowQueue_I8 temp)
                                                                                    throws java.io.IOException

Reads a PPM image file directly into a MultiSpectral image. To improve performance when reading many images, the user can provide work space memory in the optional parameters

Parameters:

inputStream - InputStream for PPM image

storage - (Optional) Where the image is written in to. Will be resized if needed. If null or the number of bands isn't 3, a new instance is declared.

temp - (Optional) Used internally to store the image. Can be null.

Returns:

The image.

Throws:

java.io.IOException

loadPGM_U8

public static boofcv.struct.image.ImageUInt8 loadPGM_U8(java.lang.String fileName,
                                        boofcv.struct.image.ImageUInt8 storage)
                                                 throws java.io.IOException

Loads a PGM image from an InputStream.

Parameters:

fileName - InputStream for PGM image

storage - (Optional) Storage for output image. Must be the width and height of the image being read. If null a new image will be declared.

Returns:

The read in image

Throws:

java.io.IOException

loadPGM_U8

public static boofcv.struct.image.ImageUInt8 loadPGM_U8(java.io.InputStream inputStream,
                                        boofcv.struct.image.ImageUInt8 storage)
                                                 throws java.io.IOException

Loads a PGM image from an InputStream.

Parameters:

inputStream - InputStream for PGM image

storage - (Optional) Storage for output image. Must be the width and height of the image being read. If null a new image will be declared.

Returns:

The read in image

Throws:

java.io.IOException

savePPM

public static void savePPM(boofcv.struct.image.MultiSpectral<boofcv.struct.image.ImageUInt8> rgb,
           java.lang.String fileName,
           org.ddogleg.struct.GrowQueue_I8 temp)
                    throws java.io.IOException

Saves an image in PPM format.

Parameters:

rgb - 3-band RGB image

fileName - Location where the image is to be written to.

temp - (Optional) Used internally to store the image. Can be null.

Throws:

java.io.IOException

savePGM

public static void savePGM(boofcv.struct.image.ImageUInt8 gray,
           java.lang.String fileName)
                    throws java.io.IOException

Saves an image in PGM format.

Parameters:

gray - Gray scale image

fileName - Location where the image is to be written to.

Throws:

java.io.IOException