Struct CylindricalSurface 

pub struct CylindricalSurface { /* private fields */ }

An infinite cylindrical surface.

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

Implementations

impl CylindricalSurface

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

Creates a new cylindrical surface.

Errors

Returns an error if radius is not positive 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 origin(&self) -> Point3

Returns the origin.

pub const fn axis(&self) -> Vec3

Returns the axis direction.

pub const fn radius(&self) -> f64

Returns the radius.

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( origin: Point3, axis: Vec3, radius: f64, ref_dir: Vec3, ) -> Result<Self, MathError>

Creates a cylindrical 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 radius is not positive or axis is zero.

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

Returns a copy of this cylinder with its origin translated by offset.

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

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

u is the angular parameter [0, 2π), v is the axial parameter.

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

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

Uses degree (2, 1) with 9 control points per ring (standard rational representation of a full circle). The result is geometrically exact.

Errors

Returns an error if NurbsSurface construction fails.

Trait Implementations

impl Clone for CylindricalSurface

fn clone(&self) -> CylindricalSurface

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CylindricalSurface

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for CylindricalSurface

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl ParametricSurface for CylindricalSurface

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 CylindricalSurface

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

where __S: Serializer,

Serialize this value into the given Serde serializer.