`planes3d`

and `rgl.planes`

add mathematical planes
to a scene. Their intersection with the current
bounding box will be drawn. `clipplanes3d`

and `rgl.clipplanes`

add clipping planes to a scene.

1 2 3 4 |

`a, b, c` |
Coordinates of the normal to the plane. Any reasonable way of defining the
coordinates is acceptable. See the function |

`d` |
Coordinates of the "offset". See the details. |

`...` |
Material properties. See |

`planes3d`

and `rgl.planes`

draw planes using the parametrization
*a x + b y + c z + d = 0*. Multiple planes may be specified
by giving multiple values for any of `a, b, c, d`

; the other
values will be recycled as necessary.

`clipplanes3d`

and `rgl.clipplanes`

define clipping planes
using the same equations. Clipping planes suppress the display of
other objects (or parts of them) in the subscene, based on their coordinates.
Points (or parts of lines or surfaces) where the coordinates `x, y, z`

satisfy *a x + b y + c z + d < 0* will be suppressed.

The number of clipping planes
supported by the OpenGL driver is implementation dependent; use
`par3d("maxClipPlanes")`

to find the limit.

A shape ID of the planes or clipplanes object is returned invisibly.

`abclines3d`

, `rgl.abclines`

for mathematical lines.

`triangles3d`

, `rgl.triangles`

or the corresponding
functions for quadrilaterals may be used to draw sections of planes that
do not adapt to the bounding box.

The example in subscene3d shows how to combine clipping planes to suppress complex shapes.

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 | ```
# Show regression plane with z as dependent variable
open3d()
x <- rnorm(100)
y <- rnorm(100)
z <- 0.2*x - 0.3*y + rnorm(100, sd = 0.3)
fit <- lm(z ~ x + y)
plot3d(x, y, z, type = "s", col = "red", size = 1)
coefs <- coef(fit)
a <- coefs["x"]
b <- coefs["y"]
c <- -1
d <- coefs["(Intercept)"]
planes3d(a, b, c, d, alpha = 0.5)
open3d()
ids <- plot3d(x, y, z, type = "s", col = "red", size = 1, forceClipregion = TRUE)
useSubscene3d(ids["clipregion"])
clipplanes3d(a, b, c, d)
``` |

Questions? Problems? Suggestions? Tweet to @rdrrHQ or email at ian@mutexlabs.com.

Please suggest features or report bugs with the GitHub issue tracker.

All documentation is copyright its authors; we didn't write any of that.