Struct Direction 

pub struct Direction { /* private fields */ }

A 3-D facing direction — the direction an avatar faces, as carried by the various look_at fields (the viewer’s agent/camera at-axis). It is a direction, not a position: the wire stores three f32s and the viewer uses the full 3-D vector (including any vertical component) as the forward axis. It is conventionally a unit vector, but the wire does not enforce normalisation, so the raw components are preserved verbatim for byte-identical round-trips.

Implementations

impl Direction

pub const ZERO: Self

A zero direction (the wire (0, 0, 0) sentinel the viewer replaces with the current camera axis).

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

Creates a direction from its raw components, without normalising.

pub const fn x(&self) -> f32

The x component of the facing direction.

pub const fn y(&self) -> f32

The y component of the facing direction.

pub const fn z(&self) -> f32

The z component of the facing direction.

pub fn length(&self) -> f32

The Euclidean length (magnitude) of the direction vector.

pub fn normalized(&self) -> Option<Self>

The unit-length direction, or None when the vector has (near-)zero length and a direction is therefore undefined.

Trait Implementations

impl Clone for Direction

fn clone(&self) -> Direction

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Direction

impl Debug for Direction

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Direction

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for Direction

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

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Direction