\
.\" 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 "Pamdice User Manual" 0 "27 May 2025" "netpbm documentation"

.SH "نام (NAME)"
pamdice \- قطعه‌قطعه کردن و برش تصویر Netpbm به ماتریسی از کاشی‌های کوچک‌تر

.UN example
.SH "مثال (EXAMPLE)"
.PP
در این مثال‌ها،
.B myimage.ppm
تصویری با پهنای ۱۰٬۰۰۰ پیکسل و ارتفاع ۸٬۰۰۰ پیکسل است.

.nf
\f(CW
    $ pamdice myimage.ppm -width=1000 -height=1000 -outstem=myimage_part
    $ pamundice myimage_part_%1d_%1a.ppm -across=10 -down=8 >myimage.ppm

    $ pamdice myimage.ppm -height=1000 -voverlap=90 -outstem=myimage_part

    $ pamdice myimage.ppm -width=1000 -height=1000 -outstem=myimage_part \e
        -listfile=tiles.txt
    $ pamundice -across=10 -down=8 -listfile=tiles.txt >myimage.ppm

    $ pamdice myimage.ppm -width=1000 -height=1000 -outstem=myimage_part \e
        -indexfile=tiles.pam
    $ pamundice myimage_part_%1d_%1a.ppm -indexfile=tiles.pam >myimage.ppm
\fP
.fi


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

\fBpamdice\fP

\fB-outstem=\fP\fIfilenamestem\fP

[\fB-outsuffix=\fP\fIfilenamesuffix\fP]

[\fB-width=\fP\fIwidth\fP]

[\fB-height=\fP\fIheight\fP]

[\fB-hoverlap=\fP\fIhoverlap\fP]

[\fB-voverlap=\fP\fIvoverlap\fP]

[\fB-numberwidth=\fP\fIN\fP]

[\fB-listfile=\fP\fItextfilename\fP]

[\fB-indexfile=\fP\fIpamfilename\fP]

[\fB-dry-run\fP]

[\fB-verbose\fP]

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

.UN description
.SH "توضیحات (DESCRIPTION)"
.PP
این برنامه بخشی از
.BR "Netpbm" (1)\c
\& است.
.PP
دستور
\fBpamdice\fP
یک تصویر PAM، PBM، PGM یا PPM را به‌عنوان ورودی خوانده و آن را به‌صورت افقی و/یا عمودی به قطعاتی با اندازه یکسان برش می‌دهد و هر قطعه را در قالب همان نوع تصویر در فایل‌های جداگانه ذخیره می‌کند. همچنین می‌توانید قطعات را به‌صورت هم‌پوشان ایجاد کنید.
.PP
برای اطلاعات درباره نحوه نام‌گذاری فایل‌های خروجی، گزینه
\fB-outstem\fP
را ببینید.
.PP
گزینه‌های
\fB-width\fP
و
\fB-height\fP
اندازه قطعات خروجی را تعیین می‌کنند.
.PP
دستور
\fBpamundice\fP
می‌تواند این تصاویر قطعه‌قطعه‌شده را مجدداً به یکدیگر متصل کند. برای کنترل دقیق‌تر، می‌توانید از
\fBpamcat\fP
نیز استفاده کنید.
.PP
یکی از کاربردهای این دستور، تولید قطعاتی است که پردازش آن‌ها منابع سیستمی کمتری نسبت به کل تصویر نیاز دارد. برای نمونه، ممکن است تصویری چنان بزرگ داشته باشید که ویرایشگر تصویر نتواند کل آن را در حافظه بارگذاری کند یا پردازش آن بسیار کند انجام شود. با
\fBpamdice\fP
می‌توانید تصویر را به قطعات کوچک‌تر تقسیم کرده، هر قطعه را جداگانه ویرایش کنید و سپس آن‌ها را دوباره سرهم نمایید.
.PP
کاربرد دیگر، چاپ یک تصویر بزرگ در قالب قطعات کوچک با ابعاد استاندارد چاپگر است تا پس از چاپ بتوانید آن‌ها را به یکدیگر بچسبانید. دستور
\fBppmglobe\fP
کار مشابهی انجام می‌دهد و به شما امکان می‌دهد قطعات را به شکل یک کره به هم متصل کنید.
.PP
اگر می‌خواهید قطعات را به‌صورت تکی و خارج از یک شبکه ماتریسی منظم برش دهید، از
\fBpamcut\fP
استفاده کنید.


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


.TP
\fB-outstem=\fP\fIfilenamestem\fP
این گزینه نام فایل‌های خروجی را تعیین می‌کند. نام هر فایل خروجی به‌صورت
\fIfilenamestem\fP\fB_\fP\fIy\fP\fB_\fP\fIx\fP\fB.\fP\fItype\fP
خواهد بود که در آن
\fIfilenamestem\fP
مقدار داده‌شده به گزینه
\fB-outstem\fP
است،
\fIx\fP
و
\fIy\fP
به‌ترتیب موقعیت افقی و عمودی تصویر خروجی در تصویر ورودی هستند (مقدار صفر بیانگر بالاترین و چپ‌ترین موقعیت است)، و
\fItype\fP
بسته به نوع تصویر ورودی یکی از پسوندهای
\fB.pbm\fP\c
،
\fB.pgm\fP\c
،
\fB.ppm\fP
یا
\fB.pam\fP
خواهد بود.
.sp
مقادیر
\fIx\fP
و
\fIy\fP
با صفرهای پیش‌رو (Leading Zeroes) پر می‌شوند تا طول ارقام در تمام فایل‌ها یکسان باشد. با گزینه
\fB-numberwidth\fP
می‌توانید این طول را تعیین کنید؛ در غیر این صورت، به‌طور پیش‌فرض از کمترین تعداد رقم لازم برای پوشش تمام فایل‌ها استفاده می‌شود. برای نمونه، اگر ۲۵ قطعه افقی داشته باشید و
\fB-numberwidth\fP
مشخص نشده باشد،
\fIx\fP
در تمام فایل‌های خروجی ۲ رقمی خواهد بود؛ چپ‌ترین قطعه با '00' شماره‌گذاری می‌شود، قطعه بعدی با '01' و به همین ترتیب. با
\fB-numberwidth=3\fP\c
، مقدار
\fIx\fP
به‌صورت '000'، '001' و... خواهد بود.
.sp
با استفاده از گزینه
\fB-outsuffix\fP
می‌توانید پسوند نوع فایل را تغییر دهید.

.TP
\fB-outsuffix=\fP\fIfilenamesuffix\fP
پسوند نام فایل‌های خروجی را مشخص می‌کند. دستور
\fBpamdice\fP
نقطه قبل از پسوند را اضافه نمی‌کند.
.sp
مثال: \f(CW-outsuffix=.pnm\fP
.sp
حالت پیش‌فرض، پسوند مناسب با نوع تصویر است (مانند '.ppm').
.sp
این گزینه در Netpbm 11.11 (ژوئن ۲۰۲۵) اضافه شد.

.TP
\fB-numberwidth=\fP\fIN\fP
تعداد ارقام شماره‌ها را در نام فایل‌های خروجی تعیین می‌کند. برای جزئیات بیشتر به توضیحات گزینه
\fB-outstem\fP
مراجعه کنید.
.sp
تعیین طولی کمتر از حداقل تعداد ارقام لازم برای نمایش تمام قطعات مجاز نیست.
.sp
این گزینه در Netpbm 11.10 (مارس ۲۰۲۵) اضافه شد.

.TP
\fB-width=\fP\fIwidth\fP
عرض تصاویر خروجی را برحسب پیکسل تعیین می‌کند. اگر عرض تصویر ورودی مضرب دقیقی از
\fIwidth\fP
پیکسل نباشد، قطعات واقع در سمت راست‌ترین ستون کوچک‌تر خواهند بود.
.sp
در صورت عدم تعیین این گزینه، مقدار پیش‌فرض برابر با تمام عرض تصویر ورودی خواهد بود؛ یعنی
\fBpamdice\fP
برش عمودی انجام نمی‌دهد.

.TP
\fB-height=\fP\fIheight\fP
ارتفاع تصاویر خروجی را برحسب پیکسل تعیین می‌کند. اگر ارتفاع تصویر ورودی مضرب دقیقی از
\fIheight\fP
پیکسل نباشد، قطعات واقع در پایین‌ترین سطر کوچک‌تر خواهند بود.
.sp
در صورت عدم تعیین این گزینه، مقدار پیش‌فرض برابر با تمام ارتفاع تصویر ورودی خواهد بود؛ یعنی
\fBpamdice\fP
برش افقی انجام نمی‌دهد.



.TP
\fB-hoverlap=\fP\fIhoverlap\fP
میزان هم‌پوشانی افقی بین تصاویر خروجی را برحسب پیکسل تعیین می‌کند. هر تصویر در یک سطر به اندازه
\fIhoverlap\fP
پیکسل با تصویر قبلی خود هم‌پوشانی خواهد داشت. به‌طور پیش‌فرض هیچ هم‌پوشانی وجود ندارد.
.sp
این گزینه در Netpbm 10.23 (ژوئیه ۲۰۰۴) اضافه شد.

.TP
\fB-voverlap=\fP\fIvoverlap\fP
میزان هم‌پوشانی عمودی بین تصاویر خروجی را برحسب پیکسل تعیین می‌کند. هر سطر از تصاویر به اندازه
\fIvoverlap\fP
پیکسل با سطر قبلی هم‌پوشانی خواهد داشت. به‌طور پیش‌فرض هیچ هم‌پوشانی وجود ندارد.
.sp
این گزینه در Netpbm 10.23 (ژوئیه ۲۰۰۴) اضافه شد.


.TP
\fB-listfile=\fP\fItextfilename\fP
باعث می‌شود برنامه فایلی متنی شامل فهرست اسامی تمامی فایل‌های قطعات تولیدشده ایجاد کند. ترتیب اسامی به‌صورت سطری (Row-major order) است. برای نمونه،

\f(CW
  $ pamdice -width=100 -height=100 -outstem=myimage_part -listfile=mylist.txt \e
      -numberwidth=3 myimage.ppm
\fP

روی یک تصویر ۲۰۰×۲۰۰ فایلی به نام \fBmylist.txt\fP با محتوای زیر ایجاد می‌کند:

.nf
  \f(CW
    myimage_part_000_000.ppm
    myimage_part_000_001.ppm
    myimage_part_001_000.ppm
    myimage_part_001_001.ppm
    \fP
.fi
.sp
می‌توانید این فایل فهرست را همراه با گزینه
\fBpamundice -listfile\fP
به‌جای الگوی نام فایل ورودی استفاده کنید که نیاز به هماهنگ‌سازی الگوها در فراخوانی‌های
\fBpamdice\fP
و
\fBpamundice\fP
را برطرف می‌سازد.
.sp
این گزینه در Netpbm 11.10 (مارس ۲۰۲۵) اضافه شد.

.TP
\fB-indexfile=\fP\fIpamfilename\fP
باعث می‌شود برنامه فایلی حاوی یک تصویر PAM تولید کند که موقعیت و شماره ردیف و ستون قطعات را در بر دارد. این فایل تصویری است که عرض و ارتفاع آن به‌ترتیب برابر با تعداد برش‌های افقی و عمودی است و هر چندتایی (Tuple) در آن نشان‌دهنده شماره سطر و ستون همان موقعیت است. برای نمونه، اگر
\fBpamdice\fP
تعداد ۳ برش در عرض و ۲ برش در ارتفاع تولید کند، تصویر بدین شکل خواهد بود:

.nf
        (0,0) (0,1) (0,2)
        (1,0) (1,1) (1,2)
.fi
.sp
عمق (Depth) این تصویر ۲، نوع چندتایی آن 'grid_coord' (نوعی که اختصاصاً برای استفاده در
\fBpamdice\fP
و
\fBpamundice\fP
تعریف شده) و بیشینه مقدار (maxval) آن ۲۵۵ است، مگر اینکه ارتفاع یا عرض بیش از ۲۵۶ باشد که در این حالت ۶۵۵۳۵ خواهد بود.
.sp
این تصویر می‌تواند به‌عنوان ورودی برای
\fBpamundice\fP
به‌ویژه پس از اعمال تغییرات روی آن بسیار مفید باشد. نمونه بارز این کاربرد، چرخاندن یا معکوس کردن (Flip) یک تصویر بزرگ است: می‌توانید تصویر را با
\fBpamdice\fP
قطعه‌قطعه کنید، سپس هر یک از قطعات تولیدشده را با
\fBpamflip\fP
معکوس نمایید، تصویر نمایه (Index Image) را نیز با
\fBpamflip\fP
معکوس کنید، و سپس با
\fBpamundice\fP
همراه با قطعات و تصویر نمایه معکوس‌شده، نسخه معکوس‌شده تصویر بزرگ اصلی را بسازید.
.sp
این گزینه در Netpbm 11.10 (مارس ۲۰۲۵) اضافه شد.

.TP
\fB-dry-run\fP
دستور
\fBpamdice\fP
را از ساخت واقعی فایل‌های تصویری قطعات معاف می‌کند. در این حالت همچنان فایل فهرست (با
\fB-listfile\fP\c
) و فایل نمایه (با
\fB-indexfile\fP\c
) تولید شده و اکثر خطاها بررسی می‌شوند.
.sp
این گزینه در Netpbm 11.10 (مارس ۲۰۲۵) اضافه شد.

.TP
\fB-verbose\fP
اطلاعات پردازش را در خروجی خطای استاندارد (Standard Error) چاپ می‌کند.



.UN history
.SH "تاریخچه (HISTORY)"
.PP
دستور
\fBpamdice\fP
در Netpbm 9.25 (مارس ۲۰۰۲) معرفی شد.
.PP
پیش از Netpbm 10.29 (اوت ۲۰۰۵)، محدودیت ۱۰۰ قطعه در هر جهت وجود داشت و نام فایل‌های خروجی همیشه از ۲ رقم برای شماره قطعه استفاده می‌کرد.

.UN seealso
.SH "همچنین ببینید (SEE ALSO)"
.BR "pamundice" (1)\c
\&,
.BR "pamcut" (1)\c
\&,
.BR "pamcat" (1)\c
\&,
.BR "pgmslice" (1)\c
\&,
.BR "ppmglobe" (1)\c
\&,
.BR "pamflip" (1)\c
\&,
.BR "pnm" (1)\c
\&,
.BR "pam" (1)\c
\&
.SH "منبع مستندات (DOCUMENT SOURCE)"
این صفحه راهنما توسط ابزار Netpbm به نام 'makeman' از منبع HTML تولید شده است. مستندات مرجع در آدرس زیر قرار دارند:
.IP
.B http://netpbm.sourceforge.net/doc/pamdice.html
.PP