Struct DumpOptions

#[non_exhaustive]
pub struct DumpOptions {
    pub format: DumpFormat,
    pub color: ColorMode,
    pub width: Option<u32>,
    pub no_text_limit: bool,
    pub no_limit: bool,
}

Options and flags to configure how to dump a DICOM file or object.

This is a builder which exposes the various options available for printing the contents of the DICOM file in a readable way.

Once set up, the dump_file or dump_file_to methods can be used to finalize the DICOM data dumping process on an open file. Both file meta table and main data set are dumped. Alternatively, dump_object or dump_object_to methods work on bare DICOM objects without a file meta table.

Example

use dicom_object::open_file;
use dicom_dump::{ColorMode, DumpOptions};

let my_dicom_file = open_file("/path_to_file")?;
let mut options = DumpOptions::new();
options
    // maximum 120 characters per line
    .width(120)
    // no limit for text values
    .no_text_limit(true)
    // never print colored output
    .color_mode(ColorMode::Never)
    // dump to stdout
    .dump_file(&my_dicom_file)?;

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

format: DumpFormat

the output format

color: ColorMode

whether to produce colored output

width: Option<u32>

the console width to assume when trimming long values

no_text_limit: bool

never trim out long text values

no_limit: bool

never trim out any values (implies no_text_limit)

Implementations

impl DumpOptions

pub fn new() -> Self

pub fn format(&mut self, format: DumpFormat) -> &mut Self

Set the output format.

See the DumpFormat documentation for the list of supported formats.

pub fn width(&mut self, width: u32) -> &mut Self

Set the maximum output width in number of characters.

The methods dump_file_to and dump_object_to, will print everything to the end, regardless of this option.

pub fn width_auto(&mut self) -> &mut Self

Set the maximum output width to automatic, based on terminal size.

This is the default behavior. If a terminal width could not be determined, the default width of 120 characters is used.

The methods dump_file_to and dump_object_to, will print everything to the end, regardless of this option.

pub fn no_text_limit(&mut self, no_text_limit: bool) -> &mut Self

Set whether to remove the maximum width restriction for text values.

pub fn no_limit(&mut self, no_limit: bool) -> &mut Self

Set whether to remove the maximum width restriction for all DICOM values.

pub fn color_mode(&mut self, color: ColorMode) -> &mut Self

Set the output color mode.

pub fn dump_file<D>( &self, obj: &FileDicomObject<InMemDicomObject<D>>, ) -> IoResult<()>

where D: DataDictionary,

Dump the contents of an open DICOM file to standard output.

pub fn dump_file_to<D>( &self, to: impl Write, obj: &FileDicomObject<InMemDicomObject<D>>, ) -> IoResult<()>

where D: DataDictionary,

Dump the contents of an open DICOM file to the given writer.

pub fn dump_object<D>(&self, obj: &InMemDicomObject<D>) -> IoResult<()>

where D: DataDictionary,

Dump the contents of a DICOM object to standard output.

pub fn dump_object_to<D>( &self, to: impl Write, obj: &InMemDicomObject<D>, ) -> IoResult<()>

where D: DataDictionary,

Dump the contents of a DICOM object to the given writer.

Trait Implementations

impl Clone for DumpOptions

fn clone(&self) -> DumpOptions

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DumpOptions

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

Formats the value using the given formatter.

impl Default for DumpOptions

fn default() -> DumpOptions

Returns the “default value” for a type.

impl PartialEq for DumpOptions

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