Skip to main content

@vis.gl/tangram-renderer

The renderer package owns Tangram scenes, tiles, styles, labels, resource management, and luma.gl draw submission. It has no deck.gl or Leaflet dependency.

Public entrypoint​

import Tangram, {
  ClassicWebGLRenderer,
  HostFrame,
  LumaDeviceRenderer,
  Scene
} from '@vis.gl/tangram-renderer';

The default export preserves the legacy Tangram API. Named exports are the host-integration boundary:

  • Scene loads scene configuration and owns camera/tile state.
  • ClassicWebGLRenderer drives classic scene traversal and submits work to a host device/render pass. The historical named Renderer alias remains for compatibility.
  • HostFrame carries shared geographic state and one or more named camera views supplied by the embedding application.
  • LumaDeviceRenderer provides the luma.gl resource backend used by WebGL and WebGPU paths.
  • debug and version remain available for legacy consumers.

The repository's classic example carries its own Leaflet adapter. Keeping that adapter outside this package prevents host interaction and camera code from entering applications that use the renderer through deck.gl.

The renderer accepts an externally owned luma.gl device through its renderer options. Applications should use the device and render pass supplied by their host rather than reading a backend handle.

Style schema entrypoint​

Scene documents can be validated with the optional schema entrypoint:

import {TangramStyleSheetSchema} from '@vis.gl/tangram-renderer/style-schema';

const parsedScene = TangramStyleSheetSchema.parse(sceneDocument);

The generated JSON Schema is available at @vis.gl/tangram-renderer/tangram-style.schema.json for Monaco, YAML language servers, and other editor integrations.