mesh_to_sdf

⚠️ 此crate处于早期阶段。预计API将发生变化。

此crate提供两个入口点

• generate_sdf：计算由 vertices 和 indices 定义的网格在 query_points 点上的有符号距离场。
• generate_grid_sdf：计算由 vertices 和 indices 定义的网格上的有符号距离场。

use mesh_to_sdf::{generate_sdf, generate_grid_sdf, SignMethod, Topology, Grid};
// vertices are [f32; 3], but can be cgmath::Vector3<f32>, glam::Vec3, etc.
let vertices: Vec<[f32; 3]> = vec![[0.5, 1.5, 0.5], [1., 2., 3.], [1., 3., 7.]];
let indices: Vec<u32> = vec![0, 1, 2];

// query points must be of the same type as vertices
let query_points: Vec<[f32; 3]> = vec![[0.5, 0.5, 0.5]];

// Query points are expected to be in the same space as the mesh.
let sdf: Vec<f32> = generate_sdf(
    &vertices,
    Topology::TriangleList(Some(&indices)), // TriangleList as opposed to TriangleStrip
    &query_points,
    SignMethod::Raycast, // How the sign is computed.
);                       // Raycast is robust but requires the mesh to be watertight.

for point in query_points.iter().zip(sdf.iter()) {
    // distance is positive outside the mesh and negative inside.
    println!("Distance to {:?}: {}", point.0, point.1);
}

// if you can, use generate_grid_sdf instead of generate_sdf as it's optimized and much faster.
let bounding_box_min = [0., 0., 0.];
let bounding_box_max = [10., 10., 10.];
let cell_count = [10, 10, 10];

let grid = Grid::from_bounding_box(&bounding_box_min, &bounding_box_max, cell_count);

let sdf: Vec<f32> = generate_grid_sdf(
    &vertices,
    Topology::TriangleList(Some(&indices)),
    &grid,
    SignMethod::Raycast, // How the sign is computed.
);                       // Raycast is robust but requires the mesh to be watertight.

for x in 0..cell_count[0] {
    for y in 0..cell_count[1] {
        for z in 0..cell_count[2] {
            let index = grid.get_cell_idx(&[x, y, z]);
            log::info!("Distance to cell [{}, {}, {}]: {}", x, y, z, sdf[index as usize]);
        }
    }
}

网格拓扑

索引可以是实现 Into<u32> 的任何类型，例如 u16 和 u32。拓扑可以是列表或条带。如果没有提供索引，则假定它们是 0..vertices.len()。

对于顶点，此库旨在尽可能通用，通过提供可以针对任何类型实现的 Point 特性。大多数常见数学库的实现受功能标志控制。默认情况下，只提供 [f32; 3]。如果您找不到您喜欢的库，请随意为其实现特性并提交PR或打开问题。

[dependencies]
mesh_to_sdf = { version = "0.2.1", features = ["glam"] }