nip2(1) [debian man page]
NIP2(1) 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 combina- tion. -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)
Check Out this Related Man Page
execl(3) Library Functions Manual execl(3) Name execl, execv, execle, execlp, execvp, exect, environ - execute a file Syntax execl(name, arg0, arg1, ..., argn, (char *)0) char *name, *arg0, *arg1, ..., *argn; execv(name, argv) char *name, *argv[]; execle(name, arg0, arg1, ..., argn, (char *)0, envp) char *name, *arg0, *arg1, ..., *argn, *envp[]; execlp(file, arg0, arg1, ..., argn, (char *)0) char *file, *arg0, *arg1, ..., *argn; execvp(file,argv) char *file, *argv[]; exect(name, argv, envp) char *name, *argv[], *envp[]; extern char **environ; Description These routines provide various interfaces to the system call. Refer to for a description of their properties; only brief descriptions are provided here. In all their forms, these calls overlay the calling process with the named file, then transfer to the entry point of the core image of the file. There can be no return from a successful exec. The calling core image is lost. The name argument is a pointer to the name of the file to be executed. The pointers arg[0], arg[1] ... address null-terminated strings. Conventionally arg[0] is the name of the file. Two interfaces are available. is useful when a known file with known arguments is being called; the arguments to are the character strings constituting the file and the arguments; the first argument is conventionally the same as the file name (or its last component). A 0 argu- ment must end the argument list. The version is useful when the number of arguments is unknown in advance. The arguments to are the name of the file to be executed and a vector of strings containing the arguments. The last argument string must be followed by a 0 pointer. The version is used when the executed file is to be manipulated with The program is forced to single step a single instruction giving the parent an opportunity to manipulate its state. On VAX-11 machines, this is done by setting the trace bit in the process status longword. When a C program is executed, it is called as follows: main(argc, argv, envp) int argc; char **argv, **envp; where argc is the argument count and argv is an array of character pointers to the arguments themselves. As indicated, argc is convention- ally at least one and the first member of the array points to a string containing the name of the file. The argv is directly usable in another because argv[argc] is 0. The envp is a pointer to an array of strings that constitute the environment of the process. Each string consists of a name, an "=", and a null-terminated value. The array of pointers is terminated by a null pointer. The shell passes an environment entry for each global shell variable defined when the program is called. See for some conventionally used names. The C run-time start-off routine places a copy of envp in the global cell which is used by and to pass the environment to any subprograms executed by the current program. The and routines are called with the same arguments as and but duplicate the shell's actions in searching for an executable file in a list of directories. The directory list is obtained from the environment. Restrictions If is called to execute a file that turns out to be a shell command file, and if it is impossible to execute the shell, the values of argv[0] and argv[-1] will be modified before return. Diagnostics If the file cannot be found, if it is not executable, if it does not start with a valid magic number if maximum memory is exceeded, or if the arguments require too much space, a return constitutes the diagnostic; the return value is -1. For further information, see Even for the super-user, at least one of the execute-permission bits must be set for a file to be executed. Files /bin/sh Shell, invoked if command file found by execlp or execvp See Also csh(1), execve(2), fork(2), environ(7) RISC execl(3)