\
.\" 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 "Ppmglobe User Manual" 0 "23 February 2006" "netpbm documentation"

.SH "نام (NAME)"
ppmglobe \- ایجاد نوارهای پوششی کره زمین از روی تصویر استوانه‌ای در فرمت PPM

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

\fBppmglobe\fP
[\fB\-background=\fP\fIcolorname\fP]
[\fB\-closeok\fP]
\fIstripcount\fP
[\fIfilename\fP]
.PP
کوتاه‌ترین مخفف یکتا برای گزینه‌ها پذیرفته می‌شود. همچنین می‌توانید به جای تک‌خط‌تیره از دو خط‌تیره برای مشخص کردن گزینه‌ها استفاده کنید. می‌توانید به جای علامت مساوی از فاصله خالی برای جدا کردن نام گزینه از مقدار آن استفاده نمایید.


.UN description
.SH "توضیحات (DESCRIPTION)"
.PP
این برنامه بخشی از
.BR "Netpbm" (1)\c
\& است.
.PP
برنامه
\fBppmglobe\fP
عکس عمل تصویربرداری استوانه‌ای (cylindrical projection) از یک کره را انجام می‌دهد. با شروع از یک تصویر استوانه‌ای، تصویری تولید می‌کند که می‌توانید آن را برش داده و روی یک کره بچسبانید تا تصویر کروی اولیه‌ای که این تصویر استوانه‌ای از آن حاصل شده است به دست آید.
.PP
تصویربرداری استوانه‌ای چیست؟ نقشه زمین را روی یک کاغذ صاف تصور کنید. روش‌های مختلفی وجود دارد که نقشه‌نگاران اطلاعات سه‌بعدی را در چنین نقشه دوبعدی نمایش می‌دهند. تصویربرداری استوانه‌ای یکی از آن‌هاست. شما می‌توانید یک تصویر استوانه‌ای را با روش ترسیمی زیر بسازید: یک برگه کاغذ مستطیلی را دور کره بپیچید، به طوری که در خط استوا با کره مماس باشد. برای هر نقطه رنگی روی کره، یک خط افقی از محور کره و از میان آن نقطه به سمت بیرون تا سطح کاغذ امتداد دهید. همان رنگ را در آن نقطه روی کاغذ علامت‌گذاری کنید. کاغذ را صاف پهن کنید؛ اکنون یک تصویر استوانه‌ای دارید.
.PP
اینجاست که
\fBppmglobe\fP
وارد عمل می‌شود: تصویر روی آن کاغذ را به
\fBppmglobe\fP
بدهید و آنچه از خروجی بیرون می‌آید چیزی شبیه به این خواهد بود:
.PP
.B نمونه‌ای از نقشه زمین که توسط ppmglobe پردازش شده است
.IMG -C globe.jpg
.PP
می‌توانید نوارها را برش دهید و آن را روی یک کره بچسبانید و کپی‌ای از کره اولیه داشته باشید.
.PP
توجه داشته باشید که تصویربرداری‌های استوانه‌ای معمولاً همان چیزهایی نیستند که به عنوان نقشه‌های زمین می‌بینید. به احتمال زیاد شما تصویربرداری مرکاتور (Mercator projection) را دیده‌اید. در تصویربرداری مرکاتور، با دور شدن از خط استوا، زمین هم در جهت شمال-جنوب و هم شرق-غرب کشیده می‌شود. این روش برای استفاده در ناوبری و دریانوردی اختراع شد، زیرا می‌توانید مسیرهای مستقیم قطب‌نما را روی آن رسم کنید، اما امروزه به این دلیل استفاده می‌شود که زیبا است.
.PP
می‌توانید نقشه‌های سیارات را در نشانی زیر بیابید:
.UR http://space.jpl.nasa.gov
space.jpl.nasa.gov
.UE
\&.

.UN parameters
.SH "پارامترها (PARAMETERS)"
.PP
پارامتر
\fIstripcount\fP
تعداد نوارهایی است که
\fBppmglobe\fP
باید در خروجی تولید کند. نوارهای بیشتر، چسباندن و تنظیم آن روی کره را آسان‌تر می‌کند (کشیدگی، پارگی و چروکیدگی کمتر کاغذ)، اما مستلزم برش‌کاری بیشتری برای نوارها خواهد بود.
.PP
تمام نوارها دارای عرض یکسانی هستند. اگر تعداد ستون‌های پیکسل در تصویر به طور مساوی بر تعداد نوارها تقسیم‌پذیر نباشد،
\fBppmglobe\fP
تصویر را از سمت راست کوتاه (truncate) می‌کند تا فقط نوارهای کامل ایجاد شوند. در حالت غیرعادی که تعداد ستون‌های پیکسل کمتر از تعداد نوارهای درخواستی شما باشد،
\fBppmglobe\fP
با خطا مواجه می‌شود.
.PP
پیش از نسخه 10.32 بسته Netpbm (فوریه ۲۰۰۶)، به جای کوتاه کردن تصویر در سمت راست،
\fBppmglobe\fP
یک نوار کسری و ناقص در سمت راست ایجاد می‌کرد.
.PP
پارامتر
\fIfilename\fP
نام فایل ورودی است. اگر این پارامتر را مشخص نکنید،
\fBppmglobe\fP
تصویر را از ورودی استاندارد (Standard Input) می‌خواند.


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

.TP
\fB\-background=\fP\fIcolorname\fP
رنگی را که بین نوارها قرار می‌گیرد مشخص می‌کند.
.sp
رنگ (\fIcolor\fP) را مطابق توضیحات آرگومانِ
.UR libnetpbm_image.html#colorname
تابع کتابخانه‌ای \fBpnm_parsecolor()\fP
.UE
مشخص کنید.
.sp
مقدار پیش‌فرض، سیاه (black) است.
.sp
این گزینه از نسخه 10.31 بسته Netpbm (دسامبر ۲۰۰۵) اضافه شد. پیش از آن، پس‌زمینه همیشه سیاه بود.

.TP
\fB\-closeok\fP
مشخص می‌کند که اگر رنگ پس‌زمینه دقیقاً همان رنگ تعیین‌شده نباشد مشکلی وجود ندارد. گاهی اوقات به دلیل دقت (یعنی maxval) فضای رنگی تصویر، نمایش دقیق یک رنگِ نام‌گذاری‌شده غیرممکن است. اگر گزینه
\fB\-closeok\fP
را مشخص کنید و
\fBppmglobe\fP
نتواند رنگ درخواستی شما را دقیقاً بازنمایی کند، در عوض از نزدیک‌ترین رنگ ممکن به آن استفاده خواهد کرد. اگر
\fB\-closeok\fP
را مشخص نکنید،
\fBppmglobe\fP
در چنین شرایطی با خطا مواجه خواهد شد.
.sp
این گزینه از نسخه 10.31 بسته Netpbm (دسامبر ۲۰۰۵) اضافه شد.


.UN seealso
.SH "همچنین ببینید (SEE ALSO)"
.BR "ppm" (1)\c
\&,
.BR "pnmmercator" (1)\c
\&

.UN history
.SH "تاریخچه (HISTORY)"
.PP
برنامه
\fBppmglobe\fP
در نسخه 10.16 بسته Netpbm (ژوئن ۲۰۰۳) معرفی شد.
.PP
این برنامه از
\fBppmglobemap\fP
اثر Max Gensthaler مشتق شده است.

.UN authors
.SH "نویسندگان (AUTHORS)"
.PP
\fIMax Gensthaler\fP
برنامه‌ای به نام
\fBppmglobemap\fP
در ژوئن ۲۰۰۳ نوشت و پیشنهاد گنجاندن آن در Netpbm را ارائه داد. Bryan Henderson کد را کمی تغییر داد و آن را با نام
\fBppmglobe\fP
در Netpbm گنجاند.

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