Method
VipsImagecast
Declaration [src]
int
vips_cast (
VipsImage* in,
VipsImage** out,
VipsBandFormat format,
...
)
Description [src]
Optional arguments:
shift
: %gboolean, integer values are shifted
Convert in
to format
. You can convert between any pair of formats.
Floats are truncated (not rounded). Out of range values are clipped.
Casting from complex to real returns the real part.
If shift
is TRUE
, integer values are shifted up and down. For example,
casting from unsigned 8 bit to unsigned 16 bit would
shift every value left by 8 bits. The bottom bit is copied into the new
bits, so 255 would become 65535.
See also: vips_scale(), vips_complexform(), vips_real(), vips_imag(), vips_cast_uchar(), vips_msb().
This method 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 method takes ownership of the returned data, and is responsible for freeing it. format
-
Type:
VipsBandFormat
Format to convert to.
...
-
Type:
NULL
-terminated list of optional named arguments.