rgl.material {rgl} | R Documentation |
Set material properties for geometry appearance.
rgl.material( color = c("white"), alpha = c(1.0), lit = TRUE, ambient = "black", specular = "white", emission = "black", shininess = 50.0, smooth = TRUE, texture = NULL, textype = "rgb", texmipmap = FALSE, texminfilter = "linear", texmagfilter = "linear", texenvmap = FALSE, front = "fill", back = "fill", size = 1.0, fog = TRUE, ... ) material3d(...)
color |
vector of R color characters. Represents the diffuse component in case of lighting calculation (lit = TRUE), otherwise it describes the solid color characteristics. |
lit |
logical, specifying if lighting calculation should take place on geometry |
ambient, specular, emission, shininess |
properties for lighting calculation. ambient, specular, emission are R color character string values; shininess represents a numerical. |
alpha |
vector of alpha values between 0.0 (fully transparent) .. 1.0 (opaque). |
smooth |
logical, specifying whether gourad shading (smooth) or flat shading should be used. |
texture |
path to a texture image file. Supported formats: png. |
textype |
specifies what is defined with the pixmap
|
texmipmap |
Logical, specifies if the texture should be mipmapped. |
texmagfilter |
specifies the magnification filtering type (sorted by ascending quality):
|
texminfilter |
specifies the minification filtering type (sorted by ascending quality):
|
texenvmap |
logical, specifies if auto-generated texture coordinates for environment-mapping should be performed on geometry. |
front, back |
Determines the polygon mode for the specified side:
|
size |
numeric, specifying the line and point size. |
fog |
logical, specifying if fog effect should be applied on the corresponding shape |
... |
Any of the arguments above; see Details below. |
Only one side at a time can be culled.
material3d
is an alternate interface to the material properties, modelled after
par3d
: rather than setting defaults for parameters that are not specified,
they will be left unchanged. material3d
may also be used to query the material
properties; see the examples below.
The current implementation does not return parameters for textures.
The ...
parameter to rgl.material
is ignored.
rgl.primitive
,
rgl.bbox
,
rgl.bg
,
rgl.light
save <- material3d("color") material3d(color="red") material3d("color") material3d(color=save)