iShape-js

2D geometry library for triangulation and poly-bool operations such as union, intersection, difference and xor.

Demo

Try out iShape with an interactive demo.

- Stars Rotation
- Shapes Editor
- Path Offset
- Polygon Offset
- Triangulation

Features

- Boolean Operations: union, intersection, difference, and exclusion.
- Polygons: with holes, self-intersections, and multiple paths.
- Simplification: removes degenerate vertices and merges collinear edges.
- Fill Rules: even-odd, non-zero, positive and negative.

Getting Started

$3

#### Download Library Files:

- ishape_wasm.js
- ishape_bg_wasm.wasm

You can find it at: pkg

#### Place Files:
Place these files in a directory that your HTML file can access; in this example, the directory is named ./ishape

$3

#### Installation
You can install the iShape library from NPM:

``bash npm install ishape_wasm`

The NPM package is available here

#### Import and Usage

After installing the NPM package, you can import it in your JavaScript or TypeScript file as follows:

`javascript import init, { Overlay, OverlayRule, FillRule } from './ishape/ishape_wasm.js';

// Your code here

`$3`


Here is a simple HTML example that demonstrates how to use the iShape library for union operation.
Full example is available here

html



    
    
    iShape
    
    


    [[[200, 300], [200, 100], [400, 100], [400, 300]]]
    [[[300, 400], [300, 200], [500, 200], [500, 400]]]

#### Explanation:

Import classes and initialize the WebAssembly module using init().
Use the imported classes to perform geometric operations.

Overlay Rules

| A,B | A ∪ B | A ∩ B | A - B | B - A | A ⊕ B |
|---------|---------------|----------------------|----------------|--------------------|----------------|
|