vega/vega-webgl-renderer

Name: vega-webgl-renderer

Owner: Vega

Description: WebGL renderer for Vega.

Created: 2016-12-02 21:47:12.0

Updated: 2017-09-27 10:42:34.0

Pushed: 2016-12-21 21:44:12.0

Homepage: https://vega.github.io/vega-webgl-renderer

Size: 4509

Language: JavaScript

GitHub Committers

User	Most Recent Commit	# Commits

Other Committers

User	Email	Most Recent Commit	# Commits

README

WebGL renderer for Vega

Demo

Major features

• Implements nearly all Vega scene graph components as WebGL primitives. Falls back to 2D Canvas rendering for text and gradient fills, which are drawn to a WebGL texture and overlaid on the view.
• Custom shaders for Rect and Symbol marks, enabling greater scalability (to the hundreds of thousands) beyond Canvas and SVG renderers. See the “scale” example in the demo (Note: Do not attempt that example with the SVG renderer, it will lock your browser for a while).

Usage

Use this scaffolding to get started using the WebGL renderer. Instead of being directly usable after loading Vega, as the SVG and Canvas renderers are, the WebGL renderer is a plugin which requires the inclusion of an additional JavaScript library.

The WebGL renderer requires Vega 3.0 (currently in beta).

y>
cript src="https://d3js.org/d3.v4.min.js"></script>
cript src="https://unpkg.com/vega/build/vega.min.js" charset="utf-8"></script>
cript src="https://unpkg.com/vega-webgl-renderer/build/vega-webgl-renderer.js" charset="utf-8"></script>

iv id="vis"></div>
cript>
// Load in your own Vega spec here.
d3.json('https://vega.github.io/vega-webgl-renderer/spec/bar-hover-label.vg.json', function (spec) {
  var view = new vega.View(vega.parse(spec))
    .initialize(document.querySelector('#vis'))
    .renderer('webgl')
    .run();
});
script>
dy>

Build

install
run build

Test

Testing requires that the Selenium server is running with the Chrome driver installed. To run all tests:

run test

To just run the linter:

run lint

Contributing

Please try it out and let us know how it works for you. Bug reports, feature and improvement ideas, and PRs welcome.

This code is built and maintained by the Kitware Resonant team in collaboration with the UW Interactive Data Lab. The work is supported by the DARPA AFRL XDATA program.

Known issues

• Line dashes are not supported (see “barley”, “nested-plot”, “map-bind” examples).
• Triangulation of trails is known to be buggy and leave holes at internal nodes.
• Custom symbol shapes are not supported.
• Triangulation of geometry sometimes results in spurious offshoots.

Notes

There is one minor change to extrude-polyline which hacks in a way to close mitered strokes, which has not been merged upstream.