vips(1) General Commands Manual vips(1)
NAME
vips - run vips operations from the command line
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 operation, the first argument should be the name of the
operation and following arguments should be the operation arguments. For
example:
$ vips invert lena.v lena2.v
OPTIONS
-l BASE-NAME, --list=BASE-NAME
List operations below BASE-NAME. This prints a one-line summary of
every operation in vips below the class BASE-NAME, where BASE-NAME
may be a full vips class name, or a nickname.
If BASE-NAME is not supplied, this will list all classes below
VipsOperation.
-p PLUGIN, --plugin=PLUGIN
Load PLUGIN. Note that plugins in $VIPSHOME/lib/vips-plugins-
MAJOR.MINOR are loaded automatically.
-v, --version
Show VIPS version.
-c NAME, --completion NAME
Print completions for NAME
COMMANDS
operation-name operation-arguments
Execute a named operation, for example add.
EXAMPLES
Run a vips 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
default: 0 min: -100000000, max: 100000000
y - Top edge of sub in main, input gint
default: 0 min: -100000000, max: 100000000
optional arguments:
expand - Expand output to hold all of both inputs, input
gboolean default: false
background - Colour for new pixels, input VipsArrayDouble
operation flags: sequential
List all draw operations.
$ vips -l draw
VipsDraw (draw), draw operations
VipsDrawink (drawink), draw with ink operations
VipsDrawRect (draw_rect), paint a rectangle on an image
VipsDrawMask (draw_mask), draw a mask on an image
VipsDrawLine (draw_line), draw a line on an image
VipsDrawCircle (draw_circle), draw a circle on an image
VipsDrawFlood (draw_flood), flood-fill an area
VipsDrawImage (draw_image), paint an image into another image
VipsDrawSmudge (draw_smudge), blur a rectangle on an image
RETURN VALUE
returns 0 on success and non-zero on error.
SEE ALSO
vipsheader(1)
COPYRIGHT
The National Gallery and Birkbeck College, 1989-1996.
30 June 1993 vips(1)
vips 8.14.1 - Generated Sat Feb 25 16:29:05 CST 2023