Skip to content

Cadwork Math Utilities

cwmath is a small, dependency-free geometry library for cadwork 3d plugin authors. Frozen Point / Vec types in 2D and 3D, a right-handed Frame3, Plane3, Line3, and projections of a point onto a line or a plane.

Import the public types from the package root:

1
from cwmath import Point3, Vec3, Frame3, Plane3, Line3, to_point_3d

Cadwork Python Documentation

Types

  • Point3 / Vec3 — 3D affine pair, convertible to cadwork.point_3d
  • Point2 / Vec2 — 2D affine pair
  • Frame3 — local ↔ world for points and vectors
  • Plane3 / Line3 — reference plane and infinite line
  • Functions — to_point_3d, projections, is_close

Cadwork millimetres are the implicit length unit. == is exact IEEE equality; use is_close when you want a tolerance.

Host conversion

Point3.from_xyz / Vec3.from_xyz accept anything with .x, .y, .z (including cadwork.point_3d). to_point_3d imports cadwork only at the call site so CI can run without the host. Smoke-test the real adapter once in cadwork IDLE:

1
2
3
from cwmath import Point3, to_point_3d

to_point_3d(Point3(1, 2, 3))  # a real cadwork.point_3d

Backup Text

Agreement

By contributing code to this repo you agree that cadwork may distribute the code.

Guidelines

We have few guidelines, so please follow the coding styles we provide. 😉