\
.\" 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 "Pamcut User Manual" 0 "26 February 2024" "netpbm documentation"

.SH "نام (NAME)"
pamcut \- انتخاب یک ناحیه مستطیلی از تصویر PAM، PBM، PGM یا PPM

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

\fBpamcut\fP

[\fB-left \fP\fIcolnum\fP]

[\fB-right \fP\fIcolnum\fP]

[\fB-top \fP\fIrownum\fP]

[\fB-bottom \fP\fIrownum\fP]

[\fB-width \fP\fIcols\fP]

[\fB-height \fP\fIrows\fP]

[\fB-pad\fP]

[\fB-cropleft \fP\fInumcols\fP]

[\fB-cropright \fP\fInumcols\fP]

[\fB-croptop \fP\fInumrows\fP]

[\fB-cropbottom \fP\fInumrows\fP]

[\fB-reportonly\fP]

[\fB-verbose\fP]

[\fIleft\fP \fItop\fP \fIwidth\fP \fIheight\fP]

[\fIpnmfile\fP]
.PP
حداقل مخفف یکتای هر گزینه قابل قبول است. می‌توانید به جای یک خط تیره از دو خط تیره برای مشخص کردن گزینه‌ها استفاده کنید. همچنین می‌توانید به جای علامت مساوی، از فاصله خالی برای جدا کردن نام گزینه از مقدار آن استفاده نمایید.

.UN description
.SH "توضیحات (DESCRIPTION)"
.PP
این برنامه بخشی از
.BR "Netpbm" (1)\c
\& است.
.PP
برنامه \fBpamcut\fP یک تصویر PAM، PBM، PGM یا PPM را به عنوان ورودی می‌خواند، مستطیل مشخص‌شده را استخراج می‌کند، و همان نوع تصویر را در خروجی تولید می‌نماید.
.PP
می‌توانید مستطیلی را که می‌خواهید برش داده و نگه دارید مشخص کنید، یا لبه‌هایی را که باید برش خورده و دور ریخته شوند تعیین نمایید، و یا ترکیبی از هر دو را به کار ببرید.
.PP
برای درخواست برش خوردن و دور ریختن لبه‌ها، از گزینه‌های \fB-cropleft\fP، \fB-cropright\fP، \fB-croptop\fP و \fB-cropbottom\fP استفاده کنید تا مشخص شود چند سطر یا ستون باید دور ریخته شود.
.PP
به عنوان مثال، \fB-cropleft=50 -cropright=200\fP به این معناست که ۵۰ ستون سمت چپ‌ترین و ۲۰۰ ستون سمت راست‌ترین دور ریخته شوند.
.PP
برای مشخص کردن مستطیلی که باید نگه داشته شود، از گزینه‌های \fB-left\fP، \fB-right\fP، \fB-top\fP، \fB-bottom\fP، \fB-width\fP، \fB-height\fP و \fB-pad\fP استفاده کنید.
.PP
برای مثال، \fB-left=50 -right=200\fP به معنای نگه داشتن ۱۵۱ ستون بین ستون‌های ۵۰ و ۲۰۰ (شامل هر دو) است.
.PP
می‌توانید هر ترکیبی از این گزینه‌ها را استفاده کنید. مقادیری که مشخص نمی‌کنید از مقادیر پیش‌فرض استفاده خواهند کرد. این پیش‌فرض‌ها در جهت حداقل برش و به نفع بریدن لبه‌های راست و پایین، و (همراه با \fB-pad\fP) حداقل لایه‌گذاری (padding) و افزودن لایه در سمت راست و پایین هستند. تعیین بیش از حد مشخصات خطا است؛ یعنی مشخص کردن هر سه گزینه \fB-left\fP، \fB-right\fP و \fB-width\fP، یا هر سه گزینه \fB-top\fP، \fB-bottom\fP و \fB-height\fP، یا مشخص کردن هم‌زمان \fBright\fP و \fB-cropright\fP خطا محسوب می‌شود.
.PP
یک روش قدیمی‌تر نیز برای مشخص کردن مستطیل مورد نظر وجود دارد: آرگومان‌های مکانی (positional arguments). پیش از ژوئیه ۲۰۰۰، آرگومان‌ها تنها روش موجود بودند، اما نباید در برنامه‌های جدید از آن‌ها استفاده کنید. گزینه‌ها راحت‌تر به خاطر سپرده و خوانده می‌شوند، گویاتر هستند، و امکان استفاده از مقادیر پیش‌فرض را به شما می‌دهند.
.PP
اگر هم از گزینه‌ها و هم از آرگومان‌ها استفاده کنید، این دو مشخصه به روشی نامشخص با یکدیگر ترکیب می‌شوند.
.PP
برای استفاده از آرگومان‌ها، هر چهار آرگومان \fIleft\fP، \fItop\fP، \fIwidth\fP و \fIheight\fP را مشخص کنید. آرگومان‌های \fIleft\fP و \fItop\fP همان اثری را دارند که مشخص کردن آن‌ها به عنوان آرگومان گزینه‌های \fB-left\fP یا \fB-top\fP دارد. آرگومان‌های \fIwidth\fP و \fIheight\fP در صورتی که مثبت باشند، همان اثری را دارند که مشخص کردن آن‌ها به عنوان آرگومان گزینه‌های \fB-width\fP یا \fB-height\fP دارد. در صورتی که مثبت نباشند، همان اثری را دارند که مشخص کردن یک واحد کمتر از آن مقدار به عنوان آرگومان گزینه‌های \fB-right\fP یا \fB-bottom\fP دارد (مثلاً \fIwidth\fP = 0 باعث می‌شود برش تا انتهای لبه سمت راست ادامه یابد). پیش از ژوئیه ۲۰۰۰، اعداد منفی برای \fIwidth\fP و \fIheight\fP مجاز نبودند.
.PP
اگر فایل ورودی \fIpnmfile\fP را مشخص نکنید، ورودی از ورودی استاندارد خوانده می‌شود.
.PP
خروجی به خروجی استاندارد فرستاده می‌شود.
.PP
برنامه \fBpamcut\fP بر روی جریان چندتصویری (multi-image stream) نیز کار می‌کند. این برنامه هر تصویر موجود در جریان را به‌طور مستقل برش می‌دهد و یک جریان چندتصویری در خروجی تولید می‌کند. پیش از Netpbm نسخه 10.32 (مارس ۲۰۰۶)، همه تصاویر به جز اولین تصویر موجود در جریان نادیده گرفته می‌شدند.
.PP
اگر قصد دارید یک تصویر منفرد را به چندین تصویر هم‌اندازه تقسیم کنید، برنامه \fBpamdice\fP سریع‌تر و آسان‌تر از چندین بار اجرای \fBpamcut\fP است.
.PP
برنامه \fBpamcomp\fP نیز برای برش و لایه‌گذاری یک تصویر به اندازه‌ای مشخص مفید است. شما یک تصویر پس‌زمینه با ابعاد کادر مورد نظر ایجاد می‌کنید و تصویر اصلی را روی آن قرار می‌دهید.

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


.TP
\fB-left=\fP\fIcolnum\fP
شماره ستون سمت چپ‌ترین ستونی که باید در خروجی باشد. ستون‌های سمت چپ آن بریده و حذف می‌شوند. اگر عددی نامنفی باشد، به ستون‌هایی اشاره دارد که شماره‌گذاری آن‌ها از 0 در سمت چپ آغاز شده و به سمت راست افزایش می‌یابد. اگر منفی باشد، به ستون‌هایی اشاره دارد که با -1 در سمت راست شماره‌گذاری شده و به سمت چپ کاهش می‌یابند.

.TP
\fB-right=\fP\fIcolnum\fP
شماره ستون سمت راست‌ترین ستونی که باید در خروجی باشد که همانند \fB-left\fP شماره‌گذاری می‌شود. ستون‌های سمت راست آن بریده و حذف می‌شوند.

.TP
\fB-top=\fP\fIrownum\fP
شماره سطر بالاترین سطری که باید در خروجی باشد. سطرهای بالای آن بریده و حذف می‌شوند. اگر عددی نامنفی باشد، به سطرهایی اشاره دارد که شماره‌گذاری آن‌ها از 0 در بالا آغاز شده و به سمت پایین افزایش می‌یابد. اگر منفی باشد، به سطرهایی اشاره دارد که با -1 در پایین شماره‌گذاری شده و به سمت بالا کاهش می‌یابند.

.TP
\fB-bottom=\fP\fIrownum\fP
شماره سطر پایین‌ترین سطری که باید در خروجی باشد که همانند \fB-top\fP شماره‌گذاری می‌شود. سطرهای پایین آن بریده و حذف می‌شوند.

.TP
\fB-width=\fP\fIcols\fP
تعداد ستون‌هایی که باید در خروجی باشند. باید عددی مثبت باشد.

.TP
\fB-height=\fP\fIrows\fP
تعداد سطرهایی که باید در خروجی باشند. باید عددی مثبت باشد.

.TP
\fB-cropleft\fP
.TP
\fB-cropright\fP
.TP
\fB-croptop\fP
.TP
\fB-cropbottom\fP
این گزینه‌ها مشخص می‌کنند که به ترتیب چه تعداد سطر یا ستون از لبه‌های چپ، راست، بالا یا پایین برش داده و حذف شوند.
.sp
مقدار نباید منفی باشد.
.sp
این گزینه‌ها در Netpbm نسخه 10.85 (دسامبر ۲۰۱۸) اضافه شدند. پیش از آن، می‌توانستید همین کار را با \fB-left\fP، \fBtop\fP و مقادیر منفی برای \fB-right\fP و \fB-bottom\fP انجام دهید. به یاد داشته باشید که در حالت دوم باید یک واحد کم کنید؛ برای مثال معادل \fB-cropright=1\fP گزینه \fB-right=-2\fP است.
  
.TP
\fB-pad\fP
اگر مستطیلی که مشخص می‌کنید کاملاً در محدوده تصویر ورودی نباشد، \fBpamcut\fP با خطا مواجه می‌شود مگر اینکه گزینه \fB-pad\fP را نیز مشخص کرده باشید. در این حالت، خروجی را تا لبه‌های مشخص‌شده با رنگ سیاه پر (pad) می‌کند. اگر نیاز به تصویری با ابعادی معین دارید و تصویری با ابعاد دلخواه در اختیار دارید، می‌توانید از این گزینه استفاده کنید.
.sp
برنامه \fBpnmpad\fP نیز به تصویر حاشیه اضافه می‌کند، اما در آن عرض حاشیه را مستقیماً تعیین می‌کنید.
.sp
برنامه \fBpamcomp\fP شکل عمومی‌تری از این لایه‌گذاری را انجام می‌دهد. یک تصویر پس‌زمینه با ابعاد کادر مورد نظر بسازید و تصویر اصلی را روی آن بیندازید. می‌توانید با استفاده از گزینه‌ها، تصویر اصلی را در مرکز کادر یا مماس با هر یک از لبه‌ها قرار دهید و رنگ لایه‌گذاری را به هر رنگ دلخواهی درآورید (رنگ لایه‌گذاری همان رنگ تصویر پس‌زمینه خواهد بود).

.TP
\fB-reportonly\fP
این گزینه باعث می‌شود \fBpamcut\fP به جای تولید تصویر خروجی، شرحی از برشی را که انجام می‌داد در خروجی استاندارد بنویسد. برای شرح این خروجی و روش‌های استفاده از آن، به
.UR #reportonly
زیر
.UE
\& مراجعه کنید.
.sp
آن شرح، یک خط متن شامل ۸ عدد ده‌دهی از پیکسل‌ها است که با فاصله از هم جدا شده‌اند:


.IP \(bu
شماره ستون برش چپ
.IP \(bu
شماره ستون برش راست
.IP \(bu
شماره سطر برش بالا
.IP \(bu
شماره سطر برش پایین
.IP \(bu
عرض تصویر ورودی
.IP \(bu
ارتفاع تصویر ورودی
.IP \(bu
عرض تصویر خروجی
.IP \(bu
ارتفاع تصویر خروجی

.sp
شماره ستون برش چپ، شماره ستونِ چپ‌ترین ستون تصویر خروجی در تصویر ورودی است. برای برش راست، مربوط به راست‌ترین ستون خروجی است. بالا و پایین نیز به همین صورت هستند.
.sp
\fIشماره‌های ستون و سطر در صورتی که \fB-pad\fP را مشخص کرده باشید و \fBpamcut\fP لایه‌گذاری اضافه کرده باشد، می‌توانند منفی باشند\fP. به همین ترتیب، می‌توانند فراتر از لبه‌های راست و پایین تصویر ورودی باشند.
.sp
مثال:
.nf
    <span style="font-family: monospace">
      10 109 -1 98 150 80 100 100
    </span>
.fi
.sp
این گزینه در Netpbm نسخه 11.06 (مارس ۲۰۲۴) جدید بود.

.TP
\fB-verbose\fP
اطلاعات مربوط به پردازش را در خطای استاندارد چاپ می‌کند.


.UN seealso
.SH "همچنین ببینید (SEE ALSO)"
.BR "pnmcrop" (1)\c
\&,
.BR "pamdice" (1)\c
\&,
.BR "pamcomp" (1)\c
\&,
.BR "pnmpad" (1)\c
\&,
.BR "pamcat" (1)\c
\&,
.BR "pgmslice" (1)\c
\&,
.BR "pnm" (1)\c
\&

.UN history
.SH "تاریخچه (HISTORY)"
.PP
برنامه \fBpamcut\fP از \fBpnmcut\fP در Netpbm نسخه 9.20 (مه ۲۰۰۱) مشتق شد. این نخستین برنامه Netpbm بود که با قالب جدید PAM و کتابخانه برنامه‌نویسی آن سازگار گردید.
.PP
برنامه پیشین \fBpnmcut\fP یکی از قدیمی‌ترین ابزارهای بسته Netpbm بود.


.UN author
.SH "نویسنده (AUTHOR)"

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