Enum Unit 

pub enum Unit {
    Micron,
    Millimeter,
    Centimeter,
    Inch,
    Foot,
    Meter,
}

Units of measurement for the 3MF model.

Defines how vertex coordinates and dimensions are interpreted in real-world measurements. The unit applies to all geometric coordinates in the model (vertices, transformations, radii, etc.).

Per the 3MF specification, the default unit is Millimeter if not specified.

Examples

use lib3mf_core::model::Unit;

// Default is millimeter
let unit = Unit::default();
assert_eq!(unit, Unit::Millimeter);

// Convert between units
let inches = Unit::Inch.convert(1.0, Unit::Millimeter);
assert!((inches - 25.4).abs() < 1e-5);

// Get scale factor to meters
assert_eq!(Unit::Millimeter.scale_factor(), 0.001);

Variants

Micron

Micrometers - 0.000001 meters (1 μm)

Millimeter

Millimeters - 0.001 meters (1 mm) - Default per 3MF spec

Centimeter

Centimeters - 0.01 meters (1 cm)

Inch

Inches - 0.0254 meters (1 in)

Foot

Feet - 0.3048 meters (1 ft)

Meter

Meters - 1.0 meters (1 m)

Implementations

impl Unit

pub fn scale_factor(&self) -> f64

Returns the scale factor to convert this unit to meters.

Examples

use lib3mf_core::model::Unit;

assert_eq!(Unit::Millimeter.scale_factor(), 0.001);
assert_eq!(Unit::Meter.scale_factor(), 1.0);

pub fn convert(&self, value: f64, target: Unit) -> f64

Converts a value from this unit to another target unit.

Arguments

• value - The value in this unit
• target - The unit to convert to

Returns

The value converted to the target unit.

Examples

use lib3mf_core::model::Unit;

// 1 inch = 25.4 mm
let mm = Unit::Inch.convert(1.0, Unit::Millimeter);
assert!((mm - 25.4).abs() < 1e-5);

// 1000 mm = 1 meter
let m = Unit::Millimeter.convert(1000.0, Unit::Meter);
assert!((m - 1.0).abs() < 1e-5);

Trait Implementations

impl Clone for Unit

fn clone(&self) -> Unit

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Unit

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

Formats the value using the given formatter.

impl Default for Unit

fn default() -> Unit

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Unit

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for Unit

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

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Copy for Unit

impl Eq for Unit

impl StructuralPartialEq for Unit