.\"
.\" Man page for dcraw
.\"
.\" Copyright (c) 2015 by David Coffin
.\"
.\" You may distribute without restriction.
.\"
.\" David Coffin
.\" dcoffin a cybercom o net
.\" http://www.cybercom.net/~dcoffin
.\"
.TH dcraw 1 "March 3, 2015"
.LO 1
.SH "نام (NAME)"
dcraw \- ابزار خط فرمان برای رمزگشایی و تبدیل عکس‌های خام دیجیتال (RAW)
.SH "خلاصه دستور (SYNOPSIS)"
.B dcraw
[\fIگزینه‌ها\fR]... [\fIفایل\fR]...
.SH "توضیحات (DESCRIPTION)"
.B dcraw
عکس‌های خام را رمزگشایی می‌کند، فراداده‌ها را نمایش می‌دهد و تصاویر بندانگشتی را استخراج می‌نماید.
.SH "گزینه‌های عمومی (GENERAL OPTIONS)"
.TP
.B -v
چاپ پیام‌ها با جزئیات کامل، نه فقط هشدارها و خطاها.
.TP
.B -c
نوشتن تصاویر رمزگشایی‌شده یا تصاویر بندانگشتی در خروجی استاندارد.
.TP
.B -e
استخراج تصویر بندانگشتی ایجادشده توسط دوربین، به جای تصویر خام.
بسته به دوربین، یک فایل JPEG یا PPM دریافت خواهید کرد.
.TP
.B -z
تغییر زمان‌های دسترسی و تغییر یک فایل AVI ،JPEG ،TIFF یا تصویر خام به زمان ثبت عکس، با این فرض که ساعت دوربین روی زمان جهانی تنظیم بوده است.
.TP
.B -i
شناسایی فایل‌ها بدون رمزگشایی آن‌ها.
اگر
.B dcraw
بتواند آخرین فایل را رمزگشایی کند، وضعیت خروج 0 و در غیر این صورت 1 است.
.B -i -v
فراداده‌ها را نمایش می‌دهد.
.TP
.B ""
.B dcraw
نمی‌تواند فایل‌های JPEG را رمزگشایی کند!!
.SH "گزینه‌های ترمیم و اصلاح (REPAIR OPTIONS)"
.TP
.B -I
خواندن پیکسل‌های خام از ورودی استاندارد با ترتیب بایت پردازنده (CPU) و بدون سرآیند. از دستور
.B dcraw -E -4
برای دریافت مقادیر پیکسل‌های خام استفاده کنید.
.TP
.B -P deadpixels.txt
خواندن فهرست پیکسل‌های مرده از این فایل به جای «.badpixels».
بخش
.B "فایل‌ها (FILES)"
را برای توضیحات قالب فایل ببینید.
.TP
.B -K darkframe.pgm
تفریق یک فریم تاریک (dark frame) از داده‌های خام. برای تولید فریم تاریک، در تاریکی مطلق یک عکس خام بگیرید و دستور
.BR dcraw\ -D\ -4\ -j\ -t\ 0
را اجرا کنید.
.TP
.B -k darkness
زمانی که سایه‌ها مه‌آلود به نظر می‌رسند، باید سطح تاریکی را افزایش دهید.
برای اندازه‌گیری این مقدار، دستور
.B pamsumm -mean
را روی فریم تاریک تولیدشده در بالا اعمال کنید.
.TP
.B -S saturation
زمانی که هایلایت‌ها (بخش‌های پرنور) صورتی‌رنگ به نظر می‌رسند، باید سطح اشباع را کاهش دهید.
برای اندازه‌گیری این مقدار، از یک شیء براق عکس بگیرید و دستور
.B dcraw -D -4 -j -c
photo.raw
.B | pamsumm -max
را اجرا کنید.
.TP
.B ""
مقادیر پیش‌فرض تاریکی و اشباع معمولاً صحیح هستند.
.TP
.B -n noise_threshold
استفاده از تبدیل موجک (wavelet) برای حذف نویز هم‌زمان با حفظ جزئیات واقعی.
بهترین آستانه معمولاً بین 100 تا 1000 است.
.TP
.B -C red_mag blue_mag
بزرگ‌نمایی لایه‌های خام قرمز و آبی با ضرایب ارائه‌شده (معمولاً 0.999 تا 1.001) جهت تصحیح ابیراهی رنگی.
.TP
.B -H 0
برش (clip) تمام هایلایت‌ها به سفید خالص (پیش‌فرض).
.TP
.B -H 1
رها کردن هایلایت‌ها بدون برش در طیف‌های گوناگون رنگ صورتی.
.TP
.B -H 2
ترکیب مقادیر برش‌خورده و برش‌نخورده برای محو شدن تدریجی به سمت سفید.
.TP
.B -H 3+
بازسازی هایلایت‌ها. اعداد کوچک رنگ‌های سفید را ترجیح می‌دهند؛ اعداد بزرگ رنگ‌ها را در اولویت قرار می‌دهند. مقدار
.B -H 5
را به عنوان مصالحه امتحان کنید. اگر به اندازه کافی خوب نبود، از گزینه
.BR -H\ 9
استفاده کرده، هایلایت‌های غیر سفید را جدا کنید و در تصویری که با
.BR -H\ 3
تولید شده جای‌گذاری نمایید.
.SH "گزینه‌های رنگ (COLOR OPTIONS)"
به‌طور پیش‌فرض،
.B dcraw
از یک تراز سفیدی ثابت بر اساس یک جدول رنگی که با یک لامپ استاندارد D65 روشن شده استفاده می‌کند.
.TP
.B -w
استفاده از تراز سفیدی مشخص‌شده توسط دوربین.
اگر یافت نشد، یک هشدار چاپ شده و از روش دیگری استفاده می‌شود.
.TP
.B -a
محاسبه تراز سفیدی با میانگین‌گیری از کل تصویر.
.TP
.B -A left top width height
محاسبه تراز سفیدی با میانگین‌گیری از یک ناحیه مستطیلی.
ابتدا دستور
.B dcraw\ -j\ -t\ 0
را اجرا کرده و ناحیه‌ای با رنگ خاکستری خنثی را انتخاب کنید.
.TP
.B -r mul0 mul1 mul2 mul3
مشخص کردن تراز سفیدی خام سفارشی شما.
این ضرایب را می‌توان از خروجی دستور
.BR dcraw\ -v
رونوشت و جای‌گذاری کرد.
.TP
.BR +M " یا " -M
استفاده (یا عدم استفاده) از ماتریس رنگی موجود در فراداده‌های دوربین.
اگر گزینه
.B -w
تنظیم شده باشد یا عکس در قالب DNG باشد، حالت پیش‌فرض
.B +M
است؛ در غیر این صورت
.B -M
خواهد بود. به‌جز DNG، این گزینه تنها بر دوربین‌های Olympus، Leaf و Phase One تأثیر می‌گذارد.
.TP
.B -o [0-6]
انتخاب فضای رنگ خروجی هنگامی که گزینه
.B -p
استفاده نشده باشد:

.B \t0
\ \ رنگ خام (منحصربه‌فرد برای هر دوربین)
.br
.B \t1
\ \ sRGB D65 (پیش‌فرض)
.br
.B \t2
\ \ Adobe RGB (1998) D65
.br
.B \t3
\ \ Wide Gamut RGB D65
.br
.B \t4
\ \ Kodak ProPhoto RGB D65
.br
.B \t5
\ \ XYZ
.br
.B \t6
\ \ ACES
.TP
.BR -p\ camera.icm \ [\  -o\ output.icm \ ]
استفاده از پروفایل‌های ICC برای تعریف فضای رنگ خام دوربین و فضای رنگ خروجی مطلوب (به‌طور پیش‌فرض sRGB).
.TP
.B -p embed
استفاده از پروفایل ICC جاسازی‌شده در عکس خام.
.SH "گزینه‌های درون‌یابی (INTERPOLATION OPTIONS)"
.TP
.B -d
نمایش داده‌های خام به صورت یک تصویر در مقیاس خاکستری بدون درون‌یابی.
برای عکس‌برداری از اسناد سیاه‌وسفید مناسب است.
.TP
.B -D
مشابه گزینه
.BR -d ،
اما با مقادیر اصلی و بدون مقیاس‌بندی پیکسل‌ها.
.TP
.B -E
مشابه گزینه
.BR -D ،
اما پیکسل‌های پوشانده‌شده (masked) حذف نمی‌شوند.
.TP
.B -h
تولید یک تصویر رنگی با نصف اندازه. دو برابر سریع‌تر از گزینه
.BR -q\ 0 .
.TP
.B -q 0
استفاده از درون‌یابی دومحوری (bilinear) سریع با کیفیت پایین.
.TP
.B -q 1
استفاده از درون‌یابی با تعداد متغیر گرادیان‌ها (VNG).
.TP
.B -q 2
استفاده از درون‌یابی گروه‌بندی پیکسل‌های الگودار (PPG).
.TP
.B -q 3
استفاده از درون‌یابی هدایت‌شده با همگنی تطبیقی (AHD).
.TP
.B -f
درون‌یابی RGB به صورت چهار رنگ. اگر خروجی شبکه‌های ۲×۲ کاذب با VNG یا الگوهای مارپیچ با AHD نشان داد، از این گزینه استفاده کنید.
.TP
.B -m number_of_passes
پس از درون‌یابی، پاک‌سازی خطاهای رنگی با اعمال مکرر یک فیلتر میانه ۳×۳ روی کانال‌های R-G و B-G.
.SH "گزینه‌های خروجی (OUTPUT OPTIONS)"
به‌طور پیش‌فرض،
.B dcraw
خروجی PGM/PPM/PAM را با نمونه‌های ۸ بیتی، یک منحنی گامای BT.709، سطح سفید بر پایه هیستوگرام، و بدون فراداده می‌نویسد.
.TP
.B -W
استفاده از یک سطح سفید ثابت با نادیده گرفتن هیستوگرام تصویر.
.TP
.B -b brightness
تقسیم سطح سفید بر این عدد، به‌طور پیش‌فرض 1.0.
.TP
.B -g power toe_slope
تنظیم منحنی گاما، به‌طور پیش‌فرض BT.709
.RB ( -g\ 2.222\ 4.5 ).
اگر گامای sRGB را ترجیح می‌دهید، از گزینه
.BR -g\ 2.4\ 12.92
استفاده کنید. برای یک منحنی توانی ساده، شیب پنجه (toe slope) را روی صفر تنظیم کنید.
.TP
.B -6
نوشتن ۱۶ بیت در هر نمونه به جای ۸ بیت.
.TP
.B -4
۱۶ بیتی خطی، مشابه
.BR -6\ -W\ -g\ 1\ 1 .
.TP
.B -T
نوشتن TIFF با فراداده‌ها به جای PGM/PPM/PAM.
.TP
.B -t [0-7,90,180,270]
وارونه کردن یا چرخاندن تصویر خروجی. به‌طور پیش‌فرض،
.B dcraw
چرخش مشخص‌شده توسط دوربین را اعمال می‌کند. گزینه
.B -t 0
تمام چرخش‌ها را غیرفعال می‌کند.
.TP
.B -j
برای دوربین‌های Fuji\ Super\ CCD، تصویر را با چرخش ۴۵ درجه نشان می‌دهد.
برای دوربین‌هایی با پیکسل‌های غیرمربعی، تصویر را به نسبت ابعاد صحیح آن نمی‌کشد. در هر صورت، این گزینه تضمین می‌کند که هر پیکسل خروجی متناظر با یک پیکسل خام باشد.
.TP
.BR "-s [0..N-1]" " یا " "-s all"
اگر یک فایل شامل N تصویر خام است، یکی یا «all» را برای رمزگشایی انتخاب کنید.
برای نمونه، دوربین‌های Fuji\ Super\ CCD\ SR یک تصویر دوم با ۴ گام نوردهی کمتر تولید می‌کنند تا جزئیات هایلایت‌ها نمایان شود.
.SH "فایل‌ها (FILES)"
.TP
\:./.badpixels, ../.badpixels, ../../.badpixels, ...
فهرست پیکسل‌های مرده دوربین شما، به طوری که
.B dcraw
بتواند پیرامون آن‌ها درون‌یابی کند. هر خط ستون، سطر و زمان یونیکس بروز نقص را برای یک پیکسل مشخص می‌کند. برای نمونه:
.sp 1
.nf
 962   91 1028350000  # died between August 1 and 4, 2002
1285 1067 0           # don't know when this pixel died
.fi
.sp 1
این مختصات پیش از هرگونه کشش یا چرخش هستند؛ بنابراین از دستور
.B dcraw -j -t 0
برای مکان‌یابی پیکسل‌های مرده استفاده کنید.
.SH "همچنین ببینید (SEE ALSO)"
.BR pgm (5),
.BR ppm (5),
.BR pam (5),
.BR pamsumm (1),
.BR pnmgamma (1),
.BR pnmtotiff (1),
.BR pnmtopng (1),
.BR gphoto2 (1),
.BR cjpeg (1),
.BR djpeg (1)
.SH "نویسنده (AUTHOR)"
نوشته‌شده توسط David Coffin، به نشانی dcoffin a cybercom o net