Function

Vipscall

Declaration [src]

int
vips_call (
  const char* operation_name,
  ...
)

Description [src]

Vips_call() calls the named operation, passing in required arguments and then setting any optional ones from the remainder of the arguments as a set of name/value pairs.

For example, vips_embed() takes six required arguments, in, out, x, y, width, height, and has two optional arguments, extend and background. You can run it with vips_call() like this:

VipsImage *in = ...
VipsImage *out;

if( vips_call( "embed", in, &out, 10, 10, 100, 100,
    "extend", VIPS_EXTEND_COPY,
    NULL ) )
    ... error

Normally of course you’d just use the vips_embed() wrapper function and get type-safety for the required arguments.

See also: vips_call_split(), vips_call_options().

This function is not directly available to language bindings

Parameters

`operation_name`	`const char*`
	Name of operation to call.
	The data is owned by the caller of the function.
	The value is a NUL terminated UTF-8 string.
`...`
	Required args, then a `NULL`-terminated list of argument/value pairs.

Return value

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