Interface Processor

public interface Processor

Encapsulates an image processing engine.

Implementations can depend on their decoder and encoder being set before any other methods are called.

Method Summary

Modifier and Type	Method	Description
void	process(OperationList opList, OutputStream outputStream)	Reads the image from the decoder, performs the supplied operations on it, and writes the result to the supplied stream using the encoder.
void	setArena(Arena arena)	Called before process(is.galia.operation.OperationList, java.io.OutputStream).
void	setDecoder(Decoder decoder)	Will be called before process(is.galia.operation.OperationList, java.io.OutputStream).
void	setEncoder(Encoder encoder)	Will be called before process(is.galia.operation.OperationList, java.io.OutputStream).

Method Details

setArena

void setArena(Arena arena)

Called before process(is.galia.operation.OperationList, java.io.OutputStream).

Parameters:

arena - Instance in which to perform any native operations.

setDecoder

void setDecoder(Decoder decoder)

Will be called before process(is.galia.operation.OperationList, java.io.OutputStream).

Parameters:

decoder - Instance from which to read the image.

setEncoder

void setEncoder(Encoder encoder)

Will be called before process(is.galia.operation.OperationList, java.io.OutputStream).

Parameters:

encoder - Instance to which to write the image.

process

void process(OperationList opList,
 OutputStream outputStream)
      throws IOException

Reads the image from the decoder, performs the supplied operations on it, and writes the result to the supplied stream using the encoder.

Implementation notes:

• The OperationList will be frozen. Implementations should not perform any operations other than the ones in the list, as this could cause problems with caching.
• Operations should be applied in the order they are iterated.
• In addition to operations, the OperationList may contain options, which implementations should respect, where applicable. Option values may originate from the application configuration, so implementations should not try to read the application configuration themselves, as this could also cause problems with caching.
• The arguments should be assumed to all be valid. The provided OutputStream is likely going to write to the response, so it is already too late to e.g. render an error page.

Parameters:

opList - Operation list to process, which has already been validated.

outputStream - Stream to write the image to, which should not be closed.

Throws:

IOException - if anything else goes wrong.