Crate libfive

A high level wrapper around libfive – a set of tools for solid modeling based on functional representation.

Particularly suited for parametric- and procedural modeling. An infrastructure for generative design, mass customization, and domain-specific CAD tools.

Example

let f_rep_shape = Tree::sphere(1.0.into(), TreeVec3::default())
    .difference_multi(vec![
        Tree::sphere(0.6.into(), TreeVec3::default()),
        Tree::cylinder_z(
            0.6.into(),
            2.0.into(),
            TreeVec3::new(0.0, 0.0, -1.0),
        ),
        Tree::cylinder_z(
            0.6.into(),
            2.0.into(),
            TreeVec3::new(0.0, 0.0, -1.0),
        )
        .reflect_xz(),
        Tree::cylinder_z(
            0.6.into(),
            2.0.into(),
            TreeVec3::new(0.0, 0.0, -1.0),
        )
        .reflect_yz(),
    ]);

f_rep_shape.write_stl(
    "f-rep-shape.stl",
    &Region3::new(-2.0, 2.0, -2.0, 2.0, -2.0, 2.0),
    // Subdivisions
    10.0,
)?;

The STL file generated from this code is show below.

Features

• ahash – On by default. Use AHashMap for hashing when resolving variable names. Disabling this will fall back to the slower HashMap.

• stdlib – On by default. Add an extensive list of higher level operations – the libfive stdlib.

  To disable either/both of the above features unset default features in Cargo.toml:

  [dependencies.libfive]
  default-features = false

• packed_opcodes – Tightly pack opcodes. This breaks compatibility with older saved f-rep files.

  See Tree::save()/load().

Structs

Bitmap

Bitmap representing occupancy in a slice of a Tree.

Evaluator

Helper for controlling evaluation of Variables on a Tree.

FlatTriangleMesh

Flat triangle mesh.

Region2

2D bounding region.

Region3

3D bounding region.

Tree

Tree of operations.

TreeVec2

2D point/vector/normal.

TreeVec3

3D point/vector/normal.

TriangleMesh

Triangle mesh.

Variables

Set of variables to parameterize a Tree.

Enums

Error

A list specifying general categories of errors.

Traits

Point2

Trait to aid with using arbitrary 2D point types on a Contour.

Point3

Trait to aid with using arbitrary 3D point types on a TriangleMesh.

Type Aliases

Contour

Series of 2D or 3D points forming a polygonal chain.

Result

A specialized Result type for libfive operations.

TreeFloat

An alias for Tree.

Trees

A collection of Trees.