com.pixelmed.dicom

Class OtherByteAttributeMultipleCompressedFrames

java.lang.Object

com.pixelmed.dicom.Attribute

com.pixelmed.dicom.OtherByteAttributeMultipleCompressedFrames

All Implemented Interfaces:

ByteFrameSource

public class OtherByteAttributeMultipleCompressedFrames
extends Attribute
implements ByteFrameSource

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 java.io.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, java.io.File[] files) Construct an attribute from a set of compressed frames.

Method Summary

Modifier and Type	Method and Description
byte[]	getByteValuesForSelectedFrame(int frameNumber) Get the value of this attribute as a byte array for one selected frame.
java.io.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).
java.lang.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

files

protected java.io.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,
                                                  java.io.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

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 java.io.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

toString

public java.lang.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,
                  java.io.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:

java.io.IOException

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

writeItemTag

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

Throws:

java.io.IOException

writeSequenceDelimitationItemTag

protected void writeSequenceDelimitationItemTag(DicomOutputStream o)
                                         throws java.io.IOException

Throws:

java.io.IOException