×

How to Use Triangulator

General

• Show this help dialog: Press ?

File Operations

• Open Image: Load a new background image. This will reset the current mesh.
• Import/Export Mesh: Save your work (vertices and triangle connections) as a .json file. This allows you to continue working on a mesh later. You must load the same background image first.
• Export as PNG/SVG: Export the final triangulated image in various formats for use in other applications.
• Reset: Remove all triangles from the canvas.

Navigation

• Pan: Click and drag the canvas with the left mouse button, or use a two-finger swipe on a trackpad.
• Zoom: Use Ctrl + Mouse Wheel, or pinch-to-zoom on a trackpad.

Triangle Creation

• Click on an empty area to add a new vertex.
• Click near an existing vertex to snap to it.
• Create a triangle in 3 ways:
  1. Click three vertices in sequence.
  2. Click an existing edge, then click a third vertex.
  3. Click a single vertex, then click an existing edge.
• Cancel creation: Press Escape or right-click. You can also click a selected edge again to deselect it.

Modifying the Mesh

• Move Vertex: Click and drag an existing vertex to a new position.
• Remove Triangle: Right-click on a triangle to remove it. A red overlay will indicate which triangle will be removed.

History

• Undo: Ctrl + Z
• Redo: Ctrl + Y

Visibility & Shortcuts

• Toggle Image: 1
• Toggle Filled Triangles: 2
• Toggle Wireframe: 3

Constraints (Invalid Actions)

The tool will prevent you from creating an invalid mesh. You cannot:

• Create a new vertex inside an existing triangle.
• Create triangles with edges that cross, or that overlap/engulf other triangles.
• Drag a vertex to a position that would cause an invalid mesh. The move will be reverted.