1VIPS(1)                     General Commands Manual                    VIPS(1)
2
3
4

NAME

6       vips - run vips operations from the command line
7

SYNOPSIS

9       vips [options] [command] [command-options] [command-args]
10

DESCRIPTION

12       vips(1)  is  the VIPS universal main program. You can use it to run any
13       VIPS operation from the command line, to query the VIPS  class  hierar‐
14       chy, and to maintain parts of the VIPS library.
15
16       To  run  a VIPS operation, the first argument should be the name of the
17       operation and following arguments should be  the  operation  arguments.
18       For example:
19
20         $ vips invert lena.v lena2.v
21
22

OPTIONS

24       -l BASE-NAME, --list=BASE-NAME
25              List  operations below BASE-NAME. This prints a one-line summary
26              of every operation in vips  below  the  class  BASE-NAME,  where
27              BASE-NAME may be a full vips class name, or a nickname.
28
29              If  BASE-NAME  is not supplied, this will list all classes below
30              VipsOperation.
31
32
33       -p PLUGIN, --plugin=PLUGIN
34              Load PLUGIN. Note that  plugins  in  $VIPSHOME/lib/vips-plugins-
35              MAJOR.MINOR are loaded automatically.
36
37
38       -v, --version
39              Show VIPS version.
40
41

COMMANDS

43       operation-name operation-arguments
44              Execute a named operation, for example add.
45
46

EXAMPLES

48       Run  a  vips8  operation.  Operation  options must follow the operation
49       name.
50
51         $ vips insert lena.v lena2.v out.v 0 0 --background "128 0 0"
52
53       Get a "usage" message for an operation.
54
55         $ vips insert
56         insert image @sub into @main at @x, @y
57         usage:
58            insert main sub out x y
59         where:
60            main         - Main input image, input VipsImage
61            sub          - Sub-image to insert into main image, input  VipsIm‐
62       age
63            out          - Output image, output VipsImage
64            x              -   Left   edge   of   sub   in  main,  input  gint
65                        default:  0                    min:  -100000000,  max:
66       100000000
67            y            - Top edge of sub in main, input gint
68       default: 0                  min: -100000000, max: 100000000
69         optional arguments:
70            expand       - Expand output to hold all  of  both  inputs,  input
71       gboolean                  default: false
72            background   - Colour for new pixels, input VipsArrayDouble
73         operation flags: sequential
74
75       List all draw operations.
76
77         $ vips -l draw
78           VipsDraw (draw), draw operations
79             VipsDrawink (drawink), draw with ink operations
80               VipsDrawRect (draw_rect), paint a rectangle on an image
81               VipsDrawMask (draw_mask), draw a mask on an image
82               VipsDrawLine (draw_line), draw a line on an image
83               VipsDrawCircle (draw_circle), draw a circle on an image
84               VipsDrawFlood (draw_flood), flood-fill an area
85             VipsDrawImage (draw_image), paint an image into another image
86             VipsDrawSmudge (draw_smudge), blur a rectangle on an image
87
88

RETURN VALUE

90       returns 0 on success and non-zero on error.
91

SEE ALSO

93       vipsheader(1)
94

96       The National Gallery and Birkbeck College, 1989-1996.
97
98
99
100                                 30 June 1993                          VIPS(1)
Impressum