writeWebGL: Write scene to HTML.

Description Usage Arguments Details Value Note Note Author(s) References See Also Examples

View source: R/webGL.R

Description

Writes the current scene to a collection of files that contain WebGL code to reproduce it in a browser.

Usage

1
2
3
4
5
writeWebGL(dir = "webGL", filename = file.path(dir, "index.html"), 
           template = system.file(file.path("WebGL", "template.html"), package = "rgl"),
           prefix = "",
           snapshot = TRUE, commonParts = TRUE, reuse = NULL, 
           font = "Arial", width, height)

Arguments

dir

Where to write the files.

filename

The filename to use for the main file.

template

The template web page to which to write the Javascript for the scene. See Details below.

prefix

An optional prefix to use on global identifiers in the scene; use different prefixes for different scenes displayed on the same web page. If not blank, it should be a legal identifier in Javascript and HTML.

snapshot

Whether to include a snapshot of the scene, to be displayed in browsers that don't support WebGL, or a specification of the snapshot to use. See details below.

commonParts

Whether to include parts that would be common to several figures on the same page. Currently this includes a reference to and copy of the ‘CanvasMatrix.js’ file in the output.

reuse

When writing several figures on the same page, set this to a dataframe containing values to reuse. See the Value section below.

font

The font to use for text.

width, height

The (optional) width and height in pixels of the image to display. If omitted, the par3d("windowRect") dimensions will be used.

Details

This function writes out a web page containing Javascript that reconstructs the scene in WebGL.

Use the template argument to give the filename of a web page that is to contain the code for the new scene. It should contain a single line containing paste0("%", prefix, "WebGL%"), e.g. %WebGL% with the default empty prefix. That line will be replaced by the Javascript and other code necessary to reproduce the current scene. The template may also contain the string "%rglVersion%" which will be replaced with the current rgl version number. If template is NULL, the output will simply be written directly to the main file.

To put more than one scene into a web page, use different values of prefix for each. The prefix will be used in identifiers in both Javascript and HTML, so it is safest to start with a letter and only use alphanumeric characters.

WebGL is a fairly new technology for displaying 3D scenes in browsers. Most current browsers support it to some extent, though it may not be enabled by default; see http://get.webgl.org for details. A major exception currently is Microsoft's Internet Explorer, though plugins are available.

Currently writeWebGL has a number of known limitations, some of which will be gradually eliminated as development progresses:

Value

The filename is returned. If reuse is not NULL, it will have an attribute called "reuse" which contains a dataframe with columns "id" and "prefix" identifying the prefix used for objects drawn in this scene. This dataframe can be used as the reuse argument in subsequent calls to writeWebGL.

Note

This function is deprecated in favour of the rglwidget() function.

Note

If commonParts is TRUE, the output includes a binary copy of the CanvasMatrix Javascript library. This file is necessary for the Javascript code written by writeWebGL to function properly, but only one copy is needed if the output page contains multiple writeWebGL figures.

Its source (including the copyright notice and license for free use) is included in the file named by system.file("htmlwidgets/lib/CanvasMatrix.src.js", package = "rgl").

Author(s)

Duncan Murdoch.

References

http://www.webgl.org

See Also

scene3d saves a copy of a scene to an R variable; writeASY, writePLY, writeOBJ and writeSTL write the scene to a file in various other formats.

Examples

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
  plot3d(rnorm(100), rnorm(100), rnorm(100), type = "s", col = "red")
  # This writes a copy into temporary directory 'webGL', and then displays it
  filename <- writeWebGL(dir = file.path(tempdir(), "webGL"), 
                       width = 500, reuse = TRUE)
  # Display the "reuse" attribute
  attr(filename, "reuse")

  # Display the scene in a browser
  if (interactive())
    browseURL(paste0("file://", filename))

rgl documentation built on Jan. 14, 2018, 5:06 a.m.