Set Material — set_material • rayvertex

Set the material(s) of the mesh.

set_material(
  mesh,
  material = NULL,
  id = NULL,
  diffuse = c(0.5, 0.5, 0.5),
  ambient = c(0, 0, 0),
  specular = c(1, 1, 1),
  transmittance = c(0, 0, 0),
  emission = c(0, 0, 0),
  shininess = 50,
  ior = 1,
  dissolve = 1,
  illum = 1,
  texture_location = "",
  normal_texture_location = "",
  bump_texture_location = "",
  specular_texture_location = "",
  ambient_texture_location = "",
  emissive_texture_location = "",
  diffuse_intensity = 1,
  bump_intensity = 1,
  specular_intensity = 1,
  emission_intensity = 1,
  ambient_intensity = 1,
  culling = "back",
  type = "diffuse",
  translucent = TRUE,
  toon_levels = 5,
  toon_outline_width = 0.05,
  toon_outline_color = "black",
  reflection_intensity = 0,
  reflection_sharpness = 0,
  two_sided = FALSE,
  sigma = 0
)

Arguments

mesh: The target mesh.
material: Default NULL. You can pass the output of material_list() to specify the material, or use the following individual settings.
id: Default 1. Either a number specifying the material to change, or a character vector matching the material name.
diffuse: Default c(0.5,0.5,0.5). The diffuse color.
ambient: Default c(0,0,0). The ambient color.
specular: Default c(1,1,1). The specular color.
transmittance: Default c(0,0,0). The transmittance.
emission: Default c(0,0,0). The emissive color.
shininess: Default 50.0. The shininess exponent.
ior: Default 1.0. The index of refraction. If this is not equal to 1.0, the material will be refractive.
dissolve: Default 1.0. The transparency.
illum: Default 1.0. The illumination.
texture_location: Default "". The diffuse texture location.
normal_texture_location: Default "". The normal texture location.
bump_texture_location: Default "". The bump texture location.
specular_texture_location: Default "". The specular texture location.
ambient_texture_location: Default "". The ambient texture location.
emissive_texture_location: Default "". The emissive texture location.
diffuse_intensity: Default 1. The diffuse intensity.
bump_intensity: Default 1. The bump intensity.
specular_intensity: Default 1. The specular intensity.
emission_intensity: Default 1. The emission intensity.
ambient_intensity: Default 1. The ambient intensity.
culling: Default "back". The culling type. Options are back, front, and none.
type: Default "diffuse". The shader type. Options include diffuse,phong,vertex, and color.
translucent: Default TRUE. Whether light should transmit through a semi-transparent material.
toon_levels: Default 5. Number of color breaks in the toon shader.
toon_outline_width: Default 0.05. Expansion term for model to specify toon outline width. Note: setting this property via this function currently does not generate outlines. Specify it during object creation.
toon_outline_color: Default black. Toon outline color. Note: setting this property via this function currently does not color outlines. Specify it during object creation.
reflection_intensity: Default 0.0. Intensity of the reflection of the environment map, if present. This will be ignored if the material is refractive.
reflection_sharpness: Default 1.0. Sharpness of the reflection, where lower values have blurrier reflections. Must be greater than zero and less than one.
two_sided: Default NULL. Whether diffuse materials should be two sided (normal is taken as the absolute value of the dot product of the light direction and the normal).
sigma: Default 0. Oren-Nayar angle.

Value

Shape with new material

Examples

if(run_documentation()) {
#Set the material of an object
generate_cornell_mesh() |>
 add_shape(set_material(sphere_mesh(position=c(400,555/2,555/2),radius=40), 
                        diffuse="purple", type="phong")) |>
 add_shape(set_material(sphere_mesh(position=c(555/2,220,555/2),radius=40),
                        dissolve=0.2,culling="none",diffuse="red")) |>
 add_shape(set_material(sphere_mesh(position=c(155,300,555/2),radius=60), 
                        material = material_list(diffuse="gold", type="phong", 
                                                 ambient="gold", ambient_intensity=0.4))) |>
 rasterize_scene(light_info=directional_light(direction=c(0.1,0.6,-1)))
 }
#> Setting default values for Cornell box: lookfrom `c(278,278,-800)` lookat `c(278,278,0)` fov `40` .