com.pixelmed.dicom

Class OtherByteAttributeMultipleCompressedFrames

java.lang.Object

com.pixelmed.dicom.Attribute

com.pixelmed.dicom.OtherByteAttributeMultipleCompressedFrames

All Implemented Interfaces:

BasicOffsetTableAccessor, ByteFrameSource

public class OtherByteAttributeMultipleCompressedFrames
extends Attribute
implements ByteFrameSource, BasicOffsetTableAccessor

A concrete class specializing Attribute for Other Byte (OB) attributes whose values are memory or file resident compressed pixel data frames.

See Also:

Attribute, AttributeList

Field Summary

Fields

Modifier and Type	Field and Description
protected byte[]	allframes
protected int[]	basicOffsetTable
protected File[]	files
protected byte[][]	frames
protected static AttributeTag	itemTag
protected static AttributeTag	sequenceDelimitationItemTag

Fields inherited from class com.pixelmed.dicom.Attribute

valueLength, valueMultiplicity

Constructor Summary

Constructors

Constructor and Description
OtherByteAttributeMultipleCompressedFrames(AttributeTag t, byte[] allframes) Construct an attribute from a single byte array containing all compressed frames.
OtherByteAttributeMultipleCompressedFrames(AttributeTag t, byte[][] frames) Construct an attribute from a set of compressed frames.
OtherByteAttributeMultipleCompressedFrames(AttributeTag t, File[] files) Construct an attribute from a set of compressed frames.

Method Summary

Modifier and Type	Method and Description
int[]	getBasicOffsetTable() Get the 32 bit array Basic Offset Table.
byte[]	getByteValuesForSelectedFrame(int frameNumber) Get the value of this attribute as a byte array for one selected frame.
File[]	getFiles() Get the files for each frame.
byte[][]	getFrames() Get the byte arrays for each frame.
int	getNumberOfFrames() Get the number of frames.
byte[]	getVR() Get the value representation of this attribute (OB).
void	removeValues() Remove any existing values, making the attribute empty (zero length).
void	setBasicOffsetTable(int[] basicOffsetTable) Set the 32 bit array Basic Offset Table.
String	toString(DicomDictionary dictionary) Dump the contents of the attribute as a human-readable string.
void	write(DicomOutputStream o) Write the entire attribute (including values) to the output stream.
protected void	writeItemTag(DicomOutputStream o, long length)
protected void	writeSequenceDelimitationItemTag(DicomOutputStream o)

Methods inherited from class com.pixelmed.dicom.Attribute

addValue, addValue, addValue, addValue, addValue, addValue, addValue, getByteValues, getByteValues, getDelimitedStringValuesOrDefault, getDelimitedStringValuesOrDefault, getDelimitedStringValuesOrDefault, getDelimitedStringValuesOrDefault, getDelimitedStringValuesOrDefault, getDelimitedStringValuesOrDefault, getDelimitedStringValuesOrEmptyString, getDelimitedStringValuesOrEmptyString, getDelimitedStringValuesOrEmptyString, getDelimitedStringValuesOrEmptyString, getDelimitedStringValuesOrEmptyString, getDelimitedStringValuesOrEmptyString, getDelimitedStringValuesOrNull, getDelimitedStringValuesOrNull, getDelimitedStringValuesOrNull, getDelimitedStringValuesOrNull, getDelimitedStringValuesOrNull, getDelimitedStringValuesOrNull, getDoubleValues, getDoubleValues, getDoubleValues, getElement, getFloatValues, getFloatValues, getFloatValues, getGroup, getIntegerValues, getIntegerValues, getIntegerValues, getLengthOfEncodedValue, getLongValues, getLongValues, getLongValues, getOriginalStringValues, getPaddedVL, getShortValues, getSingleDoubleValueOrDefault, getSingleDoubleValueOrDefault, getSingleDoubleValueOrDefault, getSingleFloatValueOrDefault, getSingleFloatValueOrDefault, getSingleFloatValueOrDefault, getSingleIntegerValueOrDefault, getSingleIntegerValueOrDefault, getSingleIntegerValueOrDefault, getSingleLongValueOrDefault, getSingleLongValueOrDefault, getSingleLongValueOrDefault, getSingleStringValueOrDefault, getSingleStringValueOrDefault, getSingleStringValueOrDefault, getSingleStringValueOrDefault, getSingleStringValueOrDefault, getSingleStringValueOrDefault, getSingleStringValueOrEmptyString, getSingleStringValueOrEmptyString, getSingleStringValueOrEmptyString, getSingleStringValueOrEmptyString, getSingleStringValueOrEmptyString, getSingleStringValueOrEmptyString, getSingleStringValueOrNull, getSingleStringValueOrNull, getSingleStringValueOrNull, getSingleStringValueOrNull, getSingleStringValueOrNull, getSingleStringValueOrNull, getStringValues, getStringValues, getStringValues, getStringValues, getStringValues, getStringValues, getTag, getVL, getVM, getVRAsString, isValid, repairValues, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValues, setValues, setValues, setValues, setValues, setValues, setValues, toString, writeBase

Methods inherited from class java.lang.Object

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

Field Detail

allframes

protected byte[] allframes

basicOffsetTable

protected int[] basicOffsetTable

files

protected File[] files

frames

protected byte[][] frames

itemTag

protected static final AttributeTag itemTag

sequenceDelimitationItemTag

protected static final AttributeTag sequenceDelimitationItemTag

Constructor Detail

OtherByteAttributeMultipleCompressedFrames

public OtherByteAttributeMultipleCompressedFrames(AttributeTag t,
                                                  byte[] allframes)

Construct an attribute from a single byte array containing all compressed frames.

The VL is not required, since it is undefined by definition.

Parameters:

t - the tag of the attribute

allframes - the frames

OtherByteAttributeMultipleCompressedFrames

public OtherByteAttributeMultipleCompressedFrames(AttributeTag t,
                                                  byte[][] frames)

Construct an attribute from a set of compressed frames.

The VL is not required, since it is undefined by definition.

Parameters:

t - the tag of the attribute

frames - the frames

OtherByteAttributeMultipleCompressedFrames

public OtherByteAttributeMultipleCompressedFrames(AttributeTag t,
                                                  File[] files)

Construct an attribute from a set of compressed frames.

The VL is not required, since it is undefined by definition.

Parameters:

t - the tag of the attribute

files - the files containing the compressed bit streams

Method Detail

getBasicOffsetTable

public int[] getBasicOffsetTable()

Get the 32 bit array Basic Offset Table.

Specified by:

getBasicOffsetTable in interface BasicOffsetTableAccessor

Returns:

the values as an array of int, or null if none =

getByteValuesForSelectedFrame

public byte[] getByteValuesForSelectedFrame(int frameNumber)
                                     throws DicomException

Get the value of this attribute as a byte array for one selected frame.

Specified by:

getByteValuesForSelectedFrame in interface ByteFrameSource

Parameters:

frameNumber - from 0

Returns:

the values as an array of bytes

Throws:

DicomException - thrown if values cannot be read

getFiles

public File[] getFiles()

Get the files for each frame.

Returns:

an array of files for each frame

getFrames

public byte[][] getFrames()

Get the byte arrays for each frame.

Returns:

an array of byte arrays for each frame

getNumberOfFrames

public int getNumberOfFrames()

Get the number of frames.

Returns:

number of frames, or zero if all frames are in one fragment

getVR

public byte[] getVR()

Get the value representation of this attribute (OB).

Overrides:

getVR in class Attribute

Returns:

'O','B' in ASCII as a two byte array; see ValueRepresentation

removeValues

public void removeValues()

Description copied from class: Attribute

Remove any existing values, making the attribute empty (zero length).

Specified by:

removeValues in class Attribute

setBasicOffsetTable

public void setBasicOffsetTable(int[] basicOffsetTable)

Set the 32 bit array Basic Offset Table.

Specified by:

setBasicOffsetTable in interface BasicOffsetTableAccessor

Parameters:

basicOffsetTable -

toString

public String toString(DicomDictionary dictionary)

Description copied from class: Attribute

Dump the contents of the attribute as a human-readable string.

No new line is appended.

The result is of the form:

 (0xgggg,0xeeee) Name VR=<XX> VL=<0xnnnn> <...>
 

For example:

 (0x0018,0x0020) ScanningSequence VR=<CS> VL=<0x2> <GR>
 

Overrides:

toString in class Attribute

Parameters:

dictionary - the dictionary to use to look up the name

Returns:

a single String value

write

public void write(DicomOutputStream o)
           throws DicomException,
                  IOException

Description copied from class: Attribute

Write the entire attribute (including values) to the output stream.

Specified by:

write in class Attribute

Parameters:

o -

Throws:

IOException

DicomException - if no byte array or files containing the compressed bitstream have been supplied

writeItemTag

protected void writeItemTag(DicomOutputStream o,
                            long length)
                     throws IOException

Throws:

IOException

writeSequenceDelimitationItemTag

protected void writeSequenceDelimitationItemTag(DicomOutputStream o)
                                         throws IOException

Throws:

IOException