<!-- manual page source format generated by PolyglotMan v3.2, --> <!-- available at http://polyglotman.sourceforge.net/ --> <html> <head> <title>NIP2(1) manual page</title> </head> <body bgcolor='white'> <a href='#toc'>Table of Contents</a><p> <h2><a name='sect0' href='#toc0'>Name</a></h2> nip2 - image processing with the VIPS library <p> <h2><a name='sect1' href='#toc1'>Synopsis</a></h2> <b>nip2 [filename1 ...]</b> <br> <b>nip2 -s filename [arg1 ...]</b> <br> <b>nip2 -e expression [arg1 ...]</b> <p> <h2><a name='sect2' href='#toc2'>Description</a></h2> <b>nip2</b> (for New Image Processing) is a tool for manipulating images using the VIPS image processing library. <p> There are three principal modes: <p> <b>nip2 [filename1 ...]</b> <br> start in GUI mode, loading the named files<br> <p> <b>nip2 -e expression [arg1 ...]</b> <br> <b>nip2 --expression=EXPRESSION [arg1 ...]</b> <br> start in no-GUI mode; set main = expression, set list argv to<br> ["filename", "arg1", "arg2", ...], set argc to length of list; print<br> the value of symbol "main" to stdout; exit<br> <p> <b>nip2 -s filename [arg1 ...]</b> <br> <b>nip2 --script=FILENAME [arg1 ...]</b> <br> start in no-GUI mode; read in filename as a set of definitions, <br> set list argv to ["filename", "arg1", "arg2", ...], set argc to <br> length of list; print the value of symbol "main" to stdout; exit; <br> useful for running nip2 as an interpreter on unix<br> <p> You can use <b>-o</b> to direct output to a file rather than stdout. <p> <b>-o filename</b> <br> <b>--output=FILENAME</b> <br> the value of main is written to the named file. If main is a <br> list, the filename is incremented between objects. You can use <br> the suffix to specify the format and options to write in<br> <p> 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. <p> <b>-b</b> <br> <b>--batch</b> <br> batch (ie. non-GUI) mode<br> <p> <b>-m</b> <br> <b>--no-load-menus</b> <br> don’t load menus, for faster startup<br> <p> <b>-a</b> <br> <b>--no-load-args</b> <br> don’t load extra command-line arguments<br> <p> <b>-w</b> <br> <b>--stdin-ws</b> <br> load stdin as a workspace<br> <p> <b>-d</b> <br> <b>--stdin-def</b> <br> load stdin as a set of definitions<br> <p> <b>-p</b> <br> <b>--print-main</b> <br> print the value of main on exit. nip2 will check for a top-level <br> symbol called main, and also check each workspace for a main<br> <p> Finally some other options are useful for debugging, timing and for generating strings for internationalisation. <p> <b>-V</b> <br> <b>--verbose</b> <br> produce verbose error messages: handy for debugging in batch mode<br> <p> <b>-i</b> <br> <b>--i18n</b> <br> output strings from .def files for internationalisation<br> <p> <b>-v</b> <br> <b>--version</b> <br> print version information<br> <p> <b>-c</b> <br> <b>--benchmark</b> <br> benchmark: no GUI, just start up and shut down<br> <p> <b>-t</b> <br> <b>--time-save</b> <br> time saves: after every image save a popup tells you the time the <br> save took in seconds<br> <p> <b>-T</b> <br> <b>--test</b> <br> test: start up (including any arg processing), test for any errors, <br> and exit with an error code if any occured. Useful for running <br> automated tests.<br> <p> <b>-x PREFIX</b> <br> <b>--prefix=PREFIX</b> <br> set install prefix: start up as if nip2 had been installed to PREFIX.<br> Useful for running automated tests without installing the thing.<br> <p> <h2><a name='sect3' href='#toc3'>Examples</a></h2> <p> nip2 fred.jpg<br> <p> Start nip2, loading fred.jpg. <p> nip2 -e "2 + 2"<br> <p> Prints 4 to stdout. <p> nip2 -e "99 + Image_file argv?1" -o result.png fred.jpg<br> <p> Load argv1 (fred.jpg), add 99, output to result.png. <p> nip2 -e "Matrix [[1,2],[4,5]] ** -1" -o poop.mat<br> <p> Invert the 2x2 matrix and write the result to poop.mat. <p> <h2><a name='sect4' href='#toc4'>Copyright</a></h2> 2008 (c) Imperial College, London <p> <hr><p> <a name='toc'><b>Table of Contents</b></a><p> <ul> <li><a name='toc0' href='#sect0'>Name</a></li> <li><a name='toc1' href='#sect1'>Synopsis</a></li> <li><a name='toc2' href='#sect2'>Description</a></li> <li><a name='toc3' href='#sect3'>Examples</a></li> <li><a name='toc4' href='#sect4'>Copyright</a></li> </ul> </body> </html>