Struct gridd::Vector

pub struct Vector {
    pub col_offset: i32,
    pub row_offset: i32,
}

A two-dimensional vector used to relate grid elements spatially.

Fields

col_offset: i32

row_offset: i32

Methods

impl Vector

pub const NORTH: Vector

Northern unit vector: (col: +0, row: -1).

pub const EAST: Vector

Eastern unit vector: (col: +1, row: +0).

pub const SOUTH: Vector

Southern unit vector: (col: +0, row: +1).

pub const WEST: Vector

Western unit vector: (col: -1, row: +0).

pub fn rcoord(&self, (col, row): Coord) -> Option<Coord>

Get the coordinate pointed to by a Vector from a given Coord.

Returns None when either Coord component would be negative.

Examples

use gridd::{Coord, Vector};

let coord: Coord = (3, 5);

let v1 = Vector::from((-3, 2));
assert_eq!(Some((0, 7)), v1.rcoord(coord));

let v2 = Vector::from((-4, 5));
assert_eq!(None, v2.rcoord(coord));

pub fn cardinal_sum(n: i32, e: i32, s: i32, w: i32) -> Self

Create a new Vector from the sum of cardinal vectors.

Examples

use gridd::Vector;

assert_eq!(
    Vector::cardinal_sum(1, 0, 1, 0),
    Vector::NORTH + Vector::SOUTH
);

assert_eq!(
    Vector::cardinal_sum(0, 2, 0, 3),
    2 * Vector::EAST + 3 * Vector::WEST
);

Trait Implementations

impl Eq for Vector

impl Default for Vector

fn default() -> Vector

Returns the "default value" for a type.

impl Clone for Vector

fn clone(&self) -> Vector

Returns a copy of the value.

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

Performs copy-assignment from source.

impl PartialOrd<Vector> for Vector

fn partial_cmp(&self, other: &Vector) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Vector) -> bool

This method tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Vector) -> bool

This method tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Vector) -> bool

This method tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Vector) -> bool

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl Ord for Vector

fn cmp(&self, other: &Vector) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

🔬 This is a nightly-only experimental API. (clamp)

Restrict a value to a certain interval.

impl PartialEq<Vector> for Vector

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

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=.

impl From<(i32, i32)> for Vector

fn from((c, r): (i32, i32)) -> Self

Performs the conversion.

impl Copy for Vector

impl Hash for Vector

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given [Hasher].

fn hash_slice<H>(data: &[Self], state: &mut H) where
    H: Hasher, 

Feeds a slice of this type into the given [Hasher].

impl Add<Vector> for Vector

type Output = Self

The resulting type after applying the + operator.

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

Performs the + operation.

impl Sub<Vector> for Vector

type Output = Self

The resulting type after applying the - operator.

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

Performs the - operation.

impl Mul<i32> for Vector

type Output = Self

The resulting type after applying the * operator.

fn mul(self, scalar: i32) -> Self::Output

Performs the * operation.

impl Mul<Vector> for i32

type Output = Vector

The resulting type after applying the * operator.

fn mul(self, vec: Vector) -> Self::Output

Performs the * operation.

impl Debug for Vector

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

Formats the value using the given formatter.