Struct Ellipse 

pub struct Ellipse { /* private fields */ }

An ellipse in space.

Implementations

impl Ellipse

pub fn new( frame: Frame, major_radius: f64, minor_radius: f64, tol: Tolerances, ) -> OgeomResult<Self>

An ellipse with the given radii in the xy plane of frame, the major radius along x.

Errors

OgeomError::Construction if either radius is not finite and positive, or if the minor radius exceeds the major.

pub const fn frame(&self) -> Frame

The frame positioning this ellipse.

pub const fn centre(&self) -> Point

The centre.

pub const fn major_radius(&self) -> f64

The major radius.

pub const fn minor_radius(&self) -> f64

The minor radius.

pub fn focal_distance(&self) -> f64

The distance from the centre to either focus.

pub fn eccentricity(&self) -> f64

The eccentricity, in [0, 1). Zero for a circle.

pub fn foci(&self) -> (Point, Point)

The two foci, on the x axis either side of the centre.

pub fn area(&self) -> f64

The area enclosed.

pub fn length(&self) -> f64

The circumference.

Exact to machine precision, via the complete elliptic integral of the second kind; see complete_elliptic_e.

Ramanujan’s well-known approximation was the obvious alternative and is not good enough: it is excellent for a nearly circular ellipse but its relative error reaches 1.2e-5 by an axis ratio of 10:1. Perimeter feeds arc-length parameterization and measurement, where that is a visible error rather than a rounding detail.

pub fn transformed(&self, t: &Transform, tol: Tolerances) -> OgeomResult<Self>

This ellipse moved by t.

Errors

OgeomError::Construction if the transformed frame is degenerate.

Trait Implementations

impl Clone for Ellipse

fn clone(&self) -> Ellipse

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Ellipse

impl Debug for Ellipse

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

Formats the value using the given formatter.

impl PartialEq for Ellipse

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