org.dcm4che3.data

Class Fragments

java.lang.Object

java.util.AbstractCollection<E>

java.util.AbstractList<E>

java.util.ArrayList<Object>

org.dcm4che3.data.Fragments

All Implemented Interfaces:

Serializable, Cloneable, Iterable<Object>, Collection<Object>, List<Object>, RandomAccess, Value

public class Fragments
extends ArrayList<Object>
implements Value

Fragments are used for encapsulation of an encoded (=compressed) pixel data stream into the Pixel Data (7FE0,0010) portion of the DICOM Data Set. They are encoded as a sequence of items with Value Representation OB.

Each item is either a byte[], BulkData or Value.NULL.

The first Item in the sequence of items before the encoded Pixel Data Stream is a Basic Offset Table item. The value of the Basic Offset Table, however, is not required to be present. The first item is then Value.NULL.

Depending on the transfer syntax, a frame may be entirely contained within a single fragment, or may span multiple fragments to support buffering during compression or to avoid exceeding the maximum size of a fixed length fragment. A recipient can detect fragmentation of frames by comparing the number of fragments (the number of Items minus one for the Basic Offset Table) with the number of frames.

See also DICOM Part 5: A.4 TRANSFER SYNTAXES FOR ENCAPSULATION OF ENCODED PIXEL DATA and DICOM Part 5: 8.2 Native or Encapsulated Format Encoding

Author:

Gunter Zeilinger

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
private boolean	bigEndian
private String	privateCreator
private static long	serialVersionUID
private int	tag
private VR	vr

Fields inherited from class java.util.AbstractList

modCount

Fields inherited from interface org.dcm4che3.data.Value

NULL

Constructor Summary

Constructors

Constructor and Description
Fragments(String privateCreator, int tag, VR vr, boolean bigEndian, int initialCapacity)

Method Summary

Modifier and Type	Method and Description
void	add(int index, Object frag)
boolean	add(Object frag)
boolean	addAll(Collection<? extends Object> c)
boolean	addAll(int index, Collection<? extends Object> c)
boolean	bigEndian()
int	calcLength(DicomEncodingOptions encOpts, boolean explicitVR, VR vr)
boolean	equals(Object obj)
int	getEncodedLength(DicomEncodingOptions encOpts, boolean explicitVR, VR vr)
int	hashCode()
private int	itemHashCode(Object e)
private boolean	itemsEqual(Object o1, Object o2)
String	privateCreator()
int	tag()
byte[]	toBytes(VR vr, boolean bigEndian)
String	toString()
VR	vr()
void	writeTo(DicomOutputStream out, VR vr)

Methods inherited from class java.util.ArrayList

clear, clone, contains, ensureCapacity, forEach, get, indexOf, isEmpty, iterator, lastIndexOf, listIterator, listIterator, remove, remove, removeAll, removeIf, removeRange, replaceAll, retainAll, set, size, sort, spliterator, subList, toArray, toArray, trimToSize

Methods inherited from class java.util.AbstractCollection

containsAll

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.dcm4che3.data.Value

isEmpty

Methods inherited from interface java.util.List

containsAll

Methods inherited from interface java.util.Collection

parallelStream, stream

Field Detail

serialVersionUID

private static final long serialVersionUID

See Also:

Constant Field Values

privateCreator

private final String privateCreator

tag

private final int tag

vr

private final VR vr

bigEndian

private final boolean bigEndian

Constructor Detail

Fragments

public Fragments(String privateCreator,
                 int tag,
                 VR vr,
                 boolean bigEndian,
                 int initialCapacity)

Method Detail

privateCreator

public String privateCreator()

tag

public final int tag()

vr

public final VR vr()

bigEndian

public final boolean bigEndian()

toString

public String toString()

Overrides:

toString in class AbstractCollection<Object>

add

public boolean add(Object frag)

Specified by:

add in interface Collection<Object>

Specified by:

add in interface List<Object>

Overrides:

add in class ArrayList<Object>

add

public void add(int index,
                Object frag)

Specified by:

add in interface List<Object>

Overrides:

add in class ArrayList<Object>

addAll

public boolean addAll(Collection<? extends Object> c)

Specified by:

addAll in interface Collection<Object>

Specified by:

addAll in interface List<Object>

Overrides:

addAll in class ArrayList<Object>

addAll

public boolean addAll(int index,
                      Collection<? extends Object> c)

Specified by:

addAll in interface List<Object>

Overrides:

addAll in class ArrayList<Object>

writeTo

public void writeTo(DicomOutputStream out,
                    VR vr)
             throws IOException

Specified by:

writeTo in interface Value

Throws:

IOException

calcLength

public int calcLength(DicomEncodingOptions encOpts,
                      boolean explicitVR,
                      VR vr)

Specified by:

calcLength in interface Value

getEncodedLength

public int getEncodedLength(DicomEncodingOptions encOpts,
                            boolean explicitVR,
                            VR vr)

Specified by:

getEncodedLength in interface Value

toBytes

public byte[] toBytes(VR vr,
                      boolean bigEndian)
               throws IOException

Specified by:

toBytes in interface Value

Throws:

IOException

equals

public boolean equals(Object obj)

Specified by:

equals in interface Collection<Object>

Specified by:

equals in interface List<Object>

Overrides:

equals in class AbstractList<Object>

hashCode

public int hashCode()

Specified by:

hashCode in interface Collection<Object>

Specified by:

hashCode in interface List<Object>

Overrides:

hashCode in class AbstractList<Object>

itemsEqual

private boolean itemsEqual(Object o1,
                           Object o2)

itemHashCode

private int itemHashCode(Object e)