Struct FileDicomObject

pub struct FileDicomObject<O> { /* private fields */ }

A root DICOM object retrieved from a standard DICOM file, containing additional information from the file meta group in a separate table value.

Implementations

impl FileDicomObject<InMemDicomObject<StandardDataDictionary>>

pub fn open_file<P: AsRef<Path>>(path: P) -> Result<Self, ReadError>

Create a DICOM object by reading from a file.

This function assumes the standard file encoding structure: first it automatically detects whether the 128-byte preamble is present, skipping it if found. Then it reads the file meta group, followed by the rest of the data set.

pub fn from_reader<S>(src: S) -> Result<Self, ReadError>

where S: Read,

Create a DICOM object by reading from a byte source.

This function assumes the standard file encoding structure: first it automatically detects whether the 128-byte preamble is present, skipping it if found. Then it reads the file meta group, followed by the rest of the data set.

impl<D> FileDicomObject<InMemDicomObject<D>>

where D: DataDictionary + Clone,

pub fn new_empty_with_dict_and_meta(dict: D, meta: FileMetaTable) -> Self

Create a new empty object, using the given dictionary and file meta table.

pub fn open_file_with_dict<P: AsRef<Path>>( path: P, dict: D, ) -> Result<Self, ReadError>

Create a DICOM object by reading from a file.

This function assumes the standard file encoding structure: first it automatically detects whether the 128-byte preamble is present, skipping it when found. Then it reads the file meta group, followed by the rest of the data set.

pub fn open_file_with<P, R>( path: P, dict: D, ts_index: R, ) -> Result<Self, ReadError>

where P: AsRef<Path>, R: TransferSyntaxIndex,

Create a DICOM object by reading from a file.

This function assumes the standard file encoding structure: first it automatically detects whether the 128-byte preamble is present, skipping it when found. Then it reads the file meta group, followed by the rest of the data set.

This function allows you to choose a different transfer syntax index, but its use is only advised when the built-in transfer syntax registry is insufficient. Otherwise, please use open_file_with_dict instead.

pub fn from_reader_with_dict<S>(src: S, dict: D) -> Result<Self, ReadError>

where S: Read,

Create a DICOM object by reading from a byte source.

This function assumes the standard file encoding structure: first it automatically detects whether the 128-byte preamble is present, skipping it when found. Then it reads the file meta group, followed by the rest of the data set.

pub fn from_reader_with<'s, S, R>( src: S, dict: D, ts_index: R, ) -> Result<Self, ReadError>

where S: Read + 's, R: TransferSyntaxIndex,

Create a DICOM object by reading from a byte source.

This function assumes the standard file encoding structure: first it automatically detects whether the preamble is present, skipping it when found. Then it reads the file meta group, followed by the rest of the data set.

This function allows you to choose a different transfer syntax index, but its use is only advised when the built-in transfer syntax registry is insufficient. Otherwise, please use from_reader_with_dict instead.

impl FileDicomObject<InMemDicomObject<StandardDataDictionary>>

pub fn new_empty_with_meta(meta: FileMetaTable) -> Self

Create a new empty object, using the given file meta table.

impl<O> FileDicomObject<O>

pub fn meta(&self) -> &FileMetaTable

Retrieve the processed meta header table.

pub fn meta_mut(&mut self) -> &mut FileMetaTable

Retrieve a mutable reference to the processed meta header table.

Considerable care should be taken when modifying this table, as it may influence object reading and writing operations. When modifying the table through this method, the user is responsible for updating the meta information group length as well, which can be done by calling update_information_group_length.

See also update_meta.

pub fn update_meta(&mut self, f: impl FnOnce(&mut FileMetaTable))

Update the processed meta header table through a function.

Considerable care should be taken when modifying this table, as it may influence object reading and writing operations. The meta information group length is updated automatically.

pub fn into_inner(self) -> O

Retrieve the inner DICOM object structure, discarding the meta table.

impl<O> FileDicomObject<O>

where for<'a> &'a O: IntoTokens,

pub fn write_to_file<P: AsRef<Path>>(&self, path: P) -> Result<(), WriteError>

Write the entire object as a DICOM file into the given file path. Preamble, magic code, and file meta group will be included before the inner object.

pub fn write_all<W: Write>(&self, to: W) -> Result<(), WriteError>

Write the entire object as a DICOM file into the given writer. Preamble, magic code, and file meta group will be included before the inner object.

pub fn write_meta<W: Write>(&self, to: W) -> Result<(), WriteError>

Write the file meta group set into the given writer.

This is equivalent to self.meta().write(to).

pub fn write_dataset<W: Write>(&self, to: W) -> Result<(), WriteError>

Write the inner data set into the given writer, without preamble, magic code, nor file meta group.

The transfer syntax is selected from the file meta table.

Trait Implementations

impl<T> ApplyOp for FileDicomObject<T>

where T: ApplyOp<Err = ApplyError>,

fn apply(&mut self, op: AttributeOp) -> ApplyResult

Apply the given attribute operation on this object.

The operation is delegated to the file meta table if the selector root tag is in group 0002, and to the underlying object otherwise.

See the dicom_core::ops module for more information.

type Err = ApplyError

The operation error type

impl<O: Clone> Clone for FileDicomObject<O>

fn clone(&self) -> FileDicomObject<O>

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<O: Debug> Debug for FileDicomObject<O>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<O> Deref for FileDicomObject<O>

type Target = O

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl<O> DerefMut for FileDicomObject<O>

fn deref_mut(&mut self) -> &mut Self::Target

Mutably dereferences the value.

impl<'a, O> DicomObject for &'a FileDicomObject<O>

where O: DicomObject + 'a,

type Element = <O as DicomObject>::Element

fn element(&self, tag: Tag) -> Result<Self::Element, AccessError>

Retrieve a particular DICOM element by its tag.

fn element_by_name( &self, name: &str, ) -> Result<Self::Element, AccessByNameError>

Retrieve a particular DICOM element by its name.

fn meta(&self) -> Option<&FileMetaTable>

Retrieve the processed meta information table, if available.

impl<O> DicomObject for FileDicomObject<O>

where O: DicomObject,

type Element = <O as DicomObject>::Element

fn element(&self, tag: Tag) -> Result<Self::Element, AccessError>

Retrieve a particular DICOM element by its tag.

fn element_by_name( &self, name: &str, ) -> Result<Self::Element, AccessByNameError>

Retrieve a particular DICOM element by its name.

fn meta(&self) -> Option<&FileMetaTable>

Retrieve the processed meta information table, if available.

impl<'a, O> IntoIterator for &'a FileDicomObject<O>

where &'a O: IntoIterator,

This implementation creates an iterator to the elements of the underlying data set. The attributes in the file meta group are not included.

To obtain an iterator over the meta elements, use meta().to_element_iter().

type Item = <&'a O as IntoIterator>::Item

The type of the elements being iterated over.

type IntoIter = <&'a O as IntoIterator>::IntoIter

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl<O> IntoIterator for FileDicomObject<O>

where O: IntoIterator,

This implementation creates an iterator to the elements of the underlying data set, consuming the whole object. The attributes in the file meta group are not included.

To obtain an iterator over the meta elements, use meta().to_element_iter().

type Item = <O as IntoIterator>::Item

The type of the elements being iterated over.

type IntoIter = <O as IntoIterator>::IntoIter

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl<O: PartialEq> PartialEq for FileDicomObject<O>

fn eq(&self, other: &FileDicomObject<O>) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<D> PixelDataObject for FileDicomObject<InMemDicomObject<D>>

where D: DataDictionary + Clone,

Implement basic pixeldata encoder/decoder functionality

fn rows(&self) -> Option<u16>

Return the Rows attribute or None if it is not found

fn cols(&self) -> Option<u16>

Return the Columns attribute or None if it is not found

fn samples_per_pixel(&self) -> Option<u16>

Return the SamplesPerPixel attribute or None if it is not found

fn bits_allocated(&self) -> Option<u16>

Return the BitsAllocated attribute or None if it is not set

fn bits_stored(&self) -> Option<u16>

Return the BitsStored attribute or None if it is not set

fn number_of_frames(&self) -> Option<u32>

Return the NumberOfFrames attribute or None if it is not set

fn number_of_fragments(&self) -> Option<u32>

Returns the number of fragments or None for native pixel data

fn fragment(&self, fragment: usize) -> Option<Cow<'_, [u8]>>

Return a specific encoded pixel fragment by index as a Vec<u8> or None if no pixel data is found.

Non-encapsulated pixel data can be retrieved by requesting fragment #0.

Panics if fragment is out of bounds for the encapsulated pixel data fragments.

fn raw_pixel_data(&self) -> Option<RawPixelData>

Should return either a byte slice/vector if native pixel data or byte fragments if encapsulated. Returns None if no pixel data is found

fn transfer_syntax_uid(&self) -> &str

Return the object’s transfer syntax UID.

fn photometric_interpretation(&self) -> Option<&str>

Return the Photometric Interpretation, with trailing whitespace removed, or None if it is not defined

fn offset_table(&self) -> Option<Cow<'_, [u32]>>

Return the object’s offset table, or None if no offset table is available.

impl<O> StructuralPartialEq for FileDicomObject<O>