NAME

       lensfun-add-adapter - add lens mount compatibilities to Lensfun's database

SYNOPSIS

       lensfun-add-adapter
       lensfun-add-adapter [--maker MAKER] [--model MODEL] [--mount MOUNT]
       lensfun-add-adapter --remove-local-mount-config

DESCRIPTION

       Lensfun  is  a  library that corrects flaws in photographic images introduced by the lens.
       It also contains a comprehensive database  of  cameras  and  lenses  together  with  their
       characteristics  to  be  able  to  apply  automatic corrections of images taken with these
       devices.  Lensfun is used  by  darktable,  digiKam,  rawstudio,  GimpLensfun,  UFRaw,  and
       others.

       Lensfun  contains  information  about lens mounts of cameras and available mounts for lens
       models.  This way, the calling application can offer the user a list with lenses that  fit
       on  their  camera  in  order to pick one.  Otherwise, you would see all lenses every time.
       This can be pretty overwhelming.

       But if you bought an adapter for another mount system, you would want  to  see  lenses  of
       that  mount system listed for your camera.  So, you must tell Lensfun somehow that you own
       the adapter.  You can do so by calling lensfun-add-adapter.

       The easiest way to use it is to call it with no parameters.  lensfun-add-adapter will then
       enter   an   interactive   mode.    First   you   have   to   enter   your  camera  model.
       lensfun-add-adapter will use that to determine the destination mount.  In particular,  the
       extended  lens  lists  will show up for every camera with that mount, not just the one you
       entered.  Then, you have to select the mount of the lenses you can now put on your camera,
       using the adapter.  That's it.

       With  the options --maker, --model, and --mount, you can avoid interactive mode by passing
       the  nevcessary  data  explicitly.   If  you  pass  only  maker/model   or   only   mount,
       lensfun-add-adapter will enter interactive mode only for the missing data.

       You  can  also  use lensfun-add-adapter to reset your adapter configuration.  Call it with
       the --help paremeter to see all functions.

OPTIONS

       --maker MAKER --model MODEL
              The exact maker and model  of  the  camera  the  mount  of  which  should  be  made
              compatible.   You  must  provide these options only in combination rather than only
              one of them.

       --mount MOUNT
              The exact name of the mount of the lenses that should be made compatible.

       --remove-local-mount-config
              Resets the local mount configuration, i.e.  the  additional  mount  compatibilities
              that  were  created  by  this program.  Effectively, it removes the file _mount.xml
              from the local Lensfun database of the current user.

FILES

       ~/.local/share/lensfun/_mounts.xml
              File with all mount compatibilities that were added by this program.

DIAGNOSTICS

       Exit status:

                                 ┌──┬──────────────────────────────────┐
                                 │0 │ successful                       │
                                 ├──┼──────────────────────────────────┤
                                 │1 │ invalid command line arguments   │
                                 ├──┼──────────────────────────────────┤
                                 │2 │ invalid  input  in   interactive │
                                 │  │ mode                             │
                                 └──┴──────────────────────────────────┘

REPORTING BUGS

       Report bugs at <http://sourceforge.net/p/lensfun/bugs/>.

COPYRIGHT

       Lensfun is Copyright © 2007 Andrew Zabolotny

       License of the code: GNU Lesser General Public License, version 3

       License of the database: Creative Commons Attribution-Share Alike 3.0 license

SEE ALSO

       lensfun-update-data(1)

AUTHOR

       This manual page was written by Torsten Bronger <bronger@physik.rwth-aachen.de>

                                            2013-12-23                     LENSFUN-ADD-ADAPTER(1)