io.scif.codec

Class AbstractCodec

java.lang.Object

org.scijava.AbstractContextual

org.scijava.plugin.AbstractRichPlugin

io.scif.AbstractSCIFIOPlugin

io.scif.codec.AbstractCodec

All Implemented Interfaces:

Codec, SCIFIOPlugin, Comparable<org.scijava.Prioritized>, org.scijava.Contextual, org.scijava.Identifiable, org.scijava.Locatable, org.scijava.log.Logged, org.scijava.plugin.HasPluginInfo, org.scijava.plugin.RichPlugin, org.scijava.plugin.SciJavaPlugin, org.scijava.plugin.SingletonPlugin, org.scijava.Prioritized, org.scijava.Versioned

Direct Known Subclasses:

Base64Codec, HuffmanCodec, JPEG2000Codec, JPEGCodec, LosslessJPEGCodec, LuraWaveCodec, LZWCodec, MJPBCodec, MSRLECodec, MSVideoCodec, NikonCodec, PackbitsCodec, PassthroughCodec, QTRLECodec, RPZACodec, ZlibCodec

public abstract class AbstractCodec
extends AbstractSCIFIOPlugin
implements Codec

BaseCodec contains default implementation and testing for classes implementing the Codec interface, and acts as a base class for any of the compression classes. Base 1D compression and decompression methods are not implemented here, and are left as abstract. 2D methods do simple concatenation and call to the 1D methods

Author:

Eric Kjellman

Constructor Summary

Constructors

Constructor and Description
AbstractCodec()

Method Summary

Modifier and Type	Method and Description
byte[]	compress(byte[][] data, CodecOptions options) 2D data block encoding default implementation.
byte[]	decompress(byte[] data) Decompresses a block of data.
byte[]	decompress(byte[][] data) Decompresses a block of data.
byte[]	decompress(byte[][] data, CodecOptions options) 2D data block decoding default implementation.
byte[]	decompress(byte[] data, CodecOptions options) Decompresses a block of data.
void	test() Main testing method default implementation.

Methods inherited from class io.scif.AbstractSCIFIOPlugin

getVersion, log

Methods inherited from class org.scijava.plugin.AbstractRichPlugin

getInfo, getPriority, setInfo, setPriority, toString

Methods inherited from class org.scijava.AbstractContextual

context, getContext

Methods inherited from class java.lang.Object

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

Methods inherited from interface io.scif.codec.Codec

compress, decompress

Methods inherited from interface io.scif.SCIFIOPlugin

getVersion, log

Methods inherited from interface org.scijava.plugin.RichPlugin

getIdentifier

Methods inherited from interface org.scijava.Contextual

context, getContext, setContext

Methods inherited from interface org.scijava.Prioritized

compareTo, getPriority, setPriority

Methods inherited from interface org.scijava.plugin.HasPluginInfo

getInfo, setInfo

Methods inherited from interface org.scijava.Locatable

getLocation

Constructor Detail

AbstractCodec

public AbstractCodec()

Method Detail

test

public void test()
          throws FormatException

Main testing method default implementation. This method tests whether the data is the same after compressing and decompressing, as well as doing a basic test of the 2D methods.

Throws:

FormatException - Can only occur if there is a bug in the compress method.

compress

public byte[] compress(byte[][] data,
                       CodecOptions options)
                throws FormatException

2D data block encoding default implementation. This method simply concatenates data[0] + data[1] + ... + data[i] into a 1D block of data, then calls the 1D version of compress.

Specified by:

compress in interface Codec

Parameters:

data - The data to be compressed.

options - Options to be used during compression, if appropriate.

Returns:

The compressed data.

Throws:

FormatException - If input is not a compressed data block of the appropriate type.

decompress

public byte[] decompress(byte[] data)
                  throws FormatException

Description copied from interface: Codec

Decompresses a block of data.

Specified by:

decompress in interface Codec

Parameters:

data - the data to be decompressed.

Returns:

The decompressed data.

Throws:

FormatException - If data is not valid compressed data for this decompressor.

decompress

public byte[] decompress(byte[][] data)
                  throws FormatException

Description copied from interface: Codec

Decompresses a block of data.

Specified by:

decompress in interface Codec

Parameters:

data - The data to be decompressed.

Returns:

The decompressed data.

Throws:

FormatException - If data is not valid compressed data for this decompressor.

decompress

public byte[] decompress(byte[] data,
                         CodecOptions options)
                  throws FormatException

Description copied from interface: Codec

Decompresses a block of data.

Specified by:

decompress in interface Codec

Parameters:

data - the data to be decompressed

options - Options to be used during decompression.

Returns:

the decompressed data.

Throws:

FormatException - If data is not valid.

decompress

public byte[] decompress(byte[][] data,
                         CodecOptions options)
                  throws FormatException

2D data block decoding default implementation. This method simply concatenates data[0] + data[1] + ... + data[i] into a 1D block of data, then calls the 1D version of decompress.

Specified by:

decompress in interface Codec

Parameters:

data - The data to be decompressed.

options - Options to be used during decompression.

Returns:

The decompressed data.

Throws:

FormatException - If input is not a compressed data block of the appropriate type.