Struct dicom_encoding::transfer_syntax::TransferSyntax

pub struct TransferSyntax<A = DynDataRWAdapter> { /* fields omitted */ }

A DICOM transfer syntax specifier. The data RW adapter A specifies custom codec capabilities when required.

Implementations

impl<A> TransferSyntax<A>

pub const fn new(
    uid: &'static str,
    name: &'static str,
    byte_order: Endianness,
    explicit_vr: bool,
    codec: Codec<A>
) -> Self

Create a new transfer syntax descriptor.

• Note that only transfer syntax implementors are expected to construct
• TS descriptors from scratch. For a practical usage of transfer syntaxes,
• one should look up an existing transfer syntax registry by UID.

pub const fn uid(&self) -> &'static str

Obtain this transfer syntax' unique identifier.

pub const fn name(&self) -> &'static str

Obtain the name of this transfer syntax.

pub const fn endianness(&self) -> Endianness

Obtain this transfer syntax' expected endianness.

pub fn codec(&self) -> &Codec<A>

Obtain this transfer syntax' codec specification.

pub fn fully_supported(&self) -> bool

Check whether this transfer syntax specifier provides a complete implementation.

pub fn unsupported(&self) -> bool

Check whether reading and writing of data sets is unsupported. If this is true, encoding and decoding will not be available.

pub fn unsupported_pixel_encapsulation(&self) -> bool

Check whether reading and writing the pixel data is unsupported. If this is true, encoding and decoding of the data set will still be possible, but the pixel data will only be available in its encapsulated form.

pub fn decoder<'s>(&self) -> Option<DynDecoder<dyn Read + 's>>

Retrieve the appropriate data element decoder for this transfer syntax. Can yield none if decoding is not supported.

The resulting decoder does not consider pixel data encapsulation or data set compression rules. This means that the consumer of this method needs to adapt the reader before using the decoder.

pub fn decoder_for<S: ?Sized>(&self) -> Option<DynDecoder<S>> where
    Self: Sized,
    S: Read, 

Retrieve the appropriate data element decoder for this transfer syntax and given reader type (this method is not object safe). Can yield none if decoding is not supported.

The resulting decoder does not consider pixel data encapsulation or data set compression rules. This means that the consumer of this method needs to adapt the reader before using the decoder.

pub fn encoder<'w>(&self) -> Option<DynEncoder<'w, dyn Write + 'w>>

Retrieve the appropriate data element encoder for this transfer syntax. Can yield none if encoding is not supported. The resulting encoder does not consider pixel data encapsulation or data set compression rules.

pub fn encoder_for<'w, W: 'w + ?Sized>(&self) -> Option<DynEncoder<'w, W>> where
    Self: Sized,
    W: Write, 

Retrieve the appropriate data element encoder for this transfer syntax and the given writer type (this method is not object safe). Can yield none if encoding is not supported. The resulting encoder does not consider pixel data encapsulation or data set compression rules.

pub fn basic_decoder(&self) -> BasicDecoder

Obtain a dynamic basic decoder, based on this transfer syntax' expected endianness.

pub fn erased(self) -> TransferSyntax where
    A: Send + Sync + 'static,
    A: DataRWAdapter<Box<dyn Read>, Box<dyn Write>, Reader = Box<dyn Read>, Writer = Box<dyn Write>>, 

Type-erase the pixel data or data set codec.

Trait Implementations

impl<A: Debug> Debug for TransferSyntax<A>

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

Formats the value using the given formatter.