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-MA‐
35              JOR.MINOR are loaded automatically.
36
37
38       -v, --version
39              Show VIPS version.
40
41
42       -c NAME, --completion NAME
43              Print completions for NAME
44
45

COMMANDS

47       operation-name operation-arguments
48              Execute a named operation, for example add.
49
50

EXAMPLES

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

RETURN VALUE

93       returns 0 on success and non-zero on error.
94

SEE ALSO

96       vipsheader(1)
97

99       The National Gallery and Birkbeck College, 1989-1996.
100
101
102
103                                 30 June 1993                          VIPS(1)
Impressum