.\" 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 "Ppmlabel User Manual" 0 "15 April 2006" "netpbm documentation"

.SH "نام (NAME)"
ppmlabel \- افزودن متن به یک تصویر PPM

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

\fBppmlabel\fP

[\fB-angle\fP \fIangle\fP]

[\fB-background\fP { \fBtransparent\fP | \fIcolor\fP } ]

[\fB-color\fP \fIcolor\fP]

[\fB-file\fP \fIfilename\fP]

[\fB-size\fP

\fItextsize\fP]

[\fB-text\fP \fItext_string\fP]

[\fB-x\fP \fIcolumn\fP]

[\fB-y\fP \fIrow\fP]

\&...

[\fIppmfile\fP]


.UN example
.SH "مثال‌ها (EXAMPLES)"

.nf
\f(CW
    ppmlabel -x 50 -y 50 -text hello \e
             -angle -30 -text there \e
             testimg.ppm 
\fP
.fi

.UN description
.SH "توضیحات (DESCRIPTION)"
.PP
این برنامه بخشی از
.BR "Netpbm" (1)\c
\& است.
.PP
دستور \fBppmlabel\fP از امکانات رسم متن بخش «ppmd» در \fBlibnetpbm\fP برای افزودن متن به یک تصویر PBM استفاده می‌کند. شما موقعیت، اندازه، زاویه خط مبنا، رنگ متن و رنگ پس‌زمینه (در صورت وجود) را با آرگومان‌های خط فرمان کنترل می‌کنید. می‌توانید متن را در خط فرمان مشخص کرده یا آن را در فایل‌ها ارائه دهید.
.PP
شما می‌توانید هر تعداد برچسب مجزا را در یک بار اجرای \fBppmlabel\fP اضافه کنید، که تنها توسط محدودیت‌های محیط شما بر تعداد و اندازه آرگومان‌های برنامه (مانند محدودیت اندازه دستور در شل) محدود می‌شود.
.PP
اگر \fIppmfile\fP را مشخص نکنید، \fBppmlabel\fP تصویر PPM ورودی را از ورودی استاندارد می‌خواند.
.PP
تصویر خروجی به خروجی استاندارد ارسال می‌شود.
.PP
روشی پیشرفته‌تر برای افزودن برچسب به یک تصویر، استفاده از \fBpbmtext\fP یا \fBpbmtextps\fP برای ساخت تصویری از متن و سپس استفاده از \fBpamcomp\fP برای هم‌پوشانی آن بر روی تصویر پایه است.
.PP
برنامه عمومی‌تر دیگر \fBppmdraw\fP است. استفاده از آن برای برچسب‌گذاری ساده کمی دشوارتر است.

.UN options
.SH "گزینه‌ها (OPTIONS)"
.PP
علاوه بر گزینه‌های مشترک بین همه برنامه‌های مبتنی بر libnetpbm (به‌ویژه \fB-quiet\fP، به
.UR index.html#commonoptions
گزینه‌های مشترک
.UE
مراجعه کنید)، \fBppmlabel\fP گزینه‌های خط فرمان زیر را می‌شناسد:
.PP
آرگومان‌های خط فرمان \fBppmlabel\fP به معنای دقیق کلمه گزینه نیستند؛ آن‌ها دستوراتی هستند که جای‌گذاری و ظاهر متنی را که به تصویر ورودی اضافه می‌شود کنترل می‌کنند. آن‌ها از چپ به راست اجرا می‌شوند و هر تعداد آرگومان می‌تواند ظاهر شود.
.PP
می‌توانید هر گزینه را به کوتاه‌ترین پیشوند یکتای آن مخفف کنید.


.TP
\fB-angle\fP\fI angle\fP
این گزینه زاویه خط مبنای متن بعدی را تنظیم می‌کند.
\fIangle\fP یک عدد صحیح بر حسب درجه است که در جهت پادساعت‌گرد از محور ردیف تصویر اندازه‌گیری می‌شود.

.TP
\fB-background\fP { \fBtransparent\fP | \fIcolor\fP }
اگر آرگومان \fBtransparent\fP باشد، \fBppmlabel\fP متن را روی پیکسل‌های موجود در تصویر رسم می‌کند. اگر یک \fIcolor\fP مشخص کنید (برای اطلاعات در مورد نحوه مشخص کردن رنگ‌ها، گزینه \fB-color\fP در زیر را ببینید)، \fBppmlabel\fP مستطیل‌های پس‌زمینه‌ای ایجاد می‌کند که متن بعدی را در بر می‌گیرند و آن مستطیل‌ها با آن رنگ پر می‌شوند.

.TP
\fB-color\fP \fIcolor\fP
این گزینه رنگ متن بعدی را تنظیم می‌کند.
.sp
رنگ (\fIcolor\fP) را همان‌طور که برای
.UR libnetpbm_image.html#colorname
آرگومان روال کتابخانه‌ای \fBpnm_parsecolor()\fP
.UE
توضیح داده شده است، مشخص کنید.
.sp
\fB-colour\fP یک نگارش جایگزین قابل قبول است.

.TP
\fB-file\fP \fIfilename\fP
این گزینه باعث می‌شود \fBppmlabel\fP خطوط متن را از فایلی به نام \fIfilename\fP بخواند و آن را در خطوط متوالی رسم کند.

.TP
\fB-size\fP \fItextsize\fP
این گزینه ارتفاع بلندترین نویسه‌ها بالای خط مبنا را روی \fItextsize\fP پیکسل تنظیم می‌کند.

.TP
\fB-text\fP \fItext_string\fP
این گزینه باعث می‌شود \fBppmlabel\fP رشته متنی مشخص‌شده را رسم کند. این گزینه موقعیت متن بعدی را به اندازه ۱٫۷۵ برابر \fItextsize\fP فعلی به سمت پایین پیش می‌برد. این ویژگی به شما اجازه می‌دهد چندین خط متن را به شیوه‌ای معقول بدون نیاز به تعیین موقعیت هر خط رسم کنید.
.sp
توجه داشته باشید که اگر \fBppmlabel\fP را از طریق یک دستور شل اجرا می‌کنید و رشته متنی شما شامل فاصله است، باید آن را در علامت نقل‌قول قرار دهید تا شل کل رشته را به عنوان یک نشانه منفرد در نظر بگیرد. به عنوان مثال:
.nf
  $ ppmlabel -text "this is my text" baseimage.ppm >annotatedimage.ppm
.fi


.TP
\fB-x\fP \fIcolumn\fP
این گزینه ستون پیکسلی را که متن بعدی از آن چپ‌چین خواهد شد، تنظیم می‌کند. بسته به شکل نویسه اول، ممکن است متن واقعی چند پیکسل سمت راست این نقطه آغاز شود.

.TP
\fB-y\fP \fIrow\fP
این گزینه ردیف پیکسلی را که خط مبنای متن بعدی را تشکیل می‌دهد، تنظیم می‌کند. نویسه‌های دارای دنباله پایینی (مانند «y») به زیر این خط امتداد می‌یابند.



.UN limitations
.SH "محدودیت‌ها (LIMITATIONS)"
.PP
رشته‌های متنی به اسکی ۷ بیتی (7 bit ASCII) محدود هستند. قلم متنی مورداستفاده توسط
\fBppmlabel\fP شامل تعاریفی برای نویسه‌های ۸ بیتی ISO 8859/1 نیست.
.PP
هنگام رسم چندین خط متن با پس‌زمینه غیرشفاف، احتمالاً باید فضای بین خطوط با رنگ پس‌زمینه پر شود. انجام درست این کار زمانی که متن با زاویه‌ای غیرمتعامد چرخانده شده است، پیچیده و چالش‌برانگیز است.

.UN seealso
.SH "همچنین ببینید (SEE ALSO)"
.BR "ppmmake" (1)\c
\&،
.BR "ppmdraw" (1)\c
\&،
.BR "pbmtext" (1)\c
\&،
.BR "pbmtextps" (1)\c
\&،
.BR "pamcomp" (1)\c
\&،
.BR "ppm" (1)\c
\&


.UN author
.SH "نویسندگان (AUTHORS)"

حق نشر (C) ۱۹۹۵ متعلق به John Walker (\fIkelvin@fourmilab.ch\fP)
صفحه خانگی وب: 
.UR http://www.fourmilab.ch
http://www.fourmilab.ch
.UE
\&
.PP
بدین‌وسیله مجوز استفاده، کپی، تغییر و توزیع این نرم‌افزار و مستندات آن برای هر مقصودی و بدون دریافت هزینه، بدون هیچ‌گونه قید و شرطی اعطا می‌شود. این نرم‌افزار «همان‌طور که هست» (as is) و بدون هرگونه ضمانت صریح یا ضمنی ارائه می‌شود.
.SH "منبع سند (DOCUMENT SOURCE)"
این صفحه راهنما توسط ابزار 'makeman' در Netpbm از منبع HTML تولید شده است. مستندات اصلی در نشانی زیر قرار دارد:
.IP
.B http://netpbm.sourceforge.net/doc/ppmlabel.html
.PP