.\" Automatically generated by Pod::Man 2.28 (Pod::Simple 3.28)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is turned on, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{
.    if \nF \{
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "DARKTABLE-CLI 1"
.TH DARKTABLE 1 "24873d" "darktable-1.4.2" "darktable"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
darktable\-cli \- a command line darktable variant
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
.Vb 1
\&    darktable\-cli IMG_1234.{RAW,...} [<xmp file>] <output file> [options] [\-\-core <darktable options>]
.Ve
.PP
Options:
.PP
.Vb 5
\&    \-\-width <max width>
\&    \-\-height <max height>
\&    \-\-bpp <bpp>
\&    \-\-hq <0|1|true|false>
\&    \-\-verbose
.Ve
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
\&\fBdarktable\fR is a digital photography workflow application for \fBLinux\fR 
and \fBMac \s-1OS X\s0\fR in the lines of \fBAdobe Lightroom\fR and \fBApple Aperture\fR.
It's described further in \fIdarktable\fR\|(1).
.PP
\&\fBdarktable-cli\fR is a command line variant to be used to export images
given the raw file and the accompanying xmp file.
.SH "COMMAND LINE ARGUMENTS"
.IX Header "COMMAND LINE ARGUMENTS"
The user needs to supply an input filename and an output filename. All
other parameters are optional.
.IP "\fB<input file>\fR" 4
.IX Item "<input file>"
The name of the input file to export.
.IP "\fB<xmp file>\fR" 4
.IX Item "<xmp file>"
The optional name of an \s-1XMP\s0 sidecar file containing the history stack
data to be applied during export. If this option is not given
darktable will search for an \s-1XMP\s0 file that belongs to the given input
file.
.IP "\fB<output file>\fR" 4
.IX Item "<output file>"
The name of the output file. darktable derives the export file format
from the file extension.
.IP "\fB\-\-width <max width>\fR" 4
.IX Item "--width <max width>"
This optional parameter allows to limit the width of the exported
image to that number of pixels.
.IP "\fB\-\-height <max height>\fR" 4
.IX Item "--height <max height>"
This optional parameter allows to limit the height of the exported
image to that number of pixels.
.IP "\fB\-\-bpp <bpp>\fR" 4
.IX Item "--bpp <bpp>"
An optional parameter to define the bit depth of the exported image;
allowed values depend on the file format.  Currently this option is
not yet functional. If you need to define the bit depth you need to
use the following workaround:
.Sp
.Vb 1
\&    \-\-core \-\-conf plugins/imageio/format/<FORMAT>/bpp=<VALUE>
.Ve
.Sp
where \fB\s-1FORMAT\s0\fR is the name of the selected output format, for example \fBpng\fR.
.IP "\fB\-\-hq <0|1|true|false>\fR" 4
.IX Item "--hq <0|1|true|false>"
A flag that defines whether to use high quality resampling during
export. Defaults to true.
.IP "\fB\-\-verbose\fR" 4
.IX Item "--verbose"
Enables verbose output.
.IP "\fB\-\-core <darktable options>\fR" 4
.IX Item "--core <darktable options>"
All command line parameters following \fB\-\-core\fR are passed
to the darktable core and handled as standard parameters. See
\&\fIdarktable\fR\|(1) for a detailed description of the options.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\fIdarktable\fR\|(1)
.SH "AUTHORS"
.IX Header "AUTHORS"
The principal developer of darktable is Johannes Hanika. The (hopefully)
complete list of contributors to the project is:
.PP
* developers:
Henrik Andersson,
Johannes Hanika,
Tobias Ellinghaus,
Ulrich Pegelow.

* ubuntu packaging, color management, video tutorials:
Pascal de Bruijn.

* opencl pipeline, usermanual:
Ulrich Pegelow.

* networking, battle testing, translation expert:
Alexandre Prokoudine.

* translation:
a3novy,
Alexandre Prokoudine,
Anocha Yimsiriwattana,
Artur de Sousa Rocha,
Daniele Giorgis,
Dimitrios Psychogios,
Ger Siemerink,
Guilherme Brondani Torri,
Henrik Andersson,
José Carlos Casimiro,
Josep Puigdemont,
María Leandro,
Mauro Bartoccelli,
Michał Prędotka,
Mikko Ruohola,
Milan Knížek,
Olivier Tribout,
Pascal Obry,
Richard Levitte,
Roberto Quintero,
Sebastien Delcoigne,
Thomas Costis,
Thomas Pryds,
Tobias Ellinghaus,
Victor Lamoine.

* contributors:
Aldric Renaudin,
Alexandre Prokoudine,
Alexey Dokuchaev,
Ammon Riley,
Anton Keks,
Antony Dovgal,
Ari Makela,
Benjamin Cahill,
Brian Teague,
Bruce Guenter,
Cherrot Luo,
Chris Mason,
Christian Tellefsen,
David Morel,
Denis Cheremisov,
Dennis Gnad,
Diego Segura,
Dimitrios Psychogios,
Eckhart Pedersen,
Edouard Gomez,
Edward Herr,
František Šidák,
Gaspard Jankowiak,
Ger Siemerink,
Gianluigi Calcaterra,
Guilherme Brondani Torri,
Ivan Tarozzi,
James C. McPherson,
Jan Kundrát,
Jean-Sébastien Pédron,
Jérémy Rosen,
Jesper Pedersen,
Joao Trindade,
Jon Leighton,
Jose Carlos Garcia Sogo,
Josef Wells,
Julian J. M,
Mattias Eriksson,
Michal Babej,
Michał Prędotka,
Moritz Lipp,
Olivier Tribout,
Pascal de Bruijn,
Pascal Obry,
parafin,
Petr Styblo,
Pierre Le Magourou,
Richard Levitte,
Richard Tollerton,
Robert Bieber,
Roland Riegel,
Roman Lebedev,
Rostyslav Pidgornyi,
Sergey Pavlov,
Simon Harhues,
Simon Spannagel,
Stuart Henderson,
Terry Jeffress,
Tim Harder,
Togan Muftuoglu,
Tom Vanderpoel,
Ulrich Pegelow,
Wolfgang Goetz,
Wolfgang Kuehnel,
Yari Adan,
hal,
jan,
maigl,
tuxuser.
And all those of you that made previous releases possible.
.PP
This man page was written by Richard Levitte
<richard@levittr.org>.
.SH "COPYRIGHT AND LICENSE"
.IX Header "COPYRIGHT AND LICENSE"
\&\fBCopyright (C)\fR 2009\-2013 by Authors.
.PP
\&\fBdarktable\fR is free software; you can redistribute it and/or modify it
under the terms of the \s-1GPL\s0 v3 or (at your option) any later version.