Open3d is a 3d geometry library for JavaScript/Typescript inspired by RhinoCommon API.

This library is created because so far there has not been a proper typed 3d geometry library for node environment. It is often necessary to calculate vector math or basic intersections of lines or planes but it is very cumbersome or error-prone to invent the wheel. And Open3d tries to save you from the distress. It is written in Typescript which supports native types for your project without the hassle of installing "@types/xxx". Also, it is a pure package that has zero dependencies.

It currently has `Point3d`

, `Vector3d`

, `Line`

, `Polyline`

, `Transform (or Matrix4x4)`

, `BoundingBox`

, `Plane`

and `Intersection`

definitions.

**via Yarn**

```
yarn add open3d
```

or **via NPM**

```
npm i open3d
```

or if you prefer to drive without safe belt **via CDN**:

```
<script src="https://unpkg.com/open3d"></script>
```

If you are familiar with RhinoCommon, then Open3d should be very intuitive to use. Even if not, the functionalities are self-explanatory.

`import { Line, Point3d } from 'open3d';`

// if you use CDN, you can use the global parameter "Open3d" without import, such as "Open3d.Vector"

const p = new Point3d(1, 2, 3);

const from = new Point3d(6, 7, 8);

const to = new Point3d(-2, 0, 3);

const line = new Line(from, to);

const closestPt = line.ClosestPoint(p);

`import { Line, Point3d, Intersection } from 'open3d';`

const line1 = new Line(new Point3d(-4, -1, 0), new Point3d(5, 0, 0));

const line2 = new Line(new Point3d(0, -2, 0), new Point3d(3, 7, 0));

const intersection = Intersection.LineLine(line1, line2);

`import { Line, Vector3d, Point3d, Transform, Plane } from 'open3d';`

// translation

const translate = Transform.Translation(new Vector3d(1, 2, 3));

// rotation

const rotation = Transform.Rotation(Math.PI / 3, new Vector3d(5, 2, 0), new Point3d(-2, 2, 9));

// scale

const scale = Transform.Scale(new Point3d(1, 2, 3), 3);

// mirror

const mirror = Transform.Mirror(new Plane(Point3d.Origin, new Vector3d(8, 2, -4), new Vector3d(0, 8, 5)));

// combine transform

const transformation = Transform.CombineTransforms([translate, rotation, scale, mirror]);

// transform plane

const plane = new Plane(Point3d.Origin, Vector3d.XAxis, Vector3d.YAxis);

const transformedPlane = plane.Transform(transformation);

const normal = transformedPlane.Normal;

The full API reference can be found at https://open3d.chen.works/.

Any form of contributions to fix/optimize or extend the library are welcome! Please take advantage of Github's issues or pull requests. :)

If you realy find it useful and like to contribute straightforwardly, feel free to buy me a coffee :)

Generated using TypeDoc