com.pixelmed.codec.jpeg

Class OutputArrayOrStream

java.lang.Object

com.pixelmed.codec.jpeg.OutputArrayOrStream

public class OutputArrayOrStream
extends java.lang.Object

A class that allows writing to either an OutputStream or a byte[] or short[] of preallocated size.

An unallocated instance may be constructed but any attempt to write to it will fail until either an OutputStream is assigned or an array of the appropriate type is allocated. This allows, for example, the instance to be created and later allocated based on size information, e.g., as header information is encountered while decompressing before decompressed pixel values need to be written.

Field Summary

Fields

Modifier and Type	Field and Description
protected int	byteOffset
protected byte[]	byteValues
protected java.nio.ByteOrder	order
protected java.io.OutputStream	out
protected int	shortOffset
protected short[]	shortValues

Constructor Summary

Constructors

Constructor and Description
OutputArrayOrStream()
OutputArrayOrStream(byte[] byteValues)
OutputArrayOrStream(java.io.OutputStream out, java.nio.ByteOrder order)
OutputArrayOrStream(short[] shortValues)

Method Summary

Modifier and Type	Method and Description
void	allocateByteArray(int length)
void	allocateShortArray(int length)
void	close() Closes any assigned OutputStream.
byte[]	getByteArray()
java.io.OutputStream	getOutputStream()
short[]	getShortArray()
java.nio.ByteOrder	order() Retrieves the OutputStream's byte order used when writing short values.
void	order(java.nio.ByteOrder order) Modifes the OutputStream's byte order used when writing short values.
void	setOutputStream(java.io.OutputStream out, java.nio.ByteOrder order)
void	writeByte(int b) Writes the specified byte to this output.
void	writeShort(int s) Writes the specified short to this output.

Methods inherited from class java.lang.Object

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

Field Detail

out

protected java.io.OutputStream out

order

protected java.nio.ByteOrder order

byteValues

protected byte[] byteValues

shortValues

protected short[] shortValues

byteOffset

protected int byteOffset

shortOffset

protected int shortOffset

Constructor Detail

OutputArrayOrStream

public OutputArrayOrStream()

OutputArrayOrStream

public OutputArrayOrStream(java.io.OutputStream out,
                           java.nio.ByteOrder order)

OutputArrayOrStream

public OutputArrayOrStream(byte[] byteValues)

OutputArrayOrStream

public OutputArrayOrStream(short[] shortValues)

Method Detail

setOutputStream

public void setOutputStream(java.io.OutputStream out,
                            java.nio.ByteOrder order)
                     throws java.io.IOException

Throws:

java.io.IOException

order

public java.nio.ByteOrder order()

Retrieves the OutputStream's byte order used when writing short values.

Returns:

The OutputStream's byte order, or null if no OutputStream

order

public void order(java.nio.ByteOrder order)
           throws java.io.IOException

Modifes the OutputStream's byte order used when writing short values.

Parameters:

order - the new byte order, either BIG_ENDIAN or LITTLE_ENDIAN

Throws:

java.io.IOException - if no OutputStream assigned

allocateByteArray

public void allocateByteArray(int length)
                       throws java.io.IOException

Throws:

java.io.IOException

allocateShortArray

public void allocateShortArray(int length)
                        throws java.io.IOException

Throws:

java.io.IOException

getOutputStream

public java.io.OutputStream getOutputStream()

getByteArray

public byte[] getByteArray()

getShortArray

public short[] getShortArray()

writeByte

public void writeByte(int b)
               throws java.io.IOException

Writes the specified byte to this output.

Parameters:

b - the byte.

Throws:

java.io.IOException - if an I/O error occurs.

writeShort

public void writeShort(int s)
                throws java.io.IOException

Writes the specified short to this output.

Parameters:

s - the short.

Throws:

java.io.IOException - if an I/O error occurs.

close

public void close()
           throws java.io.IOException

Closes any assigned OutputStream.

Does nothing if arrays allocated instead of an OutputStream (i.e., does NOT release them).

Throws:

java.io.IOException - if an I/O error occurs.