public abstract class OtherAttributeOnDisk extends Attribute
An abstract class specializing Attribute
for
Other (OB or OW) attributes whose values are not memory resident.
Used as a base class for OtherByteAttributeOnDisk
and OtherWordAttributeOnDisk
.
Modifier and Type | Field and Description |
---|---|
protected long |
byteOffset |
protected boolean |
deleteFilesWhenNoLongerNeeded |
protected File |
file |
valueLength, valueMultiplicity
Constructor and Description |
---|
OtherAttributeOnDisk(AttributeTag t)
Construct an (empty) attribute.
|
OtherAttributeOnDisk(AttributeTag t,
File file,
boolean deleteFilesWhenNoLongerNeeded)
Read an attribute from a file.
|
OtherAttributeOnDisk(AttributeTag t,
long vl,
DicomInputStream i,
long byteOffset)
Read an attribute from an input stream.
|
OtherAttributeOnDisk(AttributeTag t,
Long vl,
DicomInputStream i,
Long byteOffset)
Read an attribute from an input stream.
|
Modifier and Type | Method and Description |
---|---|
void |
deleteFilesWhenNoLongerNeeded() |
protected void |
finalize() |
long |
getByteOffset() |
File |
getFile() |
void |
removeValues()
Remove any existing values, making the attribute empty (zero length).
|
void |
setFile(File file)
Change the file containing the data, for example if it has been renamed.
|
void |
setFile(File file,
long byteOffset)
Change the file containing the data, for example if it is a new, perhaps temporary, file containing only pixel data.
|
String |
toString(DicomDictionary dictionary)
Dump the contents of the attribute as a human-readable string.
|
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, getVR, getVRAsString, isValid, repairValues, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValues, setValues, setValues, setValues, setValues, setValues, setValues, toString, write, writeBase
protected long byteOffset
protected boolean deleteFilesWhenNoLongerNeeded
protected File file
public OtherAttributeOnDisk(AttributeTag t)
Construct an (empty) attribute.
t
- the tag of the attributepublic OtherAttributeOnDisk(AttributeTag t, File file, boolean deleteFilesWhenNoLongerNeeded) throws IOException, DicomException
Read an attribute from a file.
t
- the tag of the attributefile
- the file containing the datadeleteFilesWhenNoLongerNeeded
- delete file when attribute goes out of scopeIOException
- if an I/O error occursDicomException
- if error in DICOM encodingpublic OtherAttributeOnDisk(AttributeTag t, long vl, DicomInputStream i, long byteOffset) throws IOException, DicomException
Read an attribute from an input stream.
t
- the tag of the attributevl
- the value length of the attributei
- the input streambyteOffset
- the byte offset in the input stream of the start of the dataIOException
- if an I/O error occursDicomException
- if error in DICOM encodingpublic OtherAttributeOnDisk(AttributeTag t, Long vl, DicomInputStream i, Long byteOffset) throws IOException, DicomException
Read an attribute from an input stream.
t
- the tag of the attributevl
- the value length of the attributei
- the input streambyteOffset
- the byte offset in the input stream of the start of the dataIOException
- if an I/O error occursDicomException
- if error in DICOM encodingpublic void deleteFilesWhenNoLongerNeeded()
protected void finalize() throws Throwable
public long getByteOffset()
public File getFile()
public void removeValues()
Attribute
Remove any existing values, making the attribute empty (zero length).
removeValues
in class Attribute
public void setFile(File file)
Change the file containing the data, for example if it has been renamed.
The existing byteOffset value is unchanged.
file
- the new file containing the datapublic void setFile(File file, long byteOffset) throws IOException
Change the file containing the data, for example if it is a new, perhaps temporary, file containing only pixel data.
The value length is set to the length of the file minus the byteOffset.
file
- the new file containing the databyteOffset
- the byte offset in the input stream of the start of the dataIOException
- if cannot obtain the length of the filepublic String toString(DicomDictionary dictionary)
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>