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`	`VipsImage`
	Output image.
	The argument will be set by the function.
	The instance takes ownership of the data, and is responsible for freeing it.
`format`	`VipsBandFormat`
	Format to convert to.
`...`
	`NULL`-terminated list of optional named arguments.

Return value

Returns:	`int`
	0 on success, -1 on error.