NAME

       pmltoxmp ‐  convert a PhotoML file to XMP format

SYNOPSIS

       pmltoxmp [-h] [-n] (([-o path] [-s fstr]) | ([-g fid] [-f gid])) [xmlfile]

DESCRIPTION

       pmltoxmp  is  a shell script that calls xsltproc to transform a subset of data in a PhotoML XML file into
       XMP format. If a single frame is specified for output, it is written  to  stdout,  otherwise  a  separate
       output file is written for each frame in the PhotoML file.

       The  primary  purpose  of conversion to XMP format is to allow a subset of PhotoML data to be included in
       the metadata of a digital image by using the exiftool utility, which can  use  XMP  data  as  input.  For
       example,  assuming  that PhotoML data for roll 2001r12 is in file photoml.xml, and file 2001r22f01n01.jpg
       is a scan of frame 01 on that roll, the following commands would copy a subset of the PhotoML  data  into
       the EXIF metadata of the digital image:

              pmltoxmp -g 2001r12 -f 01 photoml.xml > tmp.xmp
              exiftool -TagsFromFile tmp.xmp 2001r22f01n01.jpg

OPTIONS

       pmltoxmp accepts the following options:

       -h      Display usage information.

       -n      Omit the validity test prior to applying the XSL.

       -o path Specify the output path. The default value is ".".

       -s fstr Specify image id format string. This format is used to construct both the EXIF DocumentName value
               and the output filename (when relevant).  Occurrences  of  "%g"  and  "%f"  in  this  string  are
               substituted with the group and frame ids respectively. The default value is "%gf%f".

       -g gid  Specify id of group containing frame to convert.

       -f fid  Specify id of frame to convert.

AUTHOR

       Brendt Wohlberg <photoml@wohlberg.net>

COPYRIGHT

       Copyright © 2010,2011 Brendt Wohlberg <photoml@wohlberg.net>

       This  program  is free software; you can redistribute it and/or modify it under the terms of version 2 of
       the GNU General Public License <http://www.gnu.org/licenses/gpl-2.0.txt>.

       This program is distributed in the hope that it will be useful, but WITHOUT ANY  WARRANTY;  without  even
       the  implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public
       License for more details.

SEE ALSO

       xsltproc(1) exiftool(1)

                                                   28 January                                        pmltrans(1)