change_material {rayvertex}

Change Material

Description

Change individual material properties, leaving others alone.

Usage

change_material(
  mesh,
  id = NULL,
  sub_id = 1,
  diffuse = NULL,
  ambient = NULL,
  specular = NULL,
  transmittance = NULL,
  emission = NULL,
  shininess = NULL,
  ior = NULL,
  dissolve = NULL,
  illum = NULL,
  texture_location = NULL,
  normal_texture_location = NULL,
  bump_texture_location = NULL,
  specular_texture_location = NULL,
  ambient_texture_location = NULL,
  emissive_texture_location = NULL,
  diffuse_intensity = NULL,
  bump_intensity = NULL,
  specular_intensity = NULL,
  emission_intensity = NULL,
  ambient_intensity = NULL,
  culling = NULL,
  type = NULL,
  translucent = NULL,
  toon_levels = NULL,
  toon_outline_width = NULL,
  toon_outline_color = NULL,
  reflection_intensity = NULL,
  reflection_sharpness = NULL,
  two_sided = NULL
)

Arguments

mesh

Mesh to change.

id

Default NULL. Either a number specifying the material to change, or a character vector matching the material name.

sub_id

Default 1. A number specifying which material to change (within an id).

diffuse

Default NULL. The diffuse color.

ambient

Default NULL. The ambient color.

specular

Default NULL. The specular color.

transmittance

Default NULL. The transmittance

emission

Default NULL. The emissive color.

shininess

Default NULL. The shininess exponent.

ior

Default NULL. The index of refraction. If this is not equal to 1.0, the material will be refractive.

dissolve

Default NULL. The transparency.

illum

Default NULL. The illumination.

texture_location

Default NULL. The diffuse texture location.

normal_texture_location

Default NULL. The normal texture location.

bump_texture_location

Default NULL. The bump texture location.

specular_texture_location

Default NULL. The specular texture location.

ambient_texture_location

Default NULL. The ambient texture location.

emissive_texture_location

Default NULL. The emissive texture location.

diffuse_intensity

Default NULL. The diffuse intensity.

bump_intensity

Default NULL. The bump intensity.

specular_intensity

Default NULL. The specular intensity.

emission_intensity

Default NULL. The emission intensity.

ambient_intensity

Default NULL. The ambient intensity.

culling

Default NULL. The culling type. Options are back, front, and none.

type

Default NULL. The shader type. Options include diffuse,phong,vertex, and color.

translucent

Default NULL. Whether light should transmit through a semi-transparent material.

toon_levels

Default NULL. Number of color breaks in the toon shader.

toon_outline_width

Default NULL. 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 NULL. Toon outline color.Note: setting this property via this function currently does not color outlines. Specify it during object creation.

reflection_intensity

Default NULL. Intensity of the reflection of the environment map, if present. This will be ignored if the material is refractive.

reflection_sharpness

Default NULL. 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 settings

Examples

if(run_documentation()) {
p_sphere = sphere_mesh(position=c(555/2,555/2,555/2), 
                      radius=40,material=material_list(diffuse="purple"))
generate_cornell_mesh() |>
 add_shape(translate_mesh(p_sphere,c(0,-100,0))) |>
 add_shape(change_material(translate_mesh(p_sphere,c(200,-100,0)),diffuse="red")) |>
 add_shape(change_material(translate_mesh(p_sphere,c(100,-100,0)),dissolve=0.5)) |>
 add_shape(change_material(translate_mesh(p_sphere,c(-100,-100,0)),type="phong")) |>
 add_shape(change_material(translate_mesh(p_sphere,c(-200,-100,0)),type="phong",shininess=30)) |>
 rasterize_scene(light_info=directional_light(direction=c(0.1,0.6,-1)))
}  

if(run_documentation()) {
#Change several shapes at once
p_sphere |>
 add_shape(change_material(translate_mesh(p_sphere,c(200,0,0)),diffuse="red")) |>
 add_shape(change_material(translate_mesh(p_sphere,c(100,0,0)),dissolve=0.5)) |>
 add_shape(change_material(translate_mesh(p_sphere,c(-100,0,0)),type="phong")) |>
 add_shape(change_material(translate_mesh(p_sphere,c(-200,0,0)),type="phong",shininess=30)) |>
 change_material(diffuse = "red") |> 
 add_shape(generate_cornell_mesh()) |> 
 rasterize_scene(light_info=directional_light(direction=c(0.1,0.6,-1)))
}