Struct Point3D 

pub struct Point3D { /* private fields */ }

A 3D point encoded with dodecets

Each coordinate (x, y, z) is stored as a dodecet (12 bits).

Example

use dodecet_encoder::geometric::Point3D;

let point = Point3D::new(0x100, 0x200, 0x300);
assert_eq!(point.x(), 0x100);

Implementations

impl Point3D

pub fn new(x: u16, y: u16, z: u16) -> Self

Create a new 3D point

Arguments

• x - X coordinate (0-4095)
• y - Y coordinate (0-4095)
• z - Z coordinate (0-4095)

Example

use dodecet_encoder::geometric::Point3D;

let point = Point3D::new(0x123, 0x456, 0x789);

pub fn x(&self) -> u16

Get x coordinate

pub fn y(&self) -> u16

Get y coordinate

pub fn z(&self) -> u16

Get z coordinate

pub fn normalized(&self) -> (f64, f64, f64)

Convert to normalized floating point coordinates [0.0, 1.0]

Example

use dodecet_encoder::geometric::Point3D;

let point = Point3D::new(0x800, 0x800, 0x800);
let (nx, ny, nz) = point.normalized();
assert!((nx - 0.5).abs() < 0.001);

pub fn signed(&self) -> (i16, i16, i16)

Convert to signed coordinates [-2048, 2047]

Example

use dodecet_encoder::geometric::Point3D;

let point = Point3D::new(0x800, 0x000, 0x7FF);
let (sx, sy, sz) = point.signed();
assert_eq!(sx, -2048);
assert_eq!(sy, 0);
assert_eq!(sz, 2047);

pub fn distance_to(&self, other: &Point3D) -> f64

Calculate distance to another point

Example

use dodecet_encoder::geometric::Point3D;

let p1 = Point3D::new(0x000, 0x000, 0x000);
let p2 = Point3D::new(0x100, 0x000, 0x000);
let dist = p1.distance_to(&p2);
assert!((dist - 256.0).abs() < 0.1);

pub fn to_hex_string(&self) -> String

Convert to hex string

pub fn from_hex_str(s: &str) -> Result<Self>

Parse from hex string

Trait Implementations

impl Clone for Point3D

fn clone(&self) -> Point3D

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Point3D

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

Formats the value using the given formatter.

impl PartialEq for Point3D

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

impl StructuralPartialEq for Point3D