Struct ConicalSurface 

pub struct ConicalSurface { /* private fields */ }

An infinite conical surface.

Parameterized as P(u, v) = apex + v*(cos(half_angle)*(cos(u)*x_axis + sin(u)*y_axis) + sin(half_angle)*axis) where u ∈ [0, 2π) and v ∈ [0, +∞).

Implementations

impl ConicalSurface

pub fn new(apex: Point3, axis: Vec3, half_angle: f64) -> Result<Self, MathError>

Creates a new conical surface.

half_angle is the angle from the radial plane to the cone’s surface generator (radians). Small angles produce wide/flat cones; angles near π/2 produce narrow/spike cones. In the evaluate formula P(u,v) = apex + v*(cos(a)*radial + sin(a)*axis), a is this angle.

Errors

Returns an error if half-angle is not in (0, π/2) or axis is zero.

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

Evaluates the surface at parameters (u, v).

pub fn normal(&self, u: f64, _v: f64) -> Vec3

Returns the surface normal at parameters (u, v).

pub const fn apex(&self) -> Point3

Returns the apex point.

pub const fn axis(&self) -> Vec3

Returns the axis direction.

pub const fn half_angle(&self) -> f64

Returns the half-angle in radians.

pub const fn x_axis(&self) -> Vec3

Returns the local X axis (first radial direction in the parametric frame).

pub const fn y_axis(&self) -> Vec3

Returns the local Y axis (second radial direction in the parametric frame).

pub fn with_ref_dir( apex: Point3, axis: Vec3, half_angle: f64, ref_dir: Vec3, ) -> Result<Self, MathError>

Creates a conical surface with a specified reference direction.

ref_dir defines the x-axis of the parametric frame (projected perpendicular to axis). This preserves the parametric orientation from STEP AXIS2_PLACEMENT_3D or BREP round-trips.

Errors

Returns an error if half-angle is not in (0, π/2) or axis is zero.

pub fn translated(&self, offset: Vec3) -> Self

Returns a copy of this cone with its apex translated by offset.

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

Returns the radius at a given distance v along the axis from the apex.

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

Project a 3D point onto the cone surface, returning (u, v) parameters.

u is the angular parameter [0, 2π), v is the distance from the apex along the cone surface generator line.

pub fn to_nurbs( &self, v_min: f64, v_max: f64, ) -> Result<NurbsSurface, MathError>

Convert to an approximate NURBS surface over the given v-range.

Errors

Returns an error if NurbsSurface construction fails.

Trait Implementations

impl Clone for ConicalSurface

fn clone(&self) -> ConicalSurface

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ConicalSurface

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ConicalSurface

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl ParametricSurface for ConicalSurface

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

Evaluate the surface at parameters (u, v).

fn normal(&self, u: f64, v: f64) -> Vec3

Surface normal at parameters (u, v).

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

Project a 3D point onto the surface, returning (u, v) parameters.

fn partial_u(&self, u: f64, v: f64) -> Vec3

Partial derivative ∂S/∂u at (u, v).

fn partial_v(&self, u: f64, _v: f64) -> Vec3

Partial derivative ∂S/∂v at (u, v).

impl Serialize for ConicalSurface

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

where __S: Serializer,

Serialize this value into the given Serde serializer.