Adds a sprite set shape node to the scene.
sprites3d(x, y = NULL, z = NULL, radius = 1, shapes = NULL, userMatrix, fixedSize = FALSE, adj = 0.5, pos = NULL, offset = 0.25, ...) particles3d(x, y = NULL, z = NULL, radius = 1, ...)
point coordinates. Any reasonable way of defining the
coordinates is acceptable. See the function
vector or single value defining the sprite radius
NULL for a simple square, or a vector of
identifiers of shapes in the scene
shape is not
NULL, the transformation matrix
for the shapes
should sprites remain at a fixed size, or resize with the scene?
positioning arguments; see Details
material properties when
shapes = NULL, texture mapping is supported
Simple sprites (used when
NULL) are 1 by 1 squares
that are directed towards the viewpoint. Their primary use is for
fast (and faked) atmospherical effects, e.g. particles and clouds
using alpha blended textures. Particles are sprites using an alpha-blended
particle texture giving the illusion of clouds and gases.
The centre of each square will by default be at the
coordinates given by
x, y, z. This may be adjusted
pos are treated similarly to the same
adj has 3
entries, for adjustment to the
z coordinates respectively. For
x, a value
of 0 puts the sprite to the right of the specified point,
0.5 centers it there, and 1 puts it to the left. The other
coordinates are similar. By default, each value is 0.5 and
the sprites are centered at the points given by
(x, y, z).
pos parameter overrides
adj. It should
be an integer or vector of integers (one per point),
interpreted as in
text3d to position the
sprite relative to the
(x, y, z) point: 0 is centered on it, 1 is below,
2 is to the left, 3 is above, 4 is to the right, 5 is in
front, and 6 is behind.
offset is the
fraction of the sprite size to separate it from the point.
shapes is not
NULL, it should be a vector of
identifiers of objects to plot in the scene (e.g. as returned by
plotting functions or by
ids3d). These objects will
be removed from the scene and duplicated as a sprite image in a
constant orientation, as specified by
userMatrix. By default the
(0, 0, 0) will be plotted at the coordinates given by
(x, y, z), perhaps modified by
userMatrix argument is ignored for
shapes = NULL. For
sprites3d defaults the matrix to
If any coordinate is
NA, the sprite is not plotted.
The id values of the shapes may be retrieved after plotting
the user matrix is retrieved using
These functions are called for the side effect of displaying the sprites. The shape ID of the displayed object is returned.
open3d() particles3d( rnorm(100), rnorm(100), rnorm(100), color = rainbow(100) ) # is the same as sprites3d( rnorm(100), rnorm(100), rnorm(100), color = rainbow(100), lit = FALSE, alpha = .2, textype = "alpha", texture = system.file("textures/particle.png", package = "rgl") ) sprites3d( rnorm(10) + 6, rnorm(10), rnorm(10), shape = shade3d(tetrahedron3d(), col = "red") )