Struct dicom_encoding::transfer_syntax::TransferSyntax

pub struct TransferSyntax<D = DynDataRWAdapter, P = DynPixelRWAdapter> { /* private fields */ }

A DICOM transfer syntax specifier.

Custom encoding and decoding capabilities are defined via the parameter types D and P, The type parameter D specifies an adapter for reading and writing data sets, whereas P specifies the encoder and decoder of encapsulated pixel data.

This type is usually consumed in its “type erased” form, with its default parameter types. On the other hand, implementers of TransferSyntax will typically specify concrete types for D and P, which are type-erased before registration. If the transfer syntax requires no data set codec, D can be assigned to the utility type NeverAdapter.

Implementations

impl<D, P> TransferSyntax<D, P>

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

Create a new transfer syntax descriptor.

Note that only transfer syntax implementers 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.

Example

To register a private transfer syntax in your program, use submit_transfer_syntax outside of a function body:

submit_transfer_syntax! {
    TransferSyntax::<NeverAdapter, NeverPixelAdapter>::new(
        "1.3.46.670589.33.1.4.1",
        "CT-Private-ELE",
        Endianness::Little,
        true,
        Codec::EncapsulatedPixelData,
    )
}

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<D, P>

Obtain this transfer syntax’ codec specification.

pub fn fully_supported(&self) -> bool

Check whether this transfer syntax specifier provides a complete implementation.

pub fn is_codec_free(&self) -> bool

Check whether no codecs are required for this transfer syntax, meaning that a complete implementation is available and no pixel data conversion is required.

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>(&self) -> Option<DynDecoder<S>> where
    Self: Sized,
    S: ?Sized + 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>(&self) -> Option<DynEncoder<'w, W>> where
    Self: Sized,
    W: ?Sized + 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
    D: Send + Sync + 'static,
    D: DataRWAdapter<Box<dyn Read>, Box<dyn Write>, Reader = Box<dyn Read>, Writer = Box<dyn Write>>,
    P: Send + Sync + 'static,
    P: PixelRWAdapter, 

Type-erase the pixel data or data set codec.

Trait Implementations

impl<D: Debug, P: Debug> Debug for TransferSyntax<D, P>

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

Formats the value using the given formatter.