manpagez: man (manual) pages & more
man vips(1)
Home | html | info | man
vips(1)                                                                vips(1)




NAME

       vips - run vips operations from the command line


SYNOPSIS

       vips [options] [command] [command-options] [command-args]


DESCRIPTION

       vips(1)  is  the VIPS universal main program. You can use it to run any
       VIPS operation from the command line, to query the VIPS  class  hierar-
       chy, and to maintain parts of the VIPS library.

       To  run  a  VIPS function, the first argument should be the name of the
       function and following arguments should be the function parameters. For
       example:

         $ vips invert lena.v lena2.v



OPTIONS

       -p PLUGIN, --plugin=PLUGIN
              Load PLUGIN. Note that plugins in $VIPSHOME/lib are loaded auto-
              matically.


       -v, --version
              Show VIPS version.



COMMANDS

       list PACKAGE
              List  operations  defined  in  PACKAGE.  PACKAGE  can  also   be
              "classes", "packages" or "all".


       cpph PACKAGE
              Print  C++  header  for  PACKAGE. PACKAGE can also be a function
              name, or "all".


       cppc PACKAGE
              Print C++ binding for PACKAGE. PACKAGE can also  be  a  function
              name, or "all".


       operation-name operation-arguments
              Execute  a named operation, for example im_invert, or add. Names
              prefixed with "im_" are called via the  vips7  interface,  names
              without the prefix use the new vips8 interface.



EXAMPLES

       Run  a  vips8  operation.  Operation  options must follow the operation
       name.

         $ vips insert lena.v lena2.v out.v 0 0 --background "128 0 0"

       Get a "usage" message for an operation

         $ vips insert
         insert image @sub into @main at @x, @y
         usage:
            insert main sub out x y
         where:
            main         - Main input image, input VipsImage
            sub          - Sub-image to insert into main image, input  VipsIm-
       age
            out          - Output image, output VipsImage
            x            - Left edge of sub in main, input gint
            y            - Top edge of sub in main, input gint
         optional arguments:
            expand        -  Expand  output  to hold all of both inputs, input
       gboolean
            background   - Colour for new pixels, input VipsArrayDouble
         operation flags: sequential-unbuffered
         insert: too few arguments



RETURN VALUE

       returns 0 on success and non-zero on error.


SEE ALSO

       vipsheader(1)


COPYRIGHT

       The National Gallery and Birkbeck College, 1989-1996.



                                 30 June 1993                          vips(1)

vips 7.40.2 - Generated Thu Jul 3 16:38:56 CDT 2014