Skip to contents

ggWebGL, Browser-Native ‘WebGL’ Rendering for R Graphics

Frédéric Bertrand

ggWebGL is an R package for browser-native WebGL rendering of R graphics through htmlwidgets. It supports grammar-style graphics workflows and renderer-ready specifications for dense analytical and scientific scenes, including point, line, trajectory, raster, vector, mesh, and surface layers, shader-driven display modes, timeline controls, structured views, selection metadata, Shiny output, and publication-oriented static export helpers.

The package keeps rendering in the browser and avoids any mandatory CUDA, Metal, or OpenCL toolchain. Heavier preprocessing, large-data preparation, and device-specific acceleration are left to companion packages.

Scope

ggWebGL provides two complementary interfaces:

  • grammar-style layers for selected ggplot2 workflows;
  • renderer-ready layer and specification helpers for downstream packages or custom visualization pipelines.

The package provides browser-native rendering, widget construction, renderer-ready specifications, shader modes, interaction contracts, structured views, timelines, and static export surfaces. It does not implement downstream scientific, simulation, topological, model-explanation, or domain-specific semantics. Those semantics should enter ggWebGL through explicit adapter boundaries such as backend-neutral tables, renderer-ready primitive layers, or ggwebgl_spec payloads.

Status

The current implementation supports:

Feature Current status
geom_point_webgl() Rendered in WebGL
geom_line_webgl() Rendered in WebGL
geom_raster_webgl() Rendered in WebGL
geom_vector_webgl() Renderer path for vector-arrow layers
geom_mesh_webgl() Renderer path for indexed mesh layers
geom_surface_webgl() Renderer path for triangulated surface layers
Renderer-ready layers Points, lines, vectors, rasters, meshes, and surfaces through ggwebgl_layer_*() helpers
Renderer specification ggwebgl_spec() and as_ggwebgl_spec() adapter boundaries
Shader modes default, density_splat, trajectory_age, trajectory_age_glow
Interaction pan, zoom, hover; visible brush and lasso selection through ggwebgl_selection()
Runtime controls Exact/cumulative timeline controls through ggwebgl_timeline()
View contract Structured 2D/3D view and camera metadata through ggwebgl_view()
Output targets R Markdown / Quarto HTML, Shiny, and static image export helpers
ggplot2 compatibility Focused grammar-preserving paths for dense scenes and fixed-scale facets
Unsupported facet mode Free x/y scales fall back to metadata

ggWebGL is not a full replacement for ggplot2. It is a browser-native WebGL rendering backend with both grammar-style front ends and explicit renderer-ready adapter boundaries.

Installation 

install.packages("ggWebGL")

For the development version:

# install.packages("remotes")
remotes::install_github("fbertran/ggWebGL")

Basic use 

library(ggplot2)
library(ggWebGL)

plot <- ggplot(diamonds, aes(carat, price, colour = cut)) +
  geom_point_webgl(size = 1.1, alpha = 0.18) +
  theme_webgl(
    shader = "density_splat",
    interactions = c("pan", "zoom", "hover")
  )

ggplot_webgl(plot, height = 520)

Renderer-ready specifications

ggWebGL can also render explicit primitive layers without requiring the input to originate from a ggplot2 object.

library(ggWebGL)

points <- ggwebgl_layer_points(
  data.frame(
    x = c(0, 1, 2),
    y = c(2, 1, 0),
    colour = c("#0f766e", "#f97316", "#2563eb")
  ),
  x = "x",
  y = "y",
  colour = "colour",
  size = 4
)

spec <- ggwebgl_spec(
  layers = list(points),
  labels = list(title = "Renderer-ready point layer")
)

ggWebGL(spec, height = 420)

Architecture

  1. Parse supported grammar-style point, line, raster, vector, mesh, surface, and fixed-scale facet layers.
  2. Normalize parsed layers into a renderer-scene contract.
  3. Accept renderer-ready primitive payloads from explicit adapter boundaries.
  4. Resolve raster fills and styling metadata on the R side.
  5. Bind panel-local payloads to browser-side WebGL buffers, textures, attributes, and shader modes.
  6. Render interactively through an htmlwidgets widget.
  7. Reuse the same widget in Shiny.

For static capture and publication workflows, ggWebGL exposes: