dymokomi/luce-geocore
Source of release 0.7.1
0.7.1 / README.md
# Luce Geocore
Shared geometry for Luce, with no GPU or UI dependency: polygon meshes, their
attributes, groups and selections (Houdini's group syntax), modeling verbs
(point, face and topology operators such as extrude, bevel, loop cut, clip,
mirror and spin, run through one verb framework), subdivision, primitives, and
CPU spatial queries (a lazy triangle BVH).
Importers, CAD tessellation and editors produce and share these meshes; the
renderer in [luce-3d](https://github.com/dymokomi/luce-3d) draws them.
A result is immutable once published. Operators return new meshes and share
everything they did not change, so a snapshot or a worker-to-UI hand-off costs
no copies. Besides meshes, a geometry set holds points, instances, curves
(poly, Bezier, NURBS, Catmull-Rom), sparse volumes and SDFs, and saves as a
.prism file. See [the API](docs/API.md), [curves, volumes, SDFs, set verbs and
files](docs/FAMILIES.md), [mesh modeling](docs/MESH_MODELING.md) and
[validation](docs/VALIDATION.md).
```prisma
def dependency "luce-geocore" {
str owner = "dymokomi"
str version = "^0.1.0"
}
```
Import `geocore` (`from geocore import Mesh, MeshBuilder, Vector3`). Base
code in other packages also has `geocore_kernel` (bit sets, groups and
selections, mesh assembly, the geometry set's component protocol, the codec
registry, curves), `geocore_parallel` (the shared worker pool),
`geocore_shared` (shared columns) and `geocore_growing` (`Growing`, a heap
array that keeps its capacity). A mesh's arrays as spans (`point_span()`,
`corner_span()`, …) and their packing into GPU layouts (`pack_positions`, …)
are methods of `Mesh` that only Base sees: Luce leaves out the methods whose
signatures it cannot take.
Check out the compilers and packages beside this repository, at main (`python3
../luce-base/tools/checkout_main.py . ../luce`), and run `./test.sh`: the Base checks at native optimization levels
0–3 and in both C modes, each with allocation failure injected at every stage.
Licensed under MIT or Apache-2.0, at your option.