راهنمای کاربر Pamslice(1)   General Commands Manual  راهنمای کاربر Pamslice(1)



نام (NAME)
       pamslice - استخراج یک ردیف یا ستون از مقادیر پیکسل‌های تصویر Netpbm


خلاصه دستور (SYNOPSIS)
       pamslice {-row=rownumber | -column=columnnumber} [-plane=planenumber]
       [imagefile]


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


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

       دستور pamslice یک سطر از چندتایی‌ها (پیکسل‌ها) را از یک تصویر Netpbm
       استخراج کرده و مقادیر آن‌ها را در یک جدول چاپ می‌کند. منظور از سطر، یک
       ردیف یا یک ستون است. این برنامه یک برش مقطعی یک‌بعدی از یک تصویر دوبعدی
       را به شما نمایش می‌دهد (با گزینه -plane می‌توان آن را به عنوان یک برش
       مقطعی یک‌بعدی از یک تصویر سه‌بعدی در نظر گرفت).

       این جدول برای هر چندتایی دارای یک خط است که شامل اعداد ده‌دهی ASCII
       جداشده با فاصله می‌باشد.  نخستین عدد، شماره ستون (در صورت تعیین برش
       ردیفی) یا شماره ردیف (در صورت تعیین برش ستونی) است. سایر اعداد، مقادیر
       نمونه‌ها به ترتیب شماره صفحه (plane) هستند.  برای ورودی PBM یا PGM تنها
       یک صفحه وجود دارد. برای ورودی PPM، صفحه ۰ قرمز، صفحه ۱ سبز و صفحه ۲ آبی
       است. برای جزئیات دقیق درباره مفهوم این اعداد، به مشخصات قالب‌های تصویری
       مراجعه کنید.

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


گزینه‌ها (OPTIONS)
       علاوه بر گزینه‌های مشترک میان تمام برنامه‌های مبتنی بر libnetpbm (به‌ویژه
       -quiet؛ به گزینه‌های مشترک <index.html#commonoptions> مراجعه کنید)،
       دستور pamslice گزینه‌های خط فرمان زیر را می‌شناسد:


       -row=rownumber
              مشخص می‌کند که برش باید افقی باشد (یعنی یک ردیف از تصویر) و تعیین
              می‌کند کدام ردیف است.  ردیف‌ها از بالا و با شروع از ۰ شماره‌گذاری
              می‌شوند.

              نمی‌توانید همزمان هر دو گزینه -row و -column را مشخص کنید.


       -column=colnumber
              مشخص می‌کند که برش باید عمودی باشد (یعنی یک ستون از تصویر) و
              تعیین می‌کند کدام ستون است.  ستون‌ها از سمت چپ و با شروع از ۰
              شماره‌گذاری می‌شوند.

              نمی‌توانید همزمان هر دو گزینه -row و -column را مشخص کنید.


       -plane=planenumber
              مشخص می‌کند که شما فقط به یک صفحه از تصویر علاقه‌مند هستید و کدام
              صفحه مد نظر است.  صفحات از ۰ شماره‌گذاری می‌شوند و بسته به نوع
              تصویر معانی متفاوتی دارند.  در تصویر PPM، صفحه ۰ قرمز، صفحه ۱
              سبز و صفحه ۲ آبی است.

              اگر -plane را مشخص نکنید، تمام صفحات را دریافت می‌کنید؛ هر خط
              خروجی علاوه بر شماره ترتیب، شامل چندین عدد خواهد بود. اگر -plane
              را مشخص کنید، هر خط خروجی علاوه بر شماره ترتیب، تنها شامل یک عدد
              خواهد بود.


       -xmgr  این گزینه باعث می‌شود pamslice خروجی را به عنوان ورودی برای xmgr
              قالب‌بندی کند تا بتوانید آن را ترسیم نمایید. تنها تفاوتی که این
              گزینه ایجاد می‌کند این است که اطلاعات سرآیند را به ابتدای خروجی
              اضافه می‌کند.


همچنین ببینید (SEE ALSO)
       pamtable(1) pamcut(1) pamtopnm(1) pamchannel(1) pnm(1)


تاریخچه (HISTORY)
       دستور pamslice در Netpbm 10.3 (ژوئن ۲۰۰۲) جایگزین pgmslice شد.  این
       دستور سازگار با نسخه‌های قبلی بود، اما بر روی تصاویر Netpbm غیر از PGM و
       PBM نیز کار می‌کرد و گزینه‌های -plane و -xmgr را اضافه کرد.


نویسنده (AUTHOR)
       Jos Dingjan <jos@tuatha.org> پس از نیافتن کد منبع برنامه Marco
       Beijersbergen با همین نام، pgmslice را نوشت. Bryan Henderson آن را به
       pamslice تبدیل کرد.

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

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

netpbm documentation           08 February 2010      راهنمای کاربر Pamslice(1)