Constructor

VipsImageuhdrload

Declaration [src]

int
vips_uhdrload (
  const char* filename,
  VipsImage** out,
  ...
)

Description [src]

Read an UltraHDR image.

The UltraHDR image is decoded as a tone-mapped SDR base image plus a gainmap attached as image metadata.

Either process the SDR image and update the gainmap if necessary, or use vips_uhdr2scRGB() to convert the SDR + gainmap image to full scRGB HDR.

vips_uhdrsave() can write both scRGB HDR and SDR plus gainmap images.

Set shrink to shrink the returned image by an integer factor during load.

::: tip “Optional arguments” * shrink: gint, shrink by this factor on load

::: seealso vips_image_new_from_file(), vips_uhdr2scRGB().

Parameters

filename const char*
 

File to load.

 The data is owned by the caller of the function.
 The string is a NUL terminated UTF-8 string.
out VipsImage
 

Decompressed image.

 The argument will be set by the function.
 The called function takes ownership of the data, and is responsible for freeing it.
... none
 

NULL-terminated list of optional named arguments.

Return value

Returns: int
 

0 on success, -1 on error.