search

Jeff-Numix / mapbox-gl-draw-bezier-curve-mode

A custom mode for MapboxGL-Draw to draw and edit bezier curves.
41 stars 9 forks source link

readme

mapbox-gl-draw-bezier-curve-mode

A mapbox gl draw mode to draw and edit bezier curves.

Demo

Demo page : https://mapbox-gl-draw-bezier-curve-demo.numix.fr

Preview

Demo

Usage

Bezier Curve Draw mode

Use the Bezier tool to enter in Bezier Curve Draw mode :

Demo

Alt + Drag with Left click to create nodes with bezier handles.\ Hit Enter or Left click on the last node to finish the curve

Create nodes with handles

Left mouse click to create nodes without handles (same as line string tool).\ Bezier Curves can have nodes with or without handles

Create nodes with handles

Close a curve by connecting the last node to the first one :

Close curve

Remove last added nodes with Right click

Remove last added nodes

Bezier Curve Editing

To edit a bezier curve, enter in direct mode.

Select a node, then drag with left click to move bezier handles :

Edit handles

Break bezier handle symmetry\ Select a node, then Alt + Drag with left click on a bezier handle :

Break handle symetry

Toggle node handles\ When bezier handles are visible, Alt + Left Click on the node will remove the handles :

Toggle node remove handles

When bezier handles are not visible Alt + Drag with left click on the node will show the handles :

Toggle node hcreate andles

Create new nodes in between\ In direct mode, click on a midpoint to create a new node inside the curve :

Create new nodes

Delete node\ Select a node and hit Delete key

Combine/Uncombine extended support

Combining / uncombining bezier curves is supported. In Direct mode there are some additional features :

In Direct mode, combine two vertices from a different bezier curve

If two bezier curves where previously combined, its possible to combine them into a single curve by selecting two vertices.

To do so :

Combine Two Separate Curvess

Close a curve\ Close the curve by combining the first and last node in direct mode.

Close Curve

Open a curve\ When a curve is closed, open it by uncombining a single vertex. It will be splitted in two separate vertices allowing the curve to be open again.

Open Curve

Split curves\ Select vertices on a non closed curve to split it in multiple curves. The result will be a combined curve.\ Uncombine it in simple_select mode to be able to move each curve independently.

Split Curves

Installation

To Install:

yarn add mapbox-gl-draw-bezier-curve-mode

To Use:

import {
  SimpleSelectModeBezierOverride, 
  DirectModeBezierOverride, 
  DrawBezierCurve, 
  customStyles,
} from 'mapbox-gl-draw-bezier-curve-mode';

var draw = new MapboxDraw({
    displayControlsDefault: false,
    userProperties: true,
    modes: {
    ...MapboxDraw.modes,
    simple_select: SimpleSelectModeBezierOverride,
    direct_select: DirectModeBezierOverride,
    draw_bezier_curve: DrawBezierCurve,
    },
    styles: customStyles
});

var map = new mapboxgl.Map({
  container: 'map',
  style: 'mapbox://styles/mapbox/streets-v8',
  center: [2.45, 46.59],
  zoom: 5.8
});

map.addControl(Draw)

See demo package for a full example.

More information about mapbox-gl-draw :

mapbox-gl-draw

mathjs

Changelog

v1.0.0

Known issues

v1.0.0

If you find an issue, please refer : https://github.com/Jeff-Numix/mapbox-gl-draw-bezier-curve-mode/issues

Licence

MIT © JeffSebrechts

Credits

Developed by Jeff Sebrechts