Constructor

VipsImageradload

Declaration [src]

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

Description [src]

Read a Radiance (HDR) file into a VIPS image.

Radiance files are read as VipsCoding. They have one byte for each of red, green and blue, and one byte of shared exponent. Some operations (like vips_extract_area()) can work directly with images in this format, but mmany (all the arithmetic operations, for example) will not. Unpack VipsCoding images to 3 band float with vips_rad2float() if you want to do arithmetic on them.

This operation ignores some header fields, like VIEW and DATE. It will not rotate/flip as the FORMAT string asks.

Sections of this reader from Greg Ward and Radiance with kind permission.

::: seealso vips_image_new_from_file().

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
 

Output 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.