Struct Ellipse3D 

pub struct Ellipse3D { /* private fields */ }

A 3D ellipse defined by center, normal, and two semi-axis lengths.

Parameterized as P(t) = center + a*cos(t)*u + b*sin(t)*v.

Implementations

impl Ellipse3D

pub fn new( center: Point3, normal: Vec3, semi_major: f64, semi_minor: f64, ) -> Result<Self, MathError>

Create a new ellipse.

semi_major is the larger radius, semi_minor the smaller. The major axis lies along the u_axis direction (computed from normal).

Errors

Returns an error if either semi-axis is non-positive.

pub fn new_with_ref( center: Point3, normal: Vec3, semi_major: f64, semi_minor: f64, ref_dir: Vec3, ) -> Result<Self, MathError>

Create a new ellipse with a caller-supplied reference major-axis direction.

ref_dir is projected onto the plane perpendicular to normal to produce u_axis (which carries the semi_major extent). If ref_dir is parallel to normal, falls back to an arbitrary perpendicular choice per Frame3::from_normal_and_ref.

Errors

Returns an error if either semi-axis is non-positive, semi_minor exceeds semi_major, or normal is zero.

pub fn evaluate(&self, t: f64) -> Point3

Evaluate the ellipse at angle t.

pub fn tangent(&self, t: f64) -> Vec3

Tangent at angle t (not unit-length).

pub const fn center(&self) -> Point3

The ellipse center.

pub const fn semi_major(&self) -> f64

Semi-major axis length.

pub const fn semi_minor(&self) -> f64

Semi-minor axis length.

pub const fn normal(&self) -> Vec3

The ellipse normal (axis direction).

pub fn approximate_circumference(&self) -> f64

Approximate circumference using Ramanujan’s formula.

pub fn project(&self, point: Point3) -> f64

Project a point onto the ellipse, returning the angle parameter.

pub const fn u_axis(&self) -> Vec3

The u-axis direction (major axis direction).

pub const fn v_axis(&self) -> Vec3

The v-axis direction (minor axis direction).

pub fn with_axes( center: Point3, normal: Vec3, semi_major: f64, semi_minor: f64, u_axis: Vec3, v_axis: Vec3, ) -> Result<Self, MathError>

Create an ellipse with explicit basis vectors (for transform/copy).

Errors

Returns an error if either semi-axis is non-positive.

Trait Implementations

impl Clone for Ellipse3D

fn clone(&self) -> Ellipse3D

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Ellipse3D

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Ellipse3D

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl ParametricCurve for Ellipse3D

fn evaluate(&self, t: f64) -> Point3

Evaluate the curve at parameter t.

fn tangent(&self, t: f64) -> Vec3

Tangent vector at parameter t.

fn domain(&self) -> (f64, f64)

Parameter domain as (t_min, t_max).

impl Serialize for Ellipse3D

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.