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
)

Arguments

mesh: The target mesh.
material: Default NULL. You can pass the output of the material_list() function 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).

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` .