/trianglify

low poly style background generator with d3.js

Primary LanguageJavaScriptOtherNOASSERTION

Trianglify

Trianglify is a library that I wrote to generate nice SVG background images like this one:

example

It was inspired by btmills/geopattern, and uses d3.js to build the polygons and SVG and SVG filters for rendering. It also includes the colorbrewer color palette library to get you up and running quickly. It was written in a single day because I got fed up with Adobe Illustrator.

Demo

Official:
http://qrohlf.com/trianglify

More:

  • @nixterrimus has a nice demo app that lets you modify the parameters and choose between the built-in color palettes: link (source)
  • @alssndro put together a version that lets you choose from the top ColourLovers palettes: link (source)

Getting Trianglify

The recommended way to use Trianglify is via Bower:

bower install trianglify

Or if you're using nodejs

npm install trianglify

Alternately, you can load it via CDNJS, download the latest version as a zip archive, or simply clone this repo.

Usage

Include d3 and trianglify.js or trianglify.min.js on your page:

<script src="http://d3js.org/d3.v3.min.js"></script>
<script src="trianglify.js"></script>

Create a new Trianglify instance and use it to generate patterns:

var t = new Trianglify();
var pattern = t.generate(800, 600); // svg width, height
pattern.svg         // SVG DOM Node object
pattern.svgString   // String representation of the svg element
pattern.base64      // Base64 representation of the svg element
pattern.dataUri     // data-uri string
pattern.dataUrl     // data-uri string wrapped in url() for use in css
pattern.append()    // append pattern to <body>. Useful for testing.

For example, to generate a background for <body> and apply it with inline CSS:

var t = new Trianglify();
var pattern = t.generate(document.body.clientWidth, document.body.clientHeight);
document.body.setAttribute('style', 'background-image: '+pattern.dataUrl);

Colors

a list of all the available colorbrewer palettes available can be found here, or you can specify your own

Examples

Smaller Cell Size

window.open(new Trianglify({
    x_gradient: colorbrewer.PuOr[9],
    noiseIntensity: 0,
    cellsize: 90}).generate(700, 400).dataUri)

Differing x and y gradients

window.open(new Trianglify({
    x_gradient: colorbrewer.YlGnBu[9],
    y_gradient: colorbrewer.RdPu[9],
    noiseIntensity: 0.1,
    cellpadding: 10,
    cellsize: 100}).generate(700, 400).dataUri);

Cellpadding Close to cellsize/2

window.open(new Trianglify({
    cellpadding: 80,
    cellsize: 200}).generate(700, 400).dataUri)

Options

The constructor takes an optional options object where you can override the default values for Trianglify like so:

var t = new Trianglify({cellsize: 100, bleed: 150, ...});

The following configuration options are available:

option usage valid default
cellsize set how large the generated cells should be integers > 0 150
bleed set how far outside the visible area of the SVG points should be rendered integers > 0 cellsize
cellpadding set the minimum distance between each point integers > 0 and < cellsize/2 cellsize*0.1
noiseIntensity set the opacity of the noise filter. This has a significant impact on SVG rendering time - set to 0 to disable. 0 to 1 0.3
x_gradient an array of colors to use to construct a gradient for the x-axis array of colors in hexadecimal string format (i.e. ["#961E00", "#FF0000", "#EEEEEE"]) random selection from colorbrewer palettes
y_gradient an array of colors to use to construct a gradient for the y-axis array of colors in hexadecimal string format (i.e. ["#961E00", "#FF0000", "#EEEEEE"]) x_gradient, brightened by a factor of 0.5
fillOpacity sets the opacity of the inside of the cells 0 to 1 1
strokeOpacity sets the opacity of the outline of the cells 0 to 1 1

Contributing

Pull requests are welcome! Fork the repo on Github and submit a pull request.

Trianglify uses gulp to handle code hinting and minification. Make sure to run gulp before committing changes for a pull request and check in the minified version along with your changes:

npm install -g gulp && npm install # you only have to do this once
gulp # do this before you commit

License

Trianglify is licensed under the GPLv3 License. Happy hacking!

Credits

  • Trianglify makes use of the excellent d3.js visualization library by Michael Bostock.
  • Trianglify includes color specifications and designs developed by Cynthia Brewer (http://colorbrewer.org/).
  • Trianglify uses the excellent (and free!) GitHub Pages for hosting.