Package it.tidalwave.image.op

Class ReadOp

java.lang.Object

it.tidalwave.image.op.Operation

it.tidalwave.image.op.ReadOp

public class ReadOp
extends Operation

Author:

Fabrizio Giudici

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static interface	ReadOp.Options	A marker interface for allowable options for ReadOp constructor.
static class	ReadOp.PluginBlackList	A container of plugin names that should not be used to load an image.
static class	ReadOp.Type

Constructor Summary

Constructors

Constructor	Description
ReadOp(java.lang.Object input)
ReadOp(java.lang.Object input, int imageIndex, int thumbnailIndex, ReadOp.Options... options)
ReadOp(java.lang.Object input, int imageIndex, ReadOp.Options... options)
ReadOp(java.lang.Object input, ReadOp.Options... options)

Method Summary

Modifier and Type	Method	Description
static javax.imageio.ImageReader	createImageReader(java.net.URL url, ReadOp.PluginBlackList pluginBlackList)	Returns a valid ImageReader for the given URL, or throw an IOException if it's not possible.
static javax.imageio.ImageReader	createImageReader(java.nio.file.Path file, ReadOp.PluginBlackList pluginBlackList)	Creates an ImageReader for the given Path.
EditableImage	execute()

Methods inherited from class java.lang.Object

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

Constructor Detail

ReadOp

public ReadOp(@Nonnull
              java.lang.Object input)

Parameters:

input - the input (an ImageReader or a Path)

ReadOp

public ReadOp(@Nonnull
              java.lang.Object input,
              @Nonnull
              ReadOp.Options... options)

Parameters:

input - the input (an ImageReader or a Path)

type - the type of read

ReadOp

public ReadOp(@Nonnull
              java.lang.Object input,
              @Nonnegative
              int imageIndex,
              @Nonnull
              ReadOp.Options... options)

Parameters:

input - the input (an ImageReader or a Path)

type - the type of read

imageIndex - the index of the image to read

ReadOp

public ReadOp(@Nonnull
              java.lang.Object input,
              @Nonnegative
              int imageIndex,
              @Nonnegative
              int thumbnailIndex,
              @Nonnull
              ReadOp.Options... options)

Parameters:

input - the input (an ImageReader or a Path)

type - the type of read

imageIndex - the index of the image to read

thumbnailIndex - the index of the thumbnail to read

Method Detail

execute

@Nonnull
public EditableImage execute()
                      throws java.io.IOException

Throws:

java.io.IOException

createImageReader

@Nonnull
public static javax.imageio.ImageReader createImageReader(@Nonnull
                                                          java.nio.file.Path file,
                                                          @Nonnull
                                                          ReadOp.PluginBlackList pluginBlackList)
                                                   throws java.io.IOException

Creates an ImageReader for the given Path. Using a Path as argument is important for photos that are stored in multiple files (e.g. Canon .CRW format). This method supports files GZIP compression (but multiple file formats such as .CRW aren't supported in this case).

Throws:

java.io.IOException - if it is not possible

createImageReader

@Nonnull
public static javax.imageio.ImageReader createImageReader(@Nonnull
                                                          java.net.URL url,
                                                          @Nonnull
                                                          ReadOp.PluginBlackList pluginBlackList)
                                                   throws java.io.IOException

Returns a valid ImageReader for the given URL, or throw an IOException if it's not possible.

Parameters:

url - the URL

Throws:

java.io.IOException - if it is not possible