Struct Cone 

pub struct Cone { /* private fields */ }

An unbounded circular cone.

The frame’s z is the axis and its origin sits on the reference circle, of radius Cone::reference_radius. The radius grows in +z for a positive half angle. The apex is the point where it reaches zero.

Implementations

impl Cone

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

A cone with the given reference radius and half angle.

The reference circle lies in frame’s xy plane. A positive half angle widens the cone in +z.

Errors

OgeomError::Construction if reference_radius is negative or non-finite, or if half_angle is not strictly between 0 and pi/2. At zero the cone is a cylinder and at pi/2 it is a plane; both are different surfaces with their own types, and admitting them here would produce a cone whose apex is at infinity.

pub const fn frame(&self) -> Frame

The frame positioning this cone.

pub const fn axis(&self) -> Axis

The axis of revolution.

pub const fn reference_radius(&self) -> f64

The radius of the circle in the frame’s xy plane.

pub const fn half_angle(&self) -> f64

The half angle at the apex, in (0, pi/2).

pub fn apex(&self) -> Point

The apex.

pub fn radius_at(&self, z: f64) -> f64

The radius at signed distance z along the axis from the frame origin.

pub fn distance_to(&self, p: Point) -> f64

The distance from p to the surface, ignoring the far nappe.

A double cone extends both sides of its apex; this measures to the surface as a whole, which is what a surface query means.

pub fn contains(&self, p: Point, tol: Tolerances) -> bool

Whether p lies on the surface within tol.confusion().

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

This cone moved by t.

Errors

OgeomError::Construction if the transformed frame is degenerate.

Trait Implementations

impl Clone for Cone

fn clone(&self) -> Cone

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Cone

impl Debug for Cone

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

Formats the value using the given formatter.

impl PartialEq for Cone

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