rgl (version 0.70)

rgl.material: Generic Appearance setup

Description

Set material properties for geometry appearance.

Usage

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(...)

Arguments

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 [object Object],[object Object],[object Object],[object Object],[object Object]

texmipmap

Logical, specifies if the texture should be mipmapped.

texmagfilter

specifies the magnification filtering type (sorted by ascending quality): [object Object],[object Object]

texminfilter

specifies the minification filtering type (sorted by ascending quality): [object Object],[object Object],[object Object],[object Object],[object Object],[object Object]

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: [object Object],[object Object],[object Object],[object Object]

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.

Value

• rgl.material() is called for the side effect of setting the material properties. It returns a value invisibly which is not intended for use by the user.

  Users should use material3d() to query material properties. It returns values similarly to par3d as follows: When setting properties, it returns the previous values in a named list. A named list is also returned when more than one value is queried. When a single value is queried it is returned directly.

Details

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.

See Also

rgl.primitive, rgl.bbox, rgl.bg, rgl.light

Examples

save <- material3d("color")
material3d(color="red")
material3d("color")
material3d(color=save)