anvil-reduce 0.2.0

Volume-based mesh proxy generator. Voxelize, marching-cubes, smooth, remesh. Fast, watertight, hands-off.

anvil-reduce

Watertight mesh proxy generator: exact narrow-band distance field, marching cubes, smooth, remesh, exact surface projection. Fast, verifiable, hands-off. Native Rust core, Python bindings via PyO3.

Install

pip install anvil-reduce

Inside DCCs:

mayapy -m pip install anvil-reduce          # Maya
hython -m pip install anvil-reduce          # Houdini
# Blender: install into the addon's bundled Python or vendor the wheel

Quick start

One-shot file pipeline (the path most pipeline TDs want):

from anvil_reduce import proxy_from_path

result = proxy_from_path(
    "hero.obj",
    "hero_proxy.obj",
    quality="balanced",          # "fast" | "balanced" | "high"
    transfer_normals=True,
)
print(f"{result['input_faces']} -> {result['output_faces']} in "
      f"{result['wall_seconds']:.2f}s")

NumPy-driven workflow:

import numpy as np
from anvil_reduce import Mesh, generate_proxy

mesh = Mesh.from_numpy(positions, indices)   # (N,3) f64, (M,3) u32
proxy = generate_proxy(mesh, quality="balanced", target_faces=20_000)
positions, indices = proxy.positions(), proxy.indices()

Quality presets

Preset	voxel_res	smooth	remesh
fast	64	3	0
balanced	128	5	3
high	256	5	5

Override individual knobs by passing them explicitly. target_faces hits an output face budget (resolution and remesh edge length are derived from it). offset is the standoff from the input surface in voxel cells (0 = surface-exact, default 0.1, larger = looser hull); close seals gaps in open meshes; project caps the final exact projection onto the offset surface.

The output is closed, outward-wound, and free of degenerate triangles; verify with the CLI's check command.

See https://github.com/voidreamer/anvil-reduce for the full project.