.\" This man page was generated by the Netpbm tool 'makeman' from HTML source.
.\" Do not hand-hack it!  If you have bug fixes or improvements, please find
.\" the corresponding HTML page on the Netpbm website, generate a patch
.\" against that, and send it to the Netpbm maintainer.
.TH "Cameratopam User Manual" 0 "12 April 2005" "netpbm documentation"

.SH "نام (NAME)"
cameratopam \- تبدیل تصاویر خام دوربین به PAM

.UN synopsis
.SH "خلاصه دستور (SYNOPSIS)"

\fBcameratopam\fP

[\fIinput_file_name\fP]

[\fB-identify_only\fP]
[\fB-quick_interpolate\fP]
[\fB-half_size\fP]
[\fB-four_color_rgb\fP]
[\fB-document_mode\fP]
[\fB-balance_auto\fP]
[\fB-balance_camera\fP]
[\fB-red_scale=\fP\fIfloat\fP]
[\fB-blue_scale=\fP\fIfloat\fP]
[\fB-brightness=\fP\fIfraction\fP]
[\fB-no_clip_color\fP]
[\fB-rgb\fP]
[\fB-secondary\fP]
[\fB-linear\fP]
[\fB-verbose\fP]
.PP
تمام گزینه‌ها را می‌توان به کوتاه‌ترین پیشوند یکتای آن‌ها خلاصه کرد. می‌توانید به‌جای یک خط تیره از دو خط تیره برای مشخص کردن یک گزینه استفاده کنید. همچنین می‌توانید بین نام یک گزینه و مقدار آن، از فاصله یا علامت مساوی استفاده نمایید.

.UN description
.SH "توضیحات (DESCRIPTION)"
.PP
این برنامه بخشی از
.BR "Netpbm" (1)\c
\& است.
.PP
دستور \fBcameratopam\fP ده‌ها قالب مختلف تصاویر خام دوربین (raw) را به PAM تبدیل می‌کند.
.PP
دوربین‌های عکاسی دیجیتال علاوه بر قالب‌های استانداردتر نظیر TIFF یا JFIF (JPEG)، اغلب می‌توانند تصاویری با یک قالب خام (raw) ویژه تولید کنند. نرم‌افزاری که همراه دوربین ارائه می‌شود به شما امکان می‌دهد تا با بهره‌گیری از داده‌هایی که حین تبدیل تصویر توسط دوربین به قالب‌های عمومی از دست می‌روند، تصویر را پردازش و دستکاری کنید. هر مدل دوربین معمولاً از یک قالب خام منحصر‌به‌فرد استفاده می‌کند.

.UN options
.SH "گزینه‌ها (OPTIONS)"
.PP
علاوه بر گزینه‌های مشترک بین تمامی برنامه‌های مبتنی بر libnetpbm (به‌ویژه \fB-quiet\fP؛ به 
.UR index.html#commonoptions
 Common Options
.UE
\& مراجعه کنید)، \fBcameratopam\fP گزینه‌های خط فرمان زیر را شناسایی می‌کند:

.TP
\fB-identify_only\fP
قالب تصویر ورودی را در خطای استاندارد (Standard Error) گزارش می‌دهد اما هیچ تصویر خروجی تولید نمی‌کند. در صورتی که برنامه نتواند قالب را شناسایی کند، با خطا متوقف می‌شود.

.TP
\fB-verbose\fP
جزئیات مربوط به پردازش را در خطای استاندارد گزارش می‌دهد.

.TP
\fB-quick_interpolate\fP
برای دستیابی سریع به نتایج، از درون‌یابی دوخطی (bilinear) ساده استفاده می‌کند. حالت پیش‌فرض استفاده از یک الگوریتم تطبیقی باکیفیت و کندتر است.

.TP
\fB-half_size\fP
اندازه تصویر خروجی را نصف می‌کند. به جای درون‌یابی، هر بلوک ۲x۲ از حسگرها به یک پیکسل کاهش داده می‌شود. این روش بسیار سریع‌تر از \fB-quick_interpolate\fP است.

.TP
\fB-four_color_rgb\fP
درون‌یابی RGB را به عنوان چهار رنگ مجزا انجام می‌دهد. این امر موجب افت اندک جزئیات می‌شود، بنابراین تنها در صورتی از آن استفاده کنید که الگوهای مشبک ۲x۲ کاذب در آسمان آبی مشاهده کردید.

.TP
\fB-document_mode\fP
داده‌های خام را به صورت یک تصویر در مقیاس خاکستری بدون هیچ‌گونه درون‌یابی نمایش می‌دهد. این گزینه برای عکاسی از اسناد سیاه و سفید مناسب است.

.TP
\fB-balance_auto\fP
تراز سفیدی (تعادل رنگ) خودکار. حالت پیش‌فرض استفاده از یک تراز رنگ ثابت بر مبنای یک کارت سفید عکاسی‌شده در زیر نور خورشید است.

.TP
\fB-balance_camera\fP
استفاده از تراز رنگ مشخص‌شده توسط خود دوربین. اگر \fBcameratopam\fP نتواند این داده‌ها را پیدا کند، یک هشدار چاپ کرده و به مقدار پیش‌فرض بازمی‌گردد.

.TP
\fB-red_scale=\fP\fIfloat\fP
.TP
\fB-blue_scale\fP\fIfloat\fP
تنظیم دقیق‌تر تراز رنگ با ضرب کردن کانال‌های قرمز و آبی در این مقادیر. مقدار پیش‌فرض هر دو 1.0 است.

.TP
\fB-brightness=\fP\fIfloat\fP
تغییر میزان روشنایی تصویر خروجی. پیش‌فرض 1.0 است.

.TP
\fB-no_clip_color\fP
به‌طور پیش‌فرض، \fBcameratopam\fP تمامی رنگ‌ها را می‌بُرد (clip می‌کند) تا از ایجاد ته‌رنگ صورتی در بخش‌های بسیار روشن (highlights) جلوگیری شود. این گزینه را با \fB-brightness=0.25\fP ترکیب کنید تا داده‌های تصویر کاملاً بدون برش باقی بمانند.

.TP
\fB-rgb\fP
رنگ‌های خام دوربین را در فایل خروجی ذخیره می‌کند. به‌طور پیش‌فرض، \fBcameratopam\fP داده‌ها را به فضای رنگی sRGB تبدیل می‌کند.

.TP
\fB-secondary\fP
برای دوربین‌های مبتنی بر Fuji Super CCD SR، این گزینه باعث می‌شود \fBcameratopam\fP از حسگرهای ثانویه استفاده کند، که در عمل تصویر را ۴ استاپ نوری کمتر در معرض نور قرار می‌دهد (underexpose) تا جزئیات نقاط بسیار روشن نمایان شوند. \fBcameratopam\fP این گزینه را برای سایر دوربین‌ها بدون اخطار نادیده می‌گیرد.

.TP
\fB-linear\fP
این گزینه باعث می‌شود \fBcameratopam\fP نوعی از PAM را تولید کند که نمونه‌های رنگی «خطی» (linear) دارد. در PAM استاندارد، هر نمونه در رستر تصویر دارای تصحیح گاما (gamma-corrected) است؛ یعنی اساساً با روشنایی ادراکی متناسب است. با گزینه \fBlinear\fP، برنامه تصویری تولید می‌کند که نمونه‌های آن در عوض متناسب با شدت نور هستند.
.sp
بدون \fB-linear\fP، مقدار maxval تصویر برابر ۲۵۵ است، بنابراین به ازای هر نمونه یک بایت ذخیره می‌شود. با استفاده از \fB-linear\fP، مقدار maxval برابر ۶۵۵۳۵ خواهد بود، در نتیجه به ازای هر نمونه دو بایت در تصویر ذخیره می‌شود.
.sp
بدون \fB-linear\fP، دستور \fBcameratopam\fP از نقطه سفید صدک ۹۹ام استفاده می‌کند. با گزینه \fB-linear\fP از آن استفاده نمی‌کند؛ من نمی‌دانم این به چه معناست.

.UN seealso
.SH "همچنین ببینید (SEE ALSO)"
.BR "411toppm" (1)\c
\&، 
.BR "pamflip" (1)\c
\&، 
.BR "pam" (1)\c
\&

.UN history
.SH "تاریخچه (HISTORY)"
.PP
دستور \fBcameratopam\fP برای اولین بار در Netpbm 10.28 (ژوئن ۲۰۰۵) ارائه شد.
.PP
این ابزار در آوریل ۲۰۰۵ توسط Bryan Henderson از برنامه
.UR https://dechifro.org/dcraw
\fBdcraw\fP اثر Dave Coffin
.UE
\& مشتق شد. Bryan بخشی را که تصویر خروجی Netpbm را تولید می‌کرد جایگزین نمود و تابع خروجی Adobe Photoshop را حذف کرد. وی همچنین ساختار دستوری برنامه را تغییر داد و اصلاحات جزئی دیگری برای سازگاری آن با Netpbm انجام داد. او کد منبع را نیز به بخش‌های قابل‌مدیریت تقسیم نمود (\fBdcraw\fP از یک تک‌فایل منبع ۵۰۰۰ خطی تشکیل شده بود).

.SH "منبع مستندات (DOCUMENT SOURCE)"
این صفحه راهنما توسط ابزار 'makeman' متعلق به Netpbm از منبع HTML تولید شده است. مستندات اصلی در نشانی زیر قرار دارند:
.IP
.B http://netpbm.sourceforge.net/doc/cameratopam.html
.PP