DragonFly On-Line Manual Pages

NIP2(1)                DragonFly General Commands Manual               NIP2(1)

NAME
       nip2 - image processing with the VIPS library

SYNOPSIS
       nip2 [filename1 ...]
       nip2 -s filename [arg1 ...]
       nip2 -e expression [arg1 ...]

DESCRIPTION
       nip2 (for New Image Processing) is a tool for manipulating images using
       the VIPS image processing library.

       There are three principal modes:

       nip2 [filename1 ...]
         start in GUI mode, loading the named files

       nip2 -e expression [arg1 ...]
       nip2 --expression=EXPRESSION [arg1 ...]
         start in no-GUI mode; set main = expression, set list argv to
         ["filename", "arg1", "arg2", ...], set argc to length of list; print
         the value of symbol "main" to stdout; exit

       nip2 -s filename [arg1 ...]
       nip2 --script=FILENAME [arg1 ...]
         start in no-GUI mode; read in filename as a set of definitions,
         set list argv to ["filename", "arg1", "arg2", ...], set argc to
         length of list; print the value of symbol "main" to stdout; exit;
         useful for running nip2 as an interpreter on unix

       You can use -o to direct output to a file rather than stdout.

       -o filename
       --output=FILENAME
         the value of main is written to the named file. If main is a
         list, the filename is incremented between objects. You can use
         the suffix to specify the format and options to write in

       Other options provide finer control over startup and shutdown. If you
       need to do something strange, don't use -e/-s, use these in
       combination.

       -b
       --batch
         batch (ie. non-GUI) mode

       -m
       --no-load-menus
         don't load menus, for faster startup

       -a
       --no-load-args
         don't load extra command-line arguments

       -w
       --stdin-ws
         load stdin as a workspace

       -d
       --stdin-def
         load stdin as a set of definitions

       -p
       --print-main
         print the value of main on exit. nip2 will check for a top-level
         symbol called main, and also check each workspace for a main

       Finally some other options are useful for debugging, timing and for
       generating strings for internationalisation.

       -V
       --verbose
         produce verbose error messages: handy for debugging in batch mode

       -i
       --i18n
         output strings from .def files for internationalisation

       -v
       --version
         print version information

       -c
       --benchmark
         benchmark: no GUI, just start up and shut down

       -t
       --time-save
         time saves: after every image save a popup tells you the time the
         save took in seconds

       -T
       --test
         test: start up (including any arg processing), test for any errors,
         and exit with an error code if any occured. Useful for running
         automated tests.

       -x PREFIX
       --prefix=PREFIX
         set install prefix: start up as if nip2 had been installed to PREFIX.
         Useful for running automated tests without installing the thing.

EXAMPLES
         nip2 fred.jpg

       Start nip2, loading fred.jpg.

         nip2 -e "2 + 2"

       Prints 4 to stdout.

         nip2 -e "99 + Image_file argv?1" -o result.png fred.jpg

       Load argv1 (fred.jpg), add 99, output to result.png.

         nip2 -e "Matrix [[1,2],[4,5]] ** -1" -o poop.mat

       Invert the 2x2 matrix and write the result to poop.mat.

COPYRIGHT
       2008 (c) Imperial College, London

                                  Oct 4 2004                           NIP2(1)