rayimage (version 0.27.1)

render_environment_white_balance: White Balance with a Lat-Long Environment Map

Description

Estimate a lat-long environment map's scene white and pass it to render_white_balance() as reference_white. This is a camera-style white balance for renders lit by an environment map.

Usage

render_environment_white_balance(
  image,
  environment_map,
  target_white = "D65",
  bake = TRUE,
  weighting = "cosine",
  hemisphere = "upper",
  environment_colorspace = NULL,
  environment_white = NULL,
  filename = NULL,
  preview = FALSE
)

Value

A white-balanced rayimg. The estimated white is attached as the environment_white attribute.

Arguments

image

3-layer RGB/4-layer RGBA array, rayimg, or filename.

environment_map

Lat-long environment map image, rayimg, array, or filename.

target_white

Default "D65". Target white (XYZ Y=1 or named).

bake

Default TRUE. Passed to render_white_balance().

weighting

Default "cosine". Passed to the environment white estimator.

hemisphere

Default "upper". Passed to the environment white estimator.

environment_colorspace

Default NULL. Optional colorspace descriptor used to tag environment_map on read.

environment_white

Default NULL. Optional white point used to tag environment_map on read.

filename

Default NULL. Output path.

preview

Default FALSE. If TRUE, display the image.