نام (NAME)

pamcut - انتخاب یک ناحیه مستطیلی از تصویر PAM، PBM، PGM یا PPM

خلاصه دستور (SYNOPSIS)

pamcut

[-left colnum]

[-right colnum]

[-top rownum]

[-bottom rownum]

[-width cols]

[-height rows]

[-pad]

[-cropleft numcols]

[-cropright numcols]

[-croptop numrows]

[-cropbottom numrows]

[-reportonly]

[-verbose]

[left top width height]

[pnmfile]

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

توضیحات (DESCRIPTION)

این برنامه بخشی از Netpbm(1) است.

برنامه pamcut یک تصویر PAM، PBM، PGM یا PPM را به عنوان ورودی می‌خواند، مستطیل مشخص‌شده را استخراج می‌کند، و همان نوع تصویر را در خروجی تولید می‌نماید.

می‌توانید مستطیلی را که می‌خواهید برش داده و نگه دارید مشخص کنید، یا لبه‌هایی را که باید برش خورده و دور ریخته شوند تعیین نمایید، و یا ترکیبی از هر دو را به کار ببرید.

برای درخواست برش خوردن و دور ریختن لبه‌ها، از گزینه‌های -cropleft، -cropright، -croptop و -cropbottom استفاده کنید تا مشخص شود چند سطر یا ستون باید دور ریخته شود.

به عنوان مثال، -cropleft=50 -cropright=200 به این معناست که ۵۰ ستون سمت چپ‌ترین و ۲۰۰ ستون سمت راست‌ترین دور ریخته شوند.

برای مشخص کردن مستطیلی که باید نگه داشته شود، از گزینه‌های -left، -right، -top، -bottom، -width، -height و -pad استفاده کنید.

برای مثال، -left=50 -right=200 به معنای نگه داشتن ۱۵۱ ستون بین ستون‌های ۵۰ و ۲۰۰ (شامل هر دو) است.

می‌توانید هر ترکیبی از این گزینه‌ها را استفاده کنید. مقادیری که مشخص نمی‌کنید از مقادیر پیش‌فرض استفاده خواهند کرد. این پیش‌فرض‌ها در جهت حداقل برش و به نفع بریدن لبه‌های راست و پایین، و (همراه با -pad) حداقل لایه‌گذاری (padding) و افزودن لایه در سمت راست و پایین هستند. تعیین بیش از حد مشخصات خطا است؛ یعنی مشخص کردن هر سه گزینه -left، -right و -width، یا هر سه گزینه -top، -bottom و -height، یا مشخص کردن هم‌زمان right و -cropright خطا محسوب می‌شود.

یک روش قدیمی‌تر نیز برای مشخص کردن مستطیل مورد نظر وجود دارد: آرگومان‌های مکانی (positional arguments). پیش از ژوئیه ۲۰۰۰، آرگومان‌ها تنها روش موجود بودند، اما نباید در برنامه‌های جدید از آن‌ها استفاده کنید. گزینه‌ها راحت‌تر به خاطر سپرده و خوانده می‌شوند، گویاتر هستند، و امکان استفاده از مقادیر پیش‌فرض را به شما می‌دهند.

اگر هم از گزینه‌ها و هم از آرگومان‌ها استفاده کنید، این دو مشخصه به روشی نامشخص با یکدیگر ترکیب می‌شوند.

برای استفاده از آرگومان‌ها، هر چهار آرگومان left، top، width و height را مشخص کنید. آرگومان‌های left و top همان اثری را دارند که مشخص کردن آن‌ها به عنوان آرگومان گزینه‌های -left یا -top دارد. آرگومان‌های width و height در صورتی که مثبت باشند، همان اثری را دارند که مشخص کردن آن‌ها به عنوان آرگومان گزینه‌های -width یا -height دارد. در صورتی که مثبت نباشند، همان اثری را دارند که مشخص کردن یک واحد کمتر از آن مقدار به عنوان آرگومان گزینه‌های -right یا -bottom دارد (مثلاً width = 0 باعث می‌شود برش تا انتهای لبه سمت راست ادامه یابد). پیش از ژوئیه ۲۰۰۰، اعداد منفی برای width و height مجاز نبودند.

اگر فایل ورودی pnmfile را مشخص نکنید، ورودی از ورودی استاندارد خوانده می‌شود.

خروجی به خروجی استاندارد فرستاده می‌شود.

برنامه pamcut بر روی جریان چندتصویری (multi-image stream) نیز کار می‌کند. این برنامه هر تصویر موجود در جریان را به‌طور مستقل برش می‌دهد و یک جریان چندتصویری در خروجی تولید می‌کند. پیش از Netpbm نسخه 10.32 (مارس ۲۰۰۶)، همه تصاویر به جز اولین تصویر موجود در جریان نادیده گرفته می‌شدند.

اگر قصد دارید یک تصویر منفرد را به چندین تصویر هم‌اندازه تقسیم کنید، برنامه pamdice سریع‌تر و آسان‌تر از چندین بار اجرای pamcut است.

برنامه pamcomp نیز برای برش و لایه‌گذاری یک تصویر به اندازه‌ای مشخص مفید است. شما یک تصویر پس‌زمینه با ابعاد کادر مورد نظر ایجاد می‌کنید و تصویر اصلی را روی آن قرار می‌دهید.

گزینه‌ها (OPTIONS)

علاوه بر گزینه‌های مشترک در تمام برنامه‌های مبتنی بر libnetpbm (به‌ویژه -quiet، به
گزینه‌های عمومی (Common Options) مراجعه کنید)، pamcut گزینه‌های خط فرمان زیر را می‌شناسد:

-left=colnum

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

-right=colnum

شماره ستون سمت راست‌ترین ستونی که باید در خروجی باشد که همانند -left شماره‌گذاری می‌شود. ستون‌های سمت راست آن بریده و حذف می‌شوند.

-top=rownum

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

-bottom=rownum

شماره سطر پایین‌ترین سطری که باید در خروجی باشد که همانند -top شماره‌گذاری می‌شود. سطرهای پایین آن بریده و حذف می‌شوند.

-width=cols

تعداد ستون‌هایی که باید در خروجی باشند. باید عددی مثبت باشد.

-height=rows

تعداد سطرهایی که باید در خروجی باشند. باید عددی مثبت باشد.

-cropleft

-cropright

-croptop

-cropbottom

این گزینه‌ها مشخص می‌کنند که به ترتیب چه تعداد سطر یا ستون از لبه‌های چپ، راست، بالا یا پایین برش داده و حذف شوند.

مقدار نباید منفی باشد.

این گزینه‌ها در Netpbm نسخه 10.85 (دسامبر ۲۰۱۸) اضافه شدند. پیش از آن، می‌توانستید همین کار را با -left، top و مقادیر منفی برای -right و -bottom انجام دهید. به یاد داشته باشید که در حالت دوم باید یک واحد کم کنید؛ برای مثال معادل -cropright=1 گزینه -right=-2 است.

-pad

اگر مستطیلی که مشخص می‌کنید کاملاً در محدوده تصویر ورودی نباشد، pamcut با خطا مواجه می‌شود مگر اینکه گزینه -pad را نیز مشخص کرده باشید. در این حالت، خروجی را تا لبه‌های مشخص‌شده با رنگ سیاه پر (pad) می‌کند. اگر نیاز به تصویری با ابعادی معین دارید و تصویری با ابعاد دلخواه در اختیار دارید، می‌توانید از این گزینه استفاده کنید.

برنامه pnmpad نیز به تصویر حاشیه اضافه می‌کند، اما در آن عرض حاشیه را مستقیماً تعیین می‌کنید.

برنامه pamcomp شکل عمومی‌تری از این لایه‌گذاری را انجام می‌دهد. یک تصویر پس‌زمینه با ابعاد کادر مورد نظر بسازید و تصویر اصلی را روی آن بیندازید. می‌توانید با استفاده از گزینه‌ها، تصویر اصلی را در مرکز کادر یا مماس با هر یک از لبه‌ها قرار دهید و رنگ لایه‌گذاری را به هر رنگ دلخواهی درآورید (رنگ لایه‌گذاری همان رنگ تصویر پس‌زمینه خواهد بود).

-reportonly

این گزینه باعث می‌شود pamcut به جای تولید تصویر خروجی، شرحی از برشی را که انجام می‌داد در خروجی استاندارد بنویسد. برای شرح این خروجی و روش‌های استفاده از آن، به زیر مراجعه کنید.

آن شرح، یک خط متن شامل ۸ عدد ده‌دهی از پیکسل‌ها است که با فاصله از هم جدا شده‌اند:

• شماره ستون برش چپ
• شماره ستون برش راست
• شماره سطر برش بالا
• شماره سطر برش پایین
• عرض تصویر ورودی
• ارتفاع تصویر ورودی
• عرض تصویر خروجی
• ارتفاع تصویر خروجی

  شماره ستون برش چپ، شماره ستونِ چپ‌ترین ستون تصویر خروجی در تصویر ورودی است. برای برش راست، مربوط به راست‌ترین ستون خروجی است. بالا و پایین نیز به همین صورت هستند.

  شماره‌های ستون و سطر در صورتی که -pad را مشخص کرده باشید و pamcut لایه‌گذاری اضافه کرده باشد، می‌توانند منفی باشند. به همین ترتیب، می‌توانند فراتر از لبه‌های راست و پایین تصویر ورودی باشند.

  مثال:

  <span style="font-family: monospace">
    10 109 -1 98 150 80 100 100
  </span>

  این گزینه در Netpbm نسخه 11.06 (مارس ۲۰۲۴) جدید بود.

-verbose

اطلاعات مربوط به پردازش را در خطای استاندارد چاپ می‌کند.

همچنین ببینید (SEE ALSO)

pnmcrop(1), pamdice(1), pamcomp(1), pnmpad(1), pamcat(1), pgmslice(1), pnm(1)

تاریخچه (HISTORY)

برنامه pamcut از pnmcut در Netpbm نسخه 9.20 (مه ۲۰۰۱) مشتق شد. این نخستین برنامه Netpbm بود که با قالب جدید PAM و کتابخانه برنامه‌نویسی آن سازگار گردید.

برنامه پیشین pnmcut یکی از قدیمی‌ترین ابزارهای بسته Netpbm بود.

نویسنده (AUTHOR)

حق نشر (C) ۱۹۸۹ توسط Jef Poskanzer.

منبع مستندات (DOCUMENT SOURCE)

این صفحه راهنما توسط ابزار Netpbm تحت عنوان 'makeman' از منبع HTML تولید شده است. مستندات اصلی در آدرس زیر قرار دارد:

http://netpbm.sourceforge.net/doc/pamcut.html