Constructor

VipsImagetonelut

Declaration [src] 

int
vips_tonelut (
  VipsImage** out,
  ...
)

Description [src]

Optional arguments:

  • in_max: input range
  • out_max: output range
  • Lb: black-point [0-100]
  • Lw: white-point [0-100]
  • Ps: shadow point (eg. 0.2)
  • Pm: mid-tone point (eg. 0.5)
  • Ph: highlight point (eg. 0.8)
  • S: shadow adjustment (+/- 30)
  • M: mid-tone adjustment (+/- 30)
  • H: highlight adjustment (+/- 30)

vips_tonelut() generates a tone curve for the adjustment of image levels. It is mostly designed for adjusting the L* part of a LAB image in a way suitable for print work, but you can use it for other things too.

The curve is an unsigned 16-bit image with (in_max + 1) entries, each in the range [0, out_max].

Lb, Lw are expressed as 0-100, as in LAB colour space. You specify the scaling for the input and output images with the in_max and out_max parameters.

This constructor is not directly available to language bindings.

Parameters

out

Type: VipsImage

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