microcad-builtin 0.5.1

Provides the built-in functionalities available in the µcad language.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41

// Copyright © 2025-2026 The µcad authors <info@microcad.xyz>
// SPDX-License-Identifier: AGPL-3.0-or-later

use microcad_lang::{builtin::*, model::*};

/// Builtin definition to orient an object towards an axis.
#[derive(Debug)]
pub struct Orient;

impl BuiltinWorkbenchDefinition for Orient {
    fn id() -> &'static str {
        "orient"
    }

    fn kind() -> BuiltinWorkbenchKind {
        BuiltinWorkbenchKind::Transform
    }

    fn workpiece_function() -> &'static BuiltinWorkpieceFn {
        use microcad_core::Vec3;
        &|args| {
            Ok(BuiltinWorkpieceOutput::Transform(
                AffineTransform::Rotation(crate::math::orient_z_to(Vec3::new(
                    args.get("x"),
                    args.get("y"),
                    args.get("z"),
                ))),
            ))
        }
    }

    fn parameters() -> ParameterValueList {
        [
            parameter!(x: Scalar),
            parameter!(y: Scalar),
            parameter!(z: Scalar),
        ]
        .into_iter()
        .collect()
    }
}