These functions allow RGL graphics to be embedded in knitr documents.
The simplest method is to run
setupKnitr(autoprint = TRUE)
early in the document. That way RGL commands act a lot
like base graphics commands: plots will be automatically inserted
where appropriate, according to the
fig.keep chunk option.
By default (
fig.keep = "high"), only high-level plots
are kept, after low-level changes have been merged into them.
See the knitr documentation
https://yihui.org/knitr/options/#plots for more details. To suppress auto-printing, the RGL calls
can be wrapped in
Similarly to grid graphics (used by lattice
and ggplot2), automatic inclusion requires the object
to be printed: only the last statement in a code block
in braces is automatically printed. Unlike those
packages, auto-printing is the only way to get this to
Other functions allow embedding either as bitmaps (
hook_rgl with format
fixed vector graphics (
hook_rgl with format
"postscript"), or interactive WebGL graphics (
hook_rglchunk is not normally invoked by the
user; it is the hook that supports automatic creation and
deletion of RGL scenes.
setupKnitr(autoprint = FALSE, rgl.newwindow = autoprint, rgl.closewindows = autoprint) hook_rgl(before, options, envir) hook_webgl(before, options, envir) hook_rglchunk(before, options, envir)
If true, RGL commands
automatically plot (with low level plots suppressed by
the default value of the
Default values for the knitr chunk options.
|before, options, envir||
Standard knitr hook function arguments.
setupKnitr(autoprint = TRUE) method assumes
all printing of RGL objects happens through
auto-printing of objects produced by the
highlevel functions. All RGL functions that
produce graphics do this, but functions in other packages that
call them may not return values appropriately.
If you have multiple calls to
should have the same arguments. If any differ, a
warning will be issued, and the first set of arguments
will be used.
Mixing explicit calls
rglwidget with auto-printing is likely to lead to failure of some
scenes to display. To avoid this, set
options(rgl.printRglwidget = FALSE) before using such explicit calls. Similarly,
use that option before calling the
in a code chunk if the example prints RGL objects.
setupKnitr() function needs to be called once
at the start of the document to install the knitr hooks.
If it is called twice in the same session the second call
will override the first.
The following chunk options are supported:
rgl.newwindow: Whether to open a new window for the chunk. Default is set by
to close windows at the end of the chunk. Default is set by
rgl.margin (default 100): number of pixels by which to indent the
snapshot: Logical value: when autoprinting
in HTML, should a snapshot be used instead of the dynamic
WebGL display? Corresponds to
rglwidget(snapshot = TRUE, webgl = FALSE). Ignored in LaTeX, where a snapshot
will always be produced (unless
no figure at all).
fig.height: standard knitr chunk
options used to set the size of the output.
fig.beforecode: standard knitr chunk options used to control the
display of plots.
dev: used by
hook_rgl to set
the output format. May be
rgl.keepopen: no longer used. Ignored
with a warning.
A string to be embedded into the output, or
NULL if called
when no output is available.
hook* functions are originally by Yihui Xie in the knitr package; and have been modified by
Duncan Murdoch. Some parts of the
duplicate source code from knitr.