.\" 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 "Pnmmargin User Manual" 0 "26 December 2025" "netpbm documentation"

.SH "نام (NAME)"

pnmmargin \- افزودن حاشیه به یک تصویر PNM

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

\fBpnmmargin\fP
[\fB-white\fP|\fB-black\fP|\fB-color\fP \fIcolorspec\fP] \fIsize\fP
[\fIpnmfile\fP]

.UN description
.SH "توضیحات (DESCRIPTION)"
.PP
این برنامه بخشی از
.BR "Netpbm" (1)\c
\& است.
.PP
دستور \fBpnmmargin\fP یک حاشیه در اطراف تصویر PNM اضافه می‌کند.


.UN arguments
.SH "آرگومان‌ها (ARGUMENTS)"
.PP
\fIpnmfile\fP نام فایل ورودی است. اگر این آرگومان را مشخص نکنید، \fBpnmmargin\fP تصویر ورودی را از ورودی استاندارد (Standard Input) می‌خواند.


.UN options
.SH "گزینه‌ها (OPTIONS)"
.PP
علاوه بر گزینه‌های مشترک میان تمامی برنامه‌های مبتنی بر libnetpbm
(به‌ویژه \fB-plain\fP، ببینید 
.UR index.html#commonoptions
گزینه‌های مشترک
.UE
\&)، دستور \fBpnmmargin\fP گزینه‌های خط فرمان زیر را می‌شناسد:
.PP
می‌توانید رنگ حاشیه را با گزینه‌های \fB-white\fP،
\fB-black\fP، و \fB-color\fP مشخص کنید. اگر رنگی را تعیین نکنید،
برنامه آن را حدس می‌زند.

گزینه‌های \fB-white\fP و \fB-black\fP به‌ترتیب همانند \fB-color=white\fP
و \fB-color=black\fP هستند (با این تفاوت که مورد دوم در صورتی که
یک واژه‌نامهٔ رنگ در محیط خود تنظیم نکرده باشید ناموفق خواهد بود، بنابراین
در عمل بیشتر شبیه به \fB-color=rgbi:0/0/0\fP و
\fB-color=rgbi:1/1/1\fP هستند).
.PP
مقدار \fB-color\fP شبیه به
.UR libnetpbm_image.html#colorname
آرگومان تابع کتابخانه‌ای \fBpnm_parsecolor()\fP است
.UE
\&.
.PP
گزینهٔ مشترک \fB-plain\fP از نسخهٔ 10.40 بستهٔ Netpbm
(سپتامبر ۲۰۰۷) پیاده‌سازی شده است.
.PP
گزینهٔ مشترک \fB-quiet\fP پیاده‌سازی نشده است.

.UN notes
.SH "نکات (NOTES)"
.PP
دستور \fBpnmpad\fP اساساً همین کار را انجام می‌دهد، اما کنترل بیشتری روی هر یک از حاشیه‌ها به شما می‌دهد و تنها حاشیه‌های سیاه و سفید ایجاد می‌کند.
.PP
برای حذف حاشیه‌ای با اندازهٔ مشخص از یک تصویر، از \fBpamcut\fP استفاده کنید.
دستور \fBpnmcrop\fP نیز حاشیه‌ها را حذف می‌کند، اما خود تشخیص می‌دهد که چه چیزی حاشیه و چه چیزی سوژه است.
.PP
اگر می‌خواهید اندازهٔ تصویر را به اندازهٔ مورد نیاز مشخصی درآورید، و در صورت لزوم حاشیه اضافه کنید یا برش (crop) بزنید، \fBpamcut\fP ممکن است همان چیزی باشد که نیاز دارید.


.UN seealso
.SH "همچنین ببینید (SEE ALSO)"


.IP \(bu

.BR "pamcut" (1)\c
\&
.IP \(bu

.BR "pnmcrop" (1)\c
\&
.IP \(bu

.BR "pamcat" (1)\c
\&
.IP \(bu

.BR "pnmpad" (1)\c
\&
.IP \(bu

.BR "pnm" (1)\c
\&


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

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