open3d - v0.2.4

Open3d

banner

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.

Install

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>

Usage

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

Example 1: Find the closest point on a line for a test point

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);

Example 2: Intersection of two lines

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);

Example 3: Transform a plane and find the normal of the transformed plane

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;

API Reference

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

Contribute

Contributors

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 :)

License

MIT

Generated using TypeDoc