node package manager


Renders 2D surfaces


Draws a surface plot

var shell = require("gl-now")({ clearColor: [0,0,0,0] })
var camera = require("game-shell-orbit-camera")(shell)
var createSurfacePlot = require("gl-surface-plot")
var ndarray = require("ndarray")
var fill = require("ndarray-fill")
var diric = require("dirichlet")
var glm = require("gl-matrix")
var mat4 = glm.mat4
var surface
shell.on("gl-init", function() {
  var gl =
  //Set up camera 
    [0, 0, 2],      //Eye position 
    [256, 256, 64], //Eye target 
    [0, 0, 1])      //Up direction 
  //Create field 
  var field = ndarray(new Float32Array(512*512), [512,512])
  fill(field, function(x,y) {
    return 128 * diric(10, 10.0*(x-256)/512) * diric(10, 10.0*(y-256)/512)
  surface = createSurface(gl, field)
shell.on("gl-render", function() {
    view: camera.view(),
    projection:  mat4.perspective(new Array(16), Math.PI/4.0, shell.width/shell.height, 0.1, 10000.0)

Here is what this should look like:

Test it in your browser (requires WebGL)

npm install gl-surface-plot
var createSurfacePlot = require("gl-surface-plot")

Creates a surface plot object

  • gl is a WebGL context

  • field is a 2D ndarray

  • params is an optional collection of arguments that contains any of the following:

    • colormap - the name of the color map to use for the surface (default "jet")
    • pickId is the picking id for the surface

Returns A surface object

Updates the surface. The parameter object may contain any of the following properties:

  • field a new 2D field encoded as an ndarray
  • colormap the name of the new color map for the surface
  • pickId is the picking id for the surface
  • ticks is a pair of arrays of ticks representing the spacing of the points for the axes of the surface
  • showSurface if set, draw the surface
  • showContour if set, draw contour lines
  • contourWidth the width fo the contour lines
  • contourTint the amount of tint of the contour lines
  • contourColor the color of the contour line tint
  • levels an array of arrays representing the level of the isolines.
  • dynamicWidth the width of the dynamic isolines
  • dynamicColors the color of the dynamic isolines
  • dynamicTint the tint of the dynamic isolines

Draws the surface. Accepts the following parameters

  • model the 4x4 model matrix (in gl-matrix format)
  • view the 4x4 view matrix
  • projection the 4x4 projection matrix

Destroys the surface, releases all associated WebGL resources

A pair of 3D arrays representing the lower/upper bounding box for the surface plot.

A pair of arrays which bound the coordinates of the surface plot in 3D.

Draws the surface for point picking mode

Test if the given selection is contained in the surface. If true, returns an object encoding the selected point.

Returns An object encoding the selected point on the surface with the following properties:

  • position which is the position of the selected point on the surface
  • index a vector encoding the [x,y] index of the closest data point
  • uv the uv coordinate of the selection
  • levels the closest levels to the selection

Toggles drawing level isolines and their projections.

  • levels is an array of 3 arrays representing the x/y/z levels to draw

You can also tweak the lighting parameters for the surface using the following variables

The position of the light source relative to the viewer in clip coordinates

The fraction of light which is ambiently lit

The amount of diffuse light to apply to the surface

THe amount of speculare light to apply to the surface

How rough the surface is (must be between 0 and 1)

The amount of rim lighting to apply. Higher values = more intense rim light.

MIT License.