Method

VipsImagecomplexform

Declaration [src]

int
vips_complexform (
  VipsImage* left,
  VipsImage* right,
  VipsImage** out,
  ...
)

Description [src]

Compose two real images to make a complex image. If either left or right are VipsBandFormat, out is VipsBandFormat. Otherwise out is VipsBandFormat. left becomes the real component of out and right the imaginary.

If the number of bands differs, one of the images must have one band. In this case, an n-band image is formed from the one-band image by joining n copies of the one-band image together, and then the two n-band images are operated upon.

::: seealso vips_complexget().

Parameters

`right`	`VipsImage`
	Input image.
	The data is owned by the caller of the function.
`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.
`...`	`none`
	`NULL`-terminated list of optional named arguments.

Return value

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