Struct PxPosition 

pub struct PxPosition {
    pub x: f32,
    pub y: f32,
}

A fractional physical-pixel position; x increases rightward and y downward.

Fields

x: f32

The x-coordinate in physical pixels. May be fractional.

y: f32

The y-coordinate in physical pixels. May be fractional.

Implementations

impl PxPosition

pub const ZERO: Self

A constant representing the zero position (0, 0).

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

Creates a new position from whole-pixel coordinates.

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

Creates a position from fractional pixel coordinates.

pub fn x_px(self) -> Px

Returns the x-coordinate rounded to the nearest whole pixel.

pub fn y_px(self) -> Px

Returns the y-coordinate rounded to the nearest whole pixel.

pub fn offset(self, dx: Px, dy: Px) -> Self

Offsets the position by the given whole-pixel deltas.

pub fn offset_f32(self, dx: f32, dy: f32) -> Self

Offsets the position by fractional pixel deltas.

pub fn saturating_offset(self, dx: Px, dy: Px) -> Self

Offsets the position with saturating arithmetic.

pub fn distance_to(self, other: Self) -> f32

Calculates the Euclidean distance to another position.

pub fn to_f32_arr2(self) -> [f32; 2]

Converts the position to a 2D f32 array.

pub fn to_f32_arr3(self) -> [f32; 3]

Converts the position to a 3D f32 array with z=0.

pub fn from_f32_arr2(arr: [f32; 2]) -> Self

Creates a position from a 2D f32 array.

pub fn from_f32_arr3(arr: [f32; 3]) -> Self

Creates a position from a 3D f32 array, ignoring z.

pub fn to_f64_arr2(self) -> [f64; 2]

Converts the position to a 2D f64 array.

pub fn to_f64_arr3(self) -> [f64; 3]

Converts the position to a 3D f64 array with z=0.

pub fn from_f64_arr2(arr: [f64; 2]) -> Self

Creates a position from a 2D f64 array.

pub fn from_f64_arr3(arr: [f64; 3]) -> Self

Creates a position from a 3D f64 array, ignoring the z component.

Trait Implementations

impl Add for PxPosition

type Output = PxPosition

The resulting type after applying the + operator.

fn add(self, rhs: Self) -> Self::Output

Performs the + operation.

impl Clone for PxPosition

fn clone(&self) -> PxPosition

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for PxPosition

impl Debug for PxPosition

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

Formats the value using the given formatter.

impl Default for PxPosition

fn default() -> PxPosition

Returns the “default value” for a type.

impl From<PxPosition> for PhysicalPosition<i32>

fn from(pos: PxPosition) -> Self

Converts to this type from the input type.

impl From<PxPosition> for Position

fn from(pos: PxPosition) -> Self

Converts to this type from the input type.

impl From<PxPosition> for [i32; 2]

fn from(pos: PxPosition) -> Self

Converts to this type from the input type.

impl From<PxPosition> for [u32; 2]

fn from(pos: PxPosition) -> Self

Converts to this type from the input type.

impl From<PxPosition> for [Px; 2]

fn from(pos: PxPosition) -> Self

Converts to this type from the input type.

impl From<[Px; 2]> for PxPosition

fn from(pos: [Px; 2]) -> Self

Converts to this type from the input type.

impl From<[i32; 2]> for PxPosition

fn from(pos: [i32; 2]) -> Self

Converts to this type from the input type.

impl From<[u32; 2]> for PxPosition

fn from(pos: [u32; 2]) -> Self

Converts to this type from the input type.

impl PartialEq for PxPosition

fn eq(&self, other: &PxPosition) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for PxPosition

impl Sub for PxPosition

type Output = PxPosition

The resulting type after applying the - operator.

fn sub(self, rhs: Self) -> Self::Output

Performs the - operation.