\
.\" 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 "Pnmpaste User Manual" 0 "16 December 2018" "netpbm documentation"

.SH "نام (NAME)"

pnmpaste \- چسباندن یک مستطیل به درون یک تصویر PNM

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

\fBpnmpaste\fP

[\fB-replace\fP | \fB-or\fP | \fB-and\fP | \fB-xor\fP |
\fB-nor\fP | \fB-nand\fP | \fB-nxor\fP]

\fIfrompnmfile\fP \fIx\fP \fIy\fP
[\fIintopnmfile\fP]
.PP
می‌توانید تمام گزینه‌ها را به کوتاه‌ترین پیشوند یکتای آن‌ها خلاصه کنید.

.UN description
.SH "توضیحات (DESCRIPTION)"
.PP
این برنامه بخشی از
.BR "Netpbm" (1)\c
\& است.
.PP
دستور \fBpnmpaste\fP دو تصویر PNM را به عنوان ورودی می‌خواند و تصویر اول (تصویر «چسبانده‌شده» یا "pasted image") را در مکان مشخص‌شده درون تصویر دوم (تصویر «پایه» یا "base image") درج می‌کند، و یک تصویر PNM با همان اندازه و نوع تصویر پایه به عنوان خروجی تولید می‌کند.
.PP
هر یک از آرگومان‌های نام فایل (ولی نه هر دو) می‌تواند برای اشاره به ورودی استاندارد (Standard Input) مقدار '-' باشد. اگر آرگومان فایل دوم را اصلاً مشخص نکنید، همانند '-' در نظر گرفته می‌شود.
.PP
مقادیر \fIx\fP و \fIy\fP مکانی را در تصویر پایه مشخص می‌کنند که گوشه بالایی و چپ تصویر چسبانده‌شده در آن قرار می‌گیرد؛ \fIx\fP موقعیت افقی و \fIy\fP موقعیت عمودی را تعیین می‌کند. یک مقدار نامنفی بیانگر تعداد پیکسل‌ها به سمت راست لبه یا پایین‌تر از لبه بالایی تصویر پایه است، در حالی که یک مقدار منفی بیانگر تعداد پیکسل‌ها به سمت راست لبه یا پایین‌تر از لبه پایینی است (بنابراین x = -5 به معنای ۵ پیکسل به سمت چپ لبه راست است).
.PP
اگر هر بخشی از تصویر چسبانده‌شده درون تصویر پایه جا نگیرد، \fBpnmpaste\fP با خطا شکست می‌خورد.
.PP
این ابزار بیشترین کاربرد را در ترکیب با \fIpamcut\fP دارد. برای نمونه، اگر می‌خواهید بخش کوچکی از یک تصویر بزرگ را ویرایش کنید و ویرایشگر تصویر شما قادر به ویرایش آن تصویر بزرگ نیست، می‌توانید بخش مورد نظر خود را برش دهید، آن را ویرایش کنید و سپس دوباره آن را در جای خود بچسبانید.
.PP
ابزار کمکی و مفید دیگر \fBpbmmask\fP است.
.PP
ابزار \fBpamcomp\fP برنامه‌ای عمومی‌تر است، با این تفاوت که فاقد عملکردهای "or" ،"and" و "xor" می‌باشد. \fBpamcomp\fP به شما اجازه می‌دهد تا یک ماسک شفافیت (transparency mask) تعیین کنید تا فقط بخشی از تصویر درج‌شده وارد شود؛ بنابراین نیازی نیست پیکسل‌های درج‌شده حتماً یک مستطیل باشند. همچنین می‌توانید کاری کنید که تصویر درج‌شده نیمه‌شفاف باشد، تا تصویر حاصل ترکیبی از تصویر درج‌شده و تصویر پایه گردد.

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


.TP
\fB-replace\fP, \fB-or\fP, \fB-and\fP, \fB-xor\fP,
\fB-nor\fP, \fB-nand\fP, \fB-nxor\fP
.sp
این گزینه‌ها عملیاتی را که هنگام چسباندن باید انجام شود تعیین می‌کنند.
حالت پیش‌فرض \fB-replace\fP است، که به معنای انجام چسباندن بدیهی است:
جایگزین کردن پیکسل‌های تصویر مقصد ("into") با پیکسل‌های تصویر مبدا ("from").
.sp
گزینه‌های \fB-and\fP، \fB-nand\fP، \fB-or\fP، \fB-nor\fP، \fB-xor\fP
و \fBnxor\fP تنها در صورتی مجاز هستند که هر دو تصویر ورودی از نوع PBM باشند. آن‌ها
مشخص می‌کنند که تصاویر مبدا ("from") و مقصد ("into") با انجام عملیات‌های بولی ترکیب شوند:
هر پیکسل از تصویر خروجی حاصل عملیات بولی روی
پیکسل‌های متناظر در دو تصویر ورودی است، که در آن سفید برابر با TRUE و سیاه
برابر با FALSE است.
.sp
توجه داشته باشید که این با نتیجه حاصل از محاسبات بیتی روی بیت‌های موجود در تصاویر PBM متفاوت است، زیرا در PBM، رنگ سفید
توسط بیت 0 نمایش داده می‌شود، و 0 در محاسبات بیتی با FALSE
در جبر بولی مطابقت دارد.
.sp
گزینه‌های \fB-nand\fP، \fB-nor\fP و \fB-nxor\fP از نسخه 10.85 برنامه Netpbm
(دسامبر ۲۰۱۸) اضافه شده‌اند.


  
.UN seealso
.SH "همچنین ببینید (SEE ALSO)"
.BR "pamcomp" (1)\c
\&,
.BR "pamcut" (1)\c
\&,
.BR "pnminvert" (1)\c
\&,
.BR "pnmarith" (1)\c
\&,
.BR "pbmmask" (1)\c
\&,
.BR "pnm" (1)\c
\&

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

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