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

NAME

6       nip2 - image processing with the VIPS library
7
8

SYNOPSIS

10       nip2 [filename1 ...]
11       nip2 -s filename [arg1 ...]
12       nip2 -e expression [arg1 ...]
13
14

DESCRIPTION

16       nip2 (for New Image Processing) is a tool for manipulating images using
17       the VIPS image processing library.
18
19       There are three principal modes:
20
21       nip2 [filename1 ...]
22         start in GUI mode, loading the named files
23
24       nip2 -e expression [arg1 ...]
25       nip2 --expression=EXPRESSION [arg1 ...]
26         start in no-GUI mode; set main = expression, set list argv to
27         ["filename", "arg1", "arg2", ...], set argc to length of list; print
28         the value of symbol "main" to stdout; exit
29
30       nip2 -s filename [arg1 ...]
31       nip2 --script=FILENAME [arg1 ...]
32         start in no-GUI mode; read in filename as a set of definitions,
33         set list argv to ["filename", "arg1", "arg2", ...], set argc to
34         length of list; print the value of symbol "main" to stdout; exit;
35         useful for running nip2 as an interpreter on unix
36
37       You can use -o to direct output to a file rather than stdout.
38
39       -o filename
40       --output=FILENAME
41         the value of main is written to the named file. If main is a
42         list, the filename is incremented between objects. You can use
43         the suffix to specify the format and options to write in
44
45       Other options provide finer control over startup and shutdown.  If  you
46       need  to  do  something strange, don't use -e/-s, use these in combina‐
47       tion.
48
49       -b
50       --batch
51         batch (ie. non-GUI) mode
52
53       -m
54       --no-load-menus
55         don't load menus, for faster startup
56
57       -a
58       --no-load-args
59         don't load extra command-line arguments
60
61       -w
62       --stdin-ws
63         load stdin as a workspace
64
65       -d
66       --stdin-def
67         load stdin as a set of definitions
68
69       -p
70       --print-main
71         print the value of main on exit. nip2 will check for a top-level
72         symbol called main, and also check each workspace for a main
73
74       Finally some other options are useful for  debugging,  timing  and  for
75       generating strings for internationalisation.
76
77       -V
78       --verbose
79         produce verbose error messages: handy for debugging in batch mode
80
81       -i
82       --i18n
83         output strings from .def files for internationalisation
84
85       -v
86       --version
87         print version information
88
89       -c
90       --benchmark
91         benchmark: no GUI, just start up and shut down
92
93       -t
94       --time-save
95         time saves: after every image save a popup tells you the time the
96         save took in seconds
97
98       -T
99       --test
100         test: start up (including any arg processing), test for any errors,
101         and exit with an error code if any occured. Useful for running
102         automated tests.
103
104       -x PREFIX
105       --prefix=PREFIX
106         set install prefix: start up as if nip2 had been installed to PREFIX.
107         Useful for running automated tests without installing the thing.
108
109

EXAMPLES

111         nip2 fred.jpg
112
113       Start nip2, loading fred.jpg.
114
115         nip2 -e "2 + 2"
116
117       Prints 4 to stdout.
118
119         nip2 -e "99 + Image_file argv?1" -o result.png fred.jpg
120
121       Load argv1 (fred.jpg), add 99, output to result.png.
122
123         nip2 -e "Matrix [[1,2],[4,5]] ** -1" -o poop.mat
124
125       Invert the 2x2 matrix and write the result to poop.mat.
126
127

129       2008 (c) Imperial College, London
130
131
132
133                                  Oct 4 2004                           NIP2(1)
Impressum