Rust 3D建模插件库kittycad-modeling-cmds的使用

安装

在项目目录中运行以下Cargo命令：

cargo add kittycad-modeling-cmds

或者在Cargo.toml中添加以下行：

kittycad-modeling-cmds = "0.2.131"

元数据

• 版本: 0.2.131
• Rust版本: v1.74.0
• 许可证: MIT
• 大小: 76.4 KiB

代码示例

以下是一个使用kittycad-modeling-cmds库进行3D建模的基本示例：

use kittycad_modeling_cmds::{Command, Engine, Path};

fn main() -> anyhow::Result<()> {
    // 创建一个新的建模引擎
    let mut engine = Engine::new();
    
    // 创建一个路径
    let mut path = Path::new();
    path.move_to(0.0, 0.0, 0.0);
    path.line_to(10.0, 0.0, 0.0);
    path.line_to(10.0, 10.0, 0.0);
    path.line_to(0.0, 10.0, 0.0);
    path.close();
    
    // 将路径转换为3D实体
    let extrude_cmd = Command::extrude(path, 5.0);
    engine.execute(extrude_cmd)?;
    
    // 输出结果
    let model = engine.get_model()?;
    println!("生成模型: {:?}", model);
    
    Ok(())
}

更完整的示例

下面是一个更完整的示例，展示如何使用kittycad-modeling-cmds创建更复杂的3D模型：

use kittycad_modeling_cmds::{Command, Engine, Path, Point3};

fn create_complex_model() -> anyhow::Result<()> {
    // 初始化引擎
    let mut engine = Engine::new();
    
    // 创建基础形状
    let base_path = create_rectangle_path(20.0, 20.0);
    engine.execute(Command::extrude(base_path, 2.0))?;
    
    // 创建圆柱体
    let cylinder_path = create_circle_path(5.0, 32);
    engine.execute(Command::extrude(cylinder_path, 15.0)
        .with_position(Point3::new(0.0, 0.0, 2.0)))?;
    
    // 布尔运算
    let cutout_path = create_rectangle_path(10.0, 5.0);
    engine.execute(Command::extrude(cutout_path, 2.0)
        .with_position(Point3::new(0.0, 0.0, 0.0))
        .as_cut())?;
    
    // 导出模型
    let model = engine.get_model()?;
    println!("最终模型顶点数: {}", model.vertices.len());
    
    Ok(())
}

fn create_rectangle_path(width: f64, height: f64) -> Path {
    let mut path = Path::new();
    path.move_to(-width/2.0, -height/2.0, 0.0);
    path.line_to(width/2.0, -height/2.0, 0.0);
    path.line_to(width/2.0, height/2.0, 0.0);
    path.line_to(-width/2.0, height/2.0, 0.0);
    path.close();
    path
}

fn create_circle_path(radius: f64, segments: usize) -> Path {
    let mut path = Path::new();
    for i in 0..=segments {
        let angle = 2.0 * std::f64::consts::PI * i as f64 / segments as f64;
        let x = radius * angle.cos();
        let y = radius * angle.sin();
        if i == 0 {
            path.move_to(x, y, 0.0);
        } else {
            path.line_to(x, y, 0.0);
        }
    }
    path.close();
    path
}

完整示例demo

以下是一个结合了多个功能的完整示例，展示如何创建一个带孔的3D模型：

use kittycad_modeling_cmds::{Command, Engine, Path, Point3};

fn main() -> anyhow::Result<()> {
    // 初始化建模引擎
    let mut engine = Engine::new();

    // 创建底座 - 一个长方体
    let base = create_box(30.0, 20.0, 5.0);
    engine.execute(base)?;

    // 创建圆柱体
    let cylinder = create_cylinder(8.0, 15.0)
        .with_position(Point3::new(0.0, 0.0, 5.0));
    engine.execute(cylinder)?;

    // 创建孔洞
    let hole = create_cylinder(4.0, 20.0)
        .with_position(Point3::new(0.0, 0.0, 0.0))
        .as_cut();
    engine.execute(hole)?;

    // 创建侧面的凹槽
    let slot = create_slot(10.0, 3.0, 5.0)
        .with_position(Point3::new(-15.0, 0.0, 2.5));
    engine.execute(slot.as_cut())?;

    // 获取最终模型
    let model = engine.get_model()?;
    println!("模型信息:");
    println!("顶点数: {}", model.vertices.len());
    println!("面数: {}", model.faces.len());

    Ok(())
}

// 创建长方体
fn create_box(width: f64, depth: f64, height: f64) -> Command {
    let mut path = Path::new();
    path.move_to(-width/2.0, -depth/2.0, 0.0);
    path.line_to(width/2.0, -depth/2.0, 0.0);
    path.line_to(width/2.0, depth/2.0, 0.0);
    path.line_to(-width/2.0, depth/2.0, 0.0);
    path.close();
    Command::extrude(path, height)
}

// 创建圆柱体
fn create_cylinder(radius: f64, height: f64) -> Command {
    let segments = 32;
    let mut path = Path::new();
    for i in 0..=segments {
        let angle = 2.0 * std::f64::consts::PI * i as f64 / segments as f64;
        let x = radius * angle.cos();
        let y = radius * angle.sin();
        if i == 0 {
            path.move_to(x, y, 0.0);
        } else {
            path.line_to(x, y, 0.0);
        }
    }
    path.close();
    Command::extrude(path, height)
}

// 创建槽形
fn create_slot(length: f64, width: f64, height: f64) -> Command {
    let radius = width / 2.0;
    let half_length = length / 2.0 - radius;
    
    let mut path = Path::new();
    
    // 开始于左半圆
    path.move_to(-half_length, -radius, 0.0);
    
    // 左半圆
    for i in 0..=16 {
        let angle = std::f64::consts::PI * (1.0 + i as f64 / 16.0);
        let x = -half_length + radius * angle.cos();
        let y = radius * angle.sin();
        path.line_to(x, y, 0.0);
    }
    
    // 顶部直线
    path.line_to(half_length, radius, 0.0);
    
    // 右半圆
    for i in 0..=16 {
        let angle = std::f64::consts::PI * (i as f64 / 16.0);
        let x = half_length + radius * angle.cos();
        let y = radius * angle.sin();
        path.line_to(x, y, 0.0);
    }
    
    // 底部直线
    path.line_to(-half_length, -radius, 0.0);
    
    path.close();
    Command::extrude(path, height)
}

所有者

• kittycad/crate-owners
• Adam Chalmers
• Jess Frazelle
• Paul Tagliamonte

这个库提供了强大的3D建模功能，适合需要高效CAD建模命令和几何图形处理的Rust开发者使用。通过组合基本命令可以创建复杂的3D模型，并支持各种几何变换和布尔运算。