Struct PixelFragmentSequence

pub struct PixelFragmentSequence<P> { /* private fields */ }

A sequence of pixel data fragments.

Each fragment (of data type P) is an even-lengthed sequence of bytes representing the encoded pixel data. The first item of the sequence is interpreted as a basic offset table, which is defined separately.

Implementations

impl<P> PixelFragmentSequence<P>

pub fn new(offset_table: impl Into<C<u32>>, fragments: impl Into<C<P>>) -> Self

Construct a DICOM pixel sequence sequence value from a basic offset table and a list of fragments.

Note: This function does not validate the offset table against the given fragments.

pub fn new_fragments(fragments: impl Into<C<P>>) -> Self

Construct a DICOM pixel sequence sequence value from a list of fragments, with an empty basic offset table.

pub fn fragments(&self) -> &[P]

Gets a reference to the pixel data fragments.

This sequence does not include the offset table.

pub fn fragments_mut(&mut self) -> &mut C<P>

Gets a mutable reference to the pixel data fragments.

This sequence does not include the offset table.

pub fn into_fragments(self) -> C<P>

Retrieve the pixel data fragments, discarding the rest of the information.

This sequence does not include the offset table.

pub fn into_parts(self) -> (C<u32>, C<P>)

Decompose the sequence into its constituent parts: the basic offset table and the pixel data fragments.

pub fn offset_table(&self) -> &[u32]

Gets a reference to the encapsulated pixel data’s offset table.

pub fn offset_table_mut(&mut self) -> &mut C<u32>

Gets a mutable reference to the encapsulated pixel data’s offset table.

pub fn length(&self) -> Length

Get the value data’s length as specified by the sequence’s data element, in bytes.

This is equivalent to HasLength::length.

pub fn truncate(&mut self, limit: usize)

Shorten this sequence by removing trailing fragments to fit the given limit.

Note that this operations does not affect the basic offset table.

Trait Implementations

impl<P: Clone> Clone for PixelFragmentSequence<P>

fn clone(&self) -> PixelFragmentSequence<P>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<P: Debug> Debug for PixelFragmentSequence<P>

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

Formats the value using the given formatter.

impl<P> DicomValueType for PixelFragmentSequence<P>

fn value_type(&self) -> ValueType

Retrieve the specific type of this value.

fn cardinality(&self) -> usize

Retrieve the number of elements contained in the DICOM value.

impl<T, F, P> From<(T, F)> for PixelFragmentSequence<P>

where T: Into<C<u32>>, F: Into<C<P>>,

fn from((offset_table, fragments): (T, F)) -> Self

Construct a pixel data fragment sequence, interpreting the first tuple element as a basic offset table and the second element as the vector of fragments.

Note: This function does not validate the offset table against the given fragments.

impl<I, P> From<PixelFragmentSequence<P>> for Value<I, P>

fn from(value: PixelFragmentSequence<P>) -> Self

Converts to this type from the input type.

impl From<Vec<Fragments>> for PixelFragmentSequence<InMemFragment>

fn from(value: Vec<Fragments>) -> Self

Converts to this type from the input type.

impl<P> HasLength for PixelFragmentSequence<P>

fn length(&self) -> Length

In standard DICOM, encapsulated pixel data is always defined by a pixel data element with an undefined length.

fn is_empty(&self) -> bool

Check whether the value is empty (0 length).

impl<P: PartialEq> PartialEq for PixelFragmentSequence<P>

fn eq(&self, other: &PixelFragmentSequence<P>) -> 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<P> StructuralPartialEq for PixelFragmentSequence<P>