Point Cloud Library (PCL) for browser, powered by WebAssembly.
English | 简体中文
Overview
pcl.js is a Point Cloud Library (PCL) that runs in the browser, powered by Emscripten and WebAssembly
The Point Cloud Library (PCL) is a large scale, open project for 2D/3D image and point cloud processing. The PCL framework contains numerous state-of-the art algorithms including filtering, feature estimation, surface reconstruction, registration, model fitting and segmentation. PCL has its own data format for storing point clouds - PCD (Point Cloud Data), but also allows datasets to be loaded and saved in many other formats.
A point cloud is a set of data points in space. The points may represent a 3D shape or object. Each point position has its set of Cartesian coordinates (X, Y, Z). Point clouds are generally produced by Lidar(light detection and ranging) or by photogrammetry software, which measure many points on the external surfaces of objects around them.
Featured Demos
## Features
- 💌 Provides an API similar to PCL(C++), easy to use
- 🌍 Supports all modern browsers and Node.js 14+
- 💪 Written in TypeScript, with predictable static typing
- 🚀 And many, many more!
## Resources
- [Documentation](https://pcl.js.org/docs/tutorials/intro)
- [API Reference](https://pcl.js.org/docs/api/about)
- [Examples](https://pcl.js.org/examples)
- [Discussions](https://github.com/luoxuhai/pcl.js/discussions)
## Environment Support
| 
Edge | 
Firefox | 
Chrome | 
Safari | 
Opera | 
Node.js |
| --------- | --------- | --------- | --------- | --------- | --------- |
| 16+ | 52+ | 57+ | 11+ | 44+ | 14+
## Bundle Size
> pcl.js version: latest
| Source | Link | Size |
| :------------ | :---------------------------------------------------------------------------------------------------------: | :-----------: |
| pcl.js | [https://cdn.jsdelivr.net/npm/pcl.js/dist/pcl.js](https://cdn.jsdelivr.net/npm/pcl.js/dist/pcl.js) | ~36k gzip’d |
| pcl-core.wasm | [https://cdn.jsdelivr.net/npm/pcl.js/dist/pcl-core.wasm](https://cdn.jsdelivr.net/npm/pcl.js/dist/pcl-core.wasm) | ~553k gzip’d |
## Installation
### NPM
```bash
# NPM
npm install pcl.js
# Yarn
yarn add pcl.js
```
### CDN
```html
```
### Basic Usage Example
```typescript
// TypeScript
import * as PCL from 'pcl.js';
async function main() {
await PCL.init({
url: 'https://cdn.jsdelivr.net/npm/pcl.js/dist/pcl-core.wasm',
});
// Get PCD file
const data = await fetch('https://cdn.jsdelivr.net/gh/luoxuhai/pcl.js@master/data/rops_tutorial/points.pcd').then(res => res.arrayBuffer());
// Load PCD file data, return point cloud object
const cloud = PCL.loadPCDData