SYNOPSIS

vips [options] [command] [command-options] [command-args]

DESCRIPTION

vips(1) is the VIPS universal main program. You can use it to run any VIPS operation from the command line, to query the VIPS class hierarchy, and to maintain parts of the VIPS library.

To run a VIPS function, the first argument should be the name of the function and following arguments should be the function parameters. For example:

  $ vips invert lena.v lena2.v

OPTIONS

-p PLUGIN, --plugin=PLUGIN

Load PLUGIN. Note that plugins in $VIPSHOME/lib are loaded automatically.

-v, --version

Show VIPS version.

COMMANDS

list PACKAGE

List operations defined in PACKAGE. PACKAGE can also be "classes", "packages" or "all".

cpph PACKAGE

Print C++ header for PACKAGE. PACKAGE can also be a function name, or "all".

cppc PACKAGE

Print C++ binding for PACKAGE. PACKAGE can also be a function name, or "all".

operation-name operation-arguments

Execute a named operation, for example im_invert, or add. Names prefixed with "im_" are called via the vips7 interface, names without the prefix use the new vips8 interface.

EXAMPLES

Run a vips8 operation. Operation options must follow the operation name.

  $ vips insert lena.v lena2.v out.v 0 0 --background "128 0 0"

Get a "usage" message for an operation

  $ vips insert
  insert image @sub into @main at @x, @y
  usage:
     insert main sub out x y
  where:
     main         - Main input image, input VipsImage
     sub          - Sub-image to insert into main image, input VipsImage
     out          - Output image, output VipsImage
     x            - Left edge of sub in main, input gint
     y            - Top edge of sub in main, input gint
  optional arguments:
     expand       - Expand output to hold all of both inputs, input gboolean
     background   - Colour for new pixels, input VipsArrayDouble
  operation flags: sequential-unbuffered
  insert: too few arguments

RETURN VALUE

returns 0 on success and non-zero on error.

RELATED TO vips…

COPYRIGHT

The National Gallery and Birkbeck College, 1989-1996.