Write Image — ray_write_image • rayimage

Takes an RGB array/filename and writes it to file.

ray_write_image(image, filename, clamp = NA, ...)

Arguments

image: 3-layer RGB/4-layer RGBA array, rayimg class, or filename of an image.
filename: File to write to, with filetype determined by extension. Filetype can be PNG, JPEG, TIFF, or EXR.
clamp: Default NA, automatically determined. Whether to clamp the image to 0-1. If the file extension is PNG of JPEG, this is forced to TRUE.
...: Arguments to pass to either jpeg::writeJPEG, png::writePNG, or tiff::writeTIFF.

Value

A rayimg RGBA array.

Examples

if(run_documentation()){
#Write as a png
tmparr = tempfile(fileext=".png")
ray_read_image(dragon) |>
 ray_write_image(tmparr)
ray_read_image(tmparr) |>
 plot_image()
}
#> Error in !gamma_corrected: invalid argument type
if(run_documentation()){
#Write as a JPEG (passing quality arguments via ...)
tmparr = tempfile(fileext=".jpg")
ray_read_image(dragon) |>
 ray_write_image(tmparr, quality = 0.2)
ray_read_image(tmparr) |>
 plot_image()
}
#> Error in !gamma_corrected: invalid argument type
if(run_documentation()){
#Write as a tiff
tmparr = tempfile(fileext=".tiff")
ray_read_image(dragon) |>
 ray_write_image(tmparr)
ray_read_image(tmparr) |>
  plot_image()
}
#> Warning: The input contains values outside the [0, 1] range - storage of such values is undefined
#> Warning: TIFFReadDirectory: Sum of Photometric type-related color channels and ExtraSamples doesn't match SamplesPerPixel. Defining non-color channels as ExtraSamples.