Struct truck_geometry::decorators::RevolutedCurve

pub struct RevolutedCurve<C> { /* private fields */ }

surface constructed by revoluting a curve

Examples

Revoluted sphere

use truck_geometry::prelude::*;
use std::f64::consts::PI;
let knot_vec = KnotVec::bezier_knot(2);
let control_points = vec![
    Vector4::new(1.0, 0.0, 0.0, 1.0),
    Vector4::new(0.0, 1.0, 0.0, 0.0),
    Vector4::new(-1.0, 0.0, 0.0, 1.0),
];
// upper half circle on xy-plane
let uhcircle = NurbsCurve::new(BSplineCurve::new(knot_vec, control_points));
// sphere constructed by revolute circle
let sphere = RevolutedCurve::by_revolution(
    uhcircle, Point3::origin(), Vector3::unit_x(),
);
const N: usize = 30;
for i in 0..=N {
    for j in 0..=N {
        let u = i as f64 / N as f64;
        let v = 2.0 * PI * j as f64 / N as f64;
        let pt: Vector3 = sphere.subs(u, v).to_vec();
        assert_near2!(pt.magnitude2(), 1.0);
        assert_near!(pt, sphere.normal(u, v));
    }
}

Implementations

impl<C> RevolutedCurve<C>

pub fn by_revolution(curve: C, origin: Point3, axis: Vector3) -> Self

Creates a surface by revoluting a curve.

pub const fn entity_curve(&self) -> &C

Returns the curve before revoluted.

pub fn into_entity_curve(self) -> C

Into the curve before revoluted.

pub const fn origin(&self) -> Point3

Returns origin of revolution

pub const fn axis(&self) -> Vector3

Returns axis of revolution

impl<C: ParametricCurve3D + BoundedCurve> RevolutedCurve<C>

pub fn is_front_fixed(&self) -> bool

Returns true if the front point of the curve is on the axis of rotation.

Examples

use truck_geometry::prelude::*;
let line = BSplineCurve::new(
    KnotVec::bezier_knot(1),
    vec![Point3::new(0.0, 0.0, 0.0), Point3::new(0.0, 0.0, 1.0)],
);
let surface0 = RevolutedCurve::by_revolution(line.clone(), Point3::origin(), Vector3::unit_y());
assert!(surface0.is_front_fixed());
let surface1 = RevolutedCurve::by_revolution(line, Point3::new(1.0, 0.0, 0.0), Vector3::unit_y());
assert!(!surface1.is_front_fixed());

pub fn is_back_fixed(&self) -> bool

Returns true if the back point of the curve is on the axis of rotation.

Examples

use truck_geometry::prelude::*;
let line = BSplineCurve::new(
    KnotVec::bezier_knot(1),
    vec![Point3::new(0.0, 0.0, 1.0), Point3::new(0.0, 0.0, 0.0)],
);
let surface0 = RevolutedCurve::by_revolution(line.clone(), Point3::origin(), Vector3::unit_y());
assert!(surface0.is_back_fixed());
let surface1 = RevolutedCurve::by_revolution(line, Point3::new(1.0, 0.0, 0.0), Vector3::unit_y());
assert!(!surface1.is_back_fixed());

Trait Implementations

impl<C: ParametricCurve3D + BoundedCurve> BoundedSurface for RevolutedCurve<C>

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

Return the ends of parameter_range by tuple.

impl<C: Clone> Clone for RevolutedCurve<C>

fn clone(&self) -> RevolutedCurve<C>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<C: Debug> Debug for RevolutedCurve<C>

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

Formats the value using the given formatter.

impl<'de, C> Deserialize<'de> for RevolutedCurve<C>

where C: Deserialize<'de>,

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<'a> IncludeCurve<BSplineCurve<Point3<f64>>> for RevolutedCurve<&'a BSplineCurve<Point3>>

fn include(&self, curve: &BSplineCurve<Point3>) -> bool

Returns whether the curve curve is included in the surface self.

impl<'a> IncludeCurve<BSplineCurve<Point3<f64>>> for RevolutedCurve<&'a NurbsCurve<Vector4>>

fn include(&self, curve: &BSplineCurve<Point3>) -> bool

Returns whether the curve curve is included in the surface self.

impl IncludeCurve<BSplineCurve<Point3<f64>>> for RevolutedCurve<BSplineCurve<Point3>>

fn include(&self, curve: &BSplineCurve<Point3>) -> bool

Returns whether the curve curve is included in the surface self.

impl IncludeCurve<BSplineCurve<Point3<f64>>> for RevolutedCurve<NurbsCurve<Vector4>>

fn include(&self, curve: &BSplineCurve<Point3>) -> bool

Returns whether the curve curve is included in the surface self.

impl<'a> IncludeCurve<NurbsCurve<Vector4<f64>>> for RevolutedCurve<&'a BSplineCurve<Point3>>

fn include(&self, curve: &NurbsCurve<Vector4>) -> bool

Returns whether the curve curve is included in the surface self.

impl<'a> IncludeCurve<NurbsCurve<Vector4<f64>>> for RevolutedCurve<&'a NurbsCurve<Vector4>>

fn include(&self, curve: &NurbsCurve<Vector4>) -> bool

Returns whether the curve curve is included in the surface self.

impl IncludeCurve<NurbsCurve<Vector4<f64>>> for RevolutedCurve<BSplineCurve<Point3>>

fn include(&self, curve: &NurbsCurve<Vector4>) -> bool

Returns whether the curve curve is included in the surface self.

impl IncludeCurve<NurbsCurve<Vector4<f64>>> for RevolutedCurve<NurbsCurve<Vector4>>

fn include(&self, curve: &NurbsCurve<Vector4>) -> bool

Returns whether the curve curve is included in the surface self.

impl<C: Clone> Invertible for RevolutedCurve<C>

fn invert(&mut self)

Inverts self

fn inverse(&self) -> Self

Returns the inverse.

impl<C> ParameterDivision2D for RevolutedCurve<C>

where C: ParametricCurve3D + ParameterDivision1D<Point = Point3>,

fn parameter_division( &self, (urange, vrange): ((f64, f64), (f64, f64)), tol: f64, ) -> (Vec<f64>, Vec<f64>)

Creates the surface division

impl<C: ParametricCurve3D> ParametricSurface for RevolutedCurve<C>

type Point = Point3<f64>

The surface is in the space of Self::Point.

type Vector = Vector3<f64>

The derivation vector of the curve.

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

Substitutes the parameter (u, v).

fn uder(&self, u: f64, v: f64) -> Vector3

Returns the derivation by u.

fn vder(&self, u: f64, v: f64) -> Vector3

Returns the derivation by v.

fn uuder(&self, u: f64, v: f64) -> Vector3

Returns the 2nd-order derivation by u.

fn vvder(&self, u: f64, v: f64) -> Vector3

Returns the 2nd-order derivation by v.

fn uvder(&self, u: f64, v: f64) -> Vector3

Returns the 2nd-order derivation by both u and v.

fn parameter_range(&self) -> (ParameterRange, ParameterRange)

The range of the parameter of the surface.

fn u_period(&self) -> Option<f64>

None in default; Some(period) if periodic w.r.t. parameter u.

fn v_period(&self) -> Option<f64>

None in default; Some(period) if periodic w.r.t. parameter v.

fn try_range_tuple(&self) -> (Option<(f64, f64)>, Option<(f64, f64)>)

Return the ends of parameter_range by tuple. If the range is unbounded, return `None``.

impl<C: ParametricCurve3D + BoundedCurve> ParametricSurface3D for RevolutedCurve<C>

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

Returns the normal vector at (u, v).

impl<C: PartialEq> PartialEq for RevolutedCurve<C>

fn eq(&self, other: &RevolutedCurve<C>) -> 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<C: ParametricCurve3D + BoundedCurve> SearchNearestParameter<D2> for RevolutedCurve<C>

type Point = Point3<f64>

point

fn search_nearest_parameter<H: Into<SPHint2D>>( &self, point: Point3, hint: H, trials: usize, ) -> Option<(f64, f64)>

Search nearest parameter t such that self.subs(t) is nearest point.
Returns None if could not find such parameter.

impl<C: ParametricCurve3D + BoundedCurve> SearchParameter<D2> for RevolutedCurve<C>

type Point = Point3<f64>

point

fn search_parameter<H: Into<SPHint2D>>( &self, point: Point3, hint: H, trials: usize, ) -> Option<(f64, f64)>

Search parameter t such that self.subs(t) is near point.
Returns None if could not find such parameter.

impl<C> Serialize for RevolutedCurve<C>

where C: Serialize,

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl<C: Copy> Copy for RevolutedCurve<C>

impl<C> StructuralPartialEq for RevolutedCurve<C>