Package com.pixelmed.dicom

Class UnknownAttribute

java.lang.Object
com.pixelmed.dicom.Attribute
com.pixelmed.dicom.UnknownAttribute
Direct Known Subclasses:
TestPrivateCreatorValueRepresentation.OurUnknownAttribute, TestUnknownSequenceValueRepresentation.OurUnknownAttribute
public class UnknownAttribute extends Attribute

A concrete class specializing Attribute for Unknown (UN) attributes.

Though an instance of this class may be created using its constructors, there is also a factory class, AttributeFactory.

See Also:

  • Field Details

    • originalLittleEndianByteValues

      protected byte[] originalLittleEndianByteValues

  • Constructor Details

  • Method Details

    • 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

    • 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

    • 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

    • getVR

      public byte[] getVR()

      Get the value representation of this attribute (UN).

      Overrides:
      getVR in class Attribute
      Returns:
      'U','U' in ASCII as a two byte array; see ValueRepresentation

    • setValues

      public void setValues(byte[] v) throws DicomException
      Description copied from class: Attribute
      Replace any existing values with the supplied array of byte.
      Overrides:
      setValues in class Attribute
      Parameters:
      v -
      Throws:
      DicomException

    • setValues

      public void setValues(byte[] v, boolean big) throws DicomException
      Description copied from class: Attribute
      Replace any existing values with the supplied array of byte, accounting for byte ordering of values that are larger than one byte.
      Overrides:
      setValues in class Attribute
      Parameters:
      v -
      big -
      Throws:
      DicomException

    • getByteValues

      public byte[] getByteValues()

      Get the values of this attribute as a byte array.

      Always to be interpreted as little endian, per the DICOM definition of UN, regardless of the received transfer syntax.

      Overrides:
      getByteValues in class Attribute
      Returns:
      the values as an array of bytes

    • getByteValues

      public byte[] getByteValues(boolean big) throws DicomException
      Description copied from class: Attribute

      Get the values of this attribute as a byte array, accounting for byte ordering of values that are larger than one byte.

      Overrides:
      getByteValues in class Attribute
      Parameters:
      big - whether or not to intepret the values larger than bytes as big endian or not
      Returns:
      the values as an array of bytes
      Throws:
      DicomException

    • getStringValues

      public String[] getStringValues(NumberFormat format) throws DicomException

      Get the values of this attribute as strings.

      Assumes the caller knows that the UN VR is really a valid string (e.g., knows the VR of a private attribute).

      Assumes ASCII encoding (i.e., does not consider SpecificCharacterSet).

      The strings are first cleaned up into a canonical form, to remove leading and trailing padding.

      Overrides:
      getStringValues in class Attribute
      Parameters:
      format - the format to use for each numerical or decimal value - ignored
      Returns:
      the values as an array of String
      Throws:
      DicomException - not thrown

    • getDoubleValues

      public double[] getDoubleValues() throws DicomException

      Get the values of this attribute as doubles.

      Assumes the caller knows that the UN VR is really a valid FD (e.g., knows the VR of a private attribute).

      Overrides:
      getDoubleValues in class Attribute
      Returns:
      the values as an array of double
      Throws:
      DicomException

    • getFloatValues

      public float[] getFloatValues() throws DicomException

      Get the values of this attribute as floats.

      Assumes the caller knows that the UN VR is really a valid FL (e.g., knows the VR of a private attribute).

      Overrides:
      getFloatValues in class Attribute
      Returns:
      the values as an array of float
      Throws:
      DicomException