Struct Point 

pub struct Point {
    pub x: f64,
    pub y: f64,
}

A meaningful spacial coordinate.

Most transformations of this type return a Vector, that is not bound to mean a location in space. Vectors can be converted back into points if the programmer determines they again represent a coordinate in space with Vector::p()

Fields

x: f64

y: f64

Implementations

impl Point

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

Create new point. This is just a helper given the fields are public.

pub fn close_to(&self, other: &Point, epsilon: f64) -> bool

Returns true of this point is within epsilon distance of other uses euclidian squared distance internally for speed.

pub fn distance(&self, other: &Point) -> f64

calulates the euclidian distance between this point and other

pub fn distance_2(&self, other: &Point) -> f64

calulates the euclidian squared distance between this point and other mostly useful as an optimisation to save the square root when comparing distnaces

pub fn v(self) -> Vector

Turn this point back into a vector.

Trait Implementations

impl Add<Point> for Vector

type Output = Point

The resulting type after applying the + operator.

fn add(self, rhs: Point) -> Point

Performs the + operation.

impl Add<Vector> for Point

type Output = Point

The resulting type after applying the + operator.

fn add(self, rhs: Vector) -> Point

Performs the + operation.

impl Clone for Point

fn clone(&self) -> Point

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Point

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

Formats the value using the given formatter.

impl From<(f64, f64)> for Point

fn from(value: (f64, f64)) -> Self

Converts to this type from the input type.

impl<R> From<Point> for SamplerPoint<R>

where R: Rng,

A tuple of type (Sampler::<T>,Sampler<T>) will be interpreted as a uniform distribution if turned into a sampler.

Example:

extern crate rand;

use rustic_zen::sampler::SamplerPoint;
use rustic_zen::sampler::Sampler;
use rand::prelude::*;
let mut r = rand::thread_rng();

// results in a rounds soft distribution, useful for area lights.
let _p: SamplerPoint<ThreadRng> = (Sampler::new_gaussian(0.0, 3.0), Sampler::new_gaussian(0.0, 3.0)).into();

This is the only way to construct a SamplerPoint. This shorthand can be extended using the Sampler’s into traits:

extern crate rand;

use rustic_zen::sampler::SamplerPoint;
use rustic_zen::geom::Point;
use rand::prelude::*;
let mut r = rand::thread_rng();

// results in a fixed point at 0.0, 0.0
let _p: SamplerPoint<ThreadRng> = (0.0, 0.0).into();

// results in a uniformly distributed square from 0.0, 0.0 to 10.0, 10.0
let _p: SamplerPoint<ThreadRng> = ((0.0, 10.0), (0.0, 10.0)).into();

fn from(value: Point) -> Self

Converts to this type from the input type.

impl Mul<Point> for Matrix

type Output = Point

The resulting type after applying the * operator.

fn mul(self, rhs: Point) -> Point

Performs the * operation.

impl PartialEq for Point

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

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

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

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

Tests less than (for self and other) and is used by the < operator.

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

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

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

Tests greater than (for self and other) and is used by the > operator.

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

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

impl Sub<Point> for Vector

type Output = Point

The resulting type after applying the - operator.

fn sub(self, rhs: Point) -> Point

Performs the - operation.

impl Sub<Vector> for Point

type Output = Point

The resulting type after applying the - operator.

fn sub(self, rhs: Vector) -> Point

Performs the - operation.

impl Sub for Point

type Output = Vector

The resulting type after applying the - operator.

fn sub(self, rhs: Point) -> Vector

Performs the - operation.

impl Copy for Point

impl StructuralPartialEq for Point