svg-mesh-3d

WebJar for svg-mesh-3d

License	MIT
Categories	Github Development Tools Version Controls
GroupId	org.webjars.npm
ArtifactId	github-com-mattdesl-svg-mesh-3d
Last Version	1.1.0
Release Date	Oct 8, 2016
Type	jar
Description	svg-mesh-3d WebJar for svg-mesh-3d
Project URL	http://webjars.org
Source Code Management	https://github.com/mattdesl/svg-mesh-3d

Download github-com-mattdesl-svg-mesh-3d

Filename	Size
github-com-mattdesl-svg-mesh-3d-1.1.0.pom
github-com-mattdesl-svg-mesh-3d-1.1.0.jar	96 KB
github-com-mattdesl-svg-mesh-3d-1.1.0-sources.jar	22 bytes
github-com-mattdesl-svg-mesh-3d-1.1.0-javadoc.jar	22 bytes

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/org.webjars.npm/github-com-mattdesl-svg-mesh-3d/ -->
<dependency>
    <groupId>org.webjars.npm</groupId>
    <artifactId>github-com-mattdesl-svg-mesh-3d</artifactId>
    <version>1.1.0</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/org.webjars.npm/github-com-mattdesl-svg-mesh-3d/
implementation 'org.webjars.npm:github-com-mattdesl-svg-mesh-3d:1.1.0'

Gradle Kotlin

// https://jarcasting.com/artifacts/org.webjars.npm/github-com-mattdesl-svg-mesh-3d/
implementation ("org.webjars.npm:github-com-mattdesl-svg-mesh-3d:1.1.0")

Apache Buildr

'org.webjars.npm:github-com-mattdesl-svg-mesh-3d:jar:1.1.0'

Apache Ivy

<dependency org="org.webjars.npm" name="github-com-mattdesl-svg-mesh-3d" rev="1.1.0">
  <artifact name="github-com-mattdesl-svg-mesh-3d" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='org.webjars.npm', module='github-com-mattdesl-svg-mesh-3d', version='1.1.0')
)

Scala SBT

libraryDependencies += "org.webjars.npm" % "github-com-mattdesl-svg-mesh-3d" % "1.1.0"

Leiningen

[org.webjars.npm/github-com-mattdesl-svg-mesh-3d "1.1.0"]

Dependencies

compile (9)

Group / Artifact	Type	Version
org.webjars.npm : clean-pslg	jar	[1.1.0,2)
org.webjars.npm : bound-points	jar	[1.0.0,2)
org.webjars.npm : cdt2d	jar	[1.0.0,2)
org.webjars.npm : random-float	jar	[1.0.0,2)
org.webjars.npm : object-assign	jar	[4.0.1,5)
org.webjars.npm : simplify-path	jar	[1.1.0,2)
org.webjars.npm : normalize-path-scale	jar	[2.0.0,3)
org.webjars.npm : parse-svg-path	jar	[0.1.1,0.2)
org.webjars.npm : svg-path-contours	jar	[2.0.0,3)

Project Modules

There are no modules declared in this project.

svg-mesh-3d

[

](http://mattdesl.github.io/svg-mesh-3d/)

(ThreeJS demo) - (source)

A high-level module to convert a SVG <path> string into a 3D triangulated mesh. Best suited for silhouettes, like font icon SVGs.

Built on top of cdt2d by @mikolalysenko, and various other modules.

Install

npm install svg-mesh-3d --save

Example

Here is an example using a simple path:

var svgMesh3d = require('svg-mesh-3d')

var path = 'M305.214,374.779c2.463,0,3.45,0.493...'
var mesh = svgMesh3d(path)

The returned mesh is a 3D indexed "simplicial complex" that can be used in ThreeJS, StackGL, etc. It uses arrays for vectors and follows the format:

{
  positions: [ [x1, y1, z1], [x2, y2, z2], ... ],
  cells: [ [a, b, c], [d, e, f] ]
}

Or, to load a mesh in the browser from an SVG file:

var loadSvg = require('load-svg')
var parsePath = require('extract-svg-path').parse
var svgMesh3d = require('svg-mesh-3d')

loadSvg('svg/logo.svg', function (err, svg) {
  if (err) throw err

  var svgPath = parsePath(svg)
  var mesh = svgMesh3d(svgPath, {
    delaunay: false,
    scale: 4
  })
})

Demos

• ThreeJS Demo

Source:

• demo/index.js - animated meshes in ThreeJS
• demo/2d.js - drawing Canvas2D

To run the demos from source:

git clone https://github.com/mattdesl/svg-mesh-3d.git
cd svg-mesh-3d

# install dependencies
npm install

# ThreeJS demo
npm run start

# Canvas2D demo
npm run 2d

Usage

mesh = svgMesh3d(svgPath, [opt])

Triangulates the svgPath string into a 3D simplicial complex. The positions in the 3D mesh are normalized to a -1.0 ... 1.0 range.

Options:

• delaunay (default true)
  • whether to use Delaunay triangulation
  • Delaunay triangulation is slower, but looks better
• clean (default true)
  • whether to run the mesh through clean-pslg
  • slower, but often needed for correct triangulation
• simplify (default 0)
  • a number, the distance threshold for simplication before triangulation (in pixel space)
  • higher number can produce faster triangulation
• scale (default 1)
  • a positive number, the scale at which to approximate the curves from the SVG paths
  • higher number leads to smoother corners, but slower triangulation
• normalize (default true) a boolean, whether to normalize the positions to -1 .. 1
• randomization (default 0)
  • a positive number, the amount of extra points to randomly add within the bounding box before triangulation
  • higher number can lead to a nicer aesthetic, but slower triangulation

Other options are passed to cdt2d, such as exterior (default false) and interior (default true).

See Also

• extract-svg-path - grab <path> data from SVG
• load-svg - load SVG in browser
• three-simplicial-complex - render meshes in ThreeJS
• cdt2d - constrained delaunay triangulation in 2D

License

MIT, see LICENSE.md for details.

Versions

Version
1.1.0 Oct 8, 2016