نام (NAME)

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

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

pnmpaste

[-replace | -or | -and | -xor | -nor | -nand | -nxor]

frompnmfile x y [intopnmfile]

می‌توانید تمام گزینه‌ها را به کوتاه‌ترین پیشوند یکتای آن‌ها خلاصه کنید.

توضیحات (DESCRIPTION)

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

دستور pnmpaste دو تصویر PNM را به عنوان ورودی می‌خواند و تصویر اول (تصویر «چسبانده‌شده» یا "pasted image") را در مکان مشخص‌شده درون تصویر دوم (تصویر «پایه» یا "base image") درج می‌کند، و یک تصویر PNM با همان اندازه و نوع تصویر پایه به عنوان خروجی تولید می‌کند.

هر یک از آرگومان‌های نام فایل (ولی نه هر دو) می‌تواند برای اشاره به ورودی استاندارد (Standard Input) مقدار '-' باشد. اگر آرگومان فایل دوم را اصلاً مشخص نکنید، همانند '-' در نظر گرفته می‌شود.

مقادیر x و y مکانی را در تصویر پایه مشخص می‌کنند که گوشه بالایی و چپ تصویر چسبانده‌شده در آن قرار می‌گیرد؛ x موقعیت افقی و y موقعیت عمودی را تعیین می‌کند. یک مقدار نامنفی بیانگر تعداد پیکسل‌ها به سمت راست لبه یا پایین‌تر از لبه بالایی تصویر پایه است، در حالی که یک مقدار منفی بیانگر تعداد پیکسل‌ها به سمت راست لبه یا پایین‌تر از لبه پایینی است (بنابراین x = -5 به معنای ۵ پیکسل به سمت چپ لبه راست است).

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

این ابزار بیشترین کاربرد را در ترکیب با pamcut دارد. برای نمونه، اگر می‌خواهید بخش کوچکی از یک تصویر بزرگ را ویرایش کنید و ویرایشگر تصویر شما قادر به ویرایش آن تصویر بزرگ نیست، می‌توانید بخش مورد نظر خود را برش دهید، آن را ویرایش کنید و سپس دوباره آن را در جای خود بچسبانید.

ابزار کمکی و مفید دیگر pbmmask است.

ابزار pamcomp برنامه‌ای عمومی‌تر است، با این تفاوت که فاقد عملکردهای "or" ،"and" و "xor" می‌باشد. pamcomp به شما اجازه می‌دهد تا یک ماسک شفافیت (transparency mask) تعیین کنید تا فقط بخشی از تصویر درج‌شده وارد شود؛ بنابراین نیازی نیست پیکسل‌های درج‌شده حتماً یک مستطیل باشند. همچنین می‌توانید کاری کنید که تصویر درج‌شده نیمه‌شفاف باشد، تا تصویر حاصل ترکیبی از تصویر درج‌شده و تصویر پایه گردد.

گزینه‌ها (OPTIONS)

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

-replace, -or, -and, -xor,

-nor, -nand, -nxor

این گزینه‌ها عملیاتی را که هنگام چسباندن باید انجام شود تعیین می‌کنند. حالت پیش‌فرض -replace است، که به معنای انجام چسباندن بدیهی است: جایگزین کردن پیکسل‌های تصویر مقصد ("into") با پیکسل‌های تصویر مبدا ("from").

گزینه‌های -and، -nand، -or، -nor، -xor و nxor تنها در صورتی مجاز هستند که هر دو تصویر ورودی از نوع PBM باشند. آن‌ها مشخص می‌کنند که تصاویر مبدا ("from") و مقصد ("into") با انجام عملیات‌های بولی ترکیب شوند: هر پیکسل از تصویر خروجی حاصل عملیات بولی روی پیکسل‌های متناظر در دو تصویر ورودی است، که در آن سفید برابر با TRUE و سیاه برابر با FALSE است.

توجه داشته باشید که این با نتیجه حاصل از محاسبات بیتی روی بیت‌های موجود در تصاویر PBM متفاوت است، زیرا در PBM، رنگ سفید توسط بیت 0 نمایش داده می‌شود، و 0 در محاسبات بیتی با FALSE در جبر بولی مطابقت دارد.

گزینه‌های -nand، -nor و -nxor از نسخه 10.85 برنامه Netpbm (دسامبر ۲۰۱۸) اضافه شده‌اند.

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

pamcomp(1), pamcut(1), pnminvert(1), pnmarith(1), pbmmask(1), pnm(1)

نویسندگان (AUTHORS)

حق نشر © ۱۹۸۹، ۱۹۹۱ متعلق به Jef Poskanzer است.

منبع سند (DOCUMENT SOURCE)

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

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