org.dcm4che3.data

Class Attributes

java.lang.Object

org.dcm4che3.data.Attributes

All Implemented Interfaces:

Serializable

public class Attributes
extends Object
implements Serializable

Author:

Gunter Zeilinger

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	Attributes.Visitor

Constructor Summary

Constructors

Constructor and Description
Attributes()
Attributes(Attributes other)
Attributes(Attributes other, boolean bigEndian)
Attributes(Attributes other, boolean bigEndian, Attributes selection)
Attributes(Attributes other, boolean bigEndian, int... selection)
Attributes(Attributes other, int... selection)
Attributes(boolean bigEndian)
Attributes(boolean bigEndian, int initialCapacity)
Attributes(int initialCapacity)

Method Summary

Methods

Modifier and Type	Method and Description
boolean	accept(Attributes.Visitor visitor, boolean visitNestedDatasets) Invokes Visitor.visit for each attribute in this instance.
boolean	addAll(Attributes other)
boolean	addNotSelected(Attributes other, int... selection) Add not selected attributes from another Attributes object to this.
boolean	addNotSelected(Attributes other, int[] selection, int fromIndex, int toIndex) Add not selected attributes from another Attributes object to this.
boolean	addSelected(Attributes other, Attributes selection)
boolean	addSelected(Attributes other, int... selection) Add selected attributes from another Attributes object to this.
boolean	addSelected(Attributes other, int[] selection, int fromIndex, int toIndex) Add selected attributes from another Attributes object to this.
boolean	addSelected(Attributes other, String privateCreator, int tag)
boolean	bigEndian()
int	calcLength(DicomEncodingOptions encOpts, boolean explicitVR)
Object	clearProperty(String key)
boolean	contains(int tag)
boolean	contains(String privateCreator, int tag)
boolean	containsValue(int tag)
boolean	containsValue(String privateCreator, int tag)
Attributes	createFileMetaInformation(String tsuid)
static Attributes	createFileMetaInformation(String iuid, String cuid, String tsuid)
Sequence	ensureSequence(int tag, int initialCapacity)
Sequence	ensureSequence(String privateCreator, int tag, int initialCapacity)
boolean	equals(Object o)
byte[]	getBytes(int tag)
byte[]	getBytes(String privateCreator, int tag)
Date	getDate(int tag)
Date	getDate(int tag, Date defVal)
Date	getDate(int tag, Date defVal, DatePrecision precision)
Date	getDate(int tag, DatePrecision precision)
Date	getDate(int tag, int valueIndex)
Date	getDate(int tag, int valueIndex, Date defVal)
Date	getDate(int tag, int valueIndex, Date defVal, DatePrecision precision)
Date	getDate(int tag, int valueIndex, DatePrecision precision)
Date	getDate(long tag)
Date	getDate(long tag, Date defVal)
Date	getDate(long tag, Date defVal, DatePrecision precision)
Date	getDate(long tag, DatePrecision precision)
Date	getDate(String privateCreator, int tag)
Date	getDate(String privateCreator, int tag, Date defVal, DatePrecision precision)
Date	getDate(String privateCreator, int tag, DatePrecision precision)
Date	getDate(String privateCreator, int tag, int valueIndex)
Date	getDate(String privateCreator, int tag, int valueIndex, Date defVal)
Date	getDate(String privateCreator, int tag, int valueIndex, Date defVal, DatePrecision precision)
Date	getDate(String privateCreator, int tag, int valueIndex, DatePrecision precision)
Date	getDate(String privateCreator, int tag, VR vr)
Date	getDate(String privateCreator, int tag, VR vr, Date defVal)
Date	getDate(String privateCreator, int tag, VR vr, Date defVal, DatePrecision precision)
Date	getDate(String privateCreator, int tag, VR vr, DatePrecision precision)
Date	getDate(String privateCreator, int tag, VR vr, int valueIndex)
Date	getDate(String privateCreator, int tag, VR vr, int valueIndex, Date defVal)
Date	getDate(String privateCreator, int tag, VR vr, int valueIndex, Date defVal, DatePrecision precision)
Date	getDate(String privateCreator, int tag, VR vr, int valueIndex, DatePrecision precision)
Date	getDate(String privateCreator, long tag)
Date	getDate(String privateCreator, long tag, Date defVal)
Date	getDate(String privateCreator, long tag, Date defVal, DatePrecision precision)
Date	getDate(String privateCreator, long tag, DatePrecision precision)
DateRange	getDateRange(int tag)
DateRange	getDateRange(int tag, DateRange defVal)
DateRange	getDateRange(long tag)
DateRange	getDateRange(long tag, DateRange defVal)
DateRange	getDateRange(String privateCreator, int tag)
DateRange	getDateRange(String privateCreator, int tag, DateRange defVal)
DateRange	getDateRange(String privateCreator, int tag, VR vr)
DateRange	getDateRange(String privateCreator, int tag, VR vr, DateRange defVal)
DateRange	getDateRange(String privateCreator, long tag)
DateRange	getDateRange(String privateCreator, long tag, DateRange defVal)
Date[]	getDates(int tag)
Date[]	getDates(int tag, DatePrecisions precisions)
Date[]	getDates(long tag)
Date[]	getDates(long tag, DatePrecisions precisions)
Date[]	getDates(String privateCreator, int tag)
Date[]	getDates(String privateCreator, int tag, DatePrecisions precisions)
Date[]	getDates(String privateCreator, int tag, VR vr)
Date[]	getDates(String privateCreator, int tag, VR vr, DatePrecisions precisions)
Date[]	getDates(String privateCreator, long tag)
Date[]	getDates(String privateCreator, long tag, DatePrecisions precisions)
TimeZone	getDefaultTimeZone()
double	getDouble(int tag, double defVal)
double	getDouble(int tag, int valueIndex, double defVal)
double	getDouble(String privateCreator, int tag, double defVal)
double	getDouble(String privateCreator, int tag, int valueIndex, double defVal)
double	getDouble(String privateCreator, int tag, VR vr, double defVal)
double	getDouble(String privateCreator, int tag, VR vr, int valueIndex, double defVal)
double[]	getDoubles(int tag)
double[]	getDoubles(String privateCreator, int tag)
double[]	getDoubles(String privateCreator, int tag, VR vr)
float	getFloat(int tag, float defVal)
float	getFloat(int tag, int valueIndex, float defVal)
float	getFloat(String privateCreator, int tag, float defVal)
float	getFloat(String privateCreator, int tag, int valueIndex, float defVal)
float	getFloat(String privateCreator, int tag, VR vr, float defVal)
float	getFloat(String privateCreator, int tag, VR vr, int valueIndex, float defVal)
float[]	getFloats(int tag)
float[]	getFloats(String privateCreator, int tag)
float[]	getFloats(String privateCreator, int tag, VR vr)
int	getInt(int tag, int defVal)
int	getInt(int tag, int valueIndex, int defVal)
int	getInt(String privateCreator, int tag, int defVal)
int	getInt(String privateCreator, int tag, int valueIndex, int defVal)
int	getInt(String privateCreator, int tag, VR vr, int defVal)
int	getInt(String privateCreator, int tag, VR vr, int valueIndex, int defVal)
int[]	getInts(int tag)
int[]	getInts(String privateCreator, int tag)
int[]	getInts(String privateCreator, int tag, VR vr)
long	getItemPosition()
int	getLength()
int	getLevel()
Attributes	getNestedDataset(int sequenceTag)
Attributes	getNestedDataset(int sequenceTag, int itemIndex)
Attributes	getNestedDataset(ItemPointer... itemPointers)
Attributes	getNestedDataset(String privateCreator, int sequenceTag)
Attributes	getNestedDataset(String privateCreator, int sequenceTag, int itemIndex)
Attributes	getParent()
String	getPrivateCreator(int tag)
Object	getProperty(String key, Object defVal)
byte[]	getSafeBytes(int tag)
byte[]	getSafeBytes(String privateCreator, int tag)
Sequence	getSequence(int tag)
Sequence	getSequence(String privateCreator, int tag)
SpecificCharacterSet	getSpecificCharacterSet()
SpecificCharacterSet	getSpecificCharacterSet(VR vr)
String	getString(int tag)
String	getString(int tag, int valueIndex)
String	getString(int tag, int valueIndex, String defVal)
String	getString(int tag, String defVal)
String	getString(String privateCreator, int tag)
String	getString(String privateCreator, int tag, int valueIndex)
String	getString(String privateCreator, int tag, int valueIndex, String defVal)
String	getString(String privateCreator, int tag, String defVal)
String	getString(String privateCreator, int tag, VR vr)
String	getString(String privateCreator, int tag, VR vr, int valueIndex)
String	getString(String privateCreator, int tag, VR vr, int valueIndex, String defVal)
String	getString(String privateCreator, int tag, VR vr, String defVal)
String[]	getStrings(int tag)
String[]	getStrings(String privateCreator, int tag)
String[]	getStrings(String privateCreator, int tag, VR vr)
TimeZone	getTimeZone()
Object	getValue(int tag)
Object	getValue(int tag, VR.Holder vr)
Object	getValue(String privateCreator, int tag)
Object	getValue(String privateCreator, int tag, VR.Holder vr)
VR	getVR(int tag)
VR	getVR(String privateCreator, int tag)
int	hashCode()
void	internalizeStringValues(boolean decode)
boolean	isEmpty()
boolean	isRoot()
boolean	matches(Attributes keys, boolean ignorePNCase, boolean matchNoValue)
boolean	merge(Attributes other)
boolean	mergeSelected(Attributes other, int... selection) Merge selected attributes from another Attributes object into this.
Fragments	newFragments(int tag, VR vr, int initialCapacity)
Fragments	newFragments(String privateCreator, int tag, VR vr, int initialCapacity)
Sequence	newSequence(int tag, int initialCapacity)
Sequence	newSequence(String privateCreator, int tag, int initialCapacity)
String	privateCreatorOf(int tag)
Object	remove(int tag)
Object	remove(String privateCreator, int tag)
Object	setBytes(int tag, VR vr, byte[] b)
Object	setBytes(String privateCreator, int tag, VR vr, byte[] b)
Object	setDate(int tag, VR vr, Date... ds)
Object	setDate(int tag, VR vr, DatePrecision precision, Date... ds)
void	setDate(long tag, Date dt)
void	setDate(long tag, DatePrecision precision, Date dt)
Object	setDate(String privateCreator, int tag, VR vr, Date... ds)
Object	setDate(String privateCreator, int tag, VR vr, DatePrecision precision, Date... ds)
void	setDate(String privateCreator, long tag, Date dt)
void	setDate(String privateCreator, long tag, DatePrecision precision, Date dt)
Object	setDateRange(int tag, VR vr, DateRange range)
void	setDateRange(long tag, DateRange dr)
Object	setDateRange(String privateCreator, int tag, VR vr, DateRange range)
void	setDateRange(String privateCreator, long tag, DateRange range)
void	setDefaultTimeZone(TimeZone tz)
Object	setDouble(int tag, VR vr, double... ds)
Object	setDouble(String privateCreator, int tag, VR vr, double... ds)
Object	setFloat(int tag, VR vr, float... fs)
Object	setFloat(String privateCreator, int tag, VR vr, float... fs)
Object	setInt(int tag, VR vr, int... is)
Object	setInt(String privateCreator, int tag, VR vr, int... is)
void	setItemPosition(long itemPosition)
Object	setNull(int tag, VR vr)
Object	setNull(String privateCreator, int tag, VR vr)
Object	setProperty(String key, Object value)
void	setSpecificCharacterSet(String... codes) Set Specific Character Set (0008,0005) to specified code(s) and re-encode contained LO, LT, PN, SH, ST, UT attributes accordingly.
Object	setString(int tag, VR vr, String... ss)
Object	setString(int tag, VR vr, String s)
Object	setString(String privateCreator, int tag, VR vr, String... ss)
Object	setString(String privateCreator, int tag, VR vr, String s)
void	setTimezone(TimeZone tz) Set the Default Time Zone to specified value and adjust contained DA, DT and TM attributs accordingly.
void	setTimezoneOffsetFromUTC(String utcOffset) Set Timezone Offset From UTC (0008,0201) to specified value and adjust contained DA, DT and TM attributs accordingly
Object	setValue(int tag, VR vr, Object value)
Object	setValue(String privateCreator, int tag, VR vr, Object value)
int	size()
int[]	tags()
boolean	testMerge(Attributes other)
boolean	testMergeSelected(Attributes other, int... selection) Tests if mergeSelected(org.dcm4che3.data.Attributes, int...) would modify attributes, without actually modifying this attributes
boolean	testUpdate(Attributes newAttrs, Attributes modified)
boolean	testUpdateSelected(Attributes newAttrs, Attributes modified, int... selection) Tests if updateSelected(org.dcm4che3.data.Attributes, org.dcm4che3.data.Attributes, int...) would modify attributes, without actually modifying this attributes
String	toString()
String	toString(int limit, int maxWidth)
StringBuilder	toStringBuilder(int limit, int maxWidth, StringBuilder sb)
StringBuilder	toStringBuilder(StringBuilder sb)
void	trimToSize()
void	trimToSize(boolean recursive)
boolean	update(Attributes newAttrs, Attributes modified)
boolean	updateSelected(Attributes newAttrs, Attributes modified, int... selection) Add selected attributes from another Attributes object to this.
void	validate(IOD.DataElement el, ValidationResult result)
ValidationResult	validate(IOD iod)
void	writeGroupTo(DicomOutputStream out, int groupLengthTag)
void	writeItemTo(DicomOutputStream out)
void	writeTo(DicomOutputStream out)

Methods inherited from class java.lang.Object

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

Constructor Detail

Attributes

public Attributes()

Attributes

public Attributes(boolean bigEndian)

Attributes

public Attributes(int initialCapacity)

Attributes

public Attributes(boolean bigEndian,
          int initialCapacity)

Attributes

public Attributes(Attributes other)

Attributes

public Attributes(Attributes other,
          boolean bigEndian)

Attributes

public Attributes(Attributes other,
          int... selection)

Attributes

public Attributes(Attributes other,
          boolean bigEndian,
          int... selection)

Attributes

public Attributes(Attributes other,
          boolean bigEndian,
          Attributes selection)

Method Detail

getProperty

public Object getProperty(String key,
                 Object defVal)

setProperty

public Object setProperty(String key,
                 Object value)

clearProperty

public Object clearProperty(String key)

isRoot

public final boolean isRoot()

getLevel

public final int getLevel()

bigEndian

public final boolean bigEndian()

getParent

public final Attributes getParent()

getLength

public final int getLength()

getItemPosition

public final long getItemPosition()

setItemPosition

public final void setItemPosition(long itemPosition)

isEmpty

public final boolean isEmpty()

size

public final int size()

tags

public int[] tags()

trimToSize

public void trimToSize()

trimToSize

public void trimToSize(boolean recursive)

internalizeStringValues

public void internalizeStringValues(boolean decode)

getNestedDataset

public Attributes getNestedDataset(int sequenceTag)

getNestedDataset

public Attributes getNestedDataset(int sequenceTag,
                          int itemIndex)

getNestedDataset

public Attributes getNestedDataset(String privateCreator,
                          int sequenceTag)

getNestedDataset

public Attributes getNestedDataset(String privateCreator,
                          int sequenceTag,
                          int itemIndex)

getNestedDataset

public Attributes getNestedDataset(ItemPointer... itemPointers)

getSpecificCharacterSet

public SpecificCharacterSet getSpecificCharacterSet(VR vr)

contains

public boolean contains(int tag)

contains

public boolean contains(String privateCreator,
               int tag)

containsValue

public boolean containsValue(int tag)

containsValue

public boolean containsValue(String privateCreator,
                    int tag)

privateCreatorOf

public String privateCreatorOf(int tag)

getValue

public Object getValue(int tag)

getValue

public Object getValue(int tag,
              VR.Holder vr)

getValue

public Object getValue(String privateCreator,
              int tag)

getValue

public Object getValue(String privateCreator,
              int tag,
              VR.Holder vr)

getVR

public VR getVR(int tag)

getVR

public VR getVR(String privateCreator,
       int tag)

getSequence

public Sequence getSequence(int tag)

getSequence

public Sequence getSequence(String privateCreator,
                   int tag)

getBytes

public byte[] getBytes(int tag)
                throws IOException

Throws:

IOException

getBytes

public byte[] getBytes(String privateCreator,
              int tag)
                throws IOException

Throws:

IOException

getSafeBytes

public byte[] getSafeBytes(int tag)

getSafeBytes

public byte[] getSafeBytes(String privateCreator,
                  int tag)

getString

public String getString(int tag)

getString

public String getString(int tag,
               String defVal)

getString

public String getString(int tag,
               int valueIndex)

getString

public String getString(int tag,
               int valueIndex,
               String defVal)

getString

public String getString(String privateCreator,
               int tag)

getString

public String getString(String privateCreator,
               int tag,
               String defVal)

getString

public String getString(String privateCreator,
               int tag,
               VR vr)

getString

public String getString(String privateCreator,
               int tag,
               VR vr,
               String defVal)

getString

public String getString(String privateCreator,
               int tag,
               int valueIndex)

getString

public String getString(String privateCreator,
               int tag,
               int valueIndex,
               String defVal)

getString

public String getString(String privateCreator,
               int tag,
               VR vr,
               int valueIndex)

getString

public String getString(String privateCreator,
               int tag,
               VR vr,
               int valueIndex,
               String defVal)

getStrings

public String[] getStrings(int tag)

getStrings

public String[] getStrings(String privateCreator,
                  int tag)

getStrings

public String[] getStrings(String privateCreator,
                  int tag,
                  VR vr)

getInt

public int getInt(int tag,
         int defVal)

getInt

public int getInt(int tag,
         int valueIndex,
         int defVal)

getInt

public int getInt(String privateCreator,
         int tag,
         int defVal)

getInt

public int getInt(String privateCreator,
         int tag,
         VR vr,
         int defVal)

getInt

public int getInt(String privateCreator,
         int tag,
         int valueIndex,
         int defVal)

getInt

public int getInt(String privateCreator,
         int tag,
         VR vr,
         int valueIndex,
         int defVal)

getInts

public int[] getInts(int tag)

getInts

public int[] getInts(String privateCreator,
            int tag)

getInts

public int[] getInts(String privateCreator,
            int tag,
            VR vr)

getFloat

public float getFloat(int tag,
             float defVal)

getFloat

public float getFloat(int tag,
             int valueIndex,
             float defVal)

getFloat

public float getFloat(String privateCreator,
             int tag,
             float defVal)

getFloat

public float getFloat(String privateCreator,
             int tag,
             VR vr,
             float defVal)

getFloat

public float getFloat(String privateCreator,
             int tag,
             int valueIndex,
             float defVal)

getFloat

public float getFloat(String privateCreator,
             int tag,
             VR vr,
             int valueIndex,
             float defVal)

getFloats

public float[] getFloats(int tag)

getFloats

public float[] getFloats(String privateCreator,
                int tag)

getFloats

public float[] getFloats(String privateCreator,
                int tag,
                VR vr)

getDouble

public double getDouble(int tag,
               double defVal)

getDouble

public double getDouble(int tag,
               int valueIndex,
               double defVal)

getDouble

public double getDouble(String privateCreator,
               int tag,
               double defVal)

getDouble

public double getDouble(String privateCreator,
               int tag,
               VR vr,
               double defVal)

getDouble

public double getDouble(String privateCreator,
               int tag,
               int valueIndex,
               double defVal)

getDouble

public double getDouble(String privateCreator,
               int tag,
               VR vr,
               int valueIndex,
               double defVal)

getDoubles

public double[] getDoubles(int tag)

getDoubles

public double[] getDoubles(String privateCreator,
                  int tag)

getDoubles

public double[] getDoubles(String privateCreator,
                  int tag,
                  VR vr)

getDate

public Date getDate(int tag)

getDate

public Date getDate(int tag,
           DatePrecision precision)

getDate

public Date getDate(int tag,
           Date defVal)

getDate

public Date getDate(int tag,
           Date defVal,
           DatePrecision precision)

getDate

public Date getDate(int tag,
           int valueIndex)

getDate

public Date getDate(int tag,
           int valueIndex,
           DatePrecision precision)

getDate

public Date getDate(int tag,
           int valueIndex,
           Date defVal)

getDate

public Date getDate(int tag,
           int valueIndex,
           Date defVal,
           DatePrecision precision)

getDate

public Date getDate(String privateCreator,
           int tag)

getDate

public Date getDate(String privateCreator,
           int tag,
           DatePrecision precision)

getDate

public Date getDate(String privateCreator,
           int tag,
           Date defVal,
           DatePrecision precision)

getDate

public Date getDate(String privateCreator,
           int tag,
           VR vr)

getDate

public Date getDate(String privateCreator,
           int tag,
           VR vr,
           DatePrecision precision)

getDate

public Date getDate(String privateCreator,
           int tag,
           VR vr,
           Date defVal)

getDate

public Date getDate(String privateCreator,
           int tag,
           VR vr,
           Date defVal,
           DatePrecision precision)

getDate

public Date getDate(String privateCreator,
           int tag,
           int valueIndex)

getDate

public Date getDate(String privateCreator,
           int tag,
           int valueIndex,
           DatePrecision precision)

getDate

public Date getDate(String privateCreator,
           int tag,
           int valueIndex,
           Date defVal)

getDate

public Date getDate(String privateCreator,
           int tag,
           int valueIndex,
           Date defVal,
           DatePrecision precision)

getDate

public Date getDate(String privateCreator,
           int tag,
           VR vr,
           int valueIndex)

getDate

public Date getDate(String privateCreator,
           int tag,
           VR vr,
           int valueIndex,
           DatePrecision precision)

getDate

public Date getDate(String privateCreator,
           int tag,
           VR vr,
           int valueIndex,
           Date defVal)

getDate

public Date getDate(String privateCreator,
           int tag,
           VR vr,
           int valueIndex,
           Date defVal,
           DatePrecision precision)

getDate

public Date getDate(long tag)

getDate

public Date getDate(long tag,
           DatePrecision precision)

getDate

public Date getDate(long tag,
           Date defVal)

getDate

public Date getDate(long tag,
           Date defVal,
           DatePrecision precision)

getDate

public Date getDate(String privateCreator,
           long tag)

getDate

public Date getDate(String privateCreator,
           long tag,
           DatePrecision precision)

getDate

public Date getDate(String privateCreator,
           long tag,
           Date defVal)

getDate

public Date getDate(String privateCreator,
           long tag,
           Date defVal,
           DatePrecision precision)

getDates

public Date[] getDates(int tag)

getDates

public Date[] getDates(int tag,
              DatePrecisions precisions)

getDates

public Date[] getDates(String privateCreator,
              int tag)

getDates

public Date[] getDates(String privateCreator,
              int tag,
              DatePrecisions precisions)

getDates

public Date[] getDates(String privateCreator,
              int tag,
              VR vr)

getDates

public Date[] getDates(String privateCreator,
              int tag,
              VR vr,
              DatePrecisions precisions)

getDates

public Date[] getDates(long tag)

getDates

public Date[] getDates(long tag,
              DatePrecisions precisions)

getDates

public Date[] getDates(String privateCreator,
              long tag)

getDates

public Date[] getDates(String privateCreator,
              long tag,
              DatePrecisions precisions)

getDateRange

public DateRange getDateRange(int tag)

getDateRange

public DateRange getDateRange(int tag,
                     DateRange defVal)

getDateRange

public DateRange getDateRange(String privateCreator,
                     int tag)

getDateRange

public DateRange getDateRange(String privateCreator,
                     int tag,
                     DateRange defVal)

getDateRange

public DateRange getDateRange(String privateCreator,
                     int tag,
                     VR vr)

getDateRange

public DateRange getDateRange(String privateCreator,
                     int tag,
                     VR vr,
                     DateRange defVal)

getDateRange

public DateRange getDateRange(long tag)

getDateRange

public DateRange getDateRange(long tag,
                     DateRange defVal)

getDateRange

public DateRange getDateRange(String privateCreator,
                     long tag)

getDateRange

public DateRange getDateRange(String privateCreator,
                     long tag,
                     DateRange defVal)

setSpecificCharacterSet

public void setSpecificCharacterSet(String... codes)

Set Specific Character Set (0008,0005) to specified code(s) and re-encode contained LO, LT, PN, SH, ST, UT attributes accordingly.

Parameters:

codes - new value(s) of Specific Character Set (0008,0005)

getSpecificCharacterSet

public SpecificCharacterSet getSpecificCharacterSet()

setDefaultTimeZone

public void setDefaultTimeZone(TimeZone tz)

getDefaultTimeZone

public TimeZone getDefaultTimeZone()

getTimeZone

public TimeZone getTimeZone()

setTimezoneOffsetFromUTC

public void setTimezoneOffsetFromUTC(String utcOffset)

Set Timezone Offset From UTC (0008,0201) to specified value and adjust contained DA, DT and TM attributs accordingly

Parameters:

utcOffset - offset from UTC as (+|-)HHMM

setTimezone

public void setTimezone(TimeZone tz)

Set the Default Time Zone to specified value and adjust contained DA, DT and TM attributs accordingly. If the Time Zone does not use Daylight Saving Time, attribute Timezone Offset From UTC (0008,0201) will be also set accordingly. If the Time zone uses Daylight Saving Time, a previous existing attribute Timezone Offset From UTC (0008,0201) will be removed.

Parameters:

tz - Time Zone

See Also:

setDefaultTimeZone(TimeZone), setTimezoneOffsetFromUTC(String)

getPrivateCreator

public String getPrivateCreator(int tag)

remove

public Object remove(int tag)

remove

public Object remove(String privateCreator,
            int tag)

setNull

public Object setNull(int tag,
             VR vr)

setNull

public Object setNull(String privateCreator,
             int tag,
             VR vr)

setBytes

public Object setBytes(int tag,
              VR vr,
              byte[] b)

setBytes

public Object setBytes(String privateCreator,
              int tag,
              VR vr,
              byte[] b)

setString

public Object setString(int tag,
               VR vr,
               String s)

setString

public Object setString(String privateCreator,
               int tag,
               VR vr,
               String s)

setString

public Object setString(int tag,
               VR vr,
               String... ss)

setString

public Object setString(String privateCreator,
               int tag,
               VR vr,
               String... ss)

setInt

public Object setInt(int tag,
            VR vr,
            int... is)

setInt

public Object setInt(String privateCreator,
            int tag,
            VR vr,
            int... is)

setFloat

public Object setFloat(int tag,
              VR vr,
              float... fs)

setFloat

public Object setFloat(String privateCreator,
              int tag,
              VR vr,
              float... fs)

setDouble

public Object setDouble(int tag,
               VR vr,
               double... ds)

setDouble

public Object setDouble(String privateCreator,
               int tag,
               VR vr,
               double... ds)

setDate

public Object setDate(int tag,
             VR vr,
             Date... ds)

setDate

public Object setDate(int tag,
             VR vr,
             DatePrecision precision,
             Date... ds)

setDate

public Object setDate(String privateCreator,
             int tag,
             VR vr,
             Date... ds)

setDate

public Object setDate(String privateCreator,
             int tag,
             VR vr,
             DatePrecision precision,
             Date... ds)

setDate

public void setDate(long tag,
           Date dt)

setDate

public void setDate(long tag,
           DatePrecision precision,
           Date dt)

setDate

public void setDate(String privateCreator,
           long tag,
           Date dt)

setDate

public void setDate(String privateCreator,
           long tag,
           DatePrecision precision,
           Date dt)

setDateRange

public Object setDateRange(int tag,
                  VR vr,
                  DateRange range)

setDateRange

public Object setDateRange(String privateCreator,
                  int tag,
                  VR vr,
                  DateRange range)

setDateRange

public void setDateRange(long tag,
                DateRange dr)

setDateRange

public void setDateRange(String privateCreator,
                long tag,
                DateRange range)

setValue

public Object setValue(int tag,
              VR vr,
              Object value)

setValue

public Object setValue(String privateCreator,
              int tag,
              VR vr,
              Object value)

newSequence

public Sequence newSequence(int tag,
                   int initialCapacity)

newSequence

public Sequence newSequence(String privateCreator,
                   int tag,
                   int initialCapacity)

ensureSequence

public Sequence ensureSequence(int tag,
                      int initialCapacity)

ensureSequence

public Sequence ensureSequence(String privateCreator,
                      int tag,
                      int initialCapacity)

newFragments

public Fragments newFragments(int tag,
                     VR vr,
                     int initialCapacity)

newFragments

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

addAll

public boolean addAll(Attributes other)

merge

public boolean merge(Attributes other)

testMerge

public boolean testMerge(Attributes other)

addSelected

public boolean addSelected(Attributes other,
                  Attributes selection)

addSelected

public boolean addSelected(Attributes other,
                  String privateCreator,
                  int tag)

addSelected

public boolean addSelected(Attributes other,
                  int... selection)

Add selected attributes from another Attributes object to this. The specified array of tag values must be sorted (as by the Arrays.sort(int[]) method) prior to making this call.

Parameters:

other - the other Attributes object

selection - sorted tag values

Returns:

true if one ore more attributes were added

addSelected

public boolean addSelected(Attributes other,
                  int[] selection,
                  int fromIndex,
                  int toIndex)

Add selected attributes from another Attributes object to this. The specified array of tag values must be sorted (as by the Arrays.sort(int[], int, int) method) prior to making this call.

Parameters:

other - the other Attributes object

selection - sorted tag values

fromIndex - the index of the first tag (inclusive)

toIndex - the index of the last tag (exclusive)

Returns:

true if one ore more attributes were added

mergeSelected

public boolean mergeSelected(Attributes other,
                    int... selection)

Merge selected attributes from another Attributes object into this. Does not overwrite existing non-empty attributes. The specified array of tag values must be sorted (as by the Arrays.sort(int[]) method) prior to making this call.

Parameters:

other - the other Attributes object

selection - sorted tag values

Returns:

true if one ore more attributes were added

testMergeSelected

public boolean testMergeSelected(Attributes other,
                        int... selection)

Tests if mergeSelected(org.dcm4che3.data.Attributes, int...) would modify attributes, without actually modifying this attributes

Parameters:

other - the other Attributes object

selection - sorted tag values

Returns:

true if one ore more attributes would have been added

addNotSelected

public boolean addNotSelected(Attributes other,
                     int... selection)

Add not selected attributes from another Attributes object to this. The specified array of tag values must be sorted (as by the Arrays.sort(int[]) method) prior to making this call.

Parameters:

other - the other Attributes object

selection - sorted tag values

Returns:

true if one ore more attributes were added

addNotSelected

public boolean addNotSelected(Attributes other,
                     int[] selection,
                     int fromIndex,
                     int toIndex)

Add not selected attributes from another Attributes object to this. The specified array of tag values must be sorted (as by the Arrays.sort(int[]) method) prior to making this call.

Parameters:

other - the other Attributes object

selection - sorted tag values

fromIndex - the index of the first tag (inclusive)

toIndex - the index of the last tag (exclusive)

Returns:

true if one ore more attributes were added

update

public boolean update(Attributes newAttrs,
             Attributes modified)

testUpdate

public boolean testUpdate(Attributes newAttrs,
                 Attributes modified)

updateSelected

public boolean updateSelected(Attributes newAttrs,
                     Attributes modified,
                     int... selection)

Add selected attributes from another Attributes object to this. Optionally, the original values of overwritten existing non-empty attributes are preserved in another Attributes object. The specified array of tag values must be sorted (as by the Arrays.sort(int[]) method) prior to making this call.

Parameters:

newAttrs - the other Attributes object

modified - Attributes object to collect overwritten non-empty attributes with original values or null

includes - sorted tag values

Returns:

true if one ore more attribute were added or overwritten with a different value

testUpdateSelected

public boolean testUpdateSelected(Attributes newAttrs,
                         Attributes modified,
                         int... selection)

Tests if updateSelected(org.dcm4che3.data.Attributes, org.dcm4che3.data.Attributes, int...) would modify attributes, without actually modifying this attributes

Parameters:

newAttrs - the other Attributes object

modified - Attributes object to collect overwritten non-empty attributes with original values or null

includes - sorted tag values

Returns:

true if one ore more attribute would be added or overwritten with a different value

equals

public boolean equals(Object o)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

toString

public String toString()

Overrides:

toString in class Object

toString

public String toString(int limit,
              int maxWidth)

toStringBuilder

public StringBuilder toStringBuilder(StringBuilder sb)

toStringBuilder

public StringBuilder toStringBuilder(int limit,
                            int maxWidth,
                            StringBuilder sb)

calcLength

public int calcLength(DicomEncodingOptions encOpts,
             boolean explicitVR)

writeTo

public void writeTo(DicomOutputStream out)
             throws IOException

Throws:

IOException

writeItemTo

public void writeItemTo(DicomOutputStream out)
                 throws IOException

Throws:

IOException

accept

public boolean accept(Attributes.Visitor visitor,
             boolean visitNestedDatasets)
               throws Exception

Invokes Visitor.visit for each attribute in this instance. The operation will be aborted if visitor.visit() returns false.

Parameters:

visitor -

visitNestedDatasets - controls if visitor.visit() is also invoked for attributes in nested datasets

Returns:

true if the operation was not aborted.

Throws:

Exception

writeGroupTo

public void writeGroupTo(DicomOutputStream out,
                int groupLengthTag)
                  throws IOException

Throws:

IOException

createFileMetaInformation

public Attributes createFileMetaInformation(String tsuid)

createFileMetaInformation

public static Attributes createFileMetaInformation(String iuid,
                                   String cuid,
                                   String tsuid)

matches

public boolean matches(Attributes keys,
              boolean ignorePNCase,
              boolean matchNoValue)

validate

public ValidationResult validate(IOD iod)

validate

public void validate(IOD.DataElement el,
            ValidationResult result)