Constructor

VipsImageuhdrload

Declaration [src]

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

Description [src]

Read an UltraHDR image.

By default, the UltraHDR image is decoded as a tone-mapped SDR base image plus a gainmap attached as image metadata.

If hdr is set, the UltraHDR image is decoded as an HDR scRGB image. This will usually be slow and require a lot of memory.

If hdr is not set, at some later point you can use vips_uhdr2scRGB() to convert the SDR + gainmap image to full scRGB HDR.

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

Optional arguments

  • hdr: gboolean, load as an scRGB image
  • shrink: gint, shrink by this factor on load

This constructor is not directly available to language bindings.

Parameters

filename

Type: const char*

File to load.

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

Type: VipsImage

Decompressed image.

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

Type: 

NULL-terminated list of optional named arguments.

Return value

Type: int

0 on success, -1 on error.