.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
.\"
.\" 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
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    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 >0, 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
.\"
.\" Required to disable full justification in groff 1.23.0.
.if n .ds AD l
.\" ========================================================================
.\"
.IX Title "DARKTABLE-CLI 1"
.TH DARKTABLE-CLI 1 2019-11-27 "darktable 3.0" 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 \- نگارش خط فرمانی برنامه darktable
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "خلاصه دستور (SYNOPSIS)"
.Vb 1
\&    darktable\-cli IMG_1234.{RAW,...} [<xmp file>] <output file> [options] [\-\-core <darktable options>]
.Ve
.PP
گزینه‌ها:
.PP
.Vb 12
\&    \-\-width <max width>
\&    \-\-height <max height>
\&    \-\-bpp <bpp>
\&    \-\-hq <0|1|false|true>
\&    \-\-upscale <0|1|false|true>
\&    \-\-export_masks <0|1|false|true>
\&    \-\-style <style name>
\&    \-\-style\-overwrite
\&    \-\-apply\-custom\-presets <0|1|false|true>
\&    \-\-verbose
\&    \-\-help
\&    \-\-version
.Ve
.SH "توضیحات (DESCRIPTION)"
.IX Header "توضیحات (DESCRIPTION)"
برنامه
\&\fBdarktable\fR
یک نرم‌افزار مدیریت گردش کار عکاسی دیجیتال برای \fBLinux\fR، \fBMac OS X\fR و چندین سیستم‌عامل شبه‌یونیکس دیگر است.
توضیحات بیشتر درباره آن در
\fBdarktable\fR\|(1)
آمده است.
.PP
ابزار
\&\fBdarktable\-cli\fR
نگارش خط فرمانی این برنامه است که برای خروجی گرفتن از تصاویر بر اساس فایل خام (raw) و فایل xmp همراه آن به کار می‌رود.
.SH "گزینه‌ها (OPTIONS)"
.IX Header "گزینه‌ها (OPTIONS)"
کاربر باید یک نام فایل ورودی و یک نام فایل خروجی مشخص کند.
سایر پارامترها اختیاری هستند.
.IP "\fB<input file>\fR" 4
.IX Item "<input file>"
نام فایل ورودی برای استخراج و خروجی گرفتن.
.IP "\fB<xmp file>\fR" 4
.IX Item "<xmp file>"
نام اختیاری فایل همراه XMP (sidecar) شامل داده‌های پشته تاریخچه ویرایش که در حین خروجی گرفتن اعمال می‌شود.
اگر این گزینه مشخص نشود، darktable به دنبال فایل XMP متعلق به فایل ورودی داده‌شده می‌گردد.
.IP "\fB<output file>\fR" 4
.IX Item "<output file>"
نام فایل خروجی.
برنامه darktable قالب فایل خروجی را از پسوند فایل تشخیص می‌دهد.
همچنین می‌توانید از تمام متغیرهای موجود در ماژول صدور خروجی \fBdarktable\fR در نام فایل خروجی استفاده کنید.
.IP "\fB\-\-width <max width>\fR" 4
.IX Item "--width <max width>"
این پارامتر اختیاری امکان محدود کردن پهنای تصویر خروجی به تعداد پیکسل مشخص‌شده را فراهم می‌کند.
.IP "\fB\-\-height <max height>\fR" 4
.IX Item "--height <max height>"
این پارامتر اختیاری امکان محدود کردن ارتفاع تصویر خروجی به تعداد پیکسل مشخص‌شده را فراهم می‌کند.
.IP "\fB\-\-bpp <bpp>\fR" 4
.IX Item "--bpp <bpp>"
پارامتری اختیاری برای تعیین عمق بیت (bit depth) تصویر خروجی؛ مقادیر مجاز به فرمت فایل بستگی دارد.
در حال حاضر این گزینه هنوز فعال نیست.
اگر نیاز به تعیین عمق بیت دارید، باید از راهکار زیر استفاده کنید:
.Sp
.Vb 1
\&    \-\-core \-\-conf plugins/imageio/format/<FORMAT>/bpp=<VALUE>
.Ve
.Sp
که در آن \fBFORMAT\fR نام قالب خروجی انتخاب‌شده است، برای مثال \fBpng\fR.
.IP "\fB\-\-hq <0|1|true|false>\fR" 4
.IX Item "--hq <0|1|true|false>"
فلگی که تعیین می‌کند آیا از بازنمونه‌برداری باکیفیت بالا در حین صدور خروجی استفاده شود یا خیر.
پیش‌فرض true است.
.IP "\fB\-\-upscale <0|1|true|false>\fR" 4
.IX Item "--upscale <0|1|true|false>"
فلگی که تعیین می‌کند آیا افزایش مقیاس (upscale) در حین صدور خروجی مجاز باشد یا خیر.
پیش‌فرض false است.
.IP "\fB\-\-export_masks <0|1|true|false>\fR" 4
.IX Item "--export_masks <0|1|true|false>"
فلگی که تعیین می‌کند آیا ماسک‌های استفاده‌شده در تصویر به صورت لایه‌هایی در تصویر خروجی ذخیره شوند یا خیر (در صورتی که فرمت خروجی از آن پشتیبانی کند).
پیش‌فرض false است.
.IP "\fB\-\-style <style name>\fR" 4
.IX Item "--style <style name>"
مشخص کردن نام یک سبک (style) برای اعمال در حین صدور خروجی. اگر سبکی مشخص شود، مسیر دایرکتوری پیکربندی darktable نیز باید تعیین گردد (به عنوان مثال \-\-core \-\-configdir ~/.config/darktable).
پیش‌فرض عدم تعیین سبک است.
.IP \fB\-\-style\-overwrite\fR 4
.IX Item "--style-overwrite"
سبک مشخص‌شده پشته تاریخچه ویرایش را بازنویسی می‌کند به جای اینکه به انتهای آن افزوده شود.
.IP \fB\-\-apply\-custom\-presets\fR 4
.IX Item "--apply-custom-presets"
با این گزینه می‌توانید تصمیم بگیرید که آیا darktable مجموعه پارامترهای پیش‌فرض خود را از \fBdata.db\fR بارگذاری و اعمال کند یا خیر. در غیر این صورت، پیش‌فرض‌های همراه با نرم‌افزار استفاده می‌شوند.
.Sp
جهت اجرای چند نمونه همزمان از برنامه، این فلگ را برابر با false قرار دهید.
.IP \fB\-\-verbose\fR 4
.IX Item "--verbose"
فعال‌سازی خروجی با جزئیات کامل.
.IP "\fB\-\-core <darktable options>\fR" 4
.IX Item "--core <darktable options>"
تمامی پارامترهای خط فرمان پس از \fB\-\-core\fR به هسته darktable منتقل شده و به عنوان پارامترهای استاندارد مدیریت می‌شوند.
برای شرح تفصیلی گزینه‌ها به \fBdarktable\fR\|(1) مراجعه کنید.
.SH "همچنین ببینید (SEE ALSO)"
.IX Header "همچنین ببینید (SEE ALSO)"
\&\fBdarktable\fR\|(1)
.SH "نویسندگان (AUTHORS)"
.IX Header "نویسندگان (AUTHORS)"
توسعه‌دهنده اصلی darktable یوهانس هانیکا (Johannes Hanika) است.
فهرست مشارکت‌کنندگان پروژه به شرح زیر است:
.PP
* Developers:
Pascal Obry
Hanno Schwalm
Victor Forsiuk
Mario Zimmermann
Ralf Brown
Andrii Ryzhkov
Dan Torop
Jeronimo Pellegrini
Daniele Pighin
Robert Mongold
Philipp Lutz
Bill Ferguson
Kofa
Martin Straeten
Miloš Komarčević
EdgarLux
Diederik ter Rahe
Stéphane Gourichon
Ryo Shinozaki
deekayhd
Benjamin Grimm-Lebsanft
Matjaž Jeran
esq4
David Smith
Hpbirkeland
Marko Vertainen
Yannic Meyer

* Translators:
Victor Forsiuk
Pascal Obry
Jeronimo Pellegrini
Martin Straeten
EdgarLux
Stéphane Gourichon
Ryo Shinozaki
Matjaž Jeran
esq4
Hpbirkeland
Marko Vertainen
Báthory Péter
RIM
Andrii Ryzhkov
Besmir Godolja
Johan Schiff
Kang-Wei Hsu
Tianhao Chai
94tiger
BoneNI
Florian Tham
GameMaster0x
Jan Šmucr
Yannic Meyer
zxs-un

* Sub-module rawspeed contributors (at least 1 commit):
Miloš Komarčević
Roman Lebedev
Sidhartha
Steven Le Rouzic

* Sub-module integration contributors (at least 1 commit):
Pascal Obry
yuri

* Sub-module lua-scripts contributors (at least 1 commit):
Bill Ferguson
Tino Mettler
deekayhd
Andrii Ryzhkov
Ilya Palopezhentsev
Martin Straeten
Björn Lindström
Dan Zwell
fblampe
Aaron Patterson
dterrahe
masterpiga

و تمامی افرادی که انتشار نسخه‌های پیشین را امکان‌پذیر کردند.
.PP
این صفحه راهنما توسط Richard Levitte <richard@levitte.org> نوشته شده است.
بخش‌های تکمیلی توسط Tobias Ellinghaus <me@houz.org> اضافه گردیده است.
.SH "حق نشر و مجوز (COPYRIGHT AND LICENSE)"
.IX Header "حق نشر و مجوز (COPYRIGHT AND LICENSE)"
\&\fBCopyright (C)\fR 2009\-2019 by Authors.
.PP
نرم‌افزار \fBdarktable\fR یک نرم‌افزار آزاد است؛ می‌توانید آن را تحت شرایط مجوز عمومی همگانی گنو (GPL) نسخه ۳ یا (به انتخاب خودتان) هر نسخه پس از آن بازتوزیع کرده یا تغییر دهید.