gridly::vector

Trait Component

Source 
pub trait Component:
    Sized
    + From<isize>
    + Copy
    + Ord
    + Eq
    + Debug
    + Add
    + AddAssign
    + Sub
    + SubAssign
    + Neg
    + Default
    + PartialEq<isize>
    + PartialOrd<isize>
    + VectorLike
    + Sum {
    type Converse: Component<Converse = Self>;
    type Point: LocComponent<Distance = Self>;

    // Required methods
    fn from_vector(vector: impl VectorLike) -> Self;
    fn combine(self, converse: Self::Converse) -> Vector;
    fn value(self) -> isize;
    fn transpose(self) -> Self::Converse;
}
Expand description

A Rows or Columns component of a Vector

This trait comprises a component of a Vector, which may be either Rows or Columns. It represents a distance in a single direction, either vertical (Rows) or horizontal (Columns).

In practice, most code will call methods directly on Rows or Columns values. However, a lot of gridly functionality is agnostic towards rows and columns (for instance, a view over a row in a grid is functionally the same as a view over a column), so the Component trait allows such functionality to be written generically.

The key methods for Component that allow it to work in generic contexts are from_vector, which gets a component from a Vector, and combine, which combines a Rows or Columns with its converse (a Columns or a Rows) to create a new Vector.

Required Associated Types§

Source

type Converse: Component<Converse = Self>

The converse component (Rows to Columns or vice versa)

Source

type Point: LocComponent<Distance = Self>

The assoicated location component type (Row or Column)

Required Methods§

Source

fn from_vector(vector: impl VectorLike) -> Self

Get this compnent from a Vector

§Example:
use gridly::vector::*;

let vec = Vector::new(4, 5);

assert_eq!(Rows::from_vector(&vec), Rows(4));
assert_eq!(Columns::from_vector(&vec), Columns(5));
Source

fn combine(self, converse: Self::Converse) -> Vector

Create a vector from a Row and Column

§Example:
use gridly::vector::*;

let columns = Columns(10);
let rows = Rows(2);

assert_eq!(columns.combine(rows), Vector::new(2, 10));
Source

fn value(self) -> isize

Get the integer value of this component.

§Example:
use gridly::vector::*;

let columns = Columns(10);
let rows = Rows(2);

assert_eq!(columns.value(), 10);
assert_eq!(rows.value(), 2);
Source

fn transpose(self) -> Self::Converse

use gridly::vector::*;

assert_eq!(Rows(10).transpose(), Columns(10));

Dyn Compatibility§

This trait is not dyn compatible.

In older versions of Rust, dyn compatibility was called "object safety", so this trait is not object safe.

Implementors§