rayshader (version 0.13.2)

render_water: Render Water Layer

Description

Adds water layer to the scene, removing the previous water layer if desired.

Usage

render_water(heightmap, waterdepth = 0, watercolor = "lightblue",
  zscale = 1, wateralpha = 0.5, waterlinecolor = NULL,
  waterlinealpha = 1, linewidth = 2, remove_water = TRUE)

Arguments

heightmap

A two-dimensional matrix, where each entry in the matrix is the elevation at that point. All points are assumed to be evenly spaced.

waterdepth

Default `0`.

watercolor

Default `lightblue`.

zscale

Default `1`. The ratio between the x and y spacing (which are assumed to be equal) and the z axis. For example, if the elevation levels are in units of 1 meter and the grid values are separated by 10 meters, `zscale` would be 10.

wateralpha

Default `0.5`. Water transparency.

waterlinecolor

Default `NULL`. Color of the lines around the edges of the water layer.

waterlinealpha

Default `1`. Water line tranparency.

linewidth

Default `2`. Width of the edge lines in the scene.

remove_water

Default `TRUE`. If `TRUE`, will remove existing water layer and replace it with new layer.

Examples

# NOT RUN {
montereybay %>%
 sphere_shade() %>%
 plot_3d(montereybay,zscale=50)
render_snapshot()
# }
# NOT RUN {
 
#We want to add a layer of water after the initial render.
# }
# NOT RUN {
render_water(montereybay,zscale=50)
render_snapshot()
# }
# NOT RUN {
#Call it again to change the water depth
# }
# NOT RUN {
render_water(montereybay,zscale=50,waterdepth=-1000)
render_snapshot()
# }
# NOT RUN {
#Add waterlines
# }
# NOT RUN {
render_camera(theta=-45)
render_water(montereybay,zscale=50,waterlinecolor="white")
render_snapshot(clear = TRUE)
rgl::rgl.close()
# }