Apache Commons Geometry 是一个用于几何处理的通用 Java 库。该项目的主要目标是提供一组几何类型和实用程序:
- 在数学上是正确的
- 数值上是准确的
- 易于使用
- 优良性能
该代码起源于 commons-math 项目的 org.apache.commons.math3.geometry 包， 但为了更好的可维护性被拉到一个单独的项目中。从那以后，它经历了许多改进，包括对核心接口和类的重大重构。
该库的主要特点包括：
- 支持一、二、三维的欧几里得空间
- 支持一维和二维的球面空间
- 支持无限大小的几何元素
- 支持对区域的布尔运算（并集、交集、差集、xor）
- 支持读写常见的几何数据格式，如 STL 和 OBJ
- 单一的外部依赖（common-numbers）
下面的代码通过计算一个立方体和一个球体的近似值的差值，并使用 OBJ 数据格式将结果写入文件，给出了一个 API 的小样本。
// construct a precision instance to handle floating-point comparisons
Precision.DoubleEquivalence precision = Precision.doubleEquivalenceOfEpsilon(1e-6);
// create a BSP tree representing the unit cube
RegionBSPTree3D tree = Parallelepiped.unitCube(precision).toTree();
// create a sphere centered on the origin
Sphere sphere = Sphere.from(Vector3D.ZERO, 0.65, precision);
// subtract a BSP tree approximation of the sphere containing 512 facets
// from the cube, modifying the cube tree in place
tree.difference(sphere.toTree(3));
// compute some properties of the resulting region
double size = tree.getSize(); // 0.11509505362599505
Vector3D centroid = tree.getCentroid(); // (0, 0, 0)
// convert to a triangle mesh
TriangleMesh mesh = tree.toTriangleMesh(precision);
// save as an OBJ file
IO3D.write(mesh, Paths.get("target/cube-minus-sphere.obj"));
评论