نام (NAME)

gm - ابزار خط فرمان برای ایجاد، ویرایش، مقایسه، تبدیل یا نمایش تصاویر

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

gm animate [ options ... ] file [ [ options ... ] file ... ]

gm batch [ options ... ] [ script ]

gm benchmark [ options ... ] subcommand

gm compare [ options ... ] reference-image [ options ... ] compare-image [ options ... ]

gm composite [ options ... ] change-image base-image [ mask-image ] output-image

gm conjure [ options ] script.msl [ [ options ] script.msl ]

gm convert [ [ options ... ] [ input-file ... ] [ options ... ] ] output-file

gm display [ options ... ] file ... [ [options ... ]file ... ]

gm identify file [ file ... ]

gm import [ options ... ] file

gm mogrify [ options ... ] file ...

gm montage [ options ... ] file [ [ options ... ] file ... ] output-file

gm time subcommand

gm version

توضیحات (DESCRIPTION)

برنامهٔ gm متعلق به GraphicsMagick مجموعه‌ای از ابزارها را برای ایجاد، مقایسه، تبدیل، ویرایش و نمایش تصاویر فراهم می‌کند. تمامی این ابزارها به صورت زیرفرمان‌هایی از یک فایل اجرایی واحد به نام gm ارائه می‌شوند. فایل اجرایی gm وضعیت خروج 0 را به نشانهٔ موفقیت و 1 را به نشانهٔ شکست برمی‌گرداند:

animate یک پویانمایی (مانند یک فایل GIF) را بر روی هر نمایشگر ایستگاه کاری که یک کارساز X را اجرا می‌کند، نمایش می‌دهد.

batch تعداد دلخواهی از دستورهای این ابزار (مانند convert) را در قالب یک اسکریپت دسته‌ای (batch) خطی ساده اجرا می‌کند تا بازدهی اجرا را بهبود بخشد و/یا امکان استفاده به عنوان یک فرآیند همکار (co-process) زیرمجموعه تحت کنترل یک اسکریپت یا برنامهٔ دلخواه را فراهم سازد.

benchmark یکی از دستورهای دیگر ابزار (مانند convert) را برای تعداد تکرار مشخص یا مدت زمان اجرای تعیین‌شده اجرا کرده و زمان اجرا و سایر اطلاعات تحلیل کارایی (profiling) مانند میزان استفاده از CPU را گزارش می‌دهد. Benchmark حالت‌های عملیاتی مختلفی از جمله اجرای دستور با تعداد متغیر ریسه‌ها (threads) و قالب‌های گزارش‌دهی جایگزین مانند مقادیر جداشده با کاما (CSV) را ارائه می‌دهد.

compare دو تصویر را مقایسه کرده و آمار تفاوت‌ها را بر اساس معیارهای مشخص‌شده گزارش می‌دهد و/یا تصویری شامل نمای بصری تفاوت‌ها تولید می‌کند. همچنین می‌تواند برای آزمایش اینکه آیا تصاویر در یک محدودهٔ خاص و بر اساس معیاری مشخص مشابه یکدیگر هستند استفاده شود و یک مقدار درستی (truth value) را به محیط اجرا بازگرداند.

composite تصاویر را ترکیب می‌کند (ترکیب یا ادغام تصاویر با یکدیگر) تا تصاویر جدیدی ایجاد شوند.

conjure اسکریپت‌های نوشته‌شده به زبان اسکریپت‌نویسی مجیک (MSL) را تفسیر و اجرا می‌کند.

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

display امکانی برای پردازش و نمایش تصویر، مستقل از معماری ماشین است. این دستور می‌تواند تصویری را روی هر نمایشگر ایستگاه کاری که یک کارساز X را اجرا می‌کند، نمایش دهد.

identify قالب و ویژگی‌های یک یا چند فایل تصویری را توصیف می‌کند. همچنین در صورتی که تصویری ناقص یا خراب باشد، گزارش می‌دهد.

import تصویری را از هر پنجرهٔ نمایان روی یک کارساز X می‌خواند و آن را به عنوان یک فایل تصویری ذخیره می‌کند. شما می‌توانید یک پنجرهٔ منفرد، کل صفحه یا هر بخش مستطیلی از صفحه را ضبط کنید.

mogrify یک تصویر یا توالی‌ای از تصاویر را دگرگون می‌کند. این دگرگونی‌ها شامل مقیاس‌بندی تصویر، چرخش تصویر، کاهش رنگ و موارد دیگر می‌شود. تصویر دگرگون‌شده بر روی تصویر اصلی بازنویسی می‌شود (overwrites).

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

time یک زیرفرمان را اجرا کرده و زمان مصرف‌شدهٔ کاربر، سیستم و کل زمان اجرا را گزارش می‌دهد.

version نسخهٔ انتشار GraphicsMagick، حداکثر عمق نمونه (sample-depth)، اعلان حق نشر، ویژگی‌های پشتیبانی‌شده و گزینه‌های استفاده‌شده هنگام ساخت نرم‌افزار را گزارش می‌دهد.

ابزارهای GraphicsMagick قالب‌های تصویری زیر را شناسایی می‌کنند:

نام حالت توضیحات
o 3FR r-- تصویر خام Hasselblad Photo RAW
o 8BIM rw- قالب منبع Photoshop
o 8BIMTEXT rw- قالب متنی منبع Photoshop
o 8BIMWTEXT rw- قالب متنی عریض منبع Photoshop
o APP1 rw- اطلاعات خام برنامه
o APP1JPEG rw- داده‌های باینری خام JPEG
o ART r-- قالب PF1: 1st Publisher
o ARW r-- تصویر خام Sony Alpha DSLR RAW
o AVS rw+ تصویر AVS X
o BIE rw- قالب تبادل Joint Bi-level Image experts Group
o BMP rw+ تصویر بیت‌مپ Microsoft Windows
o BMP2 -w- تصویر بیت‌مپ Microsoft Windows نسخهٔ ۲
o BMP3 -w- تصویر بیت‌مپ Microsoft Windows نسخهٔ ۳
o CACHE --- قالب تصویر حافظهٔ موقت پایدار Magick
o CALS rw- تصویر Continuous Acquisition and Life-cycle
Support نوع ۱
o CAPTION r-- عنوان (نیازمند اطلاعات اندازه به صورت جداگانه)
o CIN rw- قالب Kodak Cineon
o CMYK rw- نمونه‌های خام فیروزه‌ای، ارغوانی، زرد و سیاه
(۸ یا ۱۶ بیت، بسته به عمق تصویر)
o CMYKA rw- نمونه‌های خام فیروزه‌ای، ارغوانی، زرد، سیاه و
مات (۸ یا ۱۶ بیت، بسته به عمق تصویر)
o CR2 r-- تصویر خام Canon Photo RAW
o CRW r-- تصویر خام Canon Photo RAW
o CUR r-- آیکون نشانگر Microsoft
o CUT r-- قالب DR Halo
o DCM r-- تصویر Digital Imaging and Communications in
Medicine
o DCR r-- تصویر خام Kodak Photo RAW
o DCX rw+ تصویر چندصفحه‌ای ZSoft IBM PC Paintbrush
o DNG r-- نگاتیو دیجیتال Adobe Digital Negative
o DPX rw- Digital Moving Picture Exchange
o EPDF rw- Encapsulated Portable Document Format
o EPI rw- قالب تبادل Adobe Encapsulated PostScript
o EPS rw- Adobe Encapsulated PostScript
o EPS2 -w- Adobe Level II Encapsulated PostScript
o EPS3 -w- Adobe Level III Encapsulated PostScript
o EPSF rw- Adobe Encapsulated PostScript
o EPSI rw- قالب تبادل Adobe Encapsulated PostScript
o EPT rw- Adobe Encapsulated PostScript با پیش‌نمایش
TIFF مربوط به MS-DOS
o EPT2 rw- Adobe Level II Encapsulated PostScript با
پیش‌نمایش TIFF مربوط به MS-DOS
o EPT3 rw- Adobe Level III Encapsulated PostScript با
پیش‌نمایش TIFF مربوط به MS-DOS
o EXIF rw- داده‌های باینری دوربین دیجیتال Exif
o FAX rw+ نمابر Group 3 (نه نمابر TIFF Group3!)
o FITS rw- Flexible Image Transport System
o FRACTAL r-- تصویر فرکتال پلاسما
o FPX rw- قالب FlashPix
o GIF rw+ قالب تبادل گرافیکی CompuServe
o GIF87 rw- قالب تبادل گرافیکی CompuServe
(نسخهٔ 87a)
o GRADIENT r-- گذار تدریجی از یک سایه به سایهٔ دیگر
o GRAY rw+ نمونه‌های خاکستری خام (۸/۱۶/۳۲ بیت،
بسته به عمق تصویر)
o HISTOGRAM -w- هیستوگرام تصویر
o HRZ r-- تلویزیون اسکن آهسته (Slow scan TV) HRZ
o HTML -w- زبان نشانه‌گذاری فرامتن و نقشهٔ تصویری
سمت کاربر
o ICB rw+ تصویر Truevision Targa
o ICC rw- نمایهٔ رنگ ICC
o ICM rw- نمایهٔ رنگ ICC
o ICO r-- آیکون Microsoft
o ICON r-- آیکون Microsoft
o IDENTITY r-- تصویر همانی Hald CLUT
o IMAGE r-- تصویر تعبیه‌شدهٔ GraphicsMagick
o INFO -w+ اطلاعات توصیفی و آمار تصویر
o IPTC rw- قالب IPTC Newsphoto
o IPTCTEXT rw- قالب متنی IPTC Newsphoto
o IPTCWTEXT rw- قالب متنی عریض IPTC Newsphoto
o JBG rw+ قالب تبادل Joint Bi-level Image experts Group
o JBIG rw+ قالب تبادل Joint Bi-level Image experts Group
o JNG rw- JPEG Network Graphics
o JP2 rw- نحو ساختار فایل JPEG-2000 JP2
o JPC rw- نحو جریان کد JPEG-2000
o JPEG rw- قالب JFIF متعلق به Joint Photographic Experts Group
o JPG rw- قالب JFIF متعلق به Joint Photographic Experts Group
o K25 r-- تصویر خام Kodak Photo RAW
o KDC r-- تصویر خام Kodak Photo RAW
o LABEL r-- قالب تصویر متنی
o M2V rw+ جریان ویدیویی MPEG-2
o MAP rw- شدت‌ها و شاخص‌های جدول رنگ (Colormap)
o MAT r-- قالب تصویر MATLAB
o MATTE -w+ قالب MATTE
o MIFF rw+ Magick Image File Format
o MNG rw+ Multiple-image Network Graphics
o MONO rw- بیت‌مپ دو سطحی با ترتیب بایت کم‌ارزش‌تر در ابتدا
o MPC rw+ قالب تصویر حافظهٔ موقت پایدار Magick
o MPEG rw+ جریان ویدیویی MPEG-1
o MPG rw+ جریان ویدیویی MPEG-1
o MRW r-- تصویر خام Minolta Photo Raw
o MSL r-- زبان اسکریپت‌نویسی مجیک (Magick Scripting Language)
o MTV rw+ قالب تصویر ردگیری پرتو MTV
o MVG rw- Magick Vector Graphics
o NEF r-- Nikon Electronic Format
o NULL r-- تصویر ثابت با رنگ یکدست
o OTB rw- بیت‌مپ On-the-air
o P7 rw+ قالب بندانگشتی Xv
o PAL rw- قالب ۱۶ بیت بر پیکسل درهم‌تنیدهٔ YUV
o PALM rw- Palm Pixmap
o PBM rw+ قالب Portable bitmap (سیاه و سفید)
o PCD rw- Photo CD
o PCDS rw- Photo CD
o PCL -w- Page Control Language
o PCT rw- Apple Macintosh QuickDraw/PICT
o PCX rw- ZSoft IBM PC Paintbrush
o PDB rw+ قالب Palm Database ImageViewer
o PDF rw+ Portable Document Format
o PEF r-- Pentax Electronic File
o PFA r-- قلم TrueType
o PFB r-- قلم TrueType
o PGM rw+ قالب Portable graymap (طیف خاکستری)
o PGX r-- قالب JPEG-2000 VM
o PICON rw- Personal Icon
o PICT rw- Apple Macintosh QuickDraw/PICT
o PIX r-- قالب تصویر Alias/Wavefront RLE
o PLASMA r-- تصویر فرکتال پلاسما
o PNG rw- Portable Network Graphics
o PNG24 rw- تصویر Portable Network Graphics، ۲۴ بیتی RGB
فقط کدر (غیرشفاف)
o PNG32 rw- تصویر Portable Network Graphics، ۳۲ بیتی RGBA
با پشتیبانی از نیمه‌شفافیت
o PNG8 rw- تصویر Portable Network Graphics، ۸ بیتی
شاخص‌دار، فقط با شفافیت باینری
o PNM rw+ Portable anymap
o PPM rw+ قالب Portable pixmap (رنگی)
o PREVIEW -w- نمایش پیش‌نمایش بهینه‌سازی، جلوه یا افکت تصویری
o PS rw+ Adobe PostScript
o PS2 -w+ Adobe Level II PostScript
o PS3 -w+ Adobe Level III PostScript
o PSD rw- بیت‌مپ Adobe Photoshop
o PTIF rw- تصویر TIFF کدگذاری‌شدهٔ هرمی (Pyramid)
o PWP r-- Seattle Film Works
o RAF r-- تصویر خام Fuji Photo RAW
o RAS rw+ SUN Rasterfile
o RGB rw+ نمونه‌های خام قرمز، سبز و آبی
o RGBA rw+ نمونه‌های خام قرمز، سبز، آبی و مات
o RLA r-- تصویر Alias/Wavefront
o RLE r-- تصویر کدگذاری‌شده با طول اجرا (RLE) متعلق به Utah
o SCT r-- Scitex HandShake
o SFW r-- Seattle Film Works
o SGI rw+ تصویر Irix RGB
o SHTML -w- زبان نشانه‌گذاری فرامتن و نقشهٔ تصویری
سمت کاربر
o STEGANO r-- تصویر پنهان‌نگاری‌شده (Steganographic)
o SUN rw+ SUN Rasterfile
o SVG rw+ Scalable Vector Graphics
o TEXT rw+ متن خام
o TGA rw+ تصویر Truevision Targa
o TIFF rw+ Tagged Image File Format
o TILE r-- کاشی‌کاری تصویر با یک بافت
o TIM r-- PSX TIM
o TOPOL r-- تصویر TOPOL X
o TTF r-- قلم TrueType
o TXT rw+ متن خام
o UIL -w- جدول X-Motif UIL
o UYVY rw- قالب ۱۶ بیت بر پیکسل درهم‌تنیدهٔ YUV
o VDA rw+ تصویر Truevision Targa
o VICAR rw- قالب فایل رستری VICAR
o VID rw+ دایرکتوری تصویر بصری (Visual Image Directory)
o VIFF rw+ تصویر مصورسازی Khoros
o VST rw+ تصویر Truevision Targa
o WBMP rw- تصویر Wireless Bitmap (سطح ۰)
o WMF r-- Windows Metafile
o WPG r-- Word Perfect Graphics
o X rw- تصویر سامانهٔ X
o X3F r-- تصویر خام Foveon X3 (Sigma/Polaroid)
o XBM rw- بیت‌مپ سامانه پنجرهٔ X (سیاه
و سفید)
o XC r-- تصویر ثابت با رنگ یکدست
o XCF r-- تصویر GIMP
o XMP rw- فراداده‌های Adobe XML
o XPM rw- پیکس‌مپ سامانه پنجرهٔ X (رنگی)
o XV rw+ تصویر مصورسازی Khoros
o XWD rw- رونوشت پنجره در سامانه پنجرهٔ X (رنگی)
o YUV rw- قالب CCIR 601 با نسبت 4:1:1 یا 4:2:2 (فقط ۸ بیتی)

حالت‌ها:
r خواندن (Read)
w نوشتن (Write)
+ چند تصویری (Multi-image)

پشتیبانی از برخی از این قالب‌ها نیازمند برنامه‌ها یا کتابخانه‌های جانبی است. برای آگاهی از نحوهٔ یافتن نرم‌افزارهای اختیاری اضافی، پروندهٔ README موجود در بستهٔ کد منبع را ببینید.

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

ممکن است نصب فعلی شما از تمام قالب‌های موجود در این فهرست پشتیبانی نکند. برای دریافت فهرستی دقیق از قالب‌های پشتیبانی‌شده توسط پیکربندی خاص خود، فرمان “gm convert -list format” را اجرا کنید.

انتظار می‌رود تصاویر خام دارای یک بایت به ازای هر پیکسل باشند، مگر آنکه gm در حالت کوانتومی ۱۶ بیتی یا ۳۲ بیتی کامپایل شده باشد. در این حالت‌ها، داده‌های خام به ترتیب با دو یا چهار بایت به ازای هر پیکسل، با اولویت بایت باارزش‌تر (most-significant-byte-first) ذخیره می‌شوند. برای نمونه، می‌توانید با وارد کردن فرمان “gm version” بدون هیچ گزینه‌ای و بررسی وجود عبارت “Q:16” در سطر نخست خروجی، متوجه شوید که آیا gm در حالت ۱۶ بیتی کامپایل شده است یا خیر..SH "فایل‌ها و قالب‌ها (FILES AND FORMATS)"

به‌طور پیش‌فرض، قالب تصویر با شماره جادویی (magic number) آن، یعنی چند بایت اول فایل، تعیین می‌شود. برای مشخص کردن یک قالب تصویر خاص، نام قالب تصویر را همراه با دونقطه پیش از نام فایل بیاورید (i.e.ps:image) یا نوع تصویر را به‌عنوان پسوند نام فایل مشخص کنید (i.e.image.ps). در فایل‌های ورودی، شماره جادویی نسبت به پسوند نام فایل اولویت دارد و پیشوند نسبت به شماره جادویی و پسوند اولویت دارد. هنگامی که فایلی خوانده می‌شود، شماره جادویی آن در رشته "image->magick" ذخیره می‌گردد. در فایل‌های خروجی، پیشوند نسبت به پسوند نام فایل اولویت دارد، و پسوند نام فایل نسبت به رشته "image->magick" اولویت دارد.

برای خواندن قالب‌های «توکار» (GRANITE، H، LOGO، NETSCAPE، PLASMA و ROSE) از یک پیشوند (شامل دونقطه) بدون نام فایل یا پسوند استفاده کنید. برای خواندن قالب XC، پس از دونقطه یک مشخصه رنگ بیاورید. برای خواندن قالب CAPTION، پس از دونقطه یک رشته متنی یا نام فایلی که نماد ات‌ساین (@) در ابتدای آن قرار دارد را وارد کنید.

هنگامی که X را به‌عنوان نوع تصویر مشخص می‌کنید، نام فایل معنای خاصی دارد. این نام یک پنجره X را با id، name یا root مشخص می‌کند. اگر هیچ نام فایلی مشخص نشود، پنجره با کلیک کردن ماوس روی پنجره مورد نظر انتخاب می‌شود.

مقدار input_file را برای ورودی استاندارد برابر - و output_file را برای خروجی استاندارد برابر - قرار دهید. اگر input_file دارای پسوند .Z یا .gz باشد، فایل به‌ترتیب با uncompress یا gunzip از حالت فشرده خارج می‌شود. اگر output_file دارای پسوند .Z یا .gz باشد، فایل به‌ترتیب با استفاده از compress یا gzip فشرده‌سازی می‌شود.

برای تعیین زیر‌تصویر دلخواه در یک قالب تصویر چندوضوحی مانند Photo CD از یک نمایه اختیاری درون کروشه بعد از نام فایل ورودی استفاده کنید (مانند "img0001.pcd[4]") یا برای تصاویر MPEG از یک محدوده استفاده کنید (مانند "video.mpg[50-75]"). مشخصه زیر‌تصویر می‌تواند ناپیوسته باشد (مانند "image.tiff[2,7,4]"). برای تصاویر خام (raw)، یک زیر‌تصویر را با یک هندسه مشخص کنید (مانند -size 640x512 "image.rgb[320x256+50+50]"). نام تصویر را در علامت نقل‌قول قرار دهید تا پوسته شما کروشه‌ها را تفسیر نکند. تصاویر تکی با همان نام فایلی که مشخص کرده‌اید نوشته می‌شوند. با این حال، تصاویر چندبخشی (مانند یک سند چندصفحه‌ای PostScript با مشخص بودن گزینه +adjoin) ممکن است همراه با شماره صحنه به‌عنوان بخشی از نام فایل نوشته شوند. برای گنجاندن شماره صحنه در نام فایل، لازم است یک مشخصه قالب‌بندی به سبک printf مانند %d در نام فایل گنجانده شود و از گزینه +adjoin استفاده گردد. برای مثال،

image%02d.miff

فایل‌های image00.miff، image01.miff و غیره را می‌نویسد. تنها یک مشخصه منفرد در نام فایل خروجی مجاز است. اگر بیش از یک مشخصه وجود داشته باشد، نادیده گرفته خواهد شد. بهتر است شماره صحنه را در بخش اصلی نام فایل قرار دهید، نه در پسوند، زیرا در این صورت پسوند به‌عنوان یک نوع تصویر شناخته‌شده تشخیص داده نخواهد شد.

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

گزینه‌ها (OPTIONS)

گزینه‌ها به ترتیب خط فرمان پردازش می‌شوند. هر گزینه‌ای که در خط فرمان مشخص می‌کنید، برای مجموعه تصاویر پس از آن معتبر باقی می‌ماند، تا زمانی که آن مجموعه با ظاهر شدن هر گزینه دیگری یا -noop خاتمه یابد. برخی گزینه‌ها فقط بر رمزگشایی تصاویر تأثیر می‌گذارند و برخی دیگر فقط بر رمزگذاری آن‌ها. مورد دوم می‌تواند پس از گروه نهایی تصاویر ورودی ظاهر شود.

این یک فهرست ترکیبی از گزینه‌های خط فرمان است که توسط ابزارهای GraphicsMagick استفاده می‌شوند (animate، compare، composite، convert، display، identify، import، mogrify و montage).

در این سند، علامت‌های کوچکتر/بزرگتر ("<>") متغیرها را در بر می‌گیرند و آکولادها ("{}") پارامترهای اختیاری را مشخص می‌کنند. برای مثال، "-fuzz <distance>{%}" به این معنی است که می‌توانید از گزینه "-fuzz 10"; یا "-fuzz 2%" استفاده کنید.

-adjoin

پیوستن تصاویر در یک فایل چند‌تصویری واحد

به‌طور پیش‌فرض، تمام تصاویر یک دنباله تصویری در همان فایل ذخیره می‌شوند. با این حال، برخی قالب‌ها (مانند JPEG) از ذخیره بیش از یک تصویر در هر فایل پشتیبانی نمی‌کنند و تنها فریم اول در یک دنباله ذخیره خواهد شد مگر اینکه نتیجه در فایل‌های جداگانه ذخیره شود. از +adjoin برای اجبار به ذخیره چندین فریم در چندین فایل شماره‌گذاری‌شده استفاده کنید. در صورت استفاده از +adjoin، نام فایل خروجی باید شامل یک مشخصه قالب‌بندی به سبک printf برای بخش عددی نام فایل باشد. برای مثال،

image%02d.miff

-affine <matrix>

ماتریس تبدیل رسم

این گزینه یک ماتریس تبدیل {sx,rx,ry,sy,tx,ty} را برای استفاده توسط گزینه‌های بعدی -draw یا -transform فراهم می‌کند.

-antialias

حذف شکستگی و پلگی (aliasing) پیکسل‌ها

به‌طور پیش‌فرض هنگام رسم اشیاء (مانند خطوط) یا رندر کردن قالب‌های برداری (مانند WMF و Postscript) از الگوریتم‌های هموارسازی (antialiasing) استفاده می‌شود. برای غیرفعال کردن استفاده از الگوریتم‌های هموارسازی از +antialias استفاده کنید. دلایل غیرفعال کردن هموارسازی شامل جلوگیری از افزایش رنگ‌ها در تصویر یا بهبود سرعت رندر است.

-append

پیوست کردن مجموعه‌ای از تصاویر

این گزینه یک تصویر واحد ایجاد می‌کند که در آن تصاویر مجموعه اصلی از بالا به پایین روی هم چیده می‌شوند. اگر عرض آن‌ها یکسان نباشد، هر تصویر باریک‌تر با استفاده از رنگ پس‌زمینه گسترش می‌یابد تا اندازه شود. برای چیدن تصاویر از چپ به راست از +append استفاده کنید. مجموعه تصاویر با ظاهر شدن هر گزینه‌ای خاتمه می‌یابد. اگر گزینه -append بعد از تمام تصاویر ورودی ظاهر شود، همه تصاویر پیوست می‌شوند.

-asc-cdl <spec>

اعمال تبدیل رنگ ASC CDL

فرمت ASC CDL را اعمال (تثبیت) می‌کند، که قالبی برای تبادل اطلاعات پایه‌ای درجه‌بندی رنگ اولیه بین تجهیزات و نرم‌افزارهای سازندگان مختلف است. این قالب روابط ریاضی را برای سه تابع تعریف می‌کند: شیب (slope)، آفست (offset) و توان (power). هر تابع از یک عدد برای کانال‌های رنگ قرمز، سبز و آبی استفاده می‌کند که در مجموع نه عدد تشکیل‌دهنده یک تصمیم رنگی واحد است. عدد دهم (اختیاری) برای خلوص رنگ یا اشباع (saturation) است که توسط ASC CDL 1.2 مشخص شده است.

رشته آرگومان با کاما جدا می‌شود و به شکل زیر است (اما بدون فاصله‌ها یا شکست‌های خط میانی):

redslope,redoffset,redpower:
greenslope,greenoffset,greenpower:
blueslope,blueoffset,bluepower:
saturation

که مشخصه همانی (بدون تغییر) آن به صورت زیر است:

"1.0,0.0,1.0:1.0,0.0,1.0:1.0,0.0,1.0:1.0"

-authenticate <string>

رمزگشایی تصویر با این گذرواژه

از این گزینه برای ارائه یک گذرواژه جهت رمزگشایی یک تصویر یا دنباله‌ای از تصاویر استفاده کنید، در صورتی که تصویر از قالبی مانند PDF که از رمزگذاری پشتیبانی می‌کند خوانده شود. رمزگذاری تصاویری که در حال ذخیره هستند پشتیبانی نمی‌شود.

-auto-orient

جهت‌دهی (چرخاندن) تصویر به گونه‌ای که عمودی و درست باشد

جهت تصویر را به گونه‌ای تنظیم می‌کند که برای مشاهده مناسب باشد. از برچسب جهت‌گیری به‌دست‌آمده از فایل تصویر یا مقدار ارائه‌شده توسط گزینه -orient استفاده می‌کند.

-average

میانگین‌گیری از مجموعه‌ای از تصاویر

مجموعه تصاویر با ظاهر شدن هر گزینه‌ای خاتمه می‌یابد. اگر گزینه -average بعد از تمام تصاویر ورودی ظاهر شود، از تمام تصاویر میانگین گرفته می‌شود.

-backdrop

نمایش تصویر به‌صورت متمرکز روی یک پرده پس‌زمینه (backdrop).

این پرده پس‌زمینه کل صفحه ایستگاه کاری را می‌پوشاند و برای پنهان کردن سایر فعالیت‌های پنجره X هنگام مشاهده تصویر مفید است. رنگ پرده پس‌زمینه به‌عنوان رنگ پیش‌زمینه مشخص می‌شود (پیش‌فرض X11 سیاه است). برای جزئیات به بخش "X Resources" در زیر مراجعه کنید.

-background <color>

رنگ پس‌زمینه

رنگ با استفاده از قالب شرح‌داده‌شده ذیل گزینه -fill مشخص می‌شود.

-black-threshold red[,green][,blue][,opacity]

پیکسل‌های زیر مقدار آستانه سیاه می‌شوند

از -black-threshold برای تنظیم پیکسل‌های با مقادیر کمتر از آستانه مشخص‌شده به حداقل مقدار (سیاه) استفاده کنید. اگر فقط یک مقدار ارائه شود، یا مقادیر قرمز، سبز و آبی یکسان باشند، آستانه‌گذاری شدت روشنایی استفاده می‌شود. اگر مقادیر آستانه رنگ یکسان نباشند، آستانه‌گذاری مبتنی بر کانال استفاده می‌شود و اعوجاج رنگ رخ خواهد داد. اگر می‌خواهید یک کانال نادیده گرفته شود اما تمایل دارید آستانه‌گذاری را برای کانال بعدی در فهرست اعمال کنید، یک مقدار منفی (مانند -1) مشخص نمایید. اگر نماد درصد (%) اضافه شود، مقادیر به‌عنوان درصدی از حداکثر دامنه در نظر گرفته می‌شوند..TP -blue-primary <x>,<y> نقطه اصلی رنگینگی آبی

-blur <radius>{x<sigma>}

مات کردن تصویر با یک عملگر گاوسی

مات کردن با شعاع و انحراف معیار (سیگما) مشخص‌شده.

-border <width>x<height>

احاطه کردن تصویر با حاشیه‌ای از رنگ

برای جزئیات درباره مشخصات هندسی، به -geometry مراجعه کنید.

-bordercolor <color>

رنگ حاشیه

رنگ با استفاده از قالبی که ذیل گزینه -fill شرح داده شده است، مشخص می‌شود.

-borderwidth <geometry>

عرض حاشیه

-box <color>

تنظیم رنگ کادر احاطه‌کننده زیرنویس

رنگ با استفاده از قالبی که ذیل گزینه -fill شرح داده شده است، مشخص می‌شود.

برای جزئیات بیشتر به -draw مراجعه کنید.

-channel <type>

نوع کانال

انتخاب از میان: Red، Green، Blue، Opacity، Matte، Cyan، Magenta، Yellow، Black یا Gray.

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

-charcoal <factor>

شبیه‌سازی نقاشی با زغال

-chop <width>x<height>{+-}<x>{+-}<y>{%}

حذف پیکسل‌ها از درون یک تصویر

Width و height تعداد ستون‌ها و سطرهای قابل حذف را مشخص می‌کنند، و x و y فاصله‌هایی هستند که مکان چپ‌ترین ستون و بالاترین سطر را برای حذف تعیین می‌کنند.

فاصله x به‌طور معمول چپ‌ترین ستون را برای حذف مشخص می‌کند. اگر گزینه -gravity همراه با جهت‌های NorthEast، East یا SouthEast حضور داشته باشد، فاصله به سمت چپ را از لبه راست تصویر به راست‌ترین ستون برای حذف مشخص می‌کند. به همین ترتیب، فاصله y به‌طور معمول بالاترین سطر را برای حذف مشخص می‌کند، اما اگر گزینه -gravity همراه با جهت‌های SouthWest، South یا SouthEast باشد، فاصله رو به بالا را از لبه پایینی تصویر به پایین‌ترین سطر برای حذف مشخص می‌کند.

گزینه -chop تمام سطرها و ستون‌ها را حذف می‌کند و بلوک‌های گوشه‌ای باقی‌مانده را به سمت چپ و بالا جابه‌جا می‌کند تا شکاف‌ها پر شوند.

-clip

اعمال مسیر برش (clipping path)، در صورت وجود

اگر یک مسیر برش وجود داشته باشد، بر روی عملیات بعدی اعمال خواهد شد.

به‌عنوان مثال، اگر دستور زیر را وارد کنید:

gm convert -clip -negate cockatoo.tif negated.tif

تنها پیکسل‌های درون مسیر برش نگاتیو می‌شوند.

قابلیت -clip نیازمند کتابخانه XML است. اگر کتابخانه XML موجود نباشد، این گزینه نادیده گرفته می‌شود.

-coalesce

ادغام توالی تصاویر

هر تصویر N در توالی پس از تصویر 0 با تصویری جایگزین می‌شود که از یکدست‌سازی (flattening) تصاویر 0 تا N ایجاد شده است.

مجموعه تصاویر با ظاهر شدن هر گزینه‌ای خاتمه می‌یابد. اگر گزینه -coalesce پس از تمام تصاویر ورودی بیاید، همه تصاویر ادغام می‌شوند.

-colorize <value>

رنگ‌آمیزی تصویر با رنگ قلم

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

گزینه -colorize ممکن است در کنار -modulate برای ایجاد تصویری با رنگ‌مایه سپیا (sepia) مناسب به کار رود، مانند:

gm convert input.ppm -modulate 115,0,100 \
          -colorize 7,21,50 output.ppm.

-colormap <type>

تعریف نوع جدول رنگ (colormap)

بین shared یا private انتخاب کنید.

این گزینه تنها زمانی اعمال می‌شود که حالت بصری (visual) پیش‌فرض کارساز X برابر با PseudoColor یا GRAYScale باشد. برای جزئیات بیشتر به -visual مراجعه کنید. به‌طور پیش‌فرض، یک جدول رنگ اشتراکی تخصیص داده می‌شود. تصویر رنگ‌ها را با سایر کلاینت‌های X به اشتراک می‌گذارد. برخی از رنگ‌های تصویر ممکن است تقریبی باشند، بنابراین ممکن است تصویر شما بسیار متفاوت از آنچه در نظر گرفته شده به نظر برسد. گزینه Private را انتخاب کنید تا رنگ‌های تصویر دقیقاً همان‌طور که تعریف شده‌اند نمایش داده شوند. با این حال، هنگامی که جدول رنگ تصویر نصب می‌شود، ممکن است رنگ‌های سایر کلاینت‌ها دچار به‌هم‌ریختگی (technicolor) شود.

-colors <value>

تعداد رنگ‌های ترجیحی در تصویر

تعداد واقعی رنگ‌های تصویر ممکن است کمتر از درخواست شما باشد، اما هرگز بیشتر نخواهد بود. توجه داشته باشید که این یک گزینه کاهش رنگ است. تصاویری که دارای رنگ‌های یکتای کمتر از مقدار مشخص‌شده در این گزینه هستند، رنگ‌های تکراری یا استفاده‌نشده آن‌ها حذف خواهد شد. ترتیب یک پالت رنگی موجود ممکن است تغییر کند. هنگام تبدیل یک تصویر از رنگی به مقیاس خاکستری، پیش از کاهش تعداد رنگ‌ها تصویر را به فضای رنگی خاکستری تبدیل کنید چرا که این روش کارآمدتر است. برای جزئیات بیشتر به <a href="quantize.html">quantize مراجعه کنید.

توجه داشته باشید که گزینه‌های -dither، -colorspace و -treedepth بر الگوریتم کاهش رنگ تأثیر می‌گذارند.

-colorspace <value>

نوع فضای رنگی

انتخاب‌ها عبارتند از: CineonLog، CMYK، GRAY، HSL، HWB، OHTA، RGB، Rec601Luma، Rec709Luma، Rec601YCbCr، Rec709YCbCr، Transparent، XYZ، YCbCr، YIQ، YPbPr یا YUV.

کاهش رنگ، به‌طور پیش‌فرض در فضای رنگی RGB انجام می‌شود. شواهد تجربی نشان می‌دهند که فاصله‌ها در فضاهای رنگی مانند YUV یا YIQ نسبت به فاصله‌ها در فضای RGB، با تفاوت‌های رنگی ادراکی مطابقت نزدیک‌تری دارند. این فضاهای رنگی ممکن است هنگام کاهش رنگ یک تصویر نتایج بهتری به دست دهند. برای جزئیات بیشتر به quantize مراجعه کنید. دو فضای رنگی خاکستری پشتیبانی می‌شوند. فضای Rec601Luma بر اساس توصیه‌های تلویزیون سنتی NTSC (ITU-R BT.601-5) است. فضای Rec709Luma بر اساس توصیه‌های HDTV (Rec. ITU-R BT.709-5) بوده و برای استفاده در گرافیک رایانه‌ای و نمایشگرهای CRT امروزی مناسب است. فضای رنگی GRAY در حال حاضر به‌دلایل سازگاری با گذشته، به‌طور پیش‌فرض فضای رنگی Rec601Luma را انتخاب می‌کند. این پیش‌فرض ممکن است در آینده مورد تجدیدنظر قرار گیرد.

دو فضای رنگی YCbCr پشتیبانی می‌شوند. فضای Rec601YCbCr بر اساس توصیه‌های تلویزیون سنتی NTSC (ITU-R BT.601-5) است. فضای Rec709CbCr بر اساس توصیه‌های HDTV (Rec. ITU-R BT.709-5) بوده و برای استفاده در گرافیک رایانه‌ای و نمایشگرهای CRT امروزی مناسب است. مشخصه فضای رنگی YCbCr معادل Rec601YCbCr است.

فضای رنگی Transparent رفتاری منحصر‌به‌فرد دارد به‌طوری‌که در صورت وجود، کانال مات (matte) تصویر را حفظ می‌کند.

برای اثرگذاری این گزینه، استفاده از گزینه -colors یا -monochrome، یا ذخیره در یک قالب فایل که نیازمند کاهش رنگ باشد، الزامی است.

-comment <string>

افزودن یادداشت به تصویر

از این گزینه برای اختصاص یک یادداشت خاص به تصویر، هنگام ذخیره در یک قالب تصویری که از یادداشت‌ها پشتیبانی می‌کند، استفاده کنید. می‌توانید نام فایل تصویر، نوع، عرض، ارتفاع، یا سایر ویژگی‌های تصویر را با گنجاندن نویسه‌های قالب‌بندی خاص فهرست‌شده ذیل گزینه -format اضافه کنید. این یادداشت بر روی تصویر کشیده نمی‌شود، بلکه از طریق یک برچسب "Comment" یا سازوکاری مشابه در جریان داده تصویر تعبیه می‌گردد. اگر می‌خواهید یادداشت بر روی خود تصویر قابل مشاهده باشد، در عوض از گزینه -draw استفاده کنید.

برای مثال،

-comment "%m:%f %wx%h"

یادداشت تصویری به صورت MIFF:bird.miff 512x480 برای تصویری با عنوان bird.miff که عرض آن 512 و ارتفاع آن 480 است، ایجاد می‌کند.

اگر اولین نویسه string برابر با @ باشد، یادداشت تصویر از فایلی خوانده می‌شود که نام آن با نویسه‌های باقی‌مانده رشته مشخص شده است. لطفاً توجه داشته باشید که اگر رشته از یک منبع غیرقابل‌اعتماد باشد، باید پیش از استفاده اعتبارسنجی و پاکسازی شود؛ در غیر این صورت محتوای یک فایل خواندنی دلخواه می‌تواند در یادداشت فایل خروجی گنجانده شود (یک خطر امنیتی).

اگر گزینه -comment چندین بار ظاهر شود، تنها آخرین یادداشت ذخیره خواهد شد.

در تصاویر PNG، یادداشت در یک قطعه (chunk) از نوع tEXt یا zTXt با کلمه کلیدی "comment" ذخیره می‌شود..TP -compose <operator> نوع ترکیب تصویر

توضیحات ترکیب تصویر از اصطلاحات انتزاعی استفاده می‌کند تا توصیف واضح‌تر باشد و در عین حال از مقادیر ثابتی که مختص یک پیکربندی ساخت خاص هستند پرهیز شود. هر پیکسل تصویر با سطوح قرمز، سبز و آبی (که برای یک پیکسل خاکستری برابر هستند) نمایش داده می‌شود. مقدار MaxRGB حداکثر مقدار عدد صحیحی است که می‌تواند در کانال‌های قرمز، سبز یا آبی تصویر ذخیره شود. هر پیکسل تصویر همچنین می‌تواند به صورت اختیاری (در صورت فعال بودن کانال matte تصویر) دارای یک سطح کدر بودن (opacity) مرتبط باشد (در دامنه‌ای از کدر تا شفاف)، که ممکن است برای تعیین میزان اثرگذاری رنگ پیکسل هنگام ترکیب با پیکسل یک تصویر دیگر استفاده شود. اگر کانال matte تصویر غیرفعال باشد، همهٔ پیکسل‌ها در تصویر کدر در نظر گرفته می‌شوند. رنگ یک پیکسل کدر کاملاً قابل مشاهده است، در حالی که رنگ یک پیکسل شفاف کاملاً غایب است (رنگ پیکسل نادیده گرفته می‌شود).

بر پایه تعریف، تصاویر شطرنجی (raster) شکلی مستطیلی دارند. تمام ردیف‌های تصویر طول یکسانی دارند و تمام ستون‌های تصویر دارای تعداد ردیف‌های برابری هستند. با در نظر گرفتن کانال کدر بودن (opacity) به عنوان یک «ماسک» بصری، می‌توان با استفاده از کانال opacity همانند یک قالب برش، به تصویر مستطیلی یک «شکل» داد. پیکسل‌های درون این شکل کدر هستند، در حالی که پیکسل‌های بیرون شکل شفاف‌اند. پیکسل‌های واقع در مرز شکل می‌توانند مقداری بین کدر و شفاف داشته باشند تا قابلیت antialiasing (لبه‌های بصری صاف و هموار) فراهم شود. توصیف عملگرهای ترکیب از این مفهومِ «شکل» تصویر استفاده می‌کند تا درک رفتار عملگرها ساده‌تر شود. اگرچه توصیف عملگرها با استفاده از «شکل‌ها» کار را راحت‌تر می‌کند، اما آن‌ها به هیچ وجه محدود به عملیات‌های سبکِ ماسک نیستند، چرا که بر پایه محاسبات ریاضی ممیز شناور پیوسته عمل می‌کنند نه عملیات بولی ساده.

به‌طور پیش‌فرض، عملگر ترکیب Over استفاده می‌شود. عملگرهای ترکیب زیر در دسترس هستند:

Over
In
Out
Atop
Xor
Plus
Minus
Add
Subtract
Difference
Divide
Multiply
Bumpmap
Copy
CopyRed
CopyGreen
CopyBlue
CopyOpacity
CopyCyan
CopyMagenta
CopyYellow
CopyBlack

رفتار هر یک از عملگرها در ادامه شرح داده شده است.

Over


نتیجه، اجتماع شکل‌های دو تصویر خواهد بود، به‌طوری که نواحی کدر change-image در ناحیهٔ هم‌پوشانی، base-image را می‌پوشانند.

In


نتیجه صرفاً change-image است که با شکل base-image برش خورده است. هیچ‌یک از داده‌های تصویر base-image در نتیجه وجود نخواهد داشت.

Out


تصویر حاصل، change-image است در حالی که شکل base-image از آن بریده شده است.

Atop


نتیجه دارای همان شکل base-image است، به‌طوری که در محل هم‌پوشانی شکل‌های تصویر، change-image روی base-image را می‌پوشاند. توجه داشته باشید که این حالت با over تفاوت دارد، زیرا بخشی از change-image که خارج از شکل base-image قرار دارد در نتیجه ظاهر نمی‌شود.

Xor


نتیجه، داده‌های تصویری از هر دو تصویر change-image و base-image است که خارج از ناحیهٔ هم‌پوشانی قرار دارند. ناحیهٔ هم‌پوشانی خالی خواهد بود.

Plus


نتیجه صرفاً حاصل‌جمع داده‌های تصویر است. مقادیر خروجی به MaxRGB محدود می‌شوند (بدون سرریز). این عملیات مستقل از کانال‌های matte است.

Minus


نتیجهٔ change-image - base-image، با محدود شدن زیرریز (underflow) به صفر. کانال matte نادیده گرفته می‌شود (بر روی کدر، پوشش کامل تنظیم می‌شود).

Add


نتیجهٔ change-image + base-image، با سرریز چرخشی (mod MaxRGB+1).

Subtract


نتیجهٔ change-image - base-image، با زیرریز چرخشی (mod MaxRGB+1). عملگرهای add و subtract می‌توانند برای انجام تبدیلات برگشت‌پذیر استفاده شوند.

Difference


نتیجهٔ abs(change-image - base-image). این عملگر برای مقایسهٔ دو تصویر بسیار مشابه مفید است.

Divide


نتیجهٔ change-image / base-image. این عملگر برای بهبود خوانایی متن در عکس‌هایی با نورپردازی ناهمگن مفید است (با استفاده از یک نسخهٔ تارشده با فیلتر گوسی از change-image به عنوان base-image).

Multiply


نتیجهٔ change-image * base-image. این عملگر برای ایجاد سایه (drop-shadow) مفید است.

Bumpmap


نتیجه، base-image است که توسط change-image سایه‌پردازی شده است.

Copy


تصویر حاصل، base-image است که با change-image جایگزین شده است. در اینجا اطلاعات matte نادیده گرفته می‌شود.

CopyRed


تصویر حاصل، کانال قرمز در base-image است که با کانال قرمز در change-image جایگزین شده است. سایر کانال‌ها دست‌نخورده کپی می‌شوند.

CopyGreen


تصویر حاصل، کانال سبز در base-image است که با کانال سبز در change-image جایگزین شده است. سایر کانال‌ها دست‌نخورده کپی می‌شوند.

CopyBlue


تصویر حاصل، کانال آبی در base-image است که با کانال آبی در change-image جایگزین شده است. سایر کانال‌ها دست‌نخورده کپی می‌شوند.

CopyOpacity


تصویر حاصل، کانال opacity در base-image است که با کانال opacity در change-image جایگزین شده است. سایر کانال‌ها دست‌نخورده کپی می‌شوند.

CopyCyan


تصویر حاصل، کانال cyan (فیروزه‌ای) در base-image است که با کانال cyan در change-image جایگزین شده است. سایر کانال‌ها دست‌نخورده کپی می‌شوند. استفاده از این عملگر نیازمند آن است که base-image در فضای رنگی CMYK(A) باشد.

CopyMagenta


تصویر حاصل، کانال magenta (سرخابی) در base-image است که با کانال magenta در change-image جایگزین شده است. سایر کانال‌ها دست‌نخورده کپی می‌شوند. استفاده از این عملگر نیازمند آن است که base-image در فضای رنگی CMYK(A) باشد.

CopyYellow


تصویر حاصل، کانال yellow (زرد) در base-image است که با کانال yellow در change-image جایگزین شده است. سایر کانال‌ها دست‌نخورده کپی می‌شوند. استفاده از این عملگر نیازمند آن است که base-image در فضای رنگی CMYK(A) باشد.

CopyBlack


تصویر حاصل، کانال black (سیاه) در base-image است که با کانال black در change-image جایگزین شده است. سایر کانال‌ها دست‌نخورده کپی می‌شوند. استفاده از این عملگر نیازمند آن است که base-image در فضای رنگی CMYK(A) باشد. اگر change-image در فضای رنگی CMYK نباشد، از شدت روشنایی پیکسل‌های change-image استفاده خواهد شد.

-compress <type> نوع فشرده‌سازی تصویر

انتخاب‌ها عبارتند از: None، BZip، Fax، Group3، Group4، JPEG، Lossless، LZW، RLE، Zip، LZMA، JPEG2000، JPEG2000، JBIG، JBIG2، WebP، یا ZSTD.

برای ذخیره تصویر باینری در قالبی فشرده‌نشده، +compress را مشخص کنید. پیش‌فرض، نوع فشرده‌سازی فایل تصویر مشخص‌شده است.

عبارت "Lossless" به JPEG بدون اتلاف اشاره دارد که فقط در صورتی در دسترس است که کتابخانه JPEG برای پشتیبانی از آن وصله خورده باشد. استفاده از JPEG بدون اتلاف عموماً توصیه نمی‌شود.

از گزینه -quality برای تنظیم سطح فشرده‌سازی مورد استفاده توسط رمزگذارهای JPEG، JPEG-2000، PNG، MIFF، MPEG و TIFF استفاده کنید. از گزینه -sampling-factor برای تنظیم ضریب نمونه‌برداری مورد استفاده توسط رمزگذارهای DPX، JPEG، MPEG و YUV جهت کاهش نمونه‌برداری (downsampling) کانال‌های کروما استفاده کنید.

-contrast

افزایش یا کاهش کنتراست تصویر

این گزینه تفاوت شدت روشنایی بین عناصر روشن‌تر و تیره‌تر تصویر را تقویت می‌کند. از -contrast برای بهبود کنتراست تصویر یا از +contrast برای کاهش کنتراست تصویر استفاده کنید.

برای اثربخشی بیشتر می‌توانید گزینه را تکرار کنید:

gm convert rose: -contrast -contrast rose_c2.png

-convolve <kernel>

پیچش (کانولوشن) تصویر با هسته کانولوشن مشخص‌شده

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

-create-directories

ایجاد دایرکتوری خروجی در صورت نیاز

اگر مسیرهای ورودی شامل زیردایرکتوری‌ها هستند و تمایل دارید زیردایرکتوری‌های مشابهی در دایرکتوری خروجی ایجاد شوند، این گزینه را به همراه -output-directory به کار ببرید. بدون این گزینه، در صورتی که دایرکتوری خروجی مورد نیاز وجود نداشته باشد، اجرای mogrify با شکست مواجه خواهد شد.

-crop <width>x<height>{+-}<x>{+-}<y>{%}

اندازه و مکان ترجیحی برای تصویر برش‌خورده

برای جزئیات درباره مشخصات هندسی (geometry) به -geometry مراجعه کنید.

عرض (width) و ارتفاع (height) اندازه تصویری را که پس از برش باقی می‌ماند مشخص می‌کنند، و x و y انحراف‌هایی (offset) هستند که مکان گوشه بالای سمت چپ تصویر برش‌خورده را نسبت به تصویر اصلی تعیین می‌کنند. برای مشخص کردن مقداری که باید حذف شود، در عوض از -shave استفاده کنید.

اگر انحراف‌های x و y وجود داشته باشند، یک تصویر منفرد متشکل از پیکسل‌های ناحیه برش ایجاد می‌شود. این انحراف‌ها موقعیت گوشه بالای سمت چپ ناحیه برش را که به سمت پایین و راست نسبت به گوشه بالای سمت چپ تصویر اندازه گرفته می‌شود، مشخص می‌کنند. اگر گزینه -gravity همراه با جهت NorthEast، East یا SouthEast مشخص شده باشد، فاصله به سمت چپ را از لبه راست تصویر تا لبه راست ناحیه برش مشخص می‌کند. به همین ترتیب، اگر گزینه -gravity همراه با جهت SouthWest، South یا SouthEast مشخص شده باشد، فاصله به سمت بالا بین لبه‌های پایینی اندازه‌گیری می‌شود.

اگر انحراف‌های x و y حذف شوند، مجموعه‌ای از کاشی‌ها (tiles) با هندسه مشخص‌شده که کل تصویر ورودی را پوشش می‌دهند، تولید می‌شود. در صورتی که هندسه مشخص‌شده فراتر از ابعاد تصویر ورودی برود، راست‌ترین کاشی‌ها و کاشی‌های پایینی کوچک‌تر خواهند بود.

-cycle <amount>

جابجایی نقشه رنگ (colormap) تصویر به مقدار مشخص‌شده

مقدار (Amount) تعداد موقعیت‌هایی را که هر مدخل نقشه رنگ جابجا می‌شود مشخص می‌کند.

-debug <events>

فعال‌سازی چاپ خروجی اشکال‌زدایی

پارامتر events مشخص می‌کند چه رویدادهایی ثبت (log) شوند. این پارامتر می‌تواند None، All، یا فهرستی جداشده با کاما متشکل از یک یا چند دامنه از موارد زیر باشد: Annotate، Blob، Cache، Coder، Configure، Deprecate، Error، Exception، FatalError، Information، Locale، Option، Render، Resource، TemporaryFile، Transform، User، Warning، یا X11. برای مثال، جهت ثبت رویدادهای cache و blob، از دستور زیر استفاده کنید:

gm convert -debug "Cache,Blob" rose: rose.png

دامنه "User" معمولاً خالی است، اما توسعه‌دهندگان می‌توانند رویدادهای "User" را در نسخه اختصاصی GraphicsMagick خود ثبت کنند.

برای تعیین قالب خروجی اشکال‌زدایی از گزینه -log استفاده کنید.

برای خاموش کردن تمام ثبت‌های گزارش از +debug استفاده کنید.

یک جایگزین برای استفاده از -debug، استفاده از متغیر محیطی MAGICK_DEBUG است. مقادیر مجاز برای متغیر محیطی MAGICK_DEBUG مشابه مقادیر گزینه -debug هستند.

-deconstruct

تجزیه یک توالی تصویر به بخش‌های تشکیل‌دهنده

این گزینه هر تصویر را با تصویر بعدی در یک توالی مقایسه کرده و بزرگ‌ترین ناحیه مرزی مربوط به هرگونه تفاوت پیکسلی کشف‌شده را برمی‌گرداند. این روش می‌تواند یک توالی ادغام‌شده (coalesced) را که توسط گزینه -coalesce برگردانده شده خنثی کند، و برای حذف اطلاعات زائد از پویانمایی‌های GIF یا MNG مفید است.

توالی تصاویر با ظاهر شدن هر گزینه‌ای خاتمه می‌یابد. اگر گزینه -deconstruct پس از تمام تصاویر ورودی ظاهر شود، تمامی تصاویر تجزیه می‌شوند.

-define <key>{=<value>},...

افزودن گزینه‌های مختص رمزگذار/رمزگشا (coder/decoder) این گزینه یک یا چند تعریف را برای استفاده رمزگذارها و رمزگشاها هنگام خواندن و نوشتن داده‌های تصویر ایجاد می‌کند. تعاریف می‌توانند برای کنترل گزینه‌هایی که مختص فرمت‌های تصویری خاصی هستند به رمزگذارها و رمزگشاها ارسال شوند. اگر value برای یک تعریف ذکر نشود، تعریفی با مقدار خالی برای یک پرچم (flag) با آن نام ایجاد خواهد شد. این کار برای کنترل گزینه‌های روشن/خاموش استفاده می‌شود. از +define <key>,... برای حذف تعاریفی که پیش‌تر ایجاد شده‌اند استفاده کنید. از +define "*" برای حذف تمام تعاریف موجود استفاده کنید.

تعاریف زیر می‌توانند ایجاد شوند:

bmp:allow-jpeg={true|false}


اگر مقدار bmp:allow-jpeg روی true تنظیم شود، فایل‌های BMP با استفاده از فشرده‌سازی JPEG، تحت کنترل گزینه فشرده‌سازی (که اگر فایل ورودی JPEG باشد ممکن است از قبل JPEG باشد) فعال می‌شوند. فایل‌های BMP با فشرده‌سازی JPEG بسیار نادر هستند، بنابراین این گزینه به عنوان یک محافظ عمل می‌کند تا اطمینان حاصل شود که تنظیمات فشرده‌سازی فعلی به طور تصادفی فایل‌های BMP فشرده‌شده با JPEG تولید نکند که اکثر نرم‌افزارهای دیگر قادر به خواندن آن نیستند.

cineon:colorspace={rgb|cineonlog}


هنگام خواندن یک فایل Cineon، از گزینه cineon:colorspace برای مشخص کردن فضای رنگی مورد استفاده فایل Cineon استفاده کنید. این مقدار، نوع فضای رنگی ضمنی سرآیند DPX (در صورت وجود) را نادیده می‌گیرد.

dpx:bits-per-sample=<value>


اگر کلید dpx:bits-per-sample تعریف شود، GraphicsMagick تصاویر DPX را با بیت‌های مشخص‌شده در هر نمونه می‌نویسد و هرگونه مقدار عمق (depth) موجود را نادیده می‌گیرد. اگر این گزینه مشخص نشود، مقدار بر اساس مقدار عمق تصویر موجود از فایل تصویر اصلی تعیین می‌شود. استاندارد DPX از مقادیر بیت در هر نمونه ۱، ۸، ۱۰، ۱۲ و ۱۶ پشتیبانی می‌کند. بسیاری از خواننده‌های DPX اندازه نمونه ۱۰ بیتی با فاصله‌گذاری نوع A را طلب می‌کنند (به پایین مراجعه کنید).

dpx:colorspace={rgb|cineonlog}


هنگام خواندن یک فایل DPX، از گزینه dpx:colorspace برای مشخص کردن فضای رنگی مورد استفاده فایل DPX استفاده کنید. این مقدار، نوع فضای رنگی ضمنی سرآیند DPX (در صورت وجود) را نادیده می‌گیرد.

dpx:packing-method={packed|a|b|lsbpad|msbpad}


نمونه‌های DPX درون کلمات ۳۲ بیتی خروجی داده می‌شوند. آن‌ها می‌توانند به طور فشرده سر‌به‌سر در کلمات بسته‌بندی شوند ("packed")، با بیت‌های خالی در سمت راست نمونه فاصله‌گذاری شوند ("a" یا "lsbpad")، یا با بیت‌های خالی در سمت چپ نمونه فاصله‌گذاری شوند ("b" یا "msbpad"). این گزینه تنها برای اندازه نمونه‌های ۱۰ یا ۱۲ بیتی تأثیر دارد. اگر نمونه‌ها فشرده (packed) نشده باشند، استاندارد DPX فاصله‌گذاری نوع A را توصیه می‌کند. بسیاری از خواننده‌های DPX اندازه نمونه ۱۰ بیتی با فاصله‌گذاری نوع A را طلب می‌کنند.

dpx:pixel-endian={lsb|msb}


به کاربر امکان می‌دهد ترتیب اندیان (endian) پیکسل‌ها را هنگام خواندن یا نوشتن فایل‌های DPX مشخص کند. این گزینه گاهی اوقات در صورتی که فایل به اشتباه نوشته شده باشد (یا باید نوشته شود) به طوری که سرآیند فایل و پیکسل‌ها از ترتیب اندیان متفاوتی استفاده کنند، مفید است.

dpx:swap-samples={true|false}


dpx:swap-samples-read={true|false}


dpx:swap-samples-write={true|false}


برنامه GraphicsMagick تلاش می‌کند از استاندارد DPX پیروی کند اما جنبه‌های خاصی از این استاندارد می‌تواند بسیار گیج‌کننده باشد. در نتیجه، در برخی فایل‌های ۱۰ بیتی DPX به دلیل تفسیر متفاوتی از استاندارد یا اشتباه در اتصالات، جای Red و Blue با هم عوض شده است، یا Cb و Cr جابجا شده‌اند. گزینه swap-samples می‌تواند هنگام خواندن یا نوشتن ارائه شود تا خواندن یا نوشتن با ترتیب نمونه مورد نیاز انجام گیرد. زمانی که جابجایی فقط باید در خواننده رخ دهد از swap-samples-read استفاده کنید، یا زمانی که جابجایی فقط باید در نویسنده رخ دهد از swap-samples-write استفاده کنید.

heif:ignore-transformations={true|false}

تصویر HEIF (مانند HEIC/AVIF) را بدون اعمال هیچ‌گونه تبدیلی (مانند چرخش) برمی‌گرداند. در حالت 'ping' (پیش‌فرض identify) مقدار پیش‌فرض true است، اما در غیر این صورت false است. زمانی که ignore-transformations برابر false باشد، ممکن است identify بسیار کندتر عمل کند.

heif:interleaved-rgb-decode={true|false}

درخواست می‌کند که libheif پیکسل‌ها را به جای نمایش صفحه‌ای (planar)، در نمایش درهم‌تنیده (interleaved) برگرداند. این موضوع نباید تأثیری بر نتیجه رمزگشایی‌شده داشته باشد، اما عملکرد ممکن است متفاوت باشد.

heif:preserve-colorspace={true|false}



تصویر HEIF را در فضای رنگی اصلی‌اش بازمی‌گرداند. این گزینه اجازه می‌دهد تصویر به جای RGB در فضای رنگی اصلی YCbCr برگردانده شود.

heif:tile-threads=number

اگر یک تصویر HEIF از چندین کاشی تشکیل شده باشد، هر کاشی می‌تواند توسط یک نخ (thread) رمزگشایی شود، و چندین کاشی می‌توانند به طور هم‌زمان با استفاده از نخ‌های بیشتر رمزگشایی شوند. حداکثر مقدار معقول، کمینه بین تعداد هسته‌های CPU در دسترس یا تعداد کاشی‌های موجود در فایل HEIF است (هر کدام که کوچک‌تر باشد). اگر OpenMP در دسترس باشد، مقدار پیش‌فرض تعداد نخ‌های OpenMP است، در غیر این صورت پیش‌فرض ۴ است.

heif:max-image-size-pixels=number

یک تصویر ممکن است از پیکسل‌های فراوانی تشکیل شده باشد. در صورت وجود تعداد بسیار زیادی پیکسل، بازگرداندن یک تصویر ممکن است زمان زیادی ببرد. لطفاً برای 'max_image_size_pixels' به کد منبع (یا مستندات) libheif مراجعه کنید. توجه داشته باشید که GraphicsMagick از پیش مقداری را برای این پارامتر بر اساس محدودیت کل پیکسل‌ها یا محدودیت‌های عرض/ارتفاع محاسبه می‌کند، بنابراین ارائه این پارامتر مقدار محاسبه‌شده را لغو خواهد کرد.

heif:max-number-of-tiles=number

یک تصویر ممکن است از کاشی‌های متعددی تشکیل شده باشد. در صورت وجود تعداد بسیار زیادی کاشی، بازگرداندن یک تصویر ممکن است زمان زیادی ببرد. لطفاً برای 'max_number_of_tiles' به کد منبع (یا مستندات) libheif مراجعه کنید.

heif:max-bayer-pattern-pixels=number

لطفاً برای ´max_bayer_pattern_pixels' به کد منبع (یا مستندات) libheif مراجعه کنید.

heif:max-items=number

لطفاً برای 'max_items' به کد منبع (یا مستندات) libheif مراجعه کنید.

heif:max-color-profile-size=number

لطفاً برای 'max_color_profile_size' به کد منبع (یا مستندات) libheif مراجعه کنید.

heif:max-memory-block-size=number

لطفاً برای 'max_memory_block_size' به کد منبع (یا مستندات) libheif مراجعه کنید.

heif:max-components=number

لطفاً برای 'max_components' به کد منبع (یا مستندات) libheif مراجعه کنید.

heif:max-iloc-extents-per-item=number

لطفاً برای ´max_iloc_extents_per_item' به کد منبع (یا مستندات) libheif مراجعه کنید.

heif:max-size-entity-group=number

لطفاً برای ´max_size_entity_group' به کد منبع (یا مستندات) libheif مراجعه کنید.

heif:max-children-per-box=number

لطفاً برای ´max_children_per_box' به کد منبع (یا مستندات) libheif مراجعه کنید.

heif:max-total-memory=number

لطفاً برای ´max_total_memory' به کد منبع (یا مستندات) libheif مراجعه کنید.

heif:max-sample-description-box-entries=number

لطفاً برای ´max_sample_description_box_entries' به کد منبع (یا مستندات) libheif مراجعه کنید.

heif:max-sample-group-description-box-entries=number

لطفاً برای ´max_sample_group_description_box_entries' به کد منبع (یا مستندات) libheif مراجعه کنید.

gradient:direction={South|North|West|East|NorthWest|NorthEast|SouthWest|SouthEast}


به‌طور پیش‌فرض، رمزگذار گرادیان، گرادیانی از بالا به پایین ("South") تولید می‌کند. از نسخه 1.3.35 نرم‌افزار GraphicsMagick، جهت گرادیان می‌تواند مشخص شود تا بردارهای گرادیان را مطابق با مشخصاتی شبیه به جاذبه (gravity) تولید کند. آرگومان‌ها عبارتند از: South (بالا به پایین)، North (پایین به بالا)، West (راست به چپ)، East (چپ به راست)، NorthWest (پایین-راست به بالا-چپ)، NorthEast (پایین-چپ به بالا-راست)، SouthWest (بالا-راست به پایین-چپ)، و SouthEast (بالا-چپ به پایین-راست).

jp2:rate=<value>


ضریب فشرده‌سازی مورد استفاده هنگام نوشتن فایل‌های JPEG-2000 را مشخص می‌کند. ضریب فشرده‌سازی معکوس نسبت فشرده‌سازی است. محدوده معتبر 0.0 تا 1.0 است که در آن 1.0 نشان‌دهنده فشرده‌سازی بدون اتلاف است. در صورت تعریف شدن، این مقدار تنظیمات -quality را نادیده می‌گیرد. تنظیم پیش‌فرض کیفیت یعنی 75، منجر به مقدار نرخ 0.06641 می‌شود.

jpeg:arithmetic-coding={true|false}


در صورت پشتیبانی کتابخانه JPEG، کدگذاری حسابی (arithmetic encoding) را فعال یا غیرفعال می‌کند (پیش‌فرض غیرفعال است). هنگامی که این گزینه فعال باشد، optimize-coding لزوماً غیرفعال می‌شود.

jpeg:block-smoothing={true|false}


صاف‌سازی بلوک (block smoothing) را هنگام خواندن یک فایل JPEG فعال یا غیرفعال می‌کند (پیش‌فرض فعال است).

jpeg:dct-method=<value>


پیاده‌سازی DCT کتابخانه IJG JPEG مورد استفاده را انتخاب می‌کند. پیاده‌سازی‌های رمزگذاری در سرعت و خطای رمزگذاری متفاوت هستند. انتخاب‌های در دسترس برای value عبارتند از islow، ifast، float، default و fastest. توجه داشته باشید که بسته به انتخاب‌های صورت‌گرفته هنگام ساخت کتابخانه JPEG و نحوه رفتار پردازنده شما، fastest ممکن است لزوماً سریع‌ترین روی پردازنده شما نباشد.

jpeg:fancy-upsampling={true|false}


افزایش نمونه‌برداری دقیق (fancy upsampling) را هنگام خواندن یک فایل JPEG فعال یا غیرفعال می‌کند (پیش‌فرض فعال است).

jpeg:data-precision=<value>


اندازه ذخیره‌سازی نمونه JPEG را انتخاب می‌کند. فرمت معمولی JPEG از ۸ استفاده می‌کند. کتابخانه Turbo-jpeg و برخی گونه‌های IJG JPEG از ۱۲ و ۱۶ بیت نیز پشتیبانی می‌کنند.

jpeg:lossless-precision=<value>


درجه‌ای از دقت را برای استفاده هنگام انجام فشرده‌سازی مبتنی بر DPCM انتخاب می‌کند. محدوده در دسترس 0 تا precision-1 است. برای مثال، اگر عمق خروجی ۱۶ باشد، محدوده در دسترس ۰ تا ۱۵ است. هنگامی که دقت غیرصفر باشد، پیکسل‌ها به سمت راست شیفت داده می‌شوند تا به طور مؤثری از بیت‌های کمتر (رنگ‌های کمتر) پشتیبانی کنند، اما در عوض نسبت فشرده‌سازی بهتری ارائه می‌دهند. برای دستیابی به فشرده‌سازی بدون اتلاف از مقدار 0 استفاده کنید.

jpeg:lossless-predictor=<value>


پیش‌بینی‌کننده مورد استفاده برای فشرده‌سازی بدون اتلاف را انتخاب می‌کند. مقادیر پشتیبانی‌شده در محدوده ۱ تا ۷ هستند و یک الگوریتم پیش‌بینی‌کننده از پیش تعریف‌شده را برای استفاده انتخاب می‌کنند که پیکسل‌های اطراف را در نظر می‌گیرد. بهترین پیش‌بینی‌کننده برای یک تصویر خاص به خود تصویر بستگی دارد.

jpeg:max-scan-number=<value>


یک مقدار عدد صحیح برای حداکثر تعداد پویش‌های پیش‌رونده (progressive scans) مجاز در یک فایل JPEG مشخص می‌کند. حداکثر پیش‌فرض ۱۰۰ پویش است. این محدودیت به دلیل ضعفی در استاندارد JPEG اعمال شده است که به فایل‌های کوچک JPEG اجازه می‌دهد خواندن آن‌ها دقیقه‌ها یا ساعت‌ها به طول بینجامد.

jpeg:max-warnings=<value>


یک مقدار عدد صحیح را برای تعداد هشدارهای مجاز در هر نوع خطای خاص قبل از ارتقا به یک خطای قطعی (hard error) مشخص می‌کند. فایل‌های JPEG که هشدارهای بیش از حد تولید می‌کنند، نشان‌دهنده وجود مشکل در فایل هستند.

jpeg:optimize-coding={true|false}


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

jpeg:preserve-settings


اگر پرچم jpeg:preserve-settings تعریف شده باشد، رمزگذار JPEG از همان تنظیمات "quality" و "sampling-factor" استفاده خواهد کرد که در صورت JPEG بودن ورودی، در فایل ورودی یافت شده بودند. این تنظیمات همچنین در صورتی که ورودی یک فایل JPEG و خروجی یک فایل JNG باشد نیز حفظ می‌شوند. اگر فضای رنگی فایل خروجی با فایل ورودی متفاوت باشد، تنظیم کیفیت حفظ می‌شود اما ضرایب نمونه‌برداری حفظ نمی‌شوند.

jxl:effort=<integer>


میزان تلاش رمزگذار. مقادیر بالاتر محاسبات بیشتری را ممکن می‌سازند و عموماً خروجی کوچک‌تری را در همان کیفیت به دست می‌آورند. برای رمزگذاری اتلافی، تلاش بیشتر باید کیفیت دقیق‌تری به همراه داشته باشد. لطفاً برای 'JXL_ENC_FRAME_SETTING_EFFORT' به کد منبع (یا مستندات) libjxl مراجعه کنید.

jxl:decodingspeed=<integer>


سرعت رمزگشایی. مقادیر بالاتر سرعت رمزگشایی را به بهای کاهش کیفیت یا تراکم بهبود می‌بخشند. لطفاً برای 'JXL_ENC_FRAME_SETTING_DECODING_SPEED' به کد منبع (یا مستندات) libjxl مراجعه کنید.

pcl:fit-to-page


اگر پرچم pcl:fit-to-page تعریف شود، از چاپگر درخواست می‌شود تا اندازه تصویر را متناسب با اندازه صفحه (عرض و/یا ارتفاع) تغییر مقیاس دهد.

png:chunk-malloc-max=<value>


گزینه png:chunk-malloc-max حداکثر اندازه تکه‌ای (chunk size) را که libpng مجاز به خواندن آن خواهد بود مشخص می‌کند. پیش‌فرض libpng معمولاً ۸٬۰۰۰٬۰۰۰ بایت است. بسیار به ندرت، ممکن است با یک فایل PNG معتبر مواجه شوید که خطای "chunk data is too large" برای آن گزارش شود. در این حالت، این محدودیت می‌تواند با استفاده از این گزینه افزایش یابد. هنگام افزایش این محدودیت احتیاط کنید، زیرا یک محدودیت بیش از حد بزرگ می‌تواند به فایل‌های غیرقابل اعتماد اجازه دهد حافظه بیش از حدی مصرف کنند.

mng:maximum-loops=<value>


گزینه mng:maximum-loops حداکثر تعداد حلقه‌های مجاز برای مشخص شدن توسط یک تکه MNG LOOP را تعیین می‌کند. بدون اعمال محدودیت، یک فایل MNG می‌تواند تا ۲۱۴۷۴۸۳۶۴۷ حلقه را درخواست کند که ممکن است برای مدت بسیار طولانی اجرا شود. حد پیش‌فرض فعلی ۵۱۲ حلقه است.

pdf:use-cropbox={true|false}


اگر پرچم pdf:use-cropbox روی true تنظیم شود، از Ghostscript درخواست می‌شود تا کادر برش (crop box) فایل PDF را اعمال کند.

pdf:stop-on-error={true|false}


اگر پرچم pdf:stop-on-error روی true تنظیم شود، از Ghostscript درخواست می‌شود هنگام مواجهه با اولین خطا، پردازش PDF را متوقف کند. در غیر این صورت تلاش خواهد کرد تمام صفحات درخواست‌شده را پردازش کند.

ps:imagemask


اگر پرچم ps:imagemask تعریف شود، رمزگذارهای PS3 و EPS3 فایل‌های Postscript تولید می‌کنند که تصاویر دوسطحی (bilevel) را به جای عملگر image، با عملگر imagemask زبان Postscript رسم (render) می‌کنند.

ptif:minimum-geometry=<geometry>


اگر کلید ptif:minimum-geometry تعریف شود، GraphicsMagick از آن برای تعیین حداقل اندازه فریم خروجی هنگام نوشتن یک فایل pyramid TIFF (یک فایل TIFF شامل توالی نسخه‌های کوچک‌شده از فریم اول) استفاده خواهد کرد. هندسه حداقل پیش‌فرض 32x32 است.

tiff:alpha={unspecified|associated|unassociated}


نوع کانال آلفای TIFF را هنگام خواندن یا نوشتن فایل‌های TIFF مشخص می‌کند، و مقدار عادی را نادیده می‌گیرد. نوع پیش‌فرض کانال آلفا برای فایل‌های جدید، unspecified alpha است. تنظیمات آلفای موجود هنگام تبدیل از یک فایل TIFF به فایل دیگر حفظ می‌شوند. هنگامی که یک فایل TIFF از associated alpha استفاده می‌کند، پیکسل‌های تصویر از پیش در کانال آلفا ضرب (دگرگون) می‌شوند. فایل‌های دارای آلفای "associated" هنگامی که کانال مات (matte) غیرفعال باشد، طوری به نظر می‌رسند که گویی روی یک پس‌زمینه سیاه ترکیب آلفا شده‌اند. اگر نوع unassociated alpha انتخاب شود، کانال آلفا بدون تغییر دادن پیکسل‌ها ذخیره می‌شود. نرم‌افزار Photoshop آلفای associated را به عنوان اطلاعات شفافیت تشخیص می‌دهد؛ اگر فایل با unassociated alpha ذخیره شود، اطلاعات آلفا به عنوان یک کانال مستقل بارگذاری می‌شود. توجه داشته باشید که برای سال‌ها، ImageMagick و GraphicsMagick فایل‌های TIFF را بدون ضرب پیش‌فرض مناسب پیکسل‌ها، به عنوان فایل‌های دارای associated alpha علامت‌گذاری می‌کردند.

tiff:fill-order={msb2lsb|lsb2msb}


اگر کلید tiff:fill-order تعریف شده باشد، GraphicsMagick از آن برای تعیین ترتیب پر کردن بیت (bit fill order) مورد استفاده هنگام نوشتن فایل‌های TIFF استفاده خواهد کرد. پیش‌فرض عادی "msb2lsb" است که با ترتیب بیت بومی تمامی پردازنده‌های مدرن مطابقت دارد. تنها استثنا در این مورد زمانی است که فشرده‌سازی فکس Group3 یا Group4 درخواست شود، زیرا دستگاه‌های فکس داده‌ها را با ترتیب بیت معکوس ارسال می‌کنند و بنابراین RFC 2301 استفاده از ترتیب معکوس را توصیه می‌کند.

tiff:group-three-options=<value>


اگر کلید tiff:group-three-options تعریف شود، GraphicsMagick از آن برای تنظیم برچسب گزینه‌های group3 هنگام نوشتن TIFF فشرده‌شده با group3 استفاده خواهد کرد. لطفاً برای نحوه استفاده از این برچسب به مشخصات TIFF مراجعه کنید. مقدار پیش‌فرض ۴ است.

tiff:ignore-tags=<tags>


اگر کلید tiff:ignore-tags تعریف شود، به عنوان فهرستی از مقادیر صحیح برچسب‌های TIFF جداشده با کاما برای نادیده گرفتن در هنگام خواندن فایل TIFF استفاده می‌شود. این ویژگی برای امکان خواندن فایل‌هایی که در غیر این صورت به دلیل مشکلاتی در برچسب‌های TIFF با شکست مواجه می‌شوند، مفید است. توجه داشته باشید که برخی از برچسب‌های TIFF برای اینکه بتوان داده‌های تصویر را خواند، کاملاً ضروری هستند.

tiff:lerc-maxzerror=<value>


هنگامی که فشرده‌سازی LERC انتخاب شده باشد (از طریق `-compress lerc`)، حداکثر خطای ممیز شناور مجاز برای فشرده‌سازی با اتلاف را مشخص می‌کند (مثلاً 0.5). مقدار پیش‌فرض فشرده‌سازی 0 (بدون اتلاف) است.

tiff:lerc-compression={1|deflate|zip|2|zstd}


پس از انجام فشرده‌سازی LERC، یک مرحله فشرده‌سازی دوم اختیاری با استفاده از فشرده‌سازی Deflate یا Zstd می‌تواند انجام شود. برای استفاده از فشرده‌سازی Deflate مقدار 1، deflate یا zip، و برای استفاده از فشرده‌سازی Zstd مقدار 2 یا zstd را مشخص کنید. این آرگومان به بزرگی یا کوچکی حروف حساس نیست.

tiff:lerc-zip-quality=<value>


هنگامی که فشرده‌سازی LERC فعال است و فشرده‌سازی مرحله دوم با استفاده از Deflate انتخاب شده است، مقداری در محدوده ۱ تا ۱۲ را برای مشخص کردن سطح فشرده‌سازی Deflate ارائه دهید (مقدار بزرگ‌تر به معنای فشرده‌سازی بیشتر است). سطح پیش‌فرض برای فشرده‌سازی Deflate مقدار ۶ است.

tiff:lerc-zstd-level=<value>


هنگامی که فشرده‌سازی LERC فعال است و فشرده‌سازی مرحله دوم با استفاده از Zstd انتخاب شده است، مقداری بین ۱ و ۱۹ (یا ۲۲ با مصرف حافظه بسیار بیشتر) را برای تعیین سطح فشرده‌سازی Zstd ارائه دهید (مقدار بزرگ‌تر به معنای فشرده‌سازی بیشتر است). سطح پیش‌فرض برای فشرده‌سازی Zstd مقدار ۳ است.

tiff:photometric={minisblack|miniswhite}


برای تصاویر مقیاس خاکستری و دوسطحی، برنامه GraphicsMagick معمولاً نورسنجی (photometric) را بر اساس عمق بیت و فشرده‌سازی انتخاب می‌کند. اگر کلید tiff:photometric تعریف شود، GraphicsMagick از آن برای تعیین نورسنجی مورد استفاده هنگام نوشتن تصاویر مقیاس خاکستری و دوسطحی استفاده خواهد کرد. معمولاً تصاویر دوسطحی miniswhite و تصاویر مقیاس خاکستری minisblack هستند.

tiff:report-warnings={false|true}


اگر کلید tiff:report-warnings تعریف شده و روی true تنظیم شود، هشدارهای TIFF به عنوان یک استثنای هشدار به جای پیام لاگ رمزگذار گزارش می‌شوند. چنین هشدارهایی پس از خوانده شدن یا نوشته شدن تصویر گزارش می‌شوند. بیشتر هشدارهای TIFF بی‌خطر هستند اما گاهی می‌توانند به شناسایی مشکلات فایل TIFF کمک کنند، یا به تشخیص اینکه فایل TIFF به دلیل استفاده از افزونه‌های اختصاصی یا تخصصی برای خوانده شدن موفقیت‌آمیز به یک برنامه ویژه نیاز دارد، یاری رسانند.

tiff:sample-format={unsigned|ieeefp}


اگر کلید tiff:sample-format تعریف شود، GraphicsMagick از آن برای تعیین قالب نمونه مورد استفاده در هنگام نوشتن فایل‌های TIFF استفاده خواهد کرد. پیش‌فرض "unsigned" است. برای نوشتن فایل‌های TIFF ممیز شناور با مقادیر float (۳۲ بیتی) یا double (۶۴ بیتی)، مقدار "ieeefp" را مشخص کنید. از تعریف tiff:bits-per-sample برای تعیین نوع مقدار ممیز شناور مورد استفاده بهره ببرید.

tiff:max-sample-value=<value>


اگر کلید tiff:max-sample-value تعریف شود، GraphicsMagick از مقدار اختصاص‌یافته به عنوان حداکثر مقدار ممیز شناور هنگام خواندن یا نوشتن TIFFهای ممیز شناور IEEE استفاده خواهد کرد. در غیر این صورت مقدار حداکثر 1.0 یا مقدار به‌دست‌آمده از برچسب SMaxSampleValue فایل (در صورت وجود) است. داده‌های ممیز شناور در حال حاضر از قبل برای تعیین بهترین مقدار نمونه حداکثری پویش نمی‌شوند، بنابراین اگر محدوده 1.0 نباشد یا برچسب SMaxSampleValue وجود نداشته باشد، ممکن است لازم باشد (به صورت هوشمندانه) از این پارامتر برای خواندن صحیح یک فایل استفاده کنید.

tiff:min-sample-value=<value>


اگر کلید tiff:min-sample-value تعریف شود، GraphicsMagick از مقدار اختصاص‌یافته به عنوان حداقل مقدار ممیز شناور هنگام خواندن یا نوشتن TIFFهای ممیز شناور IEEE استفاده خواهد کرد. در غیر این صورت مقدار حداقل 0.0 یا مقدار به‌دست‌آمده از برچسب SMinSampleValue فایل (در صورت وجود) خواهد بود.

tiff:bits-per-sample=<value>


اگر کلید tiff:bits-per-sample تعریف شود، GraphicsMagick تصاویر را با بیت‌های مشخص‌شده در هر نمونه می‌نویسد و هرگونه مقدار عمق موجود را نادیده می‌گیرد. مقدار می‌تواند هر عددی در محدوده ۱ تا ۳۲ یا هنگام نوشتن قالب پیش‌فرض ´unsigned' برابر با ۶۴ باشد، یا در صورت نوشتن قالب IEEEFP برابر با 16/32/24/64 باشد. لطفاً توجه داشته باشید که مشخصات پایه TIFF 6.0 تنها خواننده‌ها را ملزم می‌کند که توان‌های خاصی از دو را مدیریت کنند، و مقادیری که باید مدیریت شوند به ماهیت تصویر بستگی دارند (مانند نقشه‌رنگی، مقیاس خاکستری، RGB، CMYK).

tiff:samples-per-pixel=<value>


اگر کلید tiff:samples-per-pixel روی مقداری تعریف شود، رمزگذار TIFF تصاویر TIFF را با نمونه‌های تعریف‌شده در هر پیکسل می‌نویسد و هرگونه مقدار ذخیره‌شده در تصویر را نادیده می‌گیرد. این گزینه معمولاً نباید استفاده شود.

tiff:rows-per-strip=<value>


به کاربر اجازه می‌دهد تعداد سطرها در هر نوار (strip) TIFF را مشخص کند. هنگام استفاده از فشرده‌سازی JPEG، به مضربی از ۱۶ به سمت بالا گرد می‌شود. در صورت استفاده از کاشی‌ها نادیده گرفته می‌شود.

tiff:strip-per-page=true


درخواست می‌کند که تصویر در یک نوار TIFF تکی نوشته شود. این معمولاً در زمانی که فشرده‌سازی group3 یا group4 در محدوده‌های معقول درخواست شود پیش‌فرض است. درخواست یک نوار منفرد برای تصاویر بزرگ ممکن است به دلیل مصرف منابع در نویسنده یا خواننده منجر به شکست شود.

tiff:tile


نوشتن TIFF کاشی‌کاری‌شده (به جای نواری) را با استفاده از اندازه پیش‌فرض کاشی فعال می‌کند. TIFF کاشی‌کاری‌شده تصویر را به صورت آرایه‌ای از تصاویر کوچک‌تر (کاشی‌ها) سازمان‌دهی می‌کند تا امکان دسترسی تصادفی فراهم شود.

tiff:tile-geometry=<width>x<height>


اندازه کاشی مورد استفاده هنگام نوشتن TIFF کاشی‌کاری‌شده را مشخص می‌کند. عرض و ارتفاع باید مضربی از ۱۶ باشند. اگر مقدار مضربی از ۱۶ نباشد، به سمت پایین گرد می‌شود. در صورتی که TIFF کاشی‌کاری‌شده قبلاً فعال نشده باشد، آن را فعال می‌کند. برنامه GraphicsMagick در داخل خود از ذخیره‌سازی کاشی‌کاری‌شده استفاده نمی‌کند، بنابراین کاشی‌ها باید از ذخیره‌سازی خط‌روبشی (scanline) داخلی به ذخیره‌سازی کاشی‌محور و برعکس تبدیل شوند. آزمایش با تصاویر معمولی RGB نشان می‌دهد که مقادیر اندازه کاشی مربعیِ کاربردی بین 128x128 تا 1024x1024 متغیر است. تصاویر بزرگی که نیازمند استفاده از حافظه پنهان پیکسل مبتنی بر دیسک هستند از اندازه‌های بزرگ کاشی بهره می‌برند، در حالی که تصاویری که در حافظه رم جا می‌شوند با اندازه‌های کوچک‌تر کاشی به خوبی کار می‌کنند.

tiff:tile-width=<width>


عرض کاشی مورد استفاده هنگام نوشتن TIFF کاشی‌کاری‌شده را مشخص می‌کند. سپس ارتفاع کاشی به‌طور پیش‌فرض به اندازه‌ای مناسب تنظیم می‌شود. عرض باید مضربی از ۱۶ باشد. اگر مقدار مضربی از ۱۶ نباشد، به سمت پایین گرد خواهد شد. در صورت عدم فعال بودن قبلی، TIFF کاشی‌کاری‌شده را فعال می‌کند.

tiff:tile-height=<height>


ارتفاع کاشی مورد استفاده هنگام نوشتن TIFF کاشی‌کاری‌شده را مشخص می‌کند. سپس عرض کاشی به‌طور پیش‌فرض به اندازه‌ای مناسب تنظیم می‌شود. ارتفاع باید مضربی از ۱۶ باشد. اگر مقدار مضربی از ۱۶ نباشد، به سمت پایین گرد خواهد شد. در صورت عدم فعال بودن قبلی، TIFF کاشی‌کاری‌شده را فعال می‌کند.

tiff:webp-lossless={TRUE|FALSE}


برای فعال‌سازی حالت بدون اتلاف هنگام نوشتن فایل‌های TIFF با فشرده‌سازی WebP، مقدار TRUE را مشخص کنید. گزینه WebP یعنی webp:lossless نیز می‌تواند استفاده شود. ضریب کیفیتی که توسط گزینه -quality تنظیم می‌شود می‌تواند برای تأثیرگذاری بر سطح تلاش صرف‌شده هنگام فشرده‌سازی استفاده شود.

tiff:zstd-compress-level=<value>


سطح فشرده‌سازی مورد استفاده هنگام نوشتن فایل‌های TIFF با فشرده‌سازی Zstd را مشخص می‌کند. محدوده معتبر ۱ تا ۲۲ است. اگر این تعریف مشخص نشود، از مقدار 'quality' استفاده می‌شود، به طوری که تنظیم پیش‌فرض کیفیت یعنی ۷۵ به سطح فشرده‌سازی ۹ ترجمه می‌شود، به نحوی که ´quality' در صورت استفاده برای این منظور دارای محدوده کاربردی ۱۰-۱۸۴ خواهد بود.

webp:exact={true|false}


حفظ مقادیر دقیق RGB در زیر نواحی شفاف. پیش‌فرض false است.

webp:lossless={true|false}


فعال‌سازی رمزگذاری بدون اتلاف. همچنین حالت 'exact' را فعال می‌کند.

webp:method={0-6}


موازنه کیفیت/سرعت.

webp:image-hint={default,graph,photo,picture}


راهنمایی برای تعیین نوع تصویر.

webp:target-size=<integer>


اندازه هدف بر حسب بایت.

webp:target-psnr=<float>


حداقل اعوجاج برای تلاش در جهت دستیابی.

webp:segments={1-4}


حداکثر تعداد قطعه‌ها (segments) برای استفاده.

webp:sns-strength={0-100}


شکل‌دهی مکانی نویز (Spatial Noise Shaping).

webp:filter-strength={0-100}


قدرت فیلتر.

webp:filter-sharpness={0-7}


وضوح فیلتر.

webp:filter-type={0,1}


نوع فیلترسازی. 0 = ساده، 1 = قوی (تنها در صورتی استفاده می‌شود که filter-strength > 0 باشد یا autofilter فعال باشد).

webp:auto-filter={true|false}


تنظیم خودکار قدرت فیلتر.

webp:alpha-compression=<integer>


الگوریتم رمزگذاری صفحه آلفا (0 = هیچ، 1 = فشرده‌شده با WebP بدون اتلاف). پیش‌فرض 1 است.

webp:alpha-filtering=<integer>


روش فیلترسازی پیش‌بینانه برای صفحه آلفا. 0: هیچ، 1: سریع، 2: بهترین. پیش‌فرض 1 است.

webp:alpha-quality={0-100}


بین 0 (کوچک‌ترین اندازه) و 100 (بدون اتلاف). پیش‌فرض 100 است.

webp:pass=[1..10]


تعداد دفعات پویش تحلیل آنتروپی.

webp:show-compressed={true|false}


صادر کردن مجدد تصویر فشرده‌شده به بیرون. فیلترسازی درون‌حلقه‌ای اعمال نمی‌شود.

webp:preprocessing=[0,1,2]


0=هیچ، 1=هموارسازی قطعه، 2=دیترینگ شبه‌تصادفی

webp:partitions=[0-3]


log2(تعداد افرازهای توکن) در [0..3]. پیش‌فرض جهت رمزگشایی پیش‌رونده آسان‌تر 0 است.

webp:partition-limit={0-100}


افت کیفیت مجاز برای جای‌گیری در محدودیت 512k روی کدگذاری حالت‌های پیش‌بینی (0: بدون افت، 100: بیشترین افت ممکن).

webp:emulate-jpeg-size={true|false}


اگر true باشد، پارامترهای فشرده‌سازی دوباره نگاشت می‌شوند تا با اندازه خروجی مورد انتظار از فشرده‌سازی JPEG تطابق بهتری داشته باشند. به‌طور کلی، اندازه خروجی مشابه خواهد بود اما میزان افت کیفیت کمتر است.

webp:thread-level=<integer>


اگر غیرصفر باشد، برای استفاده از رمزگذاری چندنخی تلاش می‌کند.

webp:low-memory={true|false}


در صورت تنظیم، مصرف حافظه را کاهش می‌دهد (اما مصرف CPU را افزایش می‌دهد)

webp:use-sharp-yuv={true|false}


در صورت تنظیم، در صورت نیاز از تبدیل دقیق (و کند) RGB->YUV استفاده می‌کند

برای مثال، جهت ایجاد یک فایل postscript که تنها پیکسل‌های سیاه یک تصویر دوسطحی را رسم می‌کند، از دستور زیر استفاده کنید:

    gm convert bilevel.tif -define ps:imagemask eps3:stencil.ps
-delay <1/100ths of a second> 
نمایش تصویر بعدی پس از مکث
این گزینه برای تنظیم پویانمایی توالی تصاویر مفید است.
پیش از نمایش تصویر بعدی باید Delay/100 ثانیه سپری شود. حالت پیش‌فرض
بدون تاخیر بین هر بار نمایش توالی تصویر است. بیشینه تاخیر 65535 است.
می‌توانید یک بازه تاخیر مشخص کنید (مثلاً -delay 10-500) که
حداقل و حداکثر تاخیر را تعیین می‌کند.

-density <width>x<height>

تفکیک‌پذیری افقی و عمودی تصویر بر حسب پیکسل
این گزینه تفکیک‌پذیری تصویر را جهت ذخیره‌سازی هنگام کدگذاری یک تصویر
شطرنجی یا تفکیک‌پذیری بوم را هنگام رندر کردن (خواندن) قالب‌های
برداری مانند Postscript، PDF، WMF و SVG به یک تصویر شطرنجی مشخص می‌کند.
تفکیک‌پذیری تصویر، واحد اندازه‌گیری مورد استفاده هنگام رندر کردن روی یک
دستگاه خروجی یا تصویر شطرنجی را فراهم می‌کند. واحد اندازه‌گیری پیش‌فرض
نقطه در اینچ (DPI) است. از گزینهٔ -units می‌توان برای انتخاب
نقطه در سانتی‌متر به جای آن استفاده کرد.
 تفکیک‌پذیری پیش‌فرض 72 نقطه در اینچ است که معادل یک پوینت به ازای هر پیکسل
است (استاندارد Macintosh و Postscript). صفحه‌نمایش‌های رایانه معمولاً
72 یا 96 نقطه در اینچ هستند در حالی که چاپگرها معمولاً از 150، 300، 600
یا 1200 نقطه در اینچ پشتیبانی می‌کنند. برای تعیین تفکیک‌پذیری نمایشگر خود،
با خط‌کش عرض صفحه‌نمایش را بر حسب اینچ اندازه گرفته و بر تعداد پیکسل‌های
افقی تقسیم کنید (1024 در یک نمایشگر 1024x768).
اگر قالب فایل پشتیبانی کند، می‌توان از این گزینه برای به‌روزرسانی
تفکیک‌پذیری ذخیره‌شدهٔ تصویر استفاده کرد. توجه داشته باشید که Photoshop
تفکیک‌پذیری تصویر را در یک نمایهٔ اختصاصی جاسازی‌شده ذخیره و دریافت
می‌کند. اگر این نمایه از تصویر حذف نشود، Photoshop همچنان با تصویر با استفاده
از تفکیک‌پذیری پیشین آن رفتار خواهد کرد و تفکیک‌پذیری مشخص‌شده در سرآیند
استاندارد فایل را نادیده می‌گیرد.
گزینهٔ density یک صفت است و تصویر شطرنجی زیرین را تغییر نمی‌دهد.
می‌توان از آن برای تنظیم اندازه رندرشده برای اهداف نشر رومیزی با تنظیم
مقیاس اعمال‌شده بر پیکسل‌ها استفاده کرد. برای تغییر اندازهٔ تصویر به‌گونه‌ای
که در یک تفکیک‌پذیری دیگر همان اندازه را داشته باشد، از گزینهٔ -resample
استفاده کنید.

-depth <value>

عمق تصویر
این مقدار تعداد بیت‌های رنگی است که باید در تصویر حفظ شوند. هر مقداری
بین 1 و QuantumDepth (گزینه ساخت) می‌تواند مشخص شود،
هرچند 8 یا 16 رایج‌ترین مقادیر هستند. از این گزینه برای مشخص کردن عمق
تصاویر خام که عمق آن‌ها ناشناخته است مانند GRAY، RGB یا CMYK،
یا برای تغییر عمق هر تصویری پس از خوانده شدن آن استفاده کنید.
برای روشی (از طریق '-operator All Depth N') جهت اعمال فوری محدودیت
عمق به پیکسل‌ها به جای تنظیم یک صفت تصویر، گزینهٔ -operator را ببینید.

-descend

به‌دست آوردن تصویر با پیمایش سلسله‌مراتب پنجره به پایین

-despeckle

کاهش لکه‌ها و نویزهای نقطه‌ای در یک تصویر

-displace <horizontal scale>x<vertical scale>

تغییر مکان پیکسل‌های تصویر مطابق با تعریف یک نگاشت جابه‌جایی
با این گزینه، composite image به عنوان یک نگاشت جابه‌جایی استفاده می‌شود. رنگ سیاه
در نگاشت جابه‌جایی، بیشینه جابه‌جایی مثبت است. رنگ سفید بیشینه جابه‌جایی
منفی بوده و خاکستری میانه خنثی است. جابه‌جایی مقیاس‌بندی می‌شود تا
میزان تغییر مکان پیکسل تعیین گردد. به‌طور پیش‌فرض، جابه‌جایی در هر دو
جهت افقی و عمودی اعمال می‌شود. با این حال، اگر mask را مشخص کنید،
composite image جابه‌جایی افقی X و mask جابه‌جایی عمودی Y خواهد بود.

-display <host:display[.screen]>

مشخص کردن کارساز X برای ارتباط
این گزینه همراه با convert برای دریافت تصویر یا قلم از این کارساز X
استفاده می‌شود. X(1) را ببینید.

-dispose <method>

روش دور انداختن در GIF
روش دور انداختن، نحوهٔ رفتار با گرافیک پس از نمایش داده شدن را نشان می‌دهد.
روش‌های معتبر عبارتند از:
    Undefined       عدم تعیین دور انداختن.
    None            عدم دور انداختن بین فریم‌ها.
    Background      بازنویسی ناحیه تصویر با
                    رنگ پس‌زمینه.
    Previous        بازنویسی ناحیه تصویر با
                    آنچه پیش از رندر تصویر
                    در آنجا بود.

-dissolve <percent>

محو/ترکیب کردن یک تصویر در تصویر دیگر با درصد داده‌شده

کدری (opacity) تصویر مرکب در درصد داده‌شده ضرب می‌شود و سپس بر روی تصویر اصلی ترکیب می‌گردد.

-dither

اعمال انتشار خطای Floyd/Steinberg بر روی تصویر

راهبرد اساسی dithering، تبادل تفکیک‌پذیری شدت با تفکیک‌پذیری مکانی از طریق میانگین‌گیری از شدت‌های چندین پیکسل مجاور است. تصاویری که هنگام کاهش رنگ دچار نواربندی یا خطوط تراز شدید (contouring) می‌شوند، می‌توانند با این گزینه بهبود یابند.

گزینهٔ -colors یا -monochrome برای اعمال اثر این گزینه الزامی است.

از +dither برای خاموش کردن dithering و رندر کردن PostScript بدون پله‌ای شدن (aliasing) متن یا گرافیک استفاده کنید. غیرفعال کردن dithering اغلب (اما نه همیشه) منجر به کاهش زمان پردازش می‌شود.

-draw <string>

حاشیه‌نویسی یا ترسیم روی تصویر با یک یا چند عنصر اولیّهٔ گرافیکی

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

point           x,y
line            x0,y0 x1,y1
rectangle       x0,y0 x1,y1
roundRectangle  x0,y0 x1,y1 wc,hc
arc             x0,y0 x1,y1 a0,a1
ellipse         x0,y0 rx,ry a0,a1
circle          x0,y0 x1,y1
polyline        x0,y0  ...  xn,yn
polygon         x0,y0  ...  xn,yn
Bezier          x0,y0  ...  xn,yn
path            path specification
image           operator x0,y0 w,h filename

عنصر اولیهٔ متن عبارت است از:

text            x0,y0 string

عنصر اولیهٔ جاذبه متن عبارت است از:

gravity         NorthWest, North, NorthEast, West, Center,
                East, SouthWest, South, or SouthEast

عنصر اولیهٔ جاذبه متن تنها بر جای‌گذاری متن اثر می‌گذارد و با سایر عناصر اولیه تداخلی ندارد. این مورد معادل استفاده از گزینهٔ خط فرمان -gravity است، با این تفاوت که دامنهٔ اثر آن به گزینهٔ -draw که در آن ظاهر شده محدود می‌شود.

عناصر اولیه تبدیل عبارتند از:

rotate          degrees
translate       dx,dy
scale           sx,sy
skewX           degrees
skewY           degrees

عناصر اولیه عملیات پیکسلی عبارتند از:

color           x0,y0 method
matte           x0,y0 method

عناصر اولیه شکل با رنگ مشخص‌شده در گزینهٔ -stroke پیشین رسم می‌شوند. به‌جز عناصر اولیهٔ line و point، آن‌ها با رنگ مشخص‌شده در گزینهٔ -fill پیشین پر می‌شوند. برای اشکال بدون پرشدگی، از -fill none استفاده کنید.

عنصر Point به یک مختصات نیاز دارد.

عنصر Line به یک مختصات شروع و پایان نیاز دارد.

عنصر Rectangle مختصات بالا-چپ و پایین-راست را انتظار دارد.

عنصر RoundRectangle مختصات بالا-چپ و پایین-راست و پهنا و ارتفاع گوشه‌ها را دریافت می‌کند.

عنصر Circle یک مختصات مرکز و یک مختصات برای لبهٔ بیرونی دارد.

از Arc برای محاط کردن یک کمان بیضوی درون یک مستطیل استفاده کنید. کمان‌ها به نقطه شروع و پایان و همچنین درجه چرخش نیاز دارند (مانند 130,30 200,100 45,90).

از Ellipse برای ترسیم یک بیضی ناقص به مرکزیت نقطه داده‌شده، همراه با شعاع محور x و محور y و شروع و پایان کمان بر حسب درجه استفاده کنید (مانند 100,100 100,150 0,360).

در نهایت، polyline و polygon برای تعریف مرزهای خود به سه یا چند مختصات نیاز دارند. مختصات‌ها اعداد صحیحی هستند که با یک ویرگول اختیاری جدا می‌شوند. برای مثال، برای تعریف دایره‌ای با مرکز در 100,100 که تا 150,150 گسترش می‌یابد از دستور زیر استفاده کنید:

-draw 'circle 100,100 150,150'

عنصر Paths (بخش Paths را ببینید) نمایانگر طرح کلی یک شیء است که بر حسب عناصر moveto (تعیین یک نقطه جاری جدید)، lineto (رسم یک خط راست)، curveto (رسم یک منحنی با بزیه درجه سه)، arc (کمان بیضوی یا دایره‌ای) و closepath (بستن شکل جاری با رسم خط به آخرین moveto) تعریف می‌شود. مسیرهای مرکب (یعنی مسیری با زیرمسیرها که هرکدام شامل یک moveto منفرد و در ادامه یک یا چند عملیات خط یا منحنی هستند) برای ایجاد جلوه‌هایی نظیر “سوراخ‌های دونات” در اشیاء امکان‌پذیر هستند.

از image برای ترکیب یک تصویر با تصویری دیگر استفاده کنید. پس از کلیدواژهٔ image، عملگر ترکیب، مکان تصویر، اندازه تصویر، و نام فایل می‌آید:

-draw 'image Over 100,100 225,225 image.jpg'

می‌توانید از 0,0 برای اندازه تصویر استفاده کنید، که به معنی استفاده از ابعاد واقعی موجود در سرآیند تصویر است. در غیر این صورت، به ابعاد داده‌شده مقیاس‌بندی خواهد شد. برای شرح عملگرهای ترکیب، -compose را ببینید.

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

برای مثال،

     -draw 'text 100,100 "%m:%f %wx%h"'
تصویر را با MIFF:bird.miff 512x480 برای تصویری با عنوان bird.miff
و پهنای 512 و ارتفاع 480 حاشیه‌نویسی می‌کند.
اگر نخستین نویسهٔ string نویسهٔ @ باشد، متن از فایلی خوانده می‌شود که
نام آن نویسه‌های باقی‌مانده در رشته است. لطفاً توجه داشته باشید که اگر رشته
از یک منبع غیرقابل‌اعتماد باشد، باید پیش از استفاده پاک‌سازی شود (یک ریسک امنیتی).
عنصر Rotate عناصر اولیه شکل و متن بعدی را حول مبدأ تصویر اصلی
می‌چرخاند. اگر گزینهٔ -region پیش از گزینهٔ -draw بیاید، مبدأ
تبدیلات گوشهٔ بالا-چپ ناحیه خواهد بود.
عنصر Translate آن‌ها را جابه‌جا (انتقال) می‌کند.
عنصر Scale آن‌ها را مقیاس‌بندی می‌کند.
عناصر SkewX و SkewY آن‌ها را نسبت به مبدأ تصویر اصلی یا
ناحیه مورب می‌کنند.
تبدیلات، ماتریس آفین جاری را تغییر می‌دهند که از ماتریس آفین اولیّهٔ
تعریف‌شده توسط گزینهٔ -affine مقداردهی اولیه شده است.
تبدیلات در درون گزینهٔ -draw تجمعی هستند.
ماتریس آفین اولیه دست‌نخورده می‌ماند؛ آن ماتریس تنها با ظاهر شدن
یک گزینهٔ -affine دیگر تغییر می‌کند. اگر گزینهٔ -draw دیگری
ظاهر شود، ماتریس آفین جاری مجدداً از ماتریس آفین اولیه مقداردهی خواهد شد.
از color برای تغییر رنگ یک پیکسل به رنگ پرکردن استفاده کنید (گزینهٔ
-fill را ببینید). پس از مختصات پیکسل یک روش می‌آید:
     point
     replace
     floodfill
     filltoborder
     reset

پیکسل هدف را همان پیکسلی در نظر بگیرید که توسط مختصات شما مشخص شده است. روش point پیکسل هدف را مجدداً رنگ‌آمیزی می‌کند. روش replace هر پیکسلی را که با رنگ پیکسل هدف تطابق داشته باشد مجدداً رنگ‌آمیزی می‌کند. روش Floodfill هر پیکسلی را که با رنگ پیکسل هدف تطابق داشته و همسایهٔ آن باشد مجدداً رنگ‌آمیزی می‌کند، در حالی که filltoborder هر پیکسل همسایه‌ای را که رنگ حاشیه نباشد مجدداً رنگ‌آمیزی می‌کند. در نهایت، reset همهٔ پیکسل‌ها را مجدداً رنگ‌آمیزی می‌نماید.

از matte برای تغییر مقدار مات پیکسل به شفاف استفاده کنید. پس از مختصات پیکسل یک روش قرار می‌گیرد (برای شرح روش‌ها به عنصر اولیهٔ color مراجعه کنید). روش point مقدار مات پیکسل هدف را تغییر می‌دهد. روش replace مقدار مات هر پیکسلی را که با رنگ پیکسل هدف تطابق دارد تغییر می‌دهد. روش Floodfill مقدار مات هر پیکسلی را که با رنگ پیکسل هدف یکسان بوده و همسایهٔ آن است تغییر می‌دهد، در حالی که filltoborder مقدار مات هر پیکسل همسایه‌ای را که رنگ حاشیه (-bordercolor) نباشد تغییر می‌دهد. در نهایت reset مقدار مات تمام پیکسل‌ها را تغییر می‌دهد.

می‌توانید رنگ عنصر اولیه، قلم، و رنگ جعبهٔ احاطه‌کنندهٔ قلم را به ترتیب با -fill، -font و -box تعیین کنید. گزینه‌ها به ترتیب خط فرمان پردازش می‌شوند، بنابراین مطمئن شوید که از این گزینه‌ها پیش از گزینهٔ -draw استفاده می‌کنید..TP -edge <radius> تشخیص لبه‌ها درون یک تصویر

-emboss <radius>

برجسته‌سازی تصویر

-encoding <type>

تعیین رمزگذاری متن

از میان موارد زیر انتخاب کنید: AdobeCustom, AdobeExpert, AdobeStandard, AppleRoman, BIG5, GB2312, Latin 2, None, SJIScode, Symbol, Unicode, Wansung.

-endian <type>

تعیین ترتیب بایت (MSB، LSB یا Native) تصویر

MSB نشان‌دهنده ترتیب بزرگ‌بایتی (مانند SPARC، Motorola 68K) است در حالی که LSB نشان‌دهنده ترتیب کوچک‌بایتی (مانند Intel 'x86، VAX) است. Native بیانگر استفاده از ترتیب بایت پیش‌فرض برای پردازنده (CPU) فعلی است. این گزینه در حال حاضر تنها بر قالب‌های CMYK، DPX، GRAY، RGB و TIFF تأثیر می‌گذارد.

برای بازگشت به ترتیب بایت نامشخص از +endian استفاده کنید.

-enhance

اعمال یک فیلتر دیجیتال برای بهبود تصویر نویزدار

-equalize

اجرای متعادل‌سازی هیستوگرام روی تصویر

-extent <width>x<height>{+-}<x>{+-}<y>

ترکیب تصویر روی یک تصویر بوم با رنگ پس‌زمینه

این گزینه تصویر را روی یک بوم جدید با رنگ پس‌زمینه (-background) و به ابعاد <width>x<height> ترکیب می‌کند. محتوای تصویر موجود در موقعیتی که توسط آفست‌های هندسی x و y یا جهت‌گیری مورد نظر (-gravity) مشخص شده، با استفاده از روش ترکیب تصویر فعلی (-compose) قرار می‌گیرد. بخش‌هایی از تصویر که خارج از ابعاد تصویر جدید قرار بگیرند، دور ریخته می‌شوند.

برای مثال، دستور زیر یک بندانگشتی از تصویر ساخته و آن را در مرکز یک تصویر پس‌زمینه قرمز قرار می‌دهد، در حالی که بوم را با توجه به بندانگشتی، ده پیکسل به چپ و پنج پیکسل به بالا منتقل می‌کند:

gm convert infile.jpg -thumbnail 120x80 -background red -gravity center \
          -extent 140x100-10-5 outfile.jpg

این دستور یک تصویر JPEG را جهت تناسب با یک نمایشگر 800x600 کوچک یا بزرگ می‌کند:

gm convert -size 800x600 input.jpg \
          -resize 800x600 -background black \
          -compose Copy -gravity center \
          -extent 800x600 \
          -quality 92 output.jpg

اگر نسبت ابعاد تصویر ورودی دقیقاً 4:3 نباشد، تصویر در مرکز یک بوم سیاه 800x600 قرار داده می‌شود.

-file <filename>

نوشتن تصویر تفاضلی نشانه‌گذاری‌شده در فایل

اگر -file تعیین شده باشد، یک تصویر تفاضلی نشانه‌گذاری‌شده تولید شده و در فایل مشخص‌شده ذخیره می‌شود. پیکسل‌هایی که میان تصاویر reference و compare متفاوت هستند، در تصویر compare اصلاح می‌شوند تا تغییرات واضح‌تر به چشم بیایند. ممکن است در برخی تصاویر پیش از آشکار شدن تغییرات، نیاز به استفاده از یک سبک برجسته‌سازی دیگر (ببینید -highlight-style) یا رنگ برجسته‌سازی دیگر (ببینید -highlight-color) باشد.

-fill <color>

رنگ مورد استفاده برای پر کردن یک عنصر گرافیکی اولیه تعریف‌های عددی رنگ‌ها در GraphicsMagick مشابه مقادیر رنگی RGB و RGBA است که در SVG و CSS Color Module Level 3 استفاده می‌شوند (https://www.w3.org/TR/css-color-3/#numerical). برای مشاهده فهرست نام‌های رنگ از دستور "gm convert -list color"; استفاده کنید:

name                              (named color)
#RGB                              (hex numbers, 4 bits each)
#RRGGBB                           (8 bits each)
#RRRGGGBBB                        (12 bits each)
#RRRRGGGGBBBB                     (16 bits each)
#RRRRRRRRGGGGGGGGBBBBBBBB         (32 bits each)
#RGBA                             (4 bits each)
#RRGGBBAA                         (8 bits each)
#RRRRRRGGGGGGBBBBBB               (12 bits each)
#RRRRRRRRGGGGGGGGBBBBBBBBAAAAAAAA (32 bits each)
rgb(r,g,b)                        (r,g,b are decimal numbers, range 0 to QuantumDepth)
rgb(r%,g%,b%)                     (r,g,b are decimal numbers, range 0 to 100%)
rgba(r,g,b,a)                     (r,g,b,a are decimal numbers, range 0 to QuantumDepth)
rgba(r%,g%,b%,a%)                 (r,g,b,a are decimal numbers, range 0 to 100%)

مشخصه رنگ را داخل علامت نقل‌قول قرار دهید تا از تفسیر "#" یا پرانتزها توسط شل جلوگیری شود.

برای مثال،

gm convert -fill blue ...
gm convert -fill "#ddddff" ...
gm convert -fill "rgb(65000,65000,65535)" ...

حالت‌های کوتاه‌تر، در صورت نیاز با تکرار ارقام به ابعاد بزرگ‌تر بسط داده می‌شوند. برای مثال، مقادیر #3af، #33aaff و #3333aaaaffff همگی معادل یکدیگرند.

برای جزئیات بیشتر به -draw مراجعه کنید.

-filter <type>

استفاده از این نوع فیلتر هنگام تغییر اندازه تصویر

از این گزینه برای تأثیرگذاری بر عملیات تغییر اندازه تصویر استفاده کنید (ببینید -geometry). از میان فیلترهای زیر انتخاب کنید (به ترتیب تقریبی افزایش زمان مصرف CPU):

Point
Box
Triangle
Hermite
Hanning
Hamming
Blackman
Gaussian
Quadratic
Cubic
Catrom
Mitchell
Lanczos
Bessel
Sinc

فیلتر پیش‌فرض به‌صورت خودکار انتخاب می‌شود تا بهترین کیفیت را با صرف زمانی معقول ارائه دهد. اگر تصویر از پالت رنگ یا کانال شفافیت (matte) پشتیبانی کند یا در حال بزرگ‌نمایی باشد، از فیلتر Mitchell استفاده می‌شود؛ در غیر این صورت از فیلتر Lanczos استفاده خواهد شد.

-flatten

مسطح‌سازی (تخت‌کردن) دنباله‌ای از تصاویر

در برخی قالب‌های پرونده (مانند PSD فتوشاپ)، ممکن است تصاویر پیچیده توسط «لایه‌ها» (تصاویر مجزا) نمایش داده شوند که برای دستیابی به خروجی نهایی باید با هم ترکیب شوند. گزینه -flatten این ترکیب را به انجام می‌رساند. دنباله تصاویر با یک تصویر تکی که حاصل ترکیب نوبتی هر تصویر با رعایت عملگرهای ترکیب و آفست‌های صفحه است جایگزین می‌شود. اگرچه -flatten در اصل برای حذف لایه‌ها به کار می‌رود، اما به عنوان ابزاری همه‌منظوره برای ترکیب تصاویر نیز سودمند است.

دنباله تصاویر با ظاهر شدن هر گزینه‌ای خاتمه می‌یابد. اگر گزینه -flatten پس از تمام تصاویر ورودی آورده شود، همه تصاویر تخت می‌شوند. همچنین گزینه -mosaic را ببینید که مشابه -flatten عمل می‌کند اما یک تصویر بوم پایه با اندازه مناسب نیز به آن اضافه می‌نماید.

برای مثال، این دستور یک تصویر را روی یک بوم سیاه شفاف با اندازه 640x400 ترکیب می‌کند:

gm convert -size 640x300 xc:transparent \
          -compose over -page +0-100 \
          frame.png -flatten output.png

و این دستور یک پرونده فتوشاپ PSD را مسطح می‌کند:

gm convert input.psd -flatten output.png

-flip

ایجاد «تصویر آینه‌ای»

وارونه کردن خطوط پویش (scanlines) در راستای عمودی.

-flop

ایجاد «تصویر آینه‌ای»

وارونه کردن خطوط پویش (scanlines) در راستای افقی.

-font <name>

استفاده از این قلم هنگام نوشتن متن روی تصویر

می‌توانید نوع قلم را مشخص کنید تا تعیین شود از نوع PostScript، TrueType، یا X11 است. برای مثال، Arial.ttf یک قلم TrueType،‏ ps:helvetica یک قلم PostScript، و x:fixed یک قلم X11 است.

-foreground <color>

تعیین رنگ پیش‌زمینه

رنگ با قالبی که تحت گزینه -fill شرح داده شده است، تعیین می‌شود..TP -format <type> نوع قالب تصویر

هنگامی که با ابزار mogrify استفاده می‌شود، این گزینه هر تصویری را به قالب تصویر مشخص‌شده تبدیل خواهد کرد. برای دیدن فهرستی از انواع قالب‌های تصویر پشتیبانی‌شده توسط GraphicsMagick، به GraphicsMagick(1) مراجعه کنید یا خروجی 'gm -list format' را بررسی نمایید.

به‌طور پیش‌فرض فایل با نام اصلی خود نوشته می‌شود. با این حال، اگر پسوند نام فایل با یک قالب پشتیبانی‌شده مطابقت داشته باشد، پسوند با نوع قالب تصویر مشخص‌شده با -format جایگزین می‌شود. برای مثال، اگر tiff را به عنوان نوع قالب مشخص کنید و نام فایل تصویر ورودی image.gif باشد، نام فایل تصویر خروجی به image.tiff تبدیل می‌شود.

-format <string>

ویژگی‌های قالب‌بندی‌شده تصویر در خروجی

هنگامی که با ابزار identify یا ابزار convert (با خروجی نوشته‌شده در مشخصه فایل 'info:-') استفاده می‌شود، از این گزینه برای چاپ اطلاعات تصویر در قالبی به انتخاب خود استفاده کنید. می‌توانید با قرار دادن نویسه‌های قالب‌بندی ویژه، مواردی چون نام فایل تصویر، نوع، عرض، ارتفاع، داده‌های Exif یا سایر ویژگی‌های تصویر را در خروجی بگنجانید:

%b   اندازه فایل
%c   توضیح (comment)
%d   دایرکتوری
%e   پسوند نام فایل
%f   نام فایل
%g   ابعاد و آفست‌های صفحه
%h   ارتفاع
%i   نام فایل ورودی
%k   تعداد رنگ‌های یکتا
%l   برچسب (label)
%m   نوع قالب (magick)
%n   تعداد صحنه‌ها
%o   نام فایل خروجی
%p   شماره صفحه
%q   عمق بیتی تصویر
%r   شرح نوع تصویر
%s   شماره صحنه
%t   نام فایل بدون پسوند
%u   نام فایل موقت یکتا
%w   عرض
%x   تفکیک‌پذیری افقی
%y   تفکیک‌پذیری عمودی
%A   پشتیبانی از شفافیت
%C   نوع فشرده‌سازی
%D   روش دفع (disposal) تصویر GIF
%G   عرض و ارتفاع اصلی
%H   ارتفاع صفحه
%M   مشخصات نام فایل اصلی
%O   آفست صفحه (x,y)
%P   ابعاد صفحه (عرض،ارتفاع)
%Q   کیفیت فشرده‌سازی
%T   تاخیر زمانی (به صدم ثانیه)
%U   واحدهای تفکیک‌پذیری
%W   عرض صفحه
%X   آفست افقی صفحه (x)
%Y   آفست عمودی صفحه (y)
%@   کادر مرزی برش (trim bounding box)
%#   امضا (signature)
\n   خط جدید
\r   بازگشت به ابتدای سطر (carriage return)
%%   %

برای مثال،

-format "%m:%f %wx%h"

برای تصویری با نام bird.miff که عرض آن 512 و ارتفاع آن 480 است، مقدار MIFF:bird.miff 512x480 را نمایش می‌دهد.

اگر نخستین نویسه از string برابر @ باشد، قالب از فایلی خوانده می‌شود که نام آن توسط نویسه‌های باقی‌مانده در رشته تعیین می‌گردد. لطفاً توجه داشته باشید که اگر رشته از یک منبع غیرقابل‌اعتماد باشد، باید پیش از استفاده پاک‌سازی (sanitize) شود، چرا که ممکن است برای گنجاندن هر فایل قابل خواندنی روی سیستم مورد سوءاستفاده قرار گیرد (یک خطر امنیتی).

مقادیری از نوع تصویر (%r) که ممکن است بازگردانده شوند شامل موارد زیر است:

Bilevel
Grayscale
GrayscaleMatte
Palette
PaletteMatte
TrueColor
TrueColorMatte
ColorSeparation
ColorSeparationMatte
Optimize

همچنین می‌توانید از نحو قالب‌بندی ویژه زیر برای چاپ اطلاعات Exif موجود در فایل استفاده کنید:

%[EXIF:<tag>]

که در آن «<tag>» می‌تواند یکی از موارد زیر باشد:

*  (چاپ تمام برچسب‌های Exif در قالب keyword=data)
!  (چاپ تمام برچسب‌های Exif در قالب tag_number)
#hhhh (چاپ داده‌های برچسب Exif با شماره #hhhh)
ImageWidth
ImageLength
BitsPerSample
Compression
PhotometricInterpretation
FillOrder
DocumentName
ImageDescription
Make
Model
StripOffsets
Orientation
SamplesPerPixel
RowsPerStrip
StripByteCounts
XResolution
YResolution
PlanarConfiguration
ResolutionUnit
TransferFunction
Software
DateTime
Artist
WhitePoint
PrimaryChromaticities
TransferRange
JPEGProc
JPEGInterchangeFormat
JPEGInterchangeFormatLength
YCbCrCoefficients
YCbCrSubSampling
YCbCrPositioning
ReferenceBlackWhite
CFARepeatPatternDim
CFAPattern
BatteryLevel
Copyright
ExposureTime
FNumber
IPTC/NAA
ExifOffset
InterColorProfile
ExposureProgram
SpectralSensitivity
GPSInfo
ISOSpeedRatings
OECF
ExifVersion
DateTimeOriginal
DateTimeDigitized
ComponentsConfiguration
CompressedBitsPerPixel
ShutterSpeedValue
ApertureValue
BrightnessValue
ExposureBiasValue
MaxApertureValue
SubjectDistance
MeteringMode
LightSource
Flash
FocalLength
MakerNote
UserComment
SubSecTime
SubSecTimeOriginal
SubSecTimeDigitized
FlashPixVersion
ColorSpace
ExifImageWidth
ExifImageLength
InteroperabilityOffset
FlashEnergy
SpatialFrequencyResponse
FocalPlaneXResolution
FocalPlaneYResolution
FocalPlaneResolutionUnit
SubjectLocation
ExposureIndex
SensingMethod
FileSource
SceneType

اطلاعات ویژه JPEG (حاصل از خواندن یک فایل JPEG) را می‌توان به این صورت به دست آورد:

%[JPEG-<tag>]

که در آن «<tag>» می‌تواند یکی از موارد زیر باشد:

*                 (تمام برچسب‌های مرتبط با JPEG، در
                   قالب keyword=data)
Quality           تخمین «کیفیت» IJG JPEG
Colorspace        شناسه عددی فضای رنگ JPEG
Colorspace-Name   نام فضای رنگ JPEG
Sampling-factors  عوامل نمونه‌برداری JPEG

لطفاً توجه داشته باشید که JPEG هیچ مفهومی از «کیفیت» ندارد و معیار کیفیتی که توسط نرم‌افزار استفاده و تخمین زده می‌شود، بر اساس معیار کیفیت تعیین‌شده توسط IJG JPEG 6b است. سایر رمزگذارها (مانند رمزگذار استفاده‌شده در Adobe Photoshop) از معیارهای کدگذاری متفاوتی استفاده می‌کنند.

مشخصه قالب را داخل علامت نقل‌قول قرار دهید تا پوسته (shell) شما فاصله‌ها و قلاب‌ها را به اشتباه تفسیر نکند..TP -frame <width>x<height>+<outer bevel width>+<inner bevel width> احاطه کردن تصویر با یک کادر تزئینی

برای جزئیات مربوط به مشخصات هندسه (geometry)، به -geometry مراجعه کنید. گزینهٔ -frame تحت تأثیر گزینهٔ -gravity قرار نمی‌گیرد.

رنگ حاشیه با گزینهٔ خط فرمان -mattecolor مشخص می‌شود.

-frame

گنجاندن قاب پنجرهٔ X در تصویر واردشده

-fuzz <distance>{%}

رنگ‌های درون این فاصلهٔ اقلیدسی، یکسان در نظر گرفته می‌شوند

تعدادی از الگوریتم‌ها به دنبال یک رنگ هدف می‌گردند. به‌طور پیش‌فرض رنگ باید دقیقاً یکسان باشد. از این گزینه برای مطابقت دادن رنگ‌هایی استفاده کنید که در فضای سه‌بعدی RGB به رنگ هدف نزدیک هستند (بر حسب فاصلهٔ اقلیدسی). برای مثال، اگر می‌خواهید با -trim لبه‌های یک تصویر را به‌طور خودکار برش بزنید، اما تصویر اسکن شده است و رنگ پس‌زمینهٔ هدف ممکن است تفاوت اندکی داشته باشد، این گزینه می‌تواند چنین تفاوت‌هایی را به حساب آورد.

مقدار distance می‌تواند در واحدهای شدت مطلق یا با افزودن "%"، به صورت درصدی از حداکثر شدت ممکن (۲۵۵، ۶۵۵۳۵، یا ۴۲۹۴۹۶۷۲۹۵) باشد.

-gamma <value>

میزان تصحیح گاما

یک تصویر رنگی یکسان ممکن است هنگام نمایش در دو ایستگاه کاری مختلف، به دلیل تفاوت در مانیتور نمایشگر، متفاوت به نظر برسد. از تصحیح گاما برای تنظیم این اختلاف رنگ استفاده کنید. مقادیر معقول از 0.8 تا 2.3 هستند. گامای کمتر از 1.0 تصویر را تیره‌تر و گامای بزرگ‌تر از 1.0 آن را روشن‌تر می‌کند. تنظیمات بزرگ در گامای تصویر ممکن است در صورتی که اندازهٔ کوانتوم پیکسل تنها هشت بیت باشد (محدودهٔ کوانتوم 0 تا 255)، منجر به از دست رفتن بخشی از اطلاعات تصویر شود.

می‌توانید مقادیر گامای جداگانه‌ای را برای کانال‌های قرمز، سبز و آبی تصویر با فهرستی از مقادیر گاما که با اسلش از هم جدا شده‌اند اعمال کنید (مانند 1.7/2.3/1.2).

از +gamma value برای تنظیم سطح گامای تصویر بدون دستکاری واقعی پیکسل‌های تصویر استفاده کنید. این گزینه زمانی مفید است که تصویر دارای گامای مشخصی باشد اما به عنوان یک صفت تصویر ثبت نشده باشد (مانند تصاویر PNG).

-gaussian <radius>{x<sigma>}

تار کردن تصویر با عملگر گاوسی

از شعاع و انحراف معیار (سیگما) داده‌شده استفاده می‌کند.

-geometry <width>x<height>{+-}<x>{+-}<y>{%}{@}{!}{^}{<}{>}

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

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

برای دستورهای X11 (مانند 'animate'، 'display' و 'import')، اندازه و مکان ترجیحی پنجرهٔ تصویر را مشخص می‌کند. به‌طور پیش‌فرض، اندازهٔ پنجره همان اندازهٔ تصویر است و مکان آن هنگام نگاشت پنجره توسط شما (یا مدیر پنجره‌تان) تعیین می‌شود. برای دستورهای ابزاری 'import'، 'convert' و 'mogrify' ممکن است برای مشخص کردن اندازهٔ دلخواه هنگام تغییر اندازهٔ تصویر به کار رود. در این حالت، نمادهایی که معرف گزینه‌های تغییر اندازه هستند را می‌توان به رشتهٔ هندسه الحاق کرد تا بر نحوهٔ برخورد با درخواست تغییر اندازه اثر بگذارند.

یادداشت‌های بعدی متناظر با کاربرد در هر دستور خاص را ببینید. یادداشت‌های زیر مربوط به زمانی است که -geometry برای بیان یک درخواست تغییر اندازه، با در نظر گرفتن ویژگی‌های کنونی تصویر به کار می‌رود.

به‌طور پیش‌فرض، عرض و ارتفاع مقادیر حداکثری هستند؛ یعنی تصویر به گونه‌ای بزرگ یا کوچک می‌شود تا با حفظ نسبت ابعاد (aspect ratio) تصویر، در مقادیر عرض و ارتفاع بگنجد.

یک ^ را به انتهای هندسه الحاق کنید تا نسبت ابعاد تصویر هنگام تغییر اندازه حفظ شود، اما عرض یا ارتفاع حاصل‌شده به جای مقادیر بیشینه، به عنوان مقادیر کمینه در نظر گرفته شوند.

یک ! (علامت تعجب) را به هندسه الحاق کنید تا اندازهٔ تصویر دقیقاً به همان اندازه‌ای که مشخص کرده‌اید تحمیل شود. برای مثال، اگر 640x480! را تعیین کنید، عرض تصویر روی ۶۴۰ پیکسل و ارتفاع روی ۴۸۰ تنظیم می‌شود و در صورت لزوم نسبت ابعاد تصویر تغییر می‌یابد.

اگر فقط عرض مشخص شود، بدون 'x' پایانی، ارتفاع برابر با عرض تنظیم می‌شود (برای مثال، -geometry 100 همانند -geometry 100x100 است). اگر فقط عرض مشخص شود اما همراه با 'x' پایانی باشد، عرض مقدار تعیین‌شده را می‌گیرد و ارتفاع به منظور حفظ نسبت ابعاد تصویر انتخاب می‌شود. به همین ترتیب، اگر فقط ارتفاع با پیشوند 'x' مشخص شود (مانند -geometry x256)، عرض به گونه‌ای انتخاب می‌شود که نسبت ابعاد حفظ شود.

برای تعیین درصدی عرض یا ارتفاع به جای آن، علامت % را الحاق کنید. اندازهٔ تصویر در درصدهای عرض و ارتفاع ضرب می‌شود تا ابعاد نهایی تصویر به دست آید. برای افزایش اندازهٔ تصویر، از مقداری بیشتر از ۱۰۰ استفاده کنید (مانند 125%). برای کاهش اندازهٔ تصویر، از درصدی کمتر از ۱۰۰ استفاده کنید.

از @ برای تعیین حداکثر مساحت تصویر بر حسب پیکسل استفاده کنید.

از > برای تغییر ابعاد تصویر تنها در صورتی که عرض یا ارتفاع آن از مشخصات هندسه بیشتر باشد، استفاده کنید. علامت < تصویر را تنها در صورتی تغییر اندازه می‌دهد که هر دو بعد آن از مشخصات هندسه کمتر باشند. برای مثال، اگر '640x480>' را مشخص کنید و اندازهٔ تصویر 256x256 باشد، اندازهٔ تصویر تغییر نمی‌کند. اما اگر اندازهٔ تصویر 512x512 یا 1024x1024 باشد، اندازهٔ آن به 480x480 تغییر می‌یابد. مشخصات هندسه را درون گیومه قرار دهید تا از تفسیر شدن < یا > به عنوان هدایت مجدد فایل (redirection) توسط شل جلوگیری شود.

هنگامی که با animate و display استفاده می‌شود، آفست‌ها به همان شیوه‌ای که در X(1) آمده مدیریت می‌شوند و گزینهٔ -gravity به کار نمی‌رود. اگر x منفی باشد، آفست به سمت چپ و از لبهٔ راست صفحه تا لبهٔ راست تصویرِ در حال نمایش اندازه‌گیری می‌شود. به همین ترتیب، y منفی بین لبه‌های پایینی اندازه‌گیری می‌شود. آفست‌ها تحت تأثیر "%" قرار نمی‌گیرند؛ آن‌ها همیشه بر حسب پیکسل سنجیده می‌شوند.

هنگامی که به عنوان یک گزینهٔ composite استفاده می‌شود، -geometry ابعاد تصویر و موقعیت آن را نسبت به تصویر ترکیبی نشان می‌دهد. اگر گزینهٔ -gravity همراه با جهت‌گیری‌های NorthEast، East یا SouthEast باشد، x بیانگر فاصله از لبهٔ راست تصویر تا لبهٔ راست تصویر ترکیبی است. به همین ترتیب، اگر گزینهٔ -gravity همراه با جهت‌گیری‌های SouthWest، South یا SouthEast باشد، y بین لبه‌های پایینی اندازه‌گیری می‌شود. در نتیجه، یک آفست مثبت هرگز به جهتی بیرون از تصویر اشاره نخواهد کرد. آفست‌ها تحت تأثیر "%" قرار نمی‌گیرند؛ آن‌ها همواره بر حسب پیکسل اندازه‌گیری می‌شوند. برای مشخص کردن ابعاد تصویر ترکیبی، از گزینهٔ -resize استفاده کنید.

هنگامی که به عنوان گزینه‌ای برای convert، import یا mogrify استفاده می‌شود، -geometry مترادف با -resize است و اندازهٔ تصویر خروجی را تعیین می‌کند. آفست‌ها در صورت وجود، نادیده گرفته می‌شوند.

هنگامی که به عنوان گزینه‌ای برای montage استفاده می‌شود، -geometry اندازهٔ تصویر و اندازهٔ حاشیه را برای هر کاشی (tile) مشخص می‌کند؛ مقدار پیش‌فرض 256x256+0+0 است. آفست‌های منفی (ابعاد حاشیه) بی‌معنی هستند. گزینهٔ -gravity بر جای‌گیری تصویر در درون کاشی تأثیر می‌گذارد؛ جهت‌گیری پیش‌فرض برای این منظور Center است. اگر علامت "%" در مشخصات هندسه بیاید، اندازهٔ کاشی برابر با درصد مشخص‌شده از ابعاد اولیهٔ اولین کاشی خواهد بود. برای مشخص کردن ابعاد مونتاژ، از گزینهٔ -resize استفاده کنید.

-gravity <type>

جهتی که عنصر اولیه هنگام حاشیه‌نویسی تصویر به سمت آن متمایل می‌شود.

گزینه‌ها عبارتند از: NorthWest، North، NorthEast، West، Center، East، SouthWest، South، SouthEast.

جهتی که انتخاب می‌کنید مشخص می‌کند که هنگام حاشیه‌نویسی، متن در کجای تصویر قرار گیرد. برای مثال، جهت‌گیری Center متن را مجبور می‌کند تا در مرکز تصویر قرار گیرد. به‌طور پیش‌فرض، جهت‌گیری تصویر NorthWest است. برای جزئیات بیشتر دربارهٔ عناصر ترسیمی، به -draw مراجعه کنید. تنها عناصر متنی تحت تأثیر گزینهٔ -gravity قرار می‌گیرند.

گزینهٔ -gravity همچنین در هماهنگی با گزینهٔ -geometry و سایر گزینه‌هایی که <geometry> را به عنوان یک پارامتر می‌پذیرند (مانند گزینهٔ -crop) استفاده می‌شود. برای جزئیات چگونگی تعامل گزینهٔ -gravity با پارامترهای <x> و <y> در مشخصات یک هندسه، به -geometry مراجعه کنید.

هنگامی که به عنوان گزینه‌ای برای composite استفاده می‌شود، -gravity جهتی را که تصویر درون تصویر ترکیبی به سمت آن متمایل می‌شود نشان می‌دهد.

هنگامی که به عنوان گزینه‌ای برای montage استفاده می‌شود، -gravity جهتی را که تصویر درون یک کاشی متمایل می‌شود تعیین می‌کند. جهت‌گیری پیش‌فرض برای این منظور Center است.

-green-primary <x>,<y>

نقطهٔ اصلی رنگینگی سبز

-hald-clut <clut>

اعمال یک Hald CLUT روی تصویر

یک Hald CLUT (یا «Color Look-Up Table») یک تصویر رنگی مربعی ویژه است که شامل یک جدول تطبیق رنگ برای قرمز، سبز و آبی می‌باشد. اندازهٔ تصویر Hald CLUT با مرتبهٔ (order) آن تعیین می‌شود. عرض (و ارتفاع) یک Hald CLUT برابر با مکعب (توان سه) مرتبه است. برای مثال، یک Hald CLUT با مرتبهٔ ۸ برابر با 512x512 پیکسل (۲۶۲٬۱۴۴ رنگ) و با مرتبهٔ ۱۶ برابر با 4096x4096 پیکسل (۱۶٬۷۷۷٬۲۱۶ رنگ) است. یک CLUT ویژه، CLUT همانی (identity CLUT) است که هیچ تغییری در تصویر ورودی ایجاد نمی‌کند. برای استفاده از Hald CLUT، ابتدا یک CLUT همانی برداشته شده و رنگ‌های آن به نحوی تغییر داده می‌شود. سپس می‌توان از این CLUT ویرایش‌شده برای تبدیل هر تعداد تصویر به شیوه‌ای یکسان استفاده کرد.

برنامهٔ GraphicsMagick شامل یک تولیدکنندهٔ توکار CLUT همانی از طریق کدگذار IDENTITY است. برای مثال، خواندن از نام فایل IDENTITY:8 یک CLUT همانی با مرتبهٔ ۸ بازمی‌گرداند. تصاویر همانی Hald CLUT معمولاً مرتبه‌ای بین ۸ و ۱۶ دارند. مرتبهٔ پیش‌فرض برای تولیدکنندهٔ CLUT با کدگذار IDENTITY مقدار ۸ است. از درون‌یابی (interpolation) استفاده می‌شود، بنابراین معمولاً نیازی نیست که تصاویر CLUT بسیار بزرگ باشند. قالب پرونده‌ای PNG برای ذخیرهٔ تصاویر Hald CLUT ایدئال است زیرا آن‌ها را بسیار خوب فشرده می‌کند..TP -help چاپ دستورالعمل‌های نحوه استفاده

-highlight-color <color>

رنگ نشانه‌گذاری پیکسل‌ها

رنگ مورد استفاده برای نشانه‌گذاری پیکسل‌های تفاوت را مشخص می‌کند.

-highlight-style <style>

سبک نشانه‌گذاری پیکسل‌ها

سبک نشانه‌گذاری تفاوت پیکسل‌ها را که برای جلب توجه به پیکسل‌های تغییریافته استفاده می‌شود، مشخص می‌کند. می‌تواند یکی از مقادیر Assign، Threshold، Tint یا XOR باشد؛ که در آن Assign پیکسل را با رنگ برجسته‌سازی جایگزین می‌کند (ببینید -highlight-color)، Threshold بر اساس تفاوت شدت، پیکسل را با سیاه یا سفید جایگزین می‌کند، Tint با استفاده از آلفا به پیکسل ته‌رنگِ رنگ برجسته‌سازی می‌بخشد، و XOR یک عملیات XOR بین پیکسل و رنگ برجسته‌سازی انجام می‌دهد.

-iconGeometry <geometry>

مشخص کردن هندسه (geometry) آیکون

آفست‌ها، در صورت وجود در مشخصات هندسه، همانند گزینهٔ -geometry پردازش می‌شوند و از سبک X11 برای مدیریت آفست‌های منفی استفاده می‌شود.

-iconic

پویانمایی آیکونی

-immutable

تغییرناپذیر کردن تصویر

-implode <factor>

فروپاشی درونی (implode) پیکسل‌های تصویر حول مرکز

-intent <type>

استفاده از این نوع مقصود رندر (rendering intent) هنگام مدیریت رنگ تصویر

از این گزینه برای تأثیرگذاری بر عملیات مدیریت رنگ تصویر استفاده کنید (ببینید -profile). از میان این مقصودها انتخاب کنید: Absolute, Perceptual, Relative, Saturation.

مقصود پیش‌فرض تعریف‌نشده (undefined) است.

-interlace <type>

نوع طرح‌بندی درهم‌بافی (interlacing)

گزینه‌های انتخابی عبارتند از: None, Line, Plane, یا Partition. مقدار پیش‌فرض None است.

این گزینه برای مشخص کردن نوع طرح‌بندی درهم‌بافی برای قالب‌های خام تصویر مانند RGB یا YUV استفاده می‌شود. None به معنای عدم درهم‌بافی است (RGBRGBRGBRGBRGBRGB...)،

Line از درهم‌بافی خط‌روبشی (scanline) استفاده می‌کند (RRR...GGG...BBB...RRR...GGG...BBB...)، و Plane از درهم‌بافی صفحه‌ای (plane) استفاده می‌کند (RRRRRR...GGGGGG...BBBBBB...).

Partition مشابه plane است، با این تفاوت که صفحه‌های مختلف در فایل‌های جداگانه ذخیره می‌شوند (مانند image.R، image.G و image.B).

از Line برای ایجاد یک تصویر interlaced PNG یا GIF یا progressive JPEG استفاده کنید.

-label <name>

اختصاص یک برچسب (label) به تصویر

هنگام نوشتن در قالب تصویری که از برچسب‌ها پشتیبانی می‌کند، مانند TIFF، PNG، MIFF یا PostScript، از این گزینه برای اختصاص یک برچسب مشخص به تصویر استفاده کنید. می‌توانید با گنجاندن نویسه‌های قالب‌بندی خاص، نام فایل تصویر، نوع، پهنا، بلندی یا سایر مشخصه‌های تصویر را بگنجانید. برچسب روی خود تصویر رسم نمی‌شود، بلکه از طریق یک برچسب "Label" یا سازوکاری مشابه درون جریان داده تصویر گنجانده می‌شود. اگر می‌خواهید برچسب روی خود تصویر نمایان باشد، از گزینهٔ -draw استفاده کنید. برای جزئیات بیشتر به -comment مراجعه کنید.

برای مثال،

-label "%m:%f %wx%h"

برچسب تصویری به صورت MIFF:bird.miff 512x480 برای تصویری با نام bird.miff که پهنای آن ۵۱۲ و بلندی آن ۴۸۰ است، ایجاد می‌کند.

اگر نخستین نویسه از string نویسهٔ @ باشد، برچسب تصویر از فایلی خوانده می‌شود که نام آن در نویسه‌های باقی‌ماندهٔ رشته آمده است. لطفاً توجه داشته باشید که اگر رشته از منبعی غیرقابل‌اعتماد باشد، باید پیش از استفاده پاک‌سازی شود؛ زیرا در غیر این صورت ممکن است محتوای یک فایل دلخواه و قابل خواندن در برچسب تصویر ادغام شود (یک مخاطرهٔ امنیتی).

اگر گزینهٔ -label چندین بار تکرار شود، تنها آخرین برچسب ذخیره می‌شود.

در تصاویر PNG، برچسب در یک قطعهٔ (chunk) tEXt یا zTXt با کلیدواژهٔ "label" ذخیره می‌شود.

هنگام تبدیل به PostScript، از این گزینه برای تعیین یک رشتهٔ سربرگ جهت چاپ بالای تصویر استفاده کنید. فونت برچسب را با -font تعیین کنید.

هنگام ایجاد یک مونتاژ، برچسب مرتبط با تصویر به‌طور پیش‌فرض به همراه کاشی متناظر در مونتاژ نمایش داده می‌شود. برای لغو این رفتار، از گزینهٔ +label استفاده کنید.

-lat <width>x<height>{+-}<offset>{%}

انجام آستانه‌گذاری تطبیقی محلی (local adaptive thresholding)

آستانه‌گذاری تطبیقی محلی را با استفاده از پهنا، بلندی و آفست مشخص‌شده انجام می‌دهد. آفست فاصله‌ای در فضای نمونه نسبت به میانگین است که به صورت یک عدد صحیح مطلق در بازهٔ ۰ تا بیشینه مقدار نمونه یا به صورت درصد بیان می‌شود. اگر گزینهٔ درصد ارائه شود، آفست به صورت درصدی از محدوده کوانتومی (quantum range) محاسبه می‌شود. اکیداً توصیه می‌شود از گزینهٔ درصد استفاده کنید تا نتایج به عمق کوانتومی پیکسل حساس نباشند.

برای مثال،

-colorspace gray -lat "10x10-5%"

به وضوح یک سند اسکن‌شدهٔ رنگی یا مقیاس خاکستری کمک کرده و یک معادل دو سطحی (سیاه و سفید خالص) تولید می‌کند.

-level <black_point>{,<gamma>}{,<white_point>}{%}

تنظیم سطح کنتراست تصویر

یک، دو یا سه مقدار جداشده با کاما وارد کنید: نقطه سیاه، گاما، نقطه سفید (برای مثال 10,1.0,250 یا 2%,0.5,98%). بازهٔ نقطه‌های سیاه و سفید از 0 تا MaxRGB یا از 0 تا 100% است؛ اگر نقطه سفید حذف شود، روی MaxRGB-black_point تنظیم می‌شود. اگر علامت "%" در هر جای رشته وجود داشته باشد، نقطه‌های سیاه و سفید درصدهایی از MaxRGB خواهند بود. گاما یک نما است که در بازهٔ 0.1 تا 10. قرار دارد؛ اگر حذف شود، مقدار پیش‌فرض 1.0 (بدون تصحیح گاما) در نظر گرفته می‌شود. این رابط کاربری مشابه بخش "Input Levels" در مسیر "Image->Adjustments->Levels..." در نرم‌افزار فتوشاپ عمل می‌کند.

-limit <type> <value>

محدودیت منابع Disk، File، Images، Map، Memory، Pixels، Width، Height، Read، Threads، یا Write

به‌طور پیش‌فرض، محدودیت‌های منابع بر اساس منابع در دسترس و قابلیت‌های سیستم برآورد می‌شوند. محدودیت‌های منابع عبارتند از: Disk، بیشینه فضای دیسک مصرفی؛ File، بیشینه تعداد توصیف‌کننده‌های فایل (file descriptors) مجاز برای باز بودن هم‌زمان؛ Images، بیشینه تصاویری که کل برنامه اجازه دارد به‌طور هم‌زمان پردازش کند؛ Map، بیشینه تعداد کل بایت‌های فایلی که می‌توانند نگاشت حافظه (memory-mapped) شوند؛ Memory، بیشینه تعداد کل بایت‌های حافظه هیپ (heap) مورد استفاده برای ذخیره‌سازی تصویر؛ Pixels، بیشینه اندازهٔ مطلق تصویر (به ازای هر تصویر)؛ Width، بیشینه پهنای پیکسل‌های تصویر؛ Height، بیشینه بلندی پیکسل‌های تصویر؛ Read، بیشینه بایت‌های فشرده‌نشده برای خواندن؛ Write، بیشینه بایت‌های فشرده‌نشده برای نوشتن؛ و Threads، بیشینه تعداد ریسه‌های کاری (worker threads) برای استفاده در هر تیم ریسهٔ OpenMP.

محدودیت‌های منابع Disk و Map برای تصمیم‌گیری دربارهٔ این موضوع استفاده می‌شوند که آیا (برای یک تصویر مشخص) تصویر رمزگشایی‌شده ("pixel cache") باید در حافظهٔ هیپ (RAM)، در یک فایل دیسک با نگاشت حافظه (memory-mapped)، یا در یک فایل دیسک که از طریق ورودی/خروجی خواندن/نوشتن دسترسی‌پذیر است ذخیره شود یا خیر.

تعداد کل پیکسل‌ها در یک تصویر (Pixels) و/یا پهنا/بلندی (Width/Height) می‌تواند محدود شود تا خواندن یا ایجاد تصاویر بزرگ‌تر از این حد (بر حسب پیکسل) عمداً با خطا مواجه شود. محدودیت دیسک (Disk) یک محدودیت کلی تعیین می‌کند، زیرا استفاده از دیسک آخرین راهکار موجود است. هنگامی که حد مجاز دیسک فرا برسد، هیچ تصویر دیگری خوانده نخواهد شد.

میزان داده‌های فشرده‌نشدهٔ خوانده‌شده هنگام خواندن یک فایل تصویر می‌تواند با محدودیت Read محدود شود. در صورت رسیدن به این حد، خواندن تصویر ناموفق خواهد بود. این گزینه زمانی مفید است که داده‌ها از یک جریان (pipe) یا از یک فایل فشرده مانند یک فایل gzipped خوانده می‌شوند. برخی فایل‌ها بسیار فشرده‌پذیر هستند و بنابراین یک فایل فشردهٔ کوچک می‌تواند پس از خارج شدن از حالت فشرده، به حجم عظیمی از داده تبدیل شود. این گزینه همچنین در برابر فایل‌هایی که هنگام رمزگشایی با پرش به عقب (seeking backwards) در فایل، حلقه‌های به ظاهر بی‌پایان ایجاد می‌کنند، محافظت می‌کند.

میزان داده‌های فشرده‌نشدهٔ نوشته‌شده هنگام نوشتن یک فایل تصویر می‌تواند با محدودیت Write محدود شود. در صورت رسیدن به این حد، نوشتن تصویر (مشابه پر شدن دیسک) با شکست مواجه می‌شود. اگر خروجی به یک فایل معمولی باشد (به جای pipe)، هرگونه فایل خروجی ناقص حذف خواهد شد. از این گزینه می‌توان اطمینان حاصل کرد که فایل‌های بیش از حد بزرگ نوشته نشوند. همچنین این گزینه می‌تواند برای شبیه‌سازی وضعیت پر شدن دیسک استفاده شود.

آرگومان value یک مقدار مطلق است، اما می‌تواند پسوندهای استاندارد باینری ('K', 'M', 'G', 'T', 'P', 'E') را به منظور مقیاس‌بندی مقدار (بر پایه ضریب ۱۰۲۴) بپذیرد. هرگونه نویسهٔ اضافی نادیده گرفته می‌شود. برای نمونه، '-limit Pixels 10MP' بیشینه اندازه تصویر را به ۱۰ مگاپیکسل محدود می‌کند و '-limit memory 32MB -limit map 64MB' حافظه و فایل‌های نگاشت‌شده به حافظه را به ترتیب به ۳۲ مگابایت و ۶۴ مگابایت محدود می‌سازد.

محدودیت‌های منابع همچنین می‌توانند با استفاده از متغیرهای محیطی تنظیم شوند. متغیرهای محیطی MAGICK_LIMIT_DISK، MAGICK_LIMIT_FILES، MAGICK_LIMIT_MAP، MAGICK_LIMIT_MEMORY، MAGICK_LIMIT_PIXELS، MAGICK_LIMIT_WIDTH، MAGICK_LIMIT_HEIGHT، MAGICK_LIMIT_READ، MAGICK_LIMIT_WRITE و OMP_NUM_THREADS ممکن است به ترتیب برای تنظیم محدودیت‌های فضای دیسک، فایل‌های باز، اندازه نگاشت حافظه، حافظه هیپ، پیکسل‌های هر تصویر، پهنای تصویر، بلندی تصویر، بایت‌های خوانده‌شده از فایل، بایت‌های نوشته‌شده روی فایل و ریسه‌های OpenMP استفاده شوند.

از گزینهٔ -list resource برای مشاهدهٔ محدودیت‌های فعلی استفاده کنید..TP -linewidth عرض خط برای عملیات‌های ترسیم بعدی

-list <type>

نوع فهرست

انتخاب‌ها عبارتند از: Color، Delegate، Format، Magic، Module، Resource یا Type. گزینهٔ Module تنها در صورتی در دسترس است که GraphicsMagick با پشتیبانی از ماژول‌های بارگذاری‌پذیر (loadable modules) ساخته شده باشد.

این گزینه اطلاعات مربوط به پیکربندی GraphicsMagick را فهرست می‌کند.

-log <string>

مشخص کردن قالب برای گزارش اشکال‌زدایی (debug log)

این گزینه قالبی را برای گزارشی که هنگام فعال بودن گزینهٔ -debug چاپ می‌شود، مشخص می‌کند.

می‌توانید با درج نویسه‌های قالب‌بندی ویژه، مؤلفه‌های زیر را نمایش دهید:

%d   دامنه (domain)
%e   رویداد (event)
%f   تابع (function)
%l   خط (line)
%m   ماژول (module)
%p   شناسه فرایند (process ID)
%r   زمان واقعی پردازنده (real CPU time)
%t   زمان ساعت دیواری (wall clock time)
%u   زمان کاربر پردازنده (user CPU time)
%%   علامت درصد
\n   خط جدید (newline)
\r   بازگشت به ابتدای سطر (carriage return)

برای مثال:

gm convert -debug coders -log "%u %m:%l %e" in.gif out.png

رفتار پیش‌فرض، چاپ تمام مؤلفه‌ها است.

-loop <iterations>

افزودن پسوند حلقهٔ Netscape به پویانمایی GIF شما

مقداری غیر از صفر، پویانمایی را وادار می‌کند تا حداکثر به تعداد iterations بار تکرار شود.

-magnify

بزرگ‌نمایی تصویر

اندازهٔ تصویر با استفاده از درون‌یابی خطی (linear interpolation) دو برابر می‌شود.

-magnify <factor>

بزرگ‌نمایی تصویر

تصویر نمایش‌یافته به اندازهٔ factor بزرگ‌نمایی می‌شود.

-map <filename>

انتخاب یک مجموعه رنگ مشخص از این تصویر

[convert یا mogrify]

به‌طور پیش‌فرض، کاهش رنگ مجموعه‌ای بهینه از رنگ‌ها را انتخاب می‌کند که تصویر اصلی را به بهترین شکل بازنمایی کنند. در مقابل، می‌توانید با این گزینه مجموعهٔ مشخصی از رنگ‌ها را از یک فایل تصویر انتخاب کنید.

از +map برای کاهش تمام تصاویر موجود در دنبالهٔ تصاویر بعدی به یک مجموعه رنگ بهینهٔ واحد که بهترین بازنمایی از تمام تصاویر باشد، استفاده کنید. دنبالهٔ تصاویر با ظاهر شدن هر گزینه‌ای پایان می‌یابد. اگر گزینهٔ +map پس از تمام تصاویر ورودی قرار گیرد، تمام تصاویر نگاشت می‌شوند.

-map <type>

نمایش تصویر با استفاده از این نوع.

[animate یا display]

از میان این انواع Standard Colormap انتخاب کنید:

best
default
gray
red
green
blue

X server باید از Standard Colormap انتخابی شما پشتیبانی کند، در غیر این صورت خطایی رخ می‌دهد. از list به عنوان نوع استفاده کنید تا display فهرست انواع نقشه‌های رنگ را به ترتیب از بالا به پایین جستجو کند تا یکی پیدا شود. برای یکی از روش‌های ایجاد Standard Colormapها، xstdcmap(1) را ببینید.

-mask <filename>

مشخص کردن یک ماسک برش (clipping mask)

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

اگر تصویر ماسک دارای یک کانال کدر بودن (opacity) باشد، کدر بودن هر پیکسل برای تعریف ماسک استفاده می‌شود. در غیر این صورت، شدت روشنایی (سطح خاکستری) هر پیکسل به کار می‌رود. پیکسل‌های بدون ماسک (سیاه) تغییر می‌کنند، در حالی که پیکسل‌های ماسک‌شده (غیرسیاه) در برابر تغییر محافظت می‌شوند.

از +mask برای حذف ماسک برش استفاده کنید.

نیازی به استفاده از -clip برای فعال‌سازی ماسک نیست؛ -clip به صورت ضمنی توسط -mask فعال می‌شود.

-matte

ذخیرهٔ کانال مات (شفافیت) در صورت وجود در تصویر

اگر تصویر فاقد کانال مات باشد، یک کانال کدر (opaque) ایجاد می‌کند.

از +matte برای نادیده گرفتن کانال مات (کدر فرض کردن آن) و جلوگیری از نوشتن کانال مات در فایل خروجی استفاده کنید.

برای دستور compare، در صورتی که تصاویر از قبل کانال مات نداشته باشند، -matte یک کانال مات کدر به آن‌ها اضافه می‌کند و مات برای هر دو تصویر فعال می‌شود. به همین ترتیب، اگر از +matte استفاده شود، کانال مات برای هر دو تصویر غیرفعال می‌شود. این امر مقایسهٔ تصاویر را صرف‌نظر از اینکه از قبل دارای کانال مات بوده‌اند یا خیر، آسان‌تر می‌سازد.

-mattecolor <color>

مشخص کردن رنگ مورد استفاده همراه با گزینهٔ -frame

رنگ با استفاده از قالبی که در ذیل گزینهٔ -fill شرح داده شده است، مشخص می‌شود.

-maximum-error <limit>

حداکثر میزان خطای کل تصویر را مشخص می‌کند

حداکثر میزان خطای کل تصویر (بر اساس مقایسه با استفاده از یک معیار مشخص) را پیش از گزارش خطا (“image difference exceeds limit”) تعیین می‌کند. این خطا از طریق وضعیت خروج (exit status) غیرصفر در اجرای دستور گزارش می‌شود.

-median <radius>

اعمال یک فیلتر میانه (median filter) بر روی تصویر

-metric <metric>

معیار مقایسه (MAE، MSE، PAE، PSNR، RMSE)

-minify <factor>

کوچک‌نمایی تصویر

اندازهٔ تصویر با استفاده از درون‌یابی خطی نصف می‌شود.

-mode <value>

حالت عملیات

حالت‌های مونتاژ موجود عبارتند از: frame برای قرار دادن تصاویر در یک شبکهٔ مستطیلی به همراه افزودن یک قاب تزئینی با سایه (dropshadow)، unframe برای قرار دادن تصاویر بدون تزیین در یک شبکهٔ مستطیلی، و concatenate برای چیدن فشردهٔ تصاویر در کنار یکدیگر بدون هیچ شبکه‌بندی یا تزیین مشخص.

-modulate brightness[,saturation[,hue]]

تغییر روشنایی، اشباع و فام رنگ در تصویر

درصد تغییر در روشنایی (brightness)، اشباع رنگ (saturation) و فام (hue) را با کاما جدا کرده و مشخص کنید. مقادیر پیش‌فرض آرگومان‌ها ۱۰۰ درصد است که منجر به عدم تغییر می‌شود. برای مثال، برای افزایش روشنایی رنگ به میزان ۲۰٪ و کاهش اشباع رنگ به میزان ۱۰٪ و بدون تغییر ماندن فام، از این عبارت استفاده کنید: -modulate 120,90.

فام (Hue) درصد چرخش مطلق از موقعیت فعلی است. برای مثال ۵۰ منجر به یک چرخش ۹۰ درجه‌ای پادساعت‌گرد می‌شود، ۱۵۰ منجر به یک چرخش ۹۰ درجه‌ای ساعت‌گرد می‌شود، و ۰ و ۲۰۰ هر دو منجر به یک چرخش ۱۸۰ درجه‌ای می‌شوند.

-monitor

نمایش نشانگر پیشرفت

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

-monochrome

تبدیل تصویر به سیاه و سفید

-morph <frames>

تبدیل تدریجی (مورف) یک دنباله از تصاویر

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

دنبالهٔ تصاویر با ظاهر شدن هر گزینه‌ای خاتمه می‌یابد. اگر گزینهٔ -morph پس از تمام تصاویر ورودی قرار گیرد، تمام تصاویر دچار تبدیل تدریجی می‌شوند..TP -mosaic ایجاد یک موزاییک از یک تصویر یا دنباله‌ای از تصاویر

گزینهٔ -mosaic روشی انعطاف‌پذیر برای ترکیب یک یا چند تصویر بر روی یک تصویر بوم تک‌رنگ فراهم می‌کند. عملکرد آن مشابه -flatten است، با این تفاوت که بر اساس اندازهٔ تصویر، ابعاد صفحه، و آفست‌های صفحه برای تصاویری که باید ترکیب شوند، یک تصویر بوم پایه با اندازهٔ مناسب به‌طور خودکار ایجاد می‌شود. رنگ تصویر بوم پایه می‌تواند با گزینهٔ -background تعیین شود. رنگ پیش‌فرض بوم سفید ('white') است، اما بسته به الگوریتم ترکیب درخواست‌شده، سیاه ('black') یا شفاف ('transparent') ممکن است مناسب‌تر باشد.

گزینهٔ -compose می‌تواند برای تعیین الگوریتم ترکیبی که هنگام ترکیب تصویر بعدی بر روی بوم پایه استفاده می‌شود، به کار رود.

گزینهٔ -page می‌تواند برای مشخص کردن ابعاد موزاییک و موقعیت‌دهی تصویر بعدی در موزاییک استفاده شود. اگر آرگومان -page عرض و ارتفاع را مشخص نکند، ابعاد بوم بر اساس اندازه‌ها و آفست‌های تصاویر محاسبه می‌شود.

دنبالهٔ تصاویر با ظاهر شدن هر گزینه‌ای خاتمه می‌یابد. اگر گزینهٔ -mosaic پس از تمام تصاویر ورودی قرار گیرد، تمامی تصاویر در موزاییک گنجانده می‌شوند.

در ادامه مثالی از ترکیب یک تصویر بر اساس لایه‌های قرمز، سبز و آبی استخراج‌شده از دنباله‌ای از تصاویر و چسباندن آن‌ها بر روی تصویر بوم در آفست‌های مشخص آورده شده است:

gm convert -background black               -compose CopyRed   -page +0-100 red.png               -compose CopyGreen -page +0+40  green.png               -compose CopyBlue  -page +0+180 blue.png               -mosaic output.png

-motion-blur <radius>{x<sigma>}{+angle}

شبیه‌سازی تاری حرکتی

شبیه‌سازی تاری حرکتی (motion blur) از طریق پیچش (کانولوشن) تصویر با یک عملگر گوسی با شعاع (radius) و انحراف معیار (sigma) داده‌شده. برای به‌دست آمدن نتایج معقول، radius باید بزرگ‌تر از sigma باشد. اگر radius صفر باشد، شعاع مناسب به‌طور خودکار بر اساس sigma انتخاب می‌شود. پارامتر angle زاویه‌ای را که شیء از آن جهت حرکت می‌کند (سمتی که تار می‌شود) مشخص می‌کند.

-name

نام‌گذاری یک تصویر

-negate

جایگزینی هر پیکسل با رنگ مکمل آن

شدت‌های قرمز، سبز و آبی یک تصویر وارونه (منفی) می‌شوند. سفید تبدیل به سیاه، زرد تبدیل به آبی و غیره می‌شود. از +negate برای معکوس کردن تنها پیکسل‌های مقیاس خاکستری (grayscale) تصویر استفاده کنید.

-noise <radius|type>

افزودن یا کاهش نویز در یک تصویر

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

از radius برای مشخص کردن پهنای همسایگی استفاده کنید.

از +noise به همراه نوع نویز برای افزودن نویز به تصویر استفاده کنید. نویز اضافه‌شده، پیکسل‌های موجود تصویر را مدوله می‌کند. از میان این انواع نویز انتخاب کنید:

Uniform
Gaussian
Multiplicative
Impulse
Laplacian
Poisson
Random (uniform distribution)

-noop

عملیات بی‌اثر یا NOOP (بدون گزینه)

گزینهٔ -noop می‌تواند برای خاتمه دادن به یک گروه از تصاویر و بازنشانی تمام گزینه‌ها به مقادیر پیش‌فرض آن‌ها استفاده شود، در شرایطی که هیچ گزینهٔ دیگری مد نظر نباشد.

-normalize

تبدیل تصویر برای پوشش دادن بازهٔ کامل مقادیر رنگی

این یک روش بهبود کنتراست بر اساس هیستوگرام تصویر است.

هنگام محاسبهٔ مقادیر بهبود کنتراست، لبه‌های هیستوگرام بریده می‌شوند تا اکثریت پیکسل‌های تصویر در بهبود کنتراست لحاظ شوند و داده‌های پرت (مانند نویز تصادفی یا جزئیات بسیار ریز) نادیده گرفته شوند. حالت پیش‌فرض این است که ۰٫۱ درصد از ورودی‌های هیستوگرام نادیده گرفته می‌شوند. درصد نادیده‌گیری هیستوگرام می‌تواند با استفاده از گزینهٔ -set همراه با پارامتر histogram-threshold مشخص شود، مشابه -set histogram-threshold 0.01 برای مشخص کردن ۰٫۰۱ درصد. از مقدار ۰ درصد برای استفاده از تمام هیستوگرام استفاده کنید که احتمالاً موجب بهبود کنتراست کمتری می‌شود.

-opaque <color>

تغییر این رنگ به رنگ قلم در تصویر

رنگ با استفاده از قالبی که در زیر گزینهٔ -fill توضیح داده شده است، مشخص می‌شود. اگر رنگ با رنگ هدف یکسان باشد، یا بر اساس فاصلهٔ اقلیدسی تعیین‌شده توسط -fuzz در یک فضای سه‌بعدی به اندازهٔ کافی به رنگ هدف نزدیک باشد، جایگزین می‌شود.

برای جزئیات بیشتر به -fill و -fuzz مراجعه کنید.

-operator channel operator rvalue[%]

اعمال یک عملگر ریاضی، بیتی یا مقداری بر روی یک کانال تصویر

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

کانال را از میان موارد زیر انتخاب کنید: Red، Green، Blue، Opacity، Matte، Cyan، Magenta، Yellow، Black، All یا Gray. مقدار All تنها کانال‌های رنگی را تغییر می‌دهد و کانال Opacity را دست‌نخورده باقی می‌گذارد. به‌جز عملگرهای آستانه‌گیری (threshold)، مقدار All روی هر کانال به‌طور مستقل عمل می‌کند، به‌گونه‌ای که عملیات بر پایهٔ هر کانال انجام می‌شود.

مقدار Gray با کانال‌های رنگی مانند شدت مقیاس خاکستری رفتار کرده و عملیات درخواستی را روی شدت پیکسلی معادل انجام می‌دهد تا نتیجه یک تصویر خاکستری باشد. عملگر را از میان این موارد انتخاب کنید: Add، And، Assign، Depth، Divide، Gamma، Negate، LShift، Log، Max، Min، Multiply، Or، Pow، RShift، Subtract، Threshold، Threshold-White، Threshold-White-Negate، Threshold-Black، Threshold-Black-Negate، Xor، Noise-Gaussian، Noise-Impulse، Noise-Laplacian، Noise-Multiplicative، Noise-Poisson، Noise-Random و Noise-Uniform.

مقدار rvalue می‌تواند هر عدد ممیز شناور یا عدد صحیحی باشد. معمولاً rvalue در بازهٔ ۰ تا MaxRGB خواهد بود، که در آن MaxRGB بزرگ‌ترین مقدار کوانتومی پشتیبانی‌شده توسط بیلد GraphicsMagick است (۲۵۵، ۶۵۵۳۵ یا ۴۲۹۴۹۶۷۲۹۵)، اما مقادیر خارج از این بازه برای برخی عملیات حسابی مفید هستند. آرگومان‌های عملیات منطقی یا بیتی، پیش از استفاده به یک مقدار صحیح مثبت گرد می‌شوند. اگر یک نماد درصد (%) به انتهای آرگومان پیوست شود، دامنهٔ آرگومان ۰ تا ۱۰۰ درصد خواهد بود.

در ادامه شرح این عملگرها آمده است:

Add


نتیجه حاصل جمع rvalue با مقدار کانال است.

And


نتیجه حاصل AND منطقی rvalue با مقدار کانال است.

Assign


نتیجه برابر با rvalue است.

Depth


نتیجه مقدار کانال تنظیم‌شده است به‌طوری که بتواند (تقریباً) در تعداد بیت‌های مشخص‌شده بدون اتلاف اضافی ذخیره شود.

Divide


نتیجه تقسیم مقدار کانال بر rvalue است.

Gamma


نتیجه مقدار کانال است که گامای آن توسط rvalue تنظیم شده است.

LShift


نتیجه مقدار کانال است که به صورت بیتی به اندازهٔ rvalue بیت به چپ شیفت داده شده است.

Log


نتیجه به صورت log(value*rvalue+1)/log(rvalue+1) محاسبه می‌شود.

Max


اگر rvalue بزرگ‌تر از value باشد، نتیجه برابر با rvalue قرار می‌گیرد.

Min


اگر rvalue کوچک‌تر از value باشد، نتیجه برابر با rvalue قرار می‌گیرد.

Multiply


نتیجه حاصل ضرب مقدار کانال در rvalue است.

Negate


نتیجه معکوس مقدار کانال است (مانند نگاتیو فیلم). یک rvalue باید مشخص شود اما در حال حاضر استفاده نمی‌شود. دو بار معکوس کردن تصویر، تصویر اصلی را حاصل می‌کند.

Or


نتیجه حاصل OR منطقی rvalue با مقدار کانال است.

Pow


نتیجه به صورت pow(value,rvalue) محاسبه می‌شود. مشابه Gamma است، به‌جز اینکه rvalue وارونه نمی‌شود.

RShift


نتیجه مقدار کانال است که به صورت بیتی به اندازهٔ rvalue بیت به راست شیفت داده شده است.

Subtract


نتیجه تفریق rvalue از مقدار کانال است.

Threshold


اگر مقدار کانال بزرگ‌تر از rvalue باشد، نتیجه بیشینه (سفید) است، و اگر کوچک‌تر یا مساوی rvalue باشد، کمینه (سیاه) است. اگر کانال‌های all مشخص شده باشند، آستانه‌گیری بر اساس شدت محاسبه‌شدهٔ پیکسل انجام می‌شود.

Threshold-white


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

Threshold-White-Negate


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

Threshold-black


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

Threshold-Black-Negate


اگر مقدار کانال کمتر از rvalue باشد، نتیجه روی سفید تنظیم می‌شود، و اگر بزرگ‌تر یا مساوی rvalue باشد دست‌نخورده باقی می‌ماند. اگر کانال‌های all مشخص شده باشند، آستانه‌گیری بر اساس شدت محاسبه‌شدهٔ پیکسل انجام می‌شود.

Xor


نتیجه حاصل XOR منطقی rvalue با مقدار کانال است. ویژگی جالب XOR این است که انجام دوبارهٔ همان عملیات منجر به مقدار اولیه می‌شود.

Noise-Gaussian


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

Noise-Impulse


نتیجه، مقدار کانال فعلی مدوله‌شده با نویز ضربه‌ای (impulse) بر اساس شدت مشخص‌شده توسط rvalue است.

Noise-Laplacian


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

Noise-Multiplicative


نتیجه، مقدار کانال فعلی مدوله‌شده با نویز گوسی ضرب‌شونده (multiplicative) بر اساس شدت مشخص‌شده توسط rvalue است.

Noise-Poisson


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

Noise-Random


نتیجه، مقدار کانال فعلی مدوله‌شده با نویز تصادفی (توزیع یکنواخت) بر اساس شدت مشخص‌شده توسط rvalue است. شدت اولیهٔ نویز (rvalue=1.0) گسترهٔ یک کوانتوم پیکسلی است.

Noise-Uniform


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

به عنوان یک مثال، عملگر Assign یک مقدار ثابت را به یک کانال اختصاص می‌دهد. برای نمونه، این دستور کانال قرمز را روی مقدار میانه تنظیم می‌کند:

gm convert in.bmp -operator red assign "50%" out.bmp

دستور زیر آستانه‌گیری ۵۰٪ را بر روی تصویر اعمال کرده و یک تصویر خاکستری برمی‌گرداند:

    gm convert in.bmp -operator gray threshold "50%" out.bmp
-ordered-dither <channeltype> <NxN> 
دیترینگ مرتب (ordered dither) تصویر
کانال یا کانال‌های مشخص‌شده در آرگومان channeltype با استفاده از روش دیترینگ مرتب، به دودویی (باینری) کاهش می‌یابند. گزینه‌های انتخابی برای channeltype عبارتند از All، Intensity، Red، Green، Blue، Cyan، Magenta، Yellow، Black و Opacity.
هنگامی که channeltype برابر "All" باشد، نمونه‌های رنگی به یک سطح خاکستری دیتر می‌شوند و سپس آن سطح خاکستری در سه کانال رنگی ذخیره می‌گردد. به‌طور جداگانه، کانال مات بودن (opacity) نیز به یک مقدار مات دوسطحی (bilevel) دیتر شده و در کانال مات بودن ذخیره می‌شود.
هنگامی که channeltype برابر "Intensity" باشد، فقط نمونه‌های رنگی دیتر می‌شوند. هنگامی که channeltype برابر "opacity" یا "matte" باشد، فقط کانال مات بودن دیتر می‌شود. زمانی که یک کانال رنگی مشخص شود، تنها همان کانال دیتر خواهد شد.
انتخاب‌های ممکن برای N از ۲ تا ۷ هستند. تصویر به کاشی‌های پیکسلی NxN تقسیم می‌شود. در هر کاشی، بسته به شدت روشنایی، برخی یا همه پیکسل‌ها به رنگ سفید درمی‌آیند. به ازای هر N، می‌توان تعداد (N**2)+1 سطح خاکستری را نمایش داد. برای N == 2، 3 یا 4، پیکسل‌ها به ترتیبی سفید می‌شوند که پراکندگی به حداکثر برسد (یعنی دانه‌دانه بودن کاهش یابد)، در حالی که برای N == 5، 6 و 7، آن‌ها به ترتیبی سفید می‌شوند که یک لکه سیاه تقریباً دایره‌ای در وسط هر کاشی ایجاد شود. یک تصویر جذاب با جلوه «نیم‌سایه» (half-tone) را می‌توان با چرخاندن اولیه تصویر به اندازه ۴۵ درجه، انجام عملیات ordered-dither با اندازه 5x5، چرخاندن مجدد آن به جهت اولیه و سپس برش دادن به ابعاد اولیه تصویر به دست آورد. اگر تصویر اولیه دارای کدگذاری گاما باشد، توصیه می‌شود ابتدا آن را به شدت خطی تبدیل کنید، مثلاً با گزینه «-gamma 0.45455».

-output-directory <directory>

خروجی دادن فایل‌ها در دایرکتوری
از -output-directory برای تعیین دایرکتوری مورد نظر جهت نوشتن فایل‌های خروجی استفاده کنید. به‌طور معمول mogrify روی فایل‌های ورودی بازنویسی می‌کند، اما با این گزینه فایل‌های خروجی می‌توانند در یک درخت دایرکتوری متفاوت نوشته شوند تا فایل‌های ورودی حفظ گردند. الگوریتم استفاده‌شده تمامی مشخصات مسیر ورودی را در مسیر خروجی حفظ می‌کند، به‌طوری که مسیر ورودی تعیین‌شده توسط کاربر (شامل هر بخش از زیردایرکتوری‌ها) به مسیر خروجی ضمیمه می‌شود. اگر فایل ورودی فاقد پسوند باشد، یک پسوند مناسب به‌طور خودکار به فایل خروجی اضافه خواهد شد. ایجاد دایرکتوری خروجی مشخص‌شده به عنوان آرگومان بر عهده کاربر است، اما در صورت مشخص کردن گزینه -create-directories، زیردایرکتوری‌ها در صورت نیاز ایجاد خواهند شد. از این گزینه می‌توان برای اعمال تغییرات بر روی فایل‌های یک دایرکتوری و ذخیره فایل‌های تغییریافته در یک دایرکتوری دیگر استفاده کرد. این گزینه در ترکیب با -create-directories، برای پشتیبانی از تبدیل کل درخت‌های دایرکتوریِ فایل‌ها طراحی شده است، به شرطی که مسیر نسبی فایل ورودی بخشی از فهرست نام فایل‌ها باشد.

-orient <orientation>

تنظیم ویژگی جهت‌گیری (orientation) تصویر
ویژگی جهت‌گیری تصویر را تنظیم می‌کند. ویژگی جهت‌گیری تصویر با برچسب جهت‌گیری TIFF (و برچسب جهت‌گیری EXIF) سازگار است. مقادیر پذیرفته‌شده عبارتند از undefined، TopLeft، TopRight، BottomRight، BottomLeft، LeftTop، RightTop، RightBottom، LeftBottom و نسخه‌های خط‌تیره‌دار آن‌ها (مانند left-bottom). لطفاً توجه داشته باشید که GraphicsMagick فاقد ویرایشگر EXIF است، بنابراین اگر یک نمایه EXIF در تصویر خروجی نوشته شود، ممکن است مقدار موجود در نمایه EXIF با تصویر همخوانی نداشته باشد. این احتمال وجود دارد که یک فایل تصویر جهت‌گیری خود را به چندین روش مختلف به‌طور همزمان مشخص کند.

-page <width>x<height>{+-}<x>{+-}<y>{%}{!}{<}{>}

اندازه و مکان بوم (canvas) تصویر
از این گزینه برای تعیین ابعاد صفحه PostScript بر حسب نقطه در اینچ (DPI) یا یک صفحه TEXT بر حسب پیکسل استفاده کنید. گزینه‌های موجود برای صفحه PostScript عبارتند از:
     11x17         792  1224
     Ledger       1224   792
     Legal         612  1008
     Letter        612   792
     LetterSmall   612   792
     ArchE        2592  3456
     ArchD        1728  2592
     ArchC        1296  1728
     ArchB         864  1296
     ArchA         648   864
     A0           2380  3368
     A1           1684  2380
     A2           1190  1684
     A3            842  1190
     A4            595   842
     A4Small       595   842
     A5            421   595
     A6            297   421
     A7            210   297
     A8            148   210
     A9            105   148
     A10            74   105
     B0           2836  4008
     B1           2004  2836
     B2           1418  2004
     B3           1002  1418
     B4            709  1002
     B5            501   709
     C0           2600  3677
     C1           1837  2600
     C2           1298  1837
     C3            918  1298
     C4            649   918
     C5            459   649
     C6            323   459
     Flsa          612   936
     Flse          612   936
     HalfLetter    396   612

برای راحتی می‌توانید اندازه صفحه را با رسانه/کاغذ (مانند A4، Ledger و غیره) مشخص کنید. در غیر این صورت، -page رفتاری بسیار شبیه به -geometry دارد (مانند -page letter+43+43>;).

این گزینه همچنین هنگام نوشتن در یک قالب چندتصویری که از انحراف‌ها (offsets) پشتیبانی می‌کند، مانند GIF89 و MNG، برای تعیین موقعیت زیرتصاویر به کار می‌رود. هنگامی که برای این منظور استفاده می‌شود، انحراف‌ها همواره از گوشه بالا سمت چپ بوم سنجیده می‌شوند و تحت تأثیر گزینه -gravity قرار نمی‌گیرند. برای موقعیت‌دهی به یک تصویر GIF یا MNG، از -page{+-}<x>{+-}<y> استفاده کنید (مانند -page +100+200). هنگام نوشتن در یک فایل MNG، وجود گزینه -page پیش از اولین تصویر در توالی با عرض و طول غیرصفر، مقادیر عرض و طولی را تعیین می‌کند که در چانک MHDR نوشته می‌شوند. در غیر این صورت، عرض و طول MNG از کادر محصورکننده‌ای (bounding box) که شامل همه تصاویر توالی است محاسبه می‌شود. هنگام نوشتن یک فایل GIF89، تنها از روش کادر محصورکننده برای تعیین ابعاد آن استفاده می‌شود.

برای یک صفحه PostScript، اندازه تصویر مشابه -geometry تعیین می‌شود و موقعیت آن نسبت به گوشه پایین سمت چپ صفحه با {+-}<xoffset>{+-}<yoffset> مشخص می‌گردد. برای مثال، از -page 612x792>; برای قرار دادن تصویر در مرکز صفحه استفاده کنید. اگر اندازه تصویر از صفحه PostScript فراتر رود، اندازه آن کاهش می‌یابد تا درون صفحه جا شود. جهت‌گیری (gravity) پیش‌فرض برای گزینه -page برابر با NorthWest است؛ به این معنی که مقادیر مثبت x و y offset به سمت راست و پایین از گوشه بالا سمت چپ صفحه اندازه‌گیری می‌شوند، مگر اینکه گزینه -gravity با مقداری غیر از NorthWest تعیین شده باشد.

ابعاد پیش‌فرض صفحه برای یک تصویر TEXT برابر 612x792 است.

این گزینه در هماهنگی با -density به کار می‌رود.

برای حذف تنظیمات صفحه یک تصویر از +page استفاده کنید.

-paint <radius>

شبیه‌سازی نقاشی رنگ روغن

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

-pause <seconds>

مکث بین چرخه‌های پویانمایی [animate]

پیش از تکرار پویانمایی، به تعداد ثانیه‌های مشخص‌شده مکث می‌کند.

-pause <seconds>

مکث بین تصاویر لحظه‌ای [import]

پیش از گرفتن تصویر لحظه‌ای (snapshot) بعدی، به تعداد ثانیه‌های مشخص‌شده مکث می‌کند.

-pen <color>

(این گزینه با گزینه -fill جایگزین شده است)

-ping

تعیین کارآمد ویژگی‌های تصویر

از این گزینه برای غیرفعال کردن خواندن پیکسل‌های تصویر استفاده کنید تا ویژگی‌های تصویر، مانند ابعاد آن، با سرعت بسیار بالا به دست آیند. برای identify، از +ping استفاده کنید تا خواندن پیکسل‌های تصویر اجباری شود و نرخ خواندن پیکسل بتواند در اطلاعات نمایش‌داده‌شده گنجانده شود.

-pointsize <value>

اندازه قلم (pointsize) برای قلم‌های PostScript، X11 یا TrueType

-preview <type>

نوع پیش‌نمایش تصویر

از این گزینه برای تأثیرگذاری بر عملیات پیش‌نمایش یک تصویر استفاده کنید (مانند convert file.png -preview Gamma Preview:gamma.png). از میان این پیش‌نمایش‌ها انتخاب کنید:

Rotate
Shear
Roll
Hue
Saturation
Brightness
Gamma
Spiff
Dull
Grayscale
Quantize
Despeckle
ReduceNoise
AddNoise
Sharpen
Blur
Threshold
EdgeDetect
Spread
Shade
Raise
Segment
Solarize
Swirl
Implode
Wave
OilPaint
CharcoalDrawing
JPEG

پیش‌نمایش پیش‌فرض JPEG است..TP -process <command> پردازش توالی‌ای از تصاویر با استفاده از یک ماژول پردازش

آرگومان command ساختاری به صورت module=arg1,arg2,arg3,...,argN دارد که در آن module نام ماژول فراخوانی‌شده (مانند "Analyze") و arg1,arg2,arg3,...,argN تعداد اختیاری آرگومان برای ارسال به ماژول پردازش هستند. توالی تصاویر با ظاهر شدن هر گزینه‌ای خاتمه می‌یابد.

اگر گزینهٔ -process بعد از تمام تصاویر ورودی قرار گیرد، همهٔ تصاویر پردازش می‌شوند.

برای مثال:

gm convert logo: -process Analyze=        -format "%[BrightnessMean],%[BrightnessStddev]" info:-
51952,23294

-profile <filename>

افزودن نمایهٔ ICM، IPTC یا عمومی به تصویر
گزینهٔ -profile filename یک نمایهٔ ICM (مدیریت رنگ ICC)، IPTC
(اطلاعات خبرگزاری) یا عمومی (شامل Exif) را به تصویر اضافه می‌کند
از +profile icm، +profile iptc یا
+profile profile_name برای حذف نمایهٔ مربوطه استفاده کنید.
می‌توان چند نمایه را که با کاما از هم جدا شده‌اند، فهرست کرد. می‌توان
با قرار دادن علامت تعجب پیش از نام نمایه، آن را از تطابق‌های
فهرست‌شدهٔ بعدی مستثنی کرد. برای نمونه، +profile '!icm,*'
تمام نمایه‌ها به جز نمایهٔ ICM را حذف می‌کند. از identify
-verbose برای پی بردن به این که چه نمایه‌هایی در فایل تصویر وجود دارند استفاده کنید. از
+profile "*" برای حذف تمامی نمایه‌ها استفاده کنید.
نوشتن تصویر در قالبی که از نمایه‌ها پشتیبانی نمی‌کند نیز
البته موجب حذف همهٔ نمایه‌ها خواهد شد. قالب‌های JPEG و PNG
هر نمایه‌ای را که خوانده شده و حذف نشده باشد ذخیره می‌کنند.
در JPEG آن‌ها در نشانگرهای APP1 و در PNG به صورت باینری
کدگذاری‌شده به مبنای ۱۶ در تکه‌های فشرده‌شدهٔ zTXt ذخیره می‌شوند، به جز تکهٔ iCC
که در تکهٔ iCCP ذخیره می‌شود.
برای استخراج یک نمایه، از گزینهٔ -profile استفاده نمی‌شود. در عوض،
به سادگی فایل را در قالبی تصویری
مانند APP1, 8BIM, ICM, یا IPTC ذخیره کنید.
برای مثال، برای استخراج داده‌های Exif (که در فایل‌های JPEG
در نمایهٔ APP1 ذخیره می‌شوند)، از این دستور استفاده کنید:
    gm convert cockatoo.jpg exifdata.app1

توجه داشته باشید که GraphicsMagick تلاشی برای به‌روزرسانی هیچ نمایه‌ای به منظور بازتاب تغییرات اعمال‌شده بر تصویر (مانند چرخش از حالت عمودی به افقی) نمی‌کند، بنابراین ممکن است نمایهٔ حفظ‌شده حاوی داده‌های نامعتبر باشد.

-preserve-timestamp

حفظ برچسب‌های زمانی اصلی فایل

از این گزینه برای حفظ برچسب‌های زمانی دسترسی و تغییر اصلی فایل، حتی در صورت تغییر یافتن آن، استفاده کنید.

+progress

غیرفعال‌سازی نمایشگر پیشرفت و مکان‌نمای مشغول

به‌طور پیش‌فرض، هنگام نمایش تصویر، یک نوار نمایشگر پیشرفت در گوشهٔ بالای سمت چپ پنجرهٔ نمایش تصویر موجود نشان داده می‌شود و مکان‌نمای فعلی با یک مکان‌نمای ساعت شنی جایگزین می‌شود. از +progress برای غیرفعال کردن نمایشگر پیشرفت و مکان‌نمای مشغول حین عملیات‌های نمایش استفاده کنید. با اینکه نمایشگر پیشرفت برای تمام عملیات‌ها غیرفعال می‌شود، اما مکان‌نمای مشغول برای عملیات‌های غیرنمایشی مانند پردازش تصویر همچنان فعال باقی می‌ماند. این گزینه برای عملیات‌های نمایش غیرتعاملی، یا در مواقعی که ظاهری خلوت و یکدست مد نظر است مفید خواهد بود.

-quality <value>

سطح فشرده‌سازی JPEG/MIFF/PNG/TIFF
برای قالب‌های تصویری JPEG و MPEG، کیفیت از 0 (کمترین کیفیت تصویر و بیشترین فشرده‌سازی) تا 100 (بهترین کیفیت، اما کم‌اثرترین فشرده‌سازی) است. مقدار پیش‌فرض کیفیت 75 است. از گزینهٔ -sampling-factor برای مشخص کردن ضرایب زیرنمونه‌گیری کروما استفاده کنید. برای استفاده از همان مقدار کیفیتی که رمزگشای JPEG تشخیص داده است، از پرچم -define jpeg:preserve-settings استفاده کنید.

برای قالب تصویر MIFF، و قالب TIFF هنگام استفاده از فشرده‌سازی ZIP، مقدار quality/10 بیانگر سطح فشرده‌سازی zlib است که مقداری از 0 (بدترین اما سریع‌ترین فشرده‌سازی) تا 9 (بهترین اما کُندترین) دارد. این مقدار هیچ اثری بر ظاهر تصویر ندارد، زیرا فشرده‌سازی همیشه بدون‌اتلاف است.

برای قالب تصویر JPEG-2000، کیفیت با استفاده از یک معادلهٔ غیرخطی به نسبت فشرده‌سازی مورد نیاز کتابخانهٔ Jasper نگاشت می‌شود. هدف از این معادلهٔ غیرخطی تقریب تقریبی کیفیت ارائه‌شده توسط قالب JPEG v1 است. مقدار کیفیت پیش‌فرض 75 منجر به درخواست فشرده‌سازی ۱۶:۱ می‌شود. مقدار کیفیت 100 منجر به درخواست فشرده‌سازی بدون‌اتلاف می‌گردد.

برای قالب‌های تصویری MNG و PNG، مقدار کیفیت، سطح فشرده‌سازی zlib (یعنی quality / 10) و نوع فیلتر (quality % 10) را مشخص می‌کند. سطوح فشرده‌سازی از 0 (سریع‌ترین فشرده‌سازی) تا 100 (بهترین اما کُندترین) متغیر است. برای سطح فشرده‌سازی 0، راهبرد تنها-هافمن (Huffman-only) استفاده می‌شود که سریع‌ترین است اما لزوماً بدترین فشرده‌سازی نیست.

اگر filter-type برابر با 4 یا کمتر باشد، نوع فیلتر مشخص‌شده برای تمام خطوط پویش به کار می‌رود:

0: none
1: sub
2: up
3: average
4: Paeth

اگر filter-type برابر با 5 باشد، فیلترسازی تطبیقی زمانی استفاده می‌شود که کیفیت بیشتر از 50 باشد و تصویر فاقد نگاشت رنگی باشد؛ در غیر این صورت هیچ فیلتری اعمال نمی‌شود.

اگر filter-type برابر با 6 باشد، فیلترسازی تطبیقی با minimum-sum-of-absolute-values استفاده می‌شود.

تنها در صورتی که خروجی MNG باشد، اگر filter-type برابر با 7 باشد، تبدیل رنگ LOCO و فیلترسازی تطبیقی با minimum-sum-of-absolute-values اعمال می‌شود.

کیفیت پیش‌فرض 75 است، که به معنی تقریباً بهترین فشرده‌سازی همراه با فیلترسازی تطبیقی است. تنظیم کیفیت هیچ اثری بر ظاهر تصاویر PNG و MNG ندارد، زیرا فشرده‌سازی همیشه بدون‌اتلاف است.

برای اطلاعات بیشتر، مشخصات PNG را ببینید.

هنگام نوشتن یک تصویر JNG دارای شفافیت، دو مقدار کیفیت مورد نیاز است، یکی برای تصویر اصلی و دیگری برای تصویر مقیاس خاکستری که کانال تیرگی را انتقال می‌دهد. این دو به صورت یک عدد صحیح واحد برابر با کیفیت تصویر اصلی بعلاوهٔ ۱۰۰۰ برابر کیفیت تیرگی نوشته می‌شوند. برای مثال، اگر می‌خواهید از کیفیت 75 برای تصویر اصلی و از کیفیت 90 برای فشرده‌سازی داده‌های تیرگی استفاده کنید، از -quality 90075 استفاده کنید.

برای خانوادهٔ قالب‌های PNM (شامل PNM، PGM، و PPM) ضریب کیفیت را برابر صفر مشخص کنید تا گونهٔ ASCII این قالب به دست آید. توجه داشته باشید که در گذشته از -compress none برای تولید خروجی ASCII استفاده می‌شد اما نتیجه‌ای معکوس در مقایسه با سایر قالب‌ها ارائه می‌داد.

برای قالب TIFF، الگوریتم‌های فشرده‌سازی JPEG، WebP، Zip و Zstd تحت تأثیر مقدار کیفیت قرار می‌گیرند. JPEG و WebP فشرده‌سازی بااتلاف ارائه می‌دهند، بنابراین کیفیت بالاتر فایلی بزرگتر با افت کیفیت کمتر تولید می‌کند. الگوریتم‌های فشرده‌سازی Zip و Zstd (و WebP در حالت بدون‌اتلاف) بدون‌اتلاف هستند و برای این الگوریتم‌ها مقدار ´quality' بالاتر به معنای پردازش بیشتر برای تولید فایلی کوچکتر است، اما بدون هیچ تفاوتی در کیفیت تصویر.

-raise <width>x<height>

روشن یا تاریک کردن لبه‌های تصویر

این کار یک جلوهٔ سه‌بعدی ایجاد می‌کند. برای جزئیات مربوط به مشخصات هندسه به -geometry مراجعه کنید. از آفست‌ها استفاده نمی‌شود.

از -raise برای ایجاد یک جلوهٔ برآمده، و در غیر این صورت از +raise استفاده کنید.

-random-threshold <channeltype> <LOWxHIGH>

اعمال آستانه‌گذاری تصادفی بر تصویر

کانال یا کانال‌های مشخص‌شده در آرگومان <channeltype> با استفاده از روش آستانه‌گذاری تصادفی به حالت دودویی تبدیل می‌شوند. گزینه‌های موجود برای channeltype عبارتند از: All، Intensity، Red، Green، Blue، Cyan، Magenta، Yellow، Black و Opacity

هنگامی که channeltype برابر "All" باشد، نمونه‌های رنگی به یک سطح خاکستری آستانه‌گذاری می‌شوند و سپس آن سطح خاکستری در سه کانال رنگ ذخیره می‌شود. به‌طور جداگانه، کانال تیرگی به یک مقدار تیرگی دوسطحی آستانه‌گذاری شده که در کانال تیرگی ذخیره می‌گردد. برای هر پیکسل، یک عدد تصادفی جدید برای تعیین آستانهٔ مورد استفاده به کار گرفته می‌شود. مقدار آستانه هرگز از بیشینهٔ مشخص‌شده (HIGH) فراتر نمی‌رود و کمتر از کمینهٔ مشخص‌شده (LOW) نخواهد بود.

هنگامی که channeltype برابر "intensity" باشد، فقط نمونه‌های رنگی آستانه‌گذاری می‌شوند. هنگامی که channeltype برابر "opacity" یا "matte" باشد، فقط کانال تیرگی آستانه‌گذاری می‌شود. سایر کانال‌های نام‌برده تنها کانال مرتبط با خود را آستانه‌گذاری می‌کنند.

-recolor <matrix>

اعمال یک ماتریس تبدیل رنگ به کانال‌های تصویر

یک ماتریس تبدیل رنگ ارائه‌شده توسط کاربر (به صورت یک رشتهٔ متنی) برای تبدیل/ترکیب کانال‌های تصویر بر اساس وزن‌دهی‌های موجود در ماتریس ارائه‌شده استفاده می‌شود که می‌تواند از مرتبهٔ ۳ (فقط کانال‌های رنگی)، ۴ (کانال‌های رنگی بعلاوهٔ تیرگی)، یا ۵ (کانال‌های رنگی بعلاوهٔ تیرگی و آفست) باشد. مقادیر موجود در ستون‌های ماتریس (قرمز، سبز، آبی، تیرگی) به عنوان ضرایب ضرب در مقادیر کانال‌های موجود استفاده شده و طبق ردیف‌های ماتریس با یکدیگر جمع می‌شوند. مقادیر ماتریس ممیز شناور هستند و می‌توانند منفی باشند. ستون آفست (ستون ۵) کاملاً جمع‌پذیر است و به‌گونه‌ای مقیاس‌بندی شده که 0.0 تا 1.0 بیانگر بیشینهٔ محدودهٔ کوانتومی باشد (اما مقادیر محدود به این بازه نیستند). محاسبات ریاضی ماتریس تبدیل رنگ مشابه روش استفاده‌شده در Adobe Flash است، با این تفاوت که آفست روی 1.0 مقیاس‌بندی شده است (آفست Flash را برای استفاده با GraphicsMagick بر ۲۵۵ تقسیم کنید) تا نتایج مستقل از عمق کوانتومی باشند.

یک ماتریس همانی (identity) برای هر مرتبهٔ ماتریس وجود دارد که منجر به هیچ تغییری در تصویر نمی‌شود. ماتریس تبدیل باید بر پایهٔ تغییر در ماتریس همانی باشد.

ماتریس همانی از مرتبهٔ ۳

1 0 0
0 1 0
0 0 1

که می‌تواند در قالب یک آرگومان ماتریسی مناسب به این شکل قالب‌بندی شود (کاما به عنوان فضای خالی در نظر گرفته می‌شود):

-recolor "1 0 0, 0 1 0, 0 0 1"

ماتریس همانی از مرتبهٔ ۴

1 0 0 0
0 1 0 0
0 0 1 0
0 0 0 1

ماتریس همانی از مرتبهٔ ۵. ردیف آخر برای اهداف تجزیه باید وجود داشته باشد، اما در غیر این صورت استفاده نمی‌شود.

1 0 0 0 0
0 1 0 0 0
0 0 1 0 0
0 0 0 1 0
0 0 0 0 1

به عنوان مثال، تصویری که به اشتباه دارای ترتیب کانال BGR است را می‌توان با استفاده از این ماتریس به RGB تبدیل کرد (آبی->قرمز، قرمز->آبی):

0 0 1
0 1 0
1 0 0

و یک تصویر RGB با استفاده از رنگ‌های پایهٔ استاندارد Rec.709 را می‌توان با استفاده از این ماتریس ضرایب وزن‌دهی استاندارد به مقیاس خاکستری تبدیل کرد:

0.2126 0.7152 0.0722
0.2126 0.7152 0.0722
0.2126 0.7152 0.0722

و کنتراست را می‌توان با کاهش مقیاس به میزان ۸۰٪ و افزودن ۱۰٪ آفست کاهش داد:

  0.8 0.0 0.0 0.0 0.1
  0.0 0.8 0.0 0.0 0.1
  0.0 0.0 0.8 0.0 0.1
  0.0 0.0 0.0 0.8 0.1
  0.0 0.0 0.0 0.0 1.0
-map <filename> 
انتخاب یک مجموعه رنگ خاص از این تصویر
[convert یا mogrify]
به‌طور پیش‌فرض، کاهش رنگ مجموعه‌ای بهینه از رنگ‌ها را برمی‌گزیند که تصویر اصلی را به بهترین نحو نمایش می‌دهند. در غیر این صورت، می‌توانید با این گزینه مجموعه‌ای خاص از رنگ‌ها را از یک فایل تصویری انتخاب کنید.
از
+map برای کاهش رنگ
تمام تصاویر موجود در دنباله تصاویر بعدی به یک مجموعه بهینه واحد از رنگ‌ها
که تمام تصاویر را به بهترین نحو نمایش دهد، استفاده کنید. دنباله تصاویر
با پدیدار شدن هر گزینه‌ای خاتمه می‌یابد.
اگر گزینه +map
پس از تمام تصاویر ورودی ظاهر شود، تمامی تصاویر نگاشت می‌شوند.

-red-primary <x>,<y>

نقطه اصلی مختصات رنگی قرمز

-region <width>x<height>{+-}<x>{+-}<y>

اعمال گزینه‌ها روی بخشی از تصویر
آفست‌های x و y به همان روشی که در -crop آمده پردازش می‌شوند.

-remote

انجام یک عملیات از راه دور X11
دستور -remote دستوری را به یک «gm display» یا «gm animate» که در حال حاضر در حال اجرا است ارسال می‌کند. تنها دستوری که در این زمان شناخته می‌شود، نام یک فایل تصویری برای بارگذاری است. این قابلیت برای بارگذاری تصاویر جدید بدون نیاز به راه‌اندازی مجدد GraphicsMagick بسیار کاربردی است (مثلاً برای نمایش اسلاید یا استفاده از GraphicsMagick به عنوان موتور نمایش برای یک واسط گرافیکی کاربر دیگر). همچنین گزینه +progress را ببینید تا بتوانید نشانگر پیشرفت را غیرفعال کرده و هنگام بارگذاری تصاویر جدید ظاهری تمیز داشته باشید.

-render

رندر عملیات برداری
از +render برای خاموش کردن رندر عملیات برداری استفاده کنید. این کار هنگام ذخیره خروجی در قالب‌های برداری مانند MVG یا SVG مفید است.

-repage <width>x<height>+xoff+yoff[!]

تنظیم آفست‌های صفحه تصویر
بوم و موقعیت صفحه تصویر فعلی را بر اساس مشخصات نسبی صفحه تنظیم می‌کند. از این گزینه می‌توان برای تغییر مکان یک زیرفریم (مثلاً بخشی از یک پویانمایی) پیش از ترکیب‌بندی (composition) استفاده کرد. اگر مشخصات هندسی (geometry) مطلق باشد (شامل «!» باشد)، تنظیم آفست مطلق خواهد بود و هیچ تنظیمی روی عرض و ارتفاع صفحه اعمال نمی‌شود؛ در غیر این صورت، مقادیر عرض و ارتفاع صفحه نیز بر اساس ابعاد تصویر فعلی تنظیم می‌شوند. برای بازگرداندن آفست‌های صفحه تصویر به حالت پیش‌فرض از +repage استفاده کنید.

-resample <horizontal>x<vertical>

نمونه‌برداری مجدد تصویر به وضوح افقی و عمودی مشخص‌شده
تغییر اندازه تصویر به گونه‌ای که اندازه رندر شده آن در وضوح هدف مشخص‌شده، با اندازه تصویر اصلی یکسان بماند. برای تفسیر این آرگومان، از واحدهای وضوح تصویر فعلی یا مقداری که پیش‌تر با -units تعیین شده استفاده می‌شود. به عنوان مثال، اگر یک تصویر ۳۰۰ DPI روی یک دستگاه ۳۰۰ DPI در ابعاد ۳ در ۲ اینچ رندر شود، هنگامی که تصویر به ۷۲ DPI بازنمونه‌برداری شود، روی یک دستگاه ۷۲ DPI باز هم در اندازه ۳ در ۲ اینچ رندر خواهد شد. توجه داشته باشید که تنها تعداد کمی از قالب‌های تصویر (مانند JPEG، PNG و TIFF) قادر به ذخیره وضوح تصویر هستند. برای قالب‌هایی که از وضوح تصویر پشتیبانی نمی‌کنند، وضوح اصلی تصویر باید پیش از مشخص کردن وضوح بازنمونه‌برداری، از طریق -density در خط فرمان مشخص شود.
توجه داشته باشید که Photoshop وضوح تصویر را در یک نمایه اختصاصی جاسازی‌شده ذخیره و دریافت می‌کند. اگر این نمایه در تصویر وجود داشته باشد، Photoshop همچنان با استفاده از وضوح پیشین خود با تصویر رفتار می‌کند و وضوح تصویر مشخص‌شده در سرایند استاندارد فایل را نادیده می‌گیرد.
برخی از قالب‌های تصویر (مانند PNG) به استفاده از واحدهای متریک یا انگلیسی نیاز دارند، بنابراین حتی اگر تصویر اصلی از یک سامانه واحد خاص استفاده کرده باشد، در صورت ذخیره شدن در قالبی دیگر پیش از بازنمونه‌برداری، ممکن است لازم باشد واحدهای وضوح مورد نظر را با استفاده از -units مشخص کنید، زیرا واحدهای اصلی ممکن است از دست رفته باشند. به عبارت دیگر، فرض نکنید که در صورت ذخیره تصویر در یک فایل، واحدهای وضوح بازیابی می‌شوند.

-resize <width>x<height>{%}{@}{!}{<}{>}

تغییر اندازه تصویر
این گزینه یک نام مستعار برای گزینه -geometry است و رفتاری مشابه دارد. اگر گزینه -filter پیش از گزینه -resize بیاید، فیلتر مشخص‌شده استفاده خواهد شد.
استثناهایی وجود دارد:
هنگامی که به عنوان گزینه composite استفاده می‌شود، -resize اندازه ترجیحی تصویر خروجی را مشخص می‌کند، در حالی که -geometry اندازه و جای‌گذاری تصویر ترکیبی را در تصویر اصلی بیان می‌کند.
هنگامی که به عنوان گزینه montage استفاده می‌شود، -resize اندازه ترجیحی مونتاژ را مشخص می‌کند، در حالی که -geometry اطلاعات مربوط به کاشی‌ها را بیان می‌کند.

-roll {+-}<x>{+-}<y>

غلتاندن تصویر به صورت عمودی یا افقی
برای جزئیات بیشتر درباره مشخصات هندسه، -geometry را ببینید. آفست‌های x و y تحت تأثیر گزینه -gravity قرار نمی‌گیرند.
آفست منفی x تصویر را از چپ به راست می‌غلتاند. آفست منفی y تصویر را از بالا به پایین می‌غلتاند.

-rotate <degrees>{<}{>}

چرخاندن تصویر
زاویه‌های مثبت تصویر را در جهت عقربه‌های ساعت و زاویه‌های منفی در جهت پادساعت‌گرد می‌چرخانند.
از > برای چرخاندن تصویر تنها در صورتی که عرض آن از ارتفاع بیشتر باشد استفاده کنید. علامت < تصویر را تنها در صورتی می‌چرخاند که عرض آن کمتر از ارتفاع باشد. به عنوان مثال، اگر -rotate "-90>" را مشخص کنید و اندازه تصویر 480x640 باشد، تصویر چرخانده نمی‌شود. اما اگر تصویر 640x480 باشد، ۹۰- درجه چرخانده می‌شود. در صورت استفاده از > یا <، آن را داخل علامت نقل‌قول قرار دهید تا از تفسیر اشتباه آن به عنوان تغییر مسیر فایل جلوگیری شود.
مثلث‌های خالی ناشی از چرخاندن تصویر با رنگ تعریف‌شده به عنوان background (کلاس backgroundColor) پر می‌شوند. این رنگ با استفاده از قالب شرح‌داده‌شده ذیل گزینه -fill تعیین می‌شود.

-sample <geometry>

مقیاس‌بندی تصویر با استفاده از نمونه‌برداری پیکسلی
برای جزئیات مربوط به مشخصات هندسی، -geometry را ببینید.
اگر گزینه -filter وجود داشته باشد، -sample فیلتر انتخاب‌شده را نادیده می‌گیرد. در صورت وجود آفست‌ها در رشته هندسه، آنها نادیده گرفته می‌شوند و گزینه -gravity هیچ تأثیری ندارد.

-sampling-factor <horizontal_factor>x<vertical_factor>

ضرایب زیرنمونه‌برداری رنگ
این گزینه ضرایب نمونه‌برداری را که باید توسط رمزگذارهای DPX، JPEG، MPEG یا YUV برای کاهش نمونه رنگ استفاده شوند، مشخص می‌کند. ضریب نمونه‌برداری باید هنگام خواندن قالب خام YUV مشخص شود زیرا در سرایند فایل نگهداری نمی‌شود.
همچنین می‌توان از نشانه‌گذاری استاندارد صنعتی زیرنمونه‌برداری ویدیو مانند «4:2:2» برای تعیین ضرایب نمونه‌برداری استفاده کرد. «4:2:2» معادل مشخصه «2x1» است.
رمزگشای JPEG هنگام خواندن یک فایل JPEG، ضرایب نمونه‌برداری اصلی (و تنظیمات کیفیت) را به دست می‌آورد. برای استفاده مجدد از ضرایب نمونه‌برداری اصلی (و تنظیمات کیفیت) در هنگام خروجی گرفتن به صورت JPEG، از پرچم -define jpeg:preserve-settings استفاده کنید.

-scale <geometry>

مقیاس‌بندی تصویر.
برای جزئیات مربوط به مشخصات هندسی، -geometry را ببینید. -scale از الگوریتمی ساده‌تر و سریع‌تر استفاده می‌کند و در صورت وجود گزینه -filter، فیلتر انتخاب‌شده را نادیده می‌گیرد. آفست‌ها در صورت وجود در رشته هندسه نادیده گرفته می‌شوند و گزینه -gravity هیچ اثری ندارد.

-scene <value>

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

-scenes <value-value>

بازه شماره‌های صحنه تصاویر جهت خواندن
هر تصویر در این بازه، با نام فایلی خوانده می‌شود که به دنبال آن یک نقطه (.) و شماره صحنه ده‌دهی قرار دارد. می‌توانید این رفتار را با گنجاندن مشخصه قالب printf به صورت %d, %0Nd, %o, %0No, %x, or %0Nx در نام فایل تغییر دهید. برای نمونه،
    gm montage -scenes 5-7 image.miff montage.miff

یک مونتاژ از فایل‌های image.miff.5، image.miff.6 و image.miff.7 می‌سازد، و

gm animate -scenes 0-12 image%02d.miff

فایل‌های image00.miff، image01.miff تا image12.miff را متحرک‌سازی می‌کند.

-screen

تعیین صفحه برای تصویربرداری

این گزینه مشخص می‌کند که درخواست GetImage که برای دریافت تصویر استفاده می‌شود، باید به جای انجام مستقیم روی پنجره مشخص‌شده، روی پنجره ریشه (root window) انجام شود. از این طریق می‌توانید بخش‌هایی از پنجره‌های دیگر را که با پنجره مشخص‌شده هم‌پوشانی دارند دریافت کنید، و مهم‌تر از آن، منوها یا سایر پنجره‌های بازشوی مستقلی را که روی پنجره مورد نظر ظاهر می‌شوند، ثبت نمایید..TP -set <attribute> <value> تنظیم یک مشخصه تصویر

یک مشخصه نام‌دار تصویر را تنظیم می‌کند. مشخصه روی تصویر جاری (که قبلاً در خط فرمان مشخص شده) تنظیم می‌شود.

+set <attribute>

لغو تنظیم یک مشخصه تصویر

تنظیم یک مشخصه نام‌دار تصویر را لغو می‌کند. مشخصه از تصویر جاری (که قبلاً در خط فرمان مشخص شده) حذف می‌شود.

-segment <cluster threshold>x<smoothing threshold>

قطعه‌بندی یک تصویر

با تجزیه و تحلیل هیستوگرام‌های مؤلفه‌های رنگ و شناسایی واحدهایی که با فن c-means فازی همگن هستند، تصویر را قطعه‌بندی می‌کند.

قطعه‌بندی یک الگوریتم کوانتیزاسیون رنگ بسیار مفید، سریع و تقریبی برای صفحات چاپ‌شده اسکن‌شده یا کارتون‌های اسکن‌شده است. همچنین می‌تواند به عنوان یک جلوه ویژه استفاده شود. cluster threshold را به عنوان حداقل درصد کل پیکسل‌ها در یک خوشه پیش از معتبر شناخته شدن آن مشخص کنید. برای تصاویر بسیار بزرگی که حاوی جزئیات ریز هستند، ممکن است این مقدار نیاز باشد کسر بسیار کوچکی از یک درصد (به عنوان مثال 0.015) باشد تا جزئیات مهم از دست نرود. Smoothing threshold نویز را در مشتق دوم هیستوگرام حذف می‌کند. با افزایش مقدار، می‌توانید انتظار مشتق دوم هموارتری را داشته باشید. مقدار پیش‌فرض 1.5 است. گزینه -verbose را اضافه کنید تا آماری از خوشه‌ها بر اساس پارامترهای استفاده شده نمایش داده شود. از این آمار می‌توان به عنوان راهنمایی برای تنظیم دقیق گزینه‌ها استفاده کرد.

-shade <azimuth>x<elevation>

سایه‌زدن تصویر با استفاده از یک منبع نور دوردست

azimuth و elevation را به عنوان موقعیت منبع نور مشخص کنید. از +shade برای برگرداندن نتایج سایه‌زنی به صورت یک تصویر در مقیاس خاکستری (grayscale) استفاده کنید.

-shadow <radius>{x<sigma>}

سایه‌اندازی روی مونتاژ

-shared-memory

استفاده از حافظه اشتراکی

این گزینه مشخص می‌کند که آیا ابزار باید تلاش کند از حافظه اشتراکی برای pixmapها استفاده کند یا خیر. GraphicsMagick باید با پشتیبانی از حافظه اشتراکی کامپایل شده باشد، و نمایشگر باید از افزونه MIT-SHM پشتیبانی کند. در غیر این صورت، این گزینه نادیده گرفته می‌شود. مقدار پیش‌فرض True است.

-sharpen <radius>{x<sigma>}

واضح‌سازی (شارپ کردن) تصویر

از یک عملگر گاوسی با شعاع و انحراف معیار (sigma) داده شده استفاده می‌کند.

-shave <width>x<height>{%}

تراشیدن پیکسل‌ها از لبه‌های تصویر

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

-shear <x degrees>x<y degrees>

برش تصویر در امتداد محور X یا Y

از زاویه برش مشخص شده مثبت یا منفی استفاده کنید.

برش (shearing)، یک لبه تصویر را در امتداد محور X یا Y می‌لغزاند و یک متوازی‌الأضلاع ایجاد می‌کند. برش در جهت X لبه را در امتداد محور X می‌لغزاند، در حالی که برش در جهت Y لبه را در امتداد محور Y می‌لغزاند. مقدار برش توسط زاویه برش کنترل می‌شود. برای برش‌های جهت X، x degrees نسبت به محور Y اندازه‌گیری می‌شود و به طور مشابه، برای برش‌های جهت Y، y degrees نسبت به محور X اندازه‌گیری می‌شود.

مثلث‌های خالی باقی‌مانده از برش تصویر با رنگ تعریف‌شده به عنوان background (کلاس backgroundColor) پر می‌شوند. رنگ با استفاده از قالب شرح‌داده‌شده ذیل گزینه -fill مشخص می‌شود.

-silent

عملکرد در حالت بی‌صدا

-size <width>x<height>{+offset}

عرض و ارتفاع تصویر

از این گزینه برای مشخص کردن عرض و ارتفاع تصاویر خامی که ابعاد آن‌ها ناشناخته است، مانند GRAY، RGB یا CMYK استفاده کنید. علاوه بر عرض و ارتفاع، از -size با یک آفست برای رد شدن از هرگونه اطلاعات سربرگ در تصویر یا بیان تعداد رنگ‌ها در یک فایل تصویری MAP استفاده کنید (به عنوان مثال -size 640x512+256).

برای تصاویر Photo CD، از بین این اندازه‌ها انتخاب کنید:

192x128
384x256
768x512
1536x1024
3072x2048

در نهایت، از این گزینه برای انتخاب یک لایه تفکیک‌پذیری خاص از یک تصویر JBIG یا JPEG استفاده کنید (مانند -size 1024x768).

-snaps <value>

تعداد عکس‌های فوری از صفحه نمایش

از این گزینه برای گرفتن بیش از یک تصویر از صفحه نمایش کارساز X، جهت ایجاد یک دنباله پویانمایی استفاده کنید.

-solarize <factor>

وارونه‌کردن تمام پیکسل‌های بالاتر از سطح آستانه

مقدار factor را به عنوان درصد آستانه شدت نور (0 - 99.9%) مشخص کنید.

این گزینه جلوه solarization (سولاریزاسیون) را ایجاد می‌کند که هنگام قرار گرفتن فیلم عکاسی در معرض نور طی فرآیند ظهور دیده می‌شود.

-spread <amount>

جابه‌جایی پیکسل‌های تصویر به میزان تصادفی

مقدار Amount اندازه همسایگی اطراف هر پیکسل را برای انتخاب یک پیکسل نامزد جهت جابه‌جایی تعیین می‌کند.

-stegano <offset>

پنهان‌سازی واترمارک درون یک تصویر

از یک آفست برای شروع پنهان‌سازی تصویر با فاصله مشخصی از پیکسل‌ها از ابتدای تصویر استفاده کنید. این آفست و اندازه تصویر را یادداشت کنید. برای بازیابی تصویر پنهان‌نگاری شده به این اطلاعات نیاز خواهید داشت (به عنوان مثال display -size 320x256+35 stegano:image.png).

-stereo

ترکیب دو تصویر برای ایجاد یک آناگلیف سه‌بعدی

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

-strip

حذف تمام پروفایل‌ها و مشخصه‌های متنی از تصویر

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

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

-stroke <color>

رنگ مورد استفاده برای خط دور اشکال اولیه گرافیکی

رنگ با استفاده از قالب شرح‌داده‌شده ذیل گزینه -fill مشخص می‌شود.

برای جزئیات بیشتر به -draw مراجعه کنید.

-strokewidth <value>

تنظیم ضخامت خط دور

برای جزئیات بیشتر به -draw مراجعه کنید.

-swirl <degrees>

چرخش گردابی پیکسل‌های تصویر حول مرکز

مقدار Degrees میزان فشردگی پیچش گردابی را تعیین می‌کند.

-text-font <name>

قلم برای نوشتن متن با عرض ثابت

نام قلم ترجیحی را برای استفاده در متن با قالب‌بندی ثابت (سبک ماشین تحریر) مشخص می‌کند. پیش‌فرض Courier با اندازه ۱۴ نقطه است.

می‌توانید یک قلم را نشانه‌گذاری کنید تا مشخص شود که یک قلم PostScript، TrueType یا X11 است. به عنوان مثال، Courier.ttf یک قلم TrueType و x:fixed از نوع X11 است.

-texture <filename>

نام بافت برای کاشی‌کاری روی پس‌زمینه تصویر

-threshold <value>{%}

آستانه‌گذاری تصویر

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

برای ایجاد بهینه یک تصویر سیاه و سفید از یک تصویر رنگی، از این دستور استفاده کنید:

gm convert -threshold 50% in.png out.png

مقدار آستانه بهینه به ماهیت تصویر بستگی دارد. به منظور آستانه‌گذاری کانال‌های جداگانه، از زیردستور -operator با گزینه‌های Threshold، Threshold-White یا Threshold-Black آن استفاده کنید..TP -thumbnail <width>x<height>{%}{@}{!}{<}{>} تغییر اندازه یک تصویر (سریع)

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

-tile <filename>

کاشی‌کاری تصویر هنگام پر کردن اشکال هندسی اولیه

-tile <geometry>

چیدمان تصاویر [montage]

-title <string>

تخصیص عنوان به تصویر نمایش‌داده‌شده [animate, display, montage]

از این گزینه برای اختصاص یک عنوان مشخص به تصویر استفاده کنید. این عنوان به پنجره تصویر تخصیص یافته و معمولاً در نوار عنوان پنجره نمایش داده می‌شود. به صورت اختیاری می‌توانید نام فایل تصویر، نوع، عرض، ارتفاع، داده‌های Exif، یا سایر ویژگی‌های تصویر را با گنجاندن نویسه‌های قالب‌بندی خاص که ذیل گزینه -format شرح داده شده‌اند، در عنوان قرار دهید.

برای مثال،

-title "%m:%f %wx%h"

عنوانی معادل MIFF:bird.miff 512x480 را برای تصویری با نام bird.miff با عرض ۵۱۲ و ارتفاع ۴۸۰ ایجاد می‌کند.

-transform

تبدیل تصویر

این گزینه ماتریس تبدیل را از گزینه پیشین -affine اعمال می‌کند.

gm convert -affine 2,2,-2,2,0,0 -transform bird.ppm bird.jpg

-transparent <color>

شفاف کردن این رنگ در تصویر

این رنگ با استفاده از قالبی که ذیل گزینه -fill شرح داده شده است، مشخص می‌شود.

-treedepth <value>

عمق درخت برای الگوریتم کاهش رنگ

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

یک عمق بهینه عموماً امکان بهترین بازنمایی تصویر منبع را با بالاترین سرعت محاسباتی و کمترین میزان حافظه فراهم می‌کند. با این حال، عمق پیش‌فرض برای برخی تصاویر نامناسب است. برای اطمینان از بهترین بازنمایی، مقادیر بین ۲ و ۸ را برای این پارامتر امتحان کنید. برای جزئیات بیشتر به quantize مراجعه کنید.

برای اعمال این گزینه، وجود گزینه -colors یا -monochrome، یا ذخیره‌سازی در قالب تصویری که نیازمند کاهش رنگ باشد، الزامی است.

-trim

حاشیه‌گیری تصویر

این گزینه هر لبه‌ای را که دقیقاً همرنگ پیکسل‌های گوشه باشد حذف می‌کند. از -fuzz استفاده کنید تا -trim لبه‌هایی را که رنگشان تقریباً با پیکسل‌های گوشه یکسان است نیز حذف کند.

-type <type>

نوع تصویر

انتخاب از میان: Bilevel، Grayscale، Palette، PaletteMatte، TrueColor، TrueColorMatte، ColorSeparation، ColorSeparationMatte یا Optimize.

معمولاً هنگامی که یک قالب از زیرقالب‌های متفاوتی مانند bilevel، grayscale، palette، truecolor و truecolor+alpha پشتیبانی می‌کند، کدگذار (encoder) تلاش خواهد کرد تا زیرقالبی مناسب را بر اساس ماهیت تصویر انتخاب کند. گزینه -type می‌تواند برای سفارشی‌سازی زیرقالب خروجی به کار رود. به‌طور پیش‌فرض زیرقالب خروجی بر اساس اطلاعات به راحتی در دسترس تصویر تعیین شده و معمولاً مشابه قالب ورودی است.

مقدار -type Optimize را به منظور فعال‌سازی بازرسی تمام پیکسل‌ها (در صورت لزوم) برای یافتن کارآمدترین زیرقالب مشخص کنید. بازرسی تمام پیکسل‌ها ممکن است برای تصاویر بسیار بزرگ، به‌ویژه در صورتی که در حافظه موقت دیسک ذخیره شده باشند، کند باشد. اگر یک تصویر RGB تنها شامل پیکسل‌های خاکستری باشد، برای تشخیص اینکه تصویر در واقع grayscale است، باید تک‌تک پیکسل‌های تصویر بازرسی شوند!

گاهی اوقات یک زیرقالب خاص مد نظر است. برای مثال، جهت وادار کردن یک تصویر JPEG به ذخیره‌سازی در قالب TrueColor RGB حتی با وجود اینکه تنها پیکسل‌های خاکستری در آن موجود است، از این دستور استفاده کنید:

gm convert bird.pgm -type TrueColor bird.jpg

به همین ترتیب، استفاده از -type TrueColorMatte در صورتی که قالب خروجی از شفافیت پشتیبانی کند، کدگذار را وادار می‌کند تا یک کانال آلفا ذخیره کند، حتی اگر تصویر کاملاً کدر باشد.

برخی از شبه‌قالب‌ها (مانند قالب XC) در صورتی که نوع درخواستی پیش‌تر در خط فرمان آمده باشد، آن را رعایت می‌کنند. به عنوان مثال، برای به دست آوردن یک بوم نقاشی تک‌رنگ از نوع DirectClass به جای PseudoClass، از این دستور استفاده کنید:

gm convert -size 640x480 -type TrueColor xc:red red.miff

به همین ترتیب، پیش از خواندن یک فایل Postscript (یا فایل PDF)، مقدار -type را برابر با Bilevel، Grayscale، TrueColor یا TrueColorMatte مشخص کنید تا بر نوع تصویری که Ghostcript بازمی‌گرداند اثر بگذارید. کارایی خواندن برای فایل‌های Postscript سیاه/سفید در صورت مشخص شدن Bilevel به طور چشمگیری بهبود خواهد یافت و اگر Grayscale تعیین شود، به طور قابل توجهی سریع‌تر خواهد بود.

-update <seconds>

تشخیص تغییر فایل تصویر و نمایش مجدد آن.

فرض کنید در حین نمایش یک تصویر، فایلی که در حال حاضر نمایش داده می‌شود بازنویسی شود. برنامه display به طور خودکار تغییر فایل ورودی را تشخیص داده و تصویر نمایش‌داده‌شده را بر این اساس به‌روزرسانی می‌کند.

-units <type>

واحدهای وضوح تصویر

انتخاب از میان: Undefined، PixelsPerInch یا PixelsPerCentimeter. این گزینه معمولاً به همراه گزینه -density به کار می‌رود.

-unsharp <radius>{x<sigma>}{+<amount>}{+<threshold>}

واضح‌سازی تصویر با عملگر ماسک محوشدگی معکوس (unsharp mask)

گزینه -unsharp تصویر را واضح‌تر می‌کند. تصویر با یک عملگر گاوسی با شعاع و انحراف معیار (sigma) داده شده پیچش (کانولوشن) می‌یابد. برای دستیابی به نتایج مناسب، شعاع باید بزرگ‌تر از سیگما باشد. از شعاع 0 استفاده کنید تا این متد شعاع مناسب را خود انتخاب کند.

پارامترها عبارتند از:

radius

شعاع عملگر گاوسی، بر حسب پیکسل، بدون احتساب پیکسل مرکزی (پیش‌فرض 0).

sigma

انحراف معیار عملگر گاوسی، بر حسب پیکسل (پیش‌فرض 1.0).

amount

درصد تفاوت میان تصویر اصلی و تصویر محوشده که مجدداً به تصویر اصلی افزوده می‌شود (پیش‌فرض 1.0).

threshold

آستانه، به عنوان کسری از MaxRGB، که برای اعمال مقدار تفاوت مورد نیاز است (پیش‌فرض 0.05).

-use-pixmap

استفاده از pixmap

-verbose

چاپ اطلاعات تفصیلی درباره تصویر

این اطلاعات چاپ می‌شوند: شماره صحنه تصویر؛ نام تصویر؛ اندازه تصویر؛ کلاس تصویر (DirectClass یا PseudoClass)؛ تعداد کل رنگ‌های یکتا؛ و مدت‌زمان به ثانیه برای خواندن و تبدیل تصویر. اگر تصویر از نوع DirectClass باشد، تعداد کل رنگ‌های یکتا نمایش داده نمی‌شود مگر اینکه -verbose دو بار مشخص شود، چرا که محاسبه آن، به‌ویژه برای تصاویر با عمق بالا، ممکن است زمان زیادی ببرد. اگر تصویر از نوع PseudoClass باشد، پیکسل‌های آن بر اساس نمایه‌ها در یک جدول رنگی (colormap) تعریف می‌شوند. اگر تصویر از نوع DirectClass باشد، هر پیکسل شامل یک مشخصه رنگی کامل و مستقل است.

اگر -colors نیز مشخص شده باشد، مجموع رنگ‌های یکتا در تصویر و مقادیر خطای کاهش رنگ چاپ می‌شوند. برای شرح این مقادیر به quantize مراجعه کنید..TP -version چاپ اطلاعات دقیق نسخه/ساخت GraphicsMagick

نسخه انتشار، حداکثر عمق نمونه (sample-depth)، نشانی اینترنتی وب‌سایت، اعلان کپی‌رایت، پشتیبانی از ویژگی‌ها، و گزینه‌های به‌کاررفته در هنگام ساخت نرم‌افزار را گزارش می‌دهد. این همان خروجی تولیدشده توسط زیردستور

-version

چاپ اطلاعات فشرده نسخه GraphicsMagick به سبک GNU

نسخه انتشار، حداکثر عمق نمونه (sample-depth)، نشانی اینترنتی وب‌سایت، و اعلان کپی‌رایت را گزارش می‌دهد.

-view <string>

پارامترهای نمایش FlashPix

-virtual-pixel <method>

مشخص کردن محتوای «پیکسل‌های مجازی»

این گزینه «پیکسل‌های مجازی» را برای استفاده در عملیاتی که می‌توانند به پیکسل‌های خارج از مرزهای تصویر دسترسی داشته باشند تعریف می‌کند.

از میان این روش‌ها انتخاب کنید:

Constant

استفاده از رنگ پس‌زمینه تصویر.

Edge

گسترش پیکسل لبه تا بی‌نهایت (پیش‌فرض).

Mirror

آینه‌ای کردن تصویر.

Tile

کاشی‌کاری تصویر.

این گزینه بر عملیاتی که از پیکسل‌های مجازی استفاده می‌کنند، مانند -blur، -sharpen، -wave و غیره تأثیر می‌گذارد.

-visual <type>

متحرک‌سازی تصاویر با استفاده از این نوع visual در X

از میان این رده‌های visual انتخاب کنید:

StaticGray
GrayScale
StaticColor
PseudoColor
TrueColor
DirectColor
default
visual id

کارساز X باید از visual انتخابی شما پشتیبانی کند، در غیر این صورت خطایی رخ می‌دهد. اگر visual مشخص نشود، رده visual که می‌تواند بیشترین رنگ‌های هم‌زمان را در صفحه پیش‌فرض نمایش دهد انتخاب می‌شود.

-watermark <brightness>x<saturation>

درصد روشنایی و اشباع رنگ یک واترمارک

-wave <amplitude>x<wavelength>

تغییر شکل تصویر در امتداد یک موج سینوسی

دامنه (amplitude) و طول موج (wavelength) موج را مشخص کنید.

-white-point <x>,<y>

نقطه سفید رنگ‌مندی (chromaticity)

-white-threshold red[,green][,blue][,opacity]

پیکسل‌های بالاتر از آستانه، سفید می‌شوند

از -white-threshold برای تنظیم پیکسل‌های دارای مقادیر بالاتر از آستانه مشخص‌شده به حداکثر مقدار (سفید) استفاده کنید. اگر فقط یک مقدار ارائه شود، یا مقادیر قرمز، سبز و آبی یکسان باشند، از آستانه‌گذاری شدت (intensity) استفاده می‌شود. اگر مقادیر آستانه رنگ یکسان نباشند، از آستانه‌گذاری مبتنی بر کانال استفاده می‌شود و اعوجاج رنگ رخ خواهد داد. اگر می‌خواهید کانالی نادیده گرفته شود اما مایلید کانالی دیگر که در ادامه فهرست آمده است آستانه‌گذاری شود، یک مقدار منفی (مانند -1) مشخص کنید. اگر نماد درصد (%) ضمیمه شود، مقادیر به عنوان درصدی از حداکثر محدوده در نظر گرفته می‌شوند.

-window <id>

قرار دادن تصویر به عنوان پس‌زمینه یک پنجره

id می‌تواند شناسه پنجره یا نام آن باشد. برای انتخاب پنجره ریشه X به عنوان پنجره هدف، root را مشخص کنید.

به‌طور پیش‌فرض، تصویر به صورت کاشی‌کاری روی پس‌زمینه پنجره هدف قرار می‌گیرد. اگر backdrop یا -geometry مشخص شده باشند، تصویر با رنگ پس‌زمینه احاطه می‌شود. برای جزئیات به X RESOURCES مراجعه کنید.

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

-window-group

مشخص کردن گروه پنجره

-write <filename>

نوشتن یک تصویر میانی [convert, composite]

تصویر فعلی در نام فایل مشخص‌شده نوشته می‌شود و سپس پردازش با استفاده از آن تصویر ادامه می‌یابد. در ادامه مثالی از چگونگی تولید چند اندازه از یک تصویر در یک دستور آورده شده است (هر چند بار که لازم است تکرار کنید):

gm convert input.jpg -resize 50% -write input50.jpg \
          -resize 25% input25.jpg

-write <filename>

نوشتن تصویر در یک فایل [display]

اگر filename از قبل وجود داشته باشد، در مورد اینکه آیا باید بازنویسی شود از شما پرسیده خواهد شد.

به‌طور پیش‌فرض، تصویر با همان قالبی که خوانده شده است نوشته می‌شود. برای تعیین قالبی خاص برای تصویر، نوع تصویر و یک دو‌نقطه را پیشوند filename کنید (مانند ps:image) یا نوع تصویر را به عنوان پسوند نام فایل مشخص نمایید (مانند image.ps). برای خروجی استاندارد نام فایل را - قرار دهید. اگر فایل دارای پسوند .Z یا .gz باشد، اندازه فایل به ترتیب با استفاده از compress یا gzip به‌صورت فشرده درمی‌آید. برای هدایت (pipe) به یک دستور سیستمی، قبل از نام فایل تصویر | قرار دهید.

برای مشخص کردن نوع فشرده‌سازی تصویر از -compress استفاده کنید.

منبع معادل سامانه X برای این گزینه writeFilename (رده WriteFilename) است. برای جزئیات، بخش "X Resources" را در ادامه ببینید..SH "محیط (ENVIRONMENT)"

COLUMNS

عرض صفحه خروجی. هنگام قالب‌بندی متن برای صفحه نمایش استفاده می‌شود. بسیاری از سیستم‌های Unix این متغیر شل را به‌روز نگه می‌دارند، اما ممکن است نیاز باشد صراحتاً export شود تا GraphicsMagick بتواند آن را ببیند.

DISPLAY

شناسه نمایشگر X11 (میزبان، شماره نمایشگر و صفحه نمایش در قالب hostname:display.screen).

HOME

مکان دایرکتوری خانگی کاربر. به دلایل امنیتی، اکنون تنها توسط ساخت‌های نصب‌نشده («uninstalled») از GraphicsMagick که مکان آن‌ها به‌صورت هاردکدشده یا توسط یک نصاب تعیین نشده است رعایت می‌شود. در صورت پشتیبانی، GraphicsMagick در صورت وجود دایرکتوری $HOME/.magick، فایل‌های پیکربندی را در آن جستجو می‌کند. در صورت نیاز به انعطاف‌پذیری بیشتر، MAGICK_CODER_MODULE_PATH، MAGICK_CONFIGURE_PATH و MAGICK_FILTER_MODULE_PATH را ببینید.

MAGICK_ACCESS_MONITOR

هنگامی که روی TRUE تنظیم شود، حالت پایش خط فرمان (فعال‌شده با -monitor) همچنین فایل‌های دسترسی‌یافته (از جمله فایل‌های موقت) و هر دستور خارجی اجراشده را نمایش می‌دهد. این قابلیت برای اشکال‌زدایی مفید است، اما همچنین آرگومان‌های ارائه‌شده به گرداننده دسترسی ثبت‌شده توسط تابع کتابخانه C با نام MagickSetConfirmAccessHandler() را نمایش می‌دهد.

MAGICK_CODER_STABILITY

حداقل سطح پایداری کدکننده قبل از اینکه مورد استفاده قرار گیرد. سطوح موجود عبارتند از PRIMARY، STABLE، UNSTABLE و BROKEN. حداقل سطح پیش‌فرض UNSTABLE است، که یعنی تمام کدکننده‌های فعال موجود استفاده خواهند شد. هدف این گزینه کاهش ریسک امنیتی (یا پیچیدگی ظاهری) ناشی از تعداد بسیار زیاد قالب‌های پشتیبانی‌شده است. کدکننده‌های سطح PRIMARY قالب‌های پرکاربرد با پیاده‌سازی‌های بسیار خوب نگهداری‌شده هستند. کدکننده‌های سطح STABLE به‌طور معقولی خوب نگهداری می‌شوند اما نشان‌دهنده قالب‌های کمتر استفاده‌شده هستند. کدکننده‌های سطح UNSTABLE یا پیاده‌سازی‌های ضعیفی دارند، یا خود قالب فایل ضعیف است، یا احتمال نیاز به آن کدکننده بسیار ناچیز است. کدکننده‌های سطح BROKEN مشخصاً اغلب درست کار نمی‌کنند یا ممکن است در وضعیت فعلی‌شان اصلاً قابل استفاده نباشند.

MAGICK_CODER_MODULE_PATH

مسیر جستجو برای استفاده هنگام جستجوی ماژول‌های کدکننده قالب تصویر. این مسیر به کاربر اجازه می‌دهد با افزودن ماژول‌های بارگذاری‌پذیر به یک مکان دلخواه به جای کپی کردن آن‌ها در دایرکتوری نصب GraphicsMagick، قالب‌های تصویر پشتیبانی‌شده توسط GraphicsMagick را به دلخواه گسترش دهد. قالب‌بندی مسیر جستجو مشابه مسیرهای جستجوی سیستم‌عامل است (یعنی برای Unix با دونقطه (:) و برای Microsoft Windows با نقطه‌ویرگول (;) جدا می‌شود). این مسیر جستجوی مشخص‌شده توسط کاربر پیش از بررسی مسیر جستجوی پیش‌فرض استفاده می‌شود.

MAGICK_CONFIGURE_PATH

مسیر جستجو برای استفاده هنگام جستجوی فایل‌های پیکربندی (.mgk). قالب‌بندی مسیر جستجو مشابه مسیرهای جستجوی سیستم‌عامل است (یعنی برای Unix با دونقطه و برای Microsoft Windows با نقطه‌ویرگول جدا می‌شود). این مسیر جستجوی مشخص‌شده توسط کاربر پیش از بررسی مسیر جستجوی پیش‌فرض استفاده می‌شود.

MAGICK_DEBUG

گزینه‌های اشکال‌زدایی (برای جزئیات -debug را ببینید). تنظیم گزینه اشکال‌زدایی configure از طریق یک متغیر محیط (به عنوان مثال MAGICK_DEBUG=configure) برای مشاهده کامل فرایند راه‌اندازی اولیه، که شامل جستجو برای فایل‌های پیکربندی است، لازم است.

MAGICK_FILTER_MODULE_PATH

مسیر جستجو برای استفاده هنگام جستجوی ماژول‌های پردازش فیلتر (فراخوانی‌شده از طریق -process). این مسیر به کاربر اجازه می‌دهد با افزودن ماژول‌های بارگذاری‌پذیر به یک مکان دلخواه به جای کپی کردن آن‌ها در دایرکتوری نصب GraphicsMagick، قابلیت‌های پردازش تصویر GraphicsMagick را به دلخواه گسترش دهد. قالب‌بندی مسیر جستجو مشابه مسیرهای جستجوی سیستم‌عامل است (یعنی برای Unix با دونقطه و برای Microsoft Windows با نقطه‌ویرگول جدا می‌شود). این مسیر جستجوی مشخص‌شده توسط کاربر پیش از بررسی مسیر جستجوی پیش‌فرض استفاده می‌شود.

MAGICK_GHOSTSCRIPT_PATH

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

MAGICK_HOME

مسیر شاخه اصلی دایرکتوری نصب GraphicsMagick. فقط توسط ساخت‌های نصب‌نشده («uninstalled») از GraphicsMagick که مکان آن‌ها به‌صورت هاردکدشده یا توسط یک نصاب تعیین نشده است رعایت می‌شود.

MAGICK_MMAP_READ

اگر MAGICK_MMAP_READ روی TRUE تنظیم شود، GraphicsMagick تلاش خواهد کرد فایل ورودی را برای خواندن در حافظه نگاشت کند (memory-map). این کار معمولاً عملکرد خواندن‌های مکرر را به میزان قابل توجهی بهبود می‌بخشد، زیرا فایل پس از نخستین باری که خوانده شد، در حافظه قرار دارد. با این حال، آزمایش‌ها نشان می‌دهد که ممکن است عملکرد برای فایل‌هایی که برای اولین بار به آن‌ها دسترسی پیدا می‌شود کاهش یابد، زیرا دسترسی به داده‌ها از طریق نقص صفحه (page-faults در اولین دسترسی) صورت می‌گیرد و بسیاری از سیستم‌های عامل پیش‌خوانی متوالی (sequential read-ahead) فایل‌های نگاشت‌شده در حافظه را به درستی انجام نمی‌دهند، به‌ویژه اگر دسترسی به آن فایل‌ها از طریق شبکه باشد. در صورت خواندن چندین فایل ورودی بزرگ، فعال‌سازی این گزینه ممکن است با تحمیل بار اضافی بر سیستم حافظه مجازی (VM) سیستم‌عامل، به عملکرد آسیب برساند، چرا که باید صفحات نگاشت‌نشده را آزاد کرده و صفحات جدید را نگاشت کند.

MAGICK_IO_FSYNC

اگر MAGICK_IO_FSYNC روی TRUE تنظیم شود، آنگاه GraphicsMagick درخواست خواهد کرد که فایل خروجی هنگام بسته شدن به‌طور کامل تخلیه (flush) شده و با دیسک همگام‌سازی شود. این کار مستلزم افت عملکرد است، اما این مزیت را دارد که در صورت قطع برق یا از کار افتادن سیستم (crash)، فایل روی دیسک معتبر باقی می‌ماند. اگر فایل‌های تصویری از یک پایگاه‌داده ارجاع داده شوند، این گزینه به اطمینان از معتبر بودن فایل‌های ارجاع‌شده توسط پایگاه‌داده کمک می‌کند.

MAGICK_IOBUF_SIZE

میزان بافرینگ I/O (به بایت) برای استفاده هنگام خواندن و نوشتن فایل‌های کدگذاری‌شده. مقدار پیش‌فرض 16384 است، که مشاهده شده در بسیاری از موارد به خوبی عمل می‌کند. بهترین مقدار برای یک سیستم فایل محلی معمولاً اندازه بلوک بومی سیستم فایل است (مثلاً 4096، 8192 یا حتی 131,072 برای ZFS) تا تعداد عملیات فیزیکی دیسک به حداقل برسد. عملکرد I/O برای فایل‌هایی که از طریق شبکه مورد دسترسی قرار می‌گیرند ممکن است با تنظیم این گزینه به طور قابل توجهی بهبود یابد. مقادیر بزرگ‌تر لزوماً بهتر نیستند (ممکن است کندتر باشند!) و به‌ندرت مزیتی در استفاده از مقادیر بزرگ‌تر از 32768 وجود دارد. از گزینه -verbose در دستور convert برای ارزیابی نرخ خواندن و نوشتن بر حسب پیکسل در ثانیه استفاده کنید، در حالی که در نظر دارید سیستم‌عامل تلاش خواهد کرد فایل‌ها را در RAM حافظه موقت (کَش) کند.

MAGICK_LIMIT_DISK

حداکثر مقدار فضای دیسک مجاز برای استفاده توسط کَش پیکسل.

MAGICK_LIMIT_FILES

حداکثر تعداد فایل‌های باز.

MAGICK_LIMIT_MAP

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

MAGICK_LIMIT_MEMORY

حداکثر مقدار حافظه برای تخصیص از هیپ (heap).

MAGICK_LIMIT_PIXELS

حداکثر تعداد کل پیکسل‌ها (ردیف‌های تصویر ضرب در ستون‌های تصویر) مجاز برای هر تصویری که درخواست ایجاد یا خواندن آن داده شده است. این گزینه برای محدود کردن اندازه تصویر مفید است. اگر ابعاد تصویر فایل ورودی بزرگ‌تر از حد مجاز پیکسل باشد، تخصیص حافظه تصویر رد شده و فوراً یک خطا برگردانده می‌شود. این محدودیت برای هر تصویر جداگانه است و کل تعداد پیکسل‌ها ناشی از چندین فریم/صفحه تصویر (مانند یک سند چندصفحه‌ای یا یک پویانمایی) را محدود نمی‌کند.

MAGICK_LIMIT_READ

حداکثر تعداد بایت‌های غیرفشرده که می‌توان هنگام رمزگشایی یک تصویر خواند. هر بار خواندن از فایل ورودی توسط نرم‌افزار، به حساب این مجموع محاسبه می‌شود، حتی اگر قبلاً خوانده شده باشد. هنگامی که این حد حاصل شود، رمزگشایی با شکست مواجه می‌شود. این محدودیت برای محافظت در برابر فایل‌های بسیار فشرده‌شده (مثلاً از طریق gzip)، یا فایل‌هایی که از ساختارهای حلقه‌ای پیچیده استفاده می‌کنند، یا هنگامی که داده‌ها از یک جریان (pipe) خوانده می‌شوند، کمک می‌کند.

MAGICK_LIMIT_WIDTH

حداکثر عرض به پیکسل برای تصویری که خوانده یا ایجاد می‌شود.

MAGICK_LIMIT_HEIGHT

حداکثر ارتفاع به پیکسل برای تصویری که خوانده یا ایجاد می‌شود.

MAGICK_TMPDIR

مسیر دایرکتوری‌ای که GraphicsMagick باید فایل‌های موقت را در آن بنویسد. پیش‌فرض این است که از مقدار پیش‌فرض سیستم، یا مکان تعیین‌شده توسط TMPDIR استفاده شود.

TMPDIR

برای سیستم‌های سازگار با POSIX (سازگار با Unix)، مسیر دایرکتوری‌ای که همه برنامه‌ها باید فایل‌های موقت را در آن بنویسند. در صورت تنظیم بودن MAGICK_TMPDIR، با آن جایگزین می‌شود.

TMP یا TEMP

برای Microsoft Windows، مسیر دایرکتوری‌ای که برنامه‌ها باید فایل‌های موقت را در آن بنویسند. در صورت تنظیم بودن MAGICK_TMPDIR، با آن جایگزین می‌شود.

OMP_NUM_THREADS

مطابق با استاندارد OpenMP، این متغیر تعداد رشته‌های (threads) مورد استفاده در نواحی موازی را تعیین می‌کند. برخی از کامپایلرها تعداد پیش‌فرض رشته‌های مورد استفاده را روی تعداد هسته‌های پردازنده موجود تنظیم می‌کنند، در حالی که برخی دیگر به طور پیش‌فرض تنها از یک رشته استفاده می‌کنند. برای سایر تنظیمات استاندارد، مشخصات OpenMP و برای تنظیمات مختص هر تولیدکننده، راهنمای کامپایلر خود را ببینید..SH "فایل‌های پیکربندی (CONFIGURATION FILES)" نرم‌افزار GraphicsMagick از چندین فایل پیکربندی در قالب XML استفاده می‌کند:

colors.mgk

فایل پیکربندی رنگ‌ها

<?xml version="1.0"?>
<colormap>
  <color name="AliceBlue" red="240" green="248" blue="255"
         compliance="SVG, X11, XPM" />
</colormap>

delegates.mgk

فایل پیکربندی برنامه‌های واسط (delegates)

log.mgk

فایل پیکربندی ثبت گزارش‌ها (logging)

<?xml version="1.0"?>
<magicklog>
  <log events="None" />
  <log output="stdout" />
  <log filename="Magick-%d.log" />
  <log generations="3" />
  <log limit="2000" />
  <log format="%t %r %u %p %m/%f/%l/%d:\n  %e"  />
</magicklog>

modules.mgk

فایل پیکربندی ماژول‌های بارگذاری‌پذیر

<?xml version="1.0"?>
<modulemap>
  <module magick="8BIM" name="META" />
</modulemap>

type.mgk

فایل پیکربندی اصلی قلم‌ها (fonts)

<?xml version="1.0"?>
<typemap>
  <include file="type-windows.mgk" />
  <type
    name="AvantGarde-Book"
    fullname="AvantGarde Book"
    family="AvantGarde"
    foundry="URW"
    weight="400"
    style="normal"
    stretch="normal"
    format="type1"
    metrics="/usr/local/share/ghostscript/fonts/a010013l.afm"
    glyphs="/usr/local/share/ghostscript/fonts/a010013l.pfb"
  />
</typemap>

GM ANIMATE

دستور Animate دنباله‌ای از تصاویر را روی هر نمایشگر ایستگاه کاری که یک کارساز X را اجرا می‌کند نمایش می‌دهد. ابتدا animate قابلیت‌های سخت‌افزاری ایستگاه کاری را بررسی و مشخص می‌کند. اگر تعداد رنگ‌های یکتا در تصویر کمتر یا مساوی مقداری باشد که ایستگاه کاری پشتیبانی می‌کند، تصویر در پنجرهٔ X نمایش داده می‌شود. در غیر این صورت، تعداد رنگ‌های تصویر پیش از نمایش، کاهش داده می‌شود تا با تفکیک‌پذیری رنگِ ایستگاه کاری سازگار شود.

این بدان معناست که یک تصویر رنگی پیوسته (continuous-tone) با ۲۴ بیت در هر پیکسل می‌تواند روی یک دستگاه ۸ بیتی با رنگ کاذب (pseudo-color) یا یک دستگاه تک‌رنگ (monochrome) نمایش یابد. در اکثر موارد، تصویر با رنگ‌های کاهش‌یافته شباهت زیادی به نسخهٔ اصلی دارد. علاوه بر این، دنباله‌ای از تصاویر تک‌رنگ یا شبه‌رنگ می‌تواند روی دستگاهی با رنگ پیوسته و ۲۴ بیت در هر پیکسل نمایش یابد.

برای جلوگیری از پرش رنگ (flashing) در حالت‌های دیداری (visuals) کارساز X که دارای جدول رنگ (colormap) هستند، animate یک جدول رنگ واحد از دنبالهٔ تصاویر ایجاد می‌کند. این کار می‌تواند زمان‌بر باشد. می‌توانید با کاهش رنگ‌های تصویر پیش از اجرای متحرک‌سازی («animate»)، سرعت این عملیات را افزایش دهید. برای کاهش رنگ تصاویر به یک جدول رنگ واحد از mogrify استفاده کنید. برای جزئیات به mogrify(1) مراجعه کنید. از طرف دیگر، می‌توانید از یک جدول رنگ استاندارد (Standard Colormap) یا یک حالت دیداری رنگ ایستا (static)، مستقیم (direct) یا رنگ واقعی (true color) استفاده نمایید. شما می‌توانید با استفاده از xstdcmap یک جدول رنگ استاندارد تعریف کنید. برای اطلاعات بیشتر به xstdcmap(1) مراجعه نمایید. این روش برای کارسازهای X با جدول رنگ پیشنهاد می‌شود، زیرا نیاز به محاسبهٔ یک جدول رنگ سراسری را برطرف می‌کند.

مثال‌ها (EXAMPLES)

برای پویانمایی مجموعه‌ای از تصاویر مربوط به یک طوطی کاکاتو، استفاده کنید از:

gm animate cockatoo.*

برای پویانمایی دنبالهٔ تصاویر کاکاتو ضمن استفاده از جدول رنگ استاندارد best، استفاده کنید از:

xstdcmap -best
gm animate -map best cockatoo.*

برای پویانمایی تصویری از یک کاکاتو بدون حاشیه و به‌صورت متمرکز در پس‌زمینه (backdrop)، استفاده کنید از:

gm animate +borderwidth -backdrop cockatoo.*

گزینه‌ها (OPTIONS)

برای توضیحات کامل‌تر دربارهٔ هر گزینه، به بخش Options در بالا مراجعه کنید.

-authenticate <string>

رمزگشایی تصویر با این گذرواژه

-backdrop

نمایش تصویر به‌صورت متمرکز در پس‌زمینه (backdrop).

-background <color>

رنگ پس‌زمینه

-bordercolor <color>

رنگ حاشیه

-borderwidth <geometry>

عرض حاشیه

-chop <width>x<height>{+-}<x>{+-}<y>{%}

حذف پیکسل‌ها از داخل تصویر

-colormap <type>

تعیین نوع جدول رنگ (colormap)

-colors <value>

تعداد رنگ ترجیحی در تصویر

-colorspace <value>

نوع فضای رنگ (colorspace)

-crop <width>x<height>{+-}<x>{+-}<y>{%}

اندازه و موقعیت ترجیحی تصویر برش‌خورده

-debug <events>

فعال‌سازی چاپ خروجی اشکال‌زدایی (debug)

-define <key>{=<value>},...

افزودن گزینه‌های خاص کُدگذار/کُدگشا (coder/decoder)

-delay <1/100ths of a second>

نمایش تصویر بعدی پس از یک مکث

-density <width>x<height>

تفکیک‌پذیری افقی و عمودی تصویر بر حسب پیکسل

-depth <value>

عمق بیت تصویر

-display <host:display[.screen]>

مشخص کردن کارساز X برای برقراری ارتباط

-dispose <method>

روش دفع/پاک‌سازی فریم‌های GIF

-dither

اعمال انتشار خطای فلوید/اشتاینبرگ (Floyd/Steinberg) بر روی تصویر

-font <name>

استفاده از این قلم هنگام حاشیه‌نویسی متن روی تصویر

-foreground <color>

تعیین رنگ پیش‌زمینه

-gamma <value>

میزان تصحیح گاما (gamma)

-geometry <width>x<height>{+-}<x>{+-}<y>{%}{@}{!}{^}{<}{>}

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

-help

چاپ دستورالعمل‌های استفاده

-iconGeometry <geometry>

مشخص کردن ابعاد و موقعیت شمایل (icon)

-iconic

پویانمایی در حالت شمایلی (کمینه‌شده)

-interlace <type>

نوع طرح درهم‌بافی (interlacing)

-limit <type> <value>

محدودیت منابع برای Disk، File، Images، Map، Memory، Pixels، Width، Height، Read، Threads یا Write

-log <string>

مشخص کردن قالب گزارش اشکال‌زدایی (debug log).TP -map <type> نمایش تصویر با استفاده از این نوع.

-matte

ذخیره کانال matte در صورت وجود در تصویر.

-mattecolor <color>

مشخص کردن رنگ مورد استفاده با گزینه -frame.

-monitor

نمایش نشانگر پیشرفت کار.

-monochrome

تبدیل تصویر به سیاه و سفید.

-name

نام‌گذاری یک تصویر.

-noop

NOOP (بدون گزینه).

-pause <seconds>

مکث بین چرخه‌های پویانمایی [animate].

-remote

انجام یک عملیات از راه دور X11.

-rotate <degrees>{<}{>}

چرخش تصویر.

-sampling-factor <horizontal_factor>x<vertical_factor>

ضرایب زیرنمونه‌برداری رنگ (chroma subsampling).

-scenes <value-value>

محدوده شماره صحنه‌های تصویر جهت خواندن.

-shared-memory

استفاده از حافظه اشتراکی.

-size <width>x<height>{+offset}

عرض و ارتفاع تصویر.

-text-font <name>

قلم برای نوشتن متن با عرض ثابت.

-title <string>

اختصاص عنوان به تصویر نمایش‌یافته [animate, display, montage].

-treedepth <value>

عمق درخت برای الگوریتم کاهش رنگ.

-trim

پیراستن (حذف لبه‌های زائد) یک تصویر.

-type <type>

نوع تصویر.

-verbose

چاپ اطلاعات تفصیلی درباره تصویر.

-version

چاپ اطلاعات تفصیلی نسخه/ساخت GraphicsMagick.

-version

چاپ اطلاعات فشرده نسخه GraphicsMagick به سبک GNU.

-visual <type>

پویانمایی تصاویر با استفاده از این نوع visual در X.

-window <id>

تنظیم تصویر به عنوان پس‌زمینه یک پنجره.

برای شرح دقیق‌تر هر گزینه، به بخش گزینه‌ها در بالا مراجعه کنید.

هر گزینه‌ای که در خط فرمان مشخص می‌کنید، برای گروه تصاویر پس از آن معتبر باقی می‌ماند، تا زمانی که آن گروه با حضور گزینه‌ای دیگر یا -noop خاتمه یابد. برای نمونه، جهت متحرک‌سازی سه تصویر که اولی دارای ۳۲ رنگ، دومی دارای تعداد نامحدودی رنگ، و سومی تنها دارای ۱۶ رنگ باشد، از این دستور استفاده کنید:

gm animate -colors 32 cockatoo.1 -noop cockatoo.2
         -colors 16 cockatoo.3

گزینه‌های Animate می‌توانند در خط فرمان یا در فایل منابع X شما قرار گیرند. به X(1) مراجعه کنید. گزینه‌های خط فرمان جایگزین مقادیر مشخص‌شده در فایل منابع X می‌شوند. اگر قالب تصویر MIFF باشد (به miff(5) مراجعه کنید) و کلیدواژه scene در تصویر مشخص شده باشد، نام‌های فایل تصویر می‌توانند با هر ترتیبی در خط فرمان قرار گیرند. در غیر این صورت، تصاویر به همان ترتیبی که در خط فرمان ظاهر شده‌اند نمایش داده خواهند شد.

دکمه‌های موشواره (MOUSE BUTTONS)

هر دکمه‌ای را فشار دهید تا ابزارک Command نگاشت (نمایان) یا حذف شود. برای اطلاعات بیشتر درباره ابزارک Command به بخش بعدی مراجعه کنید.

ابزارک فرمان (COMMAND WIDGET)

ابزارک Command فهرستی از چندین زیرمنو و فرمان را ارائه می‌دهد. آنها عبارتند از:

Animate

Open
Play
Step
Repeat
Auto Reverse

Speed

Faster
Slower

Direction

Forward
Reverse

Image Info
Help
Quit

آیتم‌های منو که دارای یک مثلث تورفته هستند، زیرمنو دارند. این موارد در بالا به عنوان آیتم‌های تورفته نمایش داده شده‌اند. برای دسترسی به یک آیتم زیرمنو، اشاره‌گر را به منوی مربوطه ببرید، دکمه را فشار داده و بکشید. هنگامی که آیتم زیرمنوی مورد نظر را یافتید، دکمه را رها کنید تا فرمان اجرا شود. اگر تصمیم گرفتید فرمان خاصی را اجرا نکنید، اشاره‌گر را از زیرمنو دور کنید..SH "کلیدهای میانبر (KEYBOARD ACCELERATORS)"

Ctl+O


برای بارگذاری یک تصویر از یک فایل فشار دهید.

space


برای نمایش تصویر بعدی در دنباله فشار دهید.

<


برای افزایش سرعت نمایش تصاویر فشار دهید. برای اطلاعات بیشتر به -delay مراجعه کنید.

>


برای کاهش سرعت نمایش تصاویر فشار دهید. برای اطلاعات بیشتر به -delay مراجعه کنید.

?


برای نمایش اطلاعات تصویر فشار دهید. برای پاک کردن اطلاعات، هر کلید یا دکمه‌ای را فشار دهید.

این اطلاعات نمایش داده می‌شوند: نام تصویر؛ اندازه تصویر؛ و تعداد کل رنگ‌های یکتا در تصویر.

F1


برای نمایش اطلاعات راهنما درباره animate(1) فشار دهید.

Ctl-q


برای دور انداختن تمام تصاویر و خروج از برنامه فشار دهید.

منابع اکس (X RESOURCES)

گزینه‌های Animate می‌توانند در خط فرمان یا در فایل منابع X شما قرار گیرند. گزینه‌های موجود در خط فرمان بر مقادیر مشخص‌شده در فایل منابع X ارجحیت دارند. برای اطلاعات بیشتر درباره منابع X به X(1) مراجعه کنید.

تمام گزینه‌های animate دارای یک منبع متناظر در X هستند. علاوه بر این، برنامه animate از منابع X زیر استفاده می‌کند:

background (class Background)

رنگ مورد نظر برای استفاده در پس‌زمینه پنجره تصویر را مشخص می‌کند. پیش‌فرض #ccc است.

borderColor (class BorderColor)

رنگ مورد نظر برای استفاده در حاشیه پنجره تصویر را مشخص می‌کند. پیش‌فرض #ccc است.

borderWidth (class BorderWidth)

عرض حاشیه پنجره تصویر را بر حسب پیکسل مشخص می‌کند. پیش‌فرض 2 است.

font (class Font or FontList)

نام قلم مورد نظر برای استفاده در متن‌های با قالب‌بندی عادی را مشخص می‌کند. پیش‌فرض 14 point Helvetica است.

foreground (class Foreground)

رنگ مورد نظر برای استفاده در متن درون پنجره تصویر را مشخص می‌کند. پیش‌فرض black است.

geometry (class geometry)

اندازه و موقعیت مورد نظر پنجره تصویر را مشخص می‌کند. لزوماً توسط همه مدیرهای پنجره رعایت نمی‌شود. فاصله‌ها (offsets)، در صورت وجود، به سبک X(1) مدیریت می‌شوند. یک فاصله x منفی از لبه راست صفحه نمایش تا لبه راست آیکون اندازه‌گیری می‌شود، و یک فاصله y منفی از لبه پایین صفحه نمایش تا لبه پایین آیکون محاسبه می‌شود.

iconGeometry (class IconGeometry)

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

iconic (class Iconic)

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

matteColor (class MatteColor)

رنگ پنجره‌ها را مشخص می‌کند. این گزینه برای پس‌زمینه پنجره‌ها، منوها و اعلان‌ها استفاده می‌شود. یک جلوه سه‌بعدی با استفاده از رنگ‌های روشن و سایه مشتق‌شده از این رنگ حاصل می‌شود. مقدار پیش‌فرض: #ddd است.

name (class Name)

این منبع نامی را مشخص می‌کند که منابع برنامه باید تحت آن پیدا شوند. این منبع در نام‌های مستعار پوسته برای تمایز قائل شدن بین فراخوانی‌های یک برنامه مفید است، بدون آنکه نیازی به ساخت پیوندها برای تغییر نام فایل اجرایی باشد. پیش‌فرض، نام برنامه است.

sharedMemory (class SharedMemory)

این منبع مشخص می‌کند که آیا animate باید برای pixmapها تلاش به استفاده از حافظه اشتراکی کند یا خیر. ImageMagick باید همراه با پشتیبانی از حافظه اشتراکی کامپایل شده باشد، و نمایشگر نیز باید از افزونه MIT-SHM پشتیبانی کند. در غیر این صورت، این منبع نادیده گرفته می‌شود. پیش‌فرض True است.

text_font (class textFont)

نام قلم مورد نظر برای استفاده در متن‌های با قالب‌بندی ثابت (به سبک ماشین تحریر) را مشخص می‌کند. پیش‌فرض 14 point Courier است.

title (class Title)

این منبع عنوانی را که باید برای پنجره تصویر استفاده شود مشخص می‌کند. این اطلاعات گاهی توسط مدیر پنجره جهت ارائه نوعی سربرگ برای شناسایی پنجره استفاده می‌شود. پیش‌فرض، نام فایل تصویر است.

توضیحات (DESCRIPTION)

دستور batch تعداد دلخواهی از دستورهای ابزار (مانند convert) را در قالب یک اسکریپت دسته‌ای (batch) خطی ساده اجرا می‌کند تا بازدهی اجرا را بهبود بخشد، یا امکان استفاده به‌عنوان یک هم‌روند (co-process) زیرمجموعه تحت کنترل یک اسکریپت یا برنامهٔ دلخواه را فراهم سازد.

مثال‌ها (EXAMPLES)

برای به‌کارگیری 'gm batch' با استفاده از یک اسکریپت شل (یا برنامه‌ای نوشته‌شده به هر زبان دیگری)، کاری کنید که اسکریپت/برنامه دستورها را از طریق ورودی استاندارد به 'gm batch' ارسال کند. با مشخص کردن '-' به‌عنوان نام فایل، تعیین کنید که باید از ورودی استاندارد استفاده شود. مثال زیر تمام فایل‌های منطبق با '*.jpg' را به قالب TIFF تبدیل کرده، هر فایل را ۹۰ درجه می‌چرخاند و تمامی پروفایل‌های تعبیه‌شده را حذف می‌کند. نحو این اسکریپت شل، شل استاندارد یونیکس است:

for file in *.jpg
do
  outfile=`basename $file .jpg`.tiff
  echo convert -verbose "'$file'" -rotate 90 \
  +profile "'*'" "'$outfile'"
done | gm batch -echo on -feedback on -

می‌توانیم همان کار مثال قبل را با قرار دادن تمام دستورها در یک فایل متنی و سپس تعیین نام فایل متنی به‌عنوان اسکریپت اجرایی انجام دهیم:

for file in *.jpg
do
  outfile=`basename $file .jpg`.tiff
  echo convert -verbose "'$file'" -rotate 90 \
  +profile "'*'" "'$outfile'"
done > script.txt
gm batch -echo on -feedback on script.txt

گزینه‌ها (OPTIONS)

گزینه‌ها از چپ به راست پردازش می‌شوند و باید پیش از هر آرگومان نام فایل قرار گیرند.

-echo on|off

روشن یا خاموش کردن پژواک دستور

مقدار on را برای فعال‌سازی پژواک دستورها در خروجی استاندارد به محض خوانده شدن، یا off را برای غیرفعال کردن آن مشخص کنید. پیش‌فرض off است.

-escape unix|windows

تجزیه با استفاده از نحو unix یا windows

دستورها باید از جریان ورودی تجزیه شوند و برای محافظت از فاصله‌ها یا نویسه‌های نقل‌قول در ورودی، باید از نویسهٔ گریز (escaping) استفاده شود. مقدار unix را برای استفاده از تجزیه خط فرمان به سبک unix، یا windows را برای تجزیه به سبک خط فرمان Microsoft Windows مشخص کنید. مقدار پیش‌فرض بستگی به این دارد که نرم‌افزار برای Microsoft Windows کامپایل شده باشد یا برای یک سیستم شبه‌یونیکس (از جمله Cygwin روی Microsoft Windows). توصیه می‌شود از نحو unix استفاده کنید زیرا قدرتمندتر و قابل‌حمل‌تر است.

-fail text

متنی که در صورت شکست دستور چاپ می‌شود

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

-feedback on|off

فعال‌سازی بازخورد خطا

چاپ بازخورد متنی (گزینه‌های pass- و fail- را ببینید) پس از هر دستور برای نشان دادن نتیجه؛ پیش‌فرض off است.

-help

راهنمای دستور batch را چاپ می‌کند.

-pass text

متنی که در صورت موفقیت دستور چاپ می‌شود

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

-prompt text

متن اعلان (prompt) برای استفاده در خط فرمان

اگر هیچ آرگومان نام فایلی مشخص نشده باشد، یک اعلان فرمان ساده ظاهر می‌شود که در آن می‌توانید دستورهای GraphicsMagick را وارد کنید. اعلان پیش‌فرض GM> است. از این گزینه برای تغییر اعلان به مقداری دیگر استفاده کنید.

-stop-on-error on|off

تعیین توقف پردازش دستورها در صورت بروز خطا

در حالت عادی، اگر دستوری با خطا مواجه شود پردازش دستورها ادامه می‌یابد. مقدار -stop-on-error on را مشخص کنید تا در صورت بروز خطا پردازش بلافاصله متوقف و خارج شود.

GM BENCHMARK

توضیحات (DESCRIPTION)

دستور benchmark یک دستور دلخواه از ابزار gm (مانند convert) را برای یک یا چند چرخه، و/یا برای مدت زمان اجرای مشخصی اجرا می‌کند و معیارهای اجرایی متعددی را گزارش می‌دهد. برای ساخت‌هایی که از OpenMP استفاده می‌کنند، حالتی در نظر گرفته شده است تا بنچمارک را با تعداد فزاینده‌ای از رشته‌ها (threads) اجرا کرده و گزارشی از افزایش سرعت (speedup) و بازدهی اجرای چندرشته‌ای ارائه دهد. اگر از benchmark برای اجرای یک دستور بدون هیچ گزینه بنچمارک اضافی استفاده شود، دستور تنها یک‌بار اجرا خواهد شد.

مثال‌ها (EXAMPLES)

برای دریافت اطلاعات بنچمارک برای یک‌بار اجرای یک دستور:

gm benchmark convert input.ppm -gaussian 0x1 output.ppm

gm benchmark -iterations 100 convert input.ppm \
  -gaussian 0x1 output.ppm

gm benchmark -duration 30 convert input.ppm \
  -gaussian 0x1 output.ppm

gm benchmark -duration 3 -stepthreads 4 convert \
  input.ppm -gaussian 0x2 output.ppm

threads - تعداد رشته‌های (threads) استفاده‌شده.
iter - تعداد تکرارهای اجراشدهٔ دستور.
user - مجموع زمان کاربری (user time) مصرف‌شده.
total - کل زمان سپری‌شده (elapsed time).
iter/s - تعداد تکرارهای دستور در هر ثانیه.
iter/cpu - میزان زمان پردازنده (CPU) مصرف‌شده در هر تکرار.
speedup - افزایش سرعت در مقایسه با یک رشته.
karp-flatt - معیار Karp-Flatt برای بازدهی افزایش سرعت.

لطفاً توجه داشته باشید که «speedup» گزارش‌شده بر اساس زمان اجرای تنها یک رشته محاسبه می‌شود. قبل از زمان‌سنجی اولین حلقه، از یک مرحلهٔ گرم‌کردن اولیه استفاده می‌شود تا اطمینان حاصل شود که پردازنده از حالت‌های صرفه‌جویی در مصرف انرژی خارج شده و حافظه‌های نهان (کَش) سیستم گرم شده‌اند. بیشتر پردازنده‌های امروزی قابلیتی به نام «turbo» ارائه می‌دهند که در آن فرکانس ساعت پردازنده هنگام فعال بودن تنها یک یا دو هسته افزایش می‌یابد (مثلاً دو برابر). اگر پردازنده (به دلیل خنک‌سازی ناکافی) بیش از حد داغ شود، ممکن است سرعت کلاک خود را به‌عنوان شکلی از مدیریت حرارتی کاهش دهد. این عوامل در مقایسه با حالتی که «turbo» غیرفعال باشد و پردازنده نیازی به مدیریت حرارتی نداشته باشد، منجر به کمتر گزارش شدن میزان افزایش سرعت (speedup) می‌شوند. ابزار powertop موجود در لینوکس و سولاریس راهکاری برای مشاهده نرخ کلاک هسته‌های پردازنده در حین اجرای بنچمارک فراهم می‌کند..SH "گزینه‌ها (OPTIONS)" گزینه‌ها از چپ به راست پردازش می‌شوند و باید پیش از هر آرگومانی قرار گیرند.

-duration duration

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

-help

راهنمای دستور بنچمارک را چاپ می‌کند.

-iterations loops

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

-rawcsv

چاپ نتایج در قالب CSV نتایج را در قالب مقادیر جداشده با کاما (CSV) چاپ می‌کند که تجزیه آن برای رسم نمودار یا وارد کردن به یک صفحه‌گسترده یا پایگاه‌داده آسان است. مقادیر گزارش‌شده شامل threads، iterations، user_time و elapsed_time هستند.

-stepthreads step

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

GM COMPARE

دستور compare دو تصویر مشابه را با استفاده از یک روش آماری مشخص (ببینید: -metric) و/یا با نوشتن یک تصویر تفاوت (-file) مقایسه می‌کند؛ به‌طوری که پیکسل‌های تغییریافته با روشی مشخص (ببینید: -highlight-style) و رنگی خاص (ببینید: -highlight-color) مشخصه‌گذاری می‌شوند. Reference-image تصویر اصلی و compare-image نسخه (احتمالاً) تغییریافته است که باید ابعادی یکسان با reference-image داشته باشد.

مثال‌ها (EXAMPLES)

برای مقایسه دو تصویر با استفاده از تحلیل آماری خطای میانگین مربعات (MSE)، از دستور زیر استفاده کنید:

gm compare -metric mse original.miff compare.miff

برای ایجاد یک تصویر تفاوتِ مشخصه‌گذاری‌شده، از دستور زیر استفاده کنید:

gm compare -highlight-style assign -highlight-color purple \
  -file diff.miff original.miff compare.miff

گزینه‌ها (OPTIONS)

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

برای توضیحات دقیق‌تر درباره هر گزینه، بخش «گزینه‌ها» در بالا را ببینید.

-authenticate <string>

رمزگشایی تصویر با این گذرواژه

-auto-orient

جهت‌دهی (چرخش) تصویر به‌گونه‌ای که به‌صورت عمودی و درست قرار گیرد

-colorspace <value>

نوع فضای رنگی

-compress <type>

نوع فشرده‌سازی تصویر

-debug <events>

فعال‌سازی چاپ خروجی اشکال‌زدایی

-define <key>{=<value>},...

افزودن گزینه‌های خاص کدگذار/کدگشا (coder/decoder)

-density <width>x<height>

وضوح افقی و عمودی تصویر بر حسب پیکسل

-depth <value>

عمق تصویر

-display <host:display[.screen]>

مشخص کردن کارساز X جهت برقراری ارتباط

-endian <type>

مشخص کردن ترتیب بایت‌ها یا اِندیَن‌نس (MSB، LSB یا Native) تصویر

-file <filename>

نوشتن تصویر تفاوتِ مشخصه‌گذاری‌شده در فایل

-help

چاپ دستورالعمل‌های استفاده

-highlight-color <color>

رنگ مشخصه‌گذاری پیکسل

-highlight-style <style>

سبک مشخصه‌گذاری پیکسل

-interlace <type>

نوع طرح درهم‌بافی (interlacing)

-limit <type> <value>

محدودیت منابع Disk، File، Images، Map، Memory، Pixels، Width، Height، Read، Threads یا Write

-log <string>

مشخص کردن قالب لاگ اشکال‌زدایی

-matte

ذخیره کانال مات (matte) در صورت وجود آن در تصویر

-maximum-error <limit>

مشخص کردن حداکثر میزان خطای کل تصویر

-metric <metric>

معیار سنجش مقایسه (MAE، MSE، PAE، PSNR، RMSE)

-monitor

نمایش نشانگر پیشرفت

-sampling-factor <horizontal_factor>x<vertical_factor>

ضرایب زیرنمونه‌برداری رنگ (chroma subsampling)

-size <width>x<height>{+offset}

عرض و ارتفاع تصویر

-type <type>

نوع تصویر

-verbose

چاپ اطلاعات تفصیلی درباره تصویر

-version

چاپ اطلاعات تفصیلی نسخه/ساخت GraphicsMagick

-version

چاپ اطلاعات فشرده نسخه GraphicsMagick به سبک GNU

برای توضیحات دقیق‌تر درباره هر گزینه، بخش «گزینه‌ها» در بالا را ببینید..SH GM COMPOSITE

ابزار composite تصاویر را برای ایجاد تصاویر جدید با یکدیگر ترکیب (هم‌آمیزی) می‌کند. base-image تصویر پایه است و change-image شامل تغییرات می‌باشد. ouput-image تصویر حاصل است و معمولاً ابعادی مشابه base-image دارد.

تصویر اختیاری mask-image می‌تواند برای ارائه اطلاعات مات‌بودن (opacity) برای change-image در زمانی که فاقد آن است یا هنگامی که ماسک متفاوتی می‌خواهید، استفاده شود. یک تصویر ماسک معمولاً در مقیاس خاکستری (grayscale) و هم‌اندازه با base-image است. اگر mask-image در مقیاس خاکستری نباشد، به مقیاس خاکستری تبدیل می‌شود و شدت‌های نوری حاصل به عنوان اطلاعات مات‌بودن استفاده خواهند شد.

مثال‌ها (EXAMPLES)

برای ترکیب تصویر یک طوطی کاکادو با یک نشیمنگاه، از این دستور استفاده کنید:

gm composite cockatoo.miff perch.ras composite.miff

برای محاسبه تفاوت بین تصاویر در یک مجموعه، استفاده کنید از:

gm composite -compose difference series.2 series.1
          difference.miff

برای ترکیب تصویر یک طوطی کاکادو با یک نشیمنگاه با نقطه شروع در مختصات (100,150)، استفاده کنید از:

gm composite -geometry +100+150 cockatoo.miff
          perch.ras composite.miff

برای چیدن کاشی‌وار یک نشان‌واره روی تصویر کاکادو، استفاده کنید از:

gm convert +shade 30x60 cockatoo.miff mask.miff
gm composite -compose bumpmap -tile logo.png
          cockatoo.miff mask.miff composite.miff

برای ترکیب صفحه‌های رنگی قرمز، سبز و آبی در یک تصویر ترکیبی واحد، امتحان کنید:

gm composite -compose CopyGreen green.png red.png
          red-green.png
gm composite -compose CopyBlue blue.png red-green.png 
          gm composite.png

گزینه‌ها (OPTIONS)

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

برای شرح دقیق‌تر هر گزینه، بخش گزینه‌ها را در بالا ببینید.

-authenticate <string>

رمزگشایی تصویر با این گذرواژه

-background <color>

رنگ پس‌زمینه

-blue-primary <x>,<y>

نقطه اصلی رنگینگی آبی

-colors <value>

تعداد رنگ ترجیحی در تصویر

-colorspace <value>

نوع فضای رنگی

-comment <string>

حاشیه‌نویسی تصویر با یک یادداشت

-compose <operator>

نوع عملگر ترکیب تصویر

-compress <type>

نوع فشرده‌سازی تصویر

-debug <events>

فعال‌سازی چاپ اطلاعات اشکال‌زدایی

-define <key>{=<value>},...

افزودن گزینه‌های اختصاصی رمزگذار/رمزگشا (coder/decoder)

-density <width>x<height>

تفکیک‌پذیری افقی و عمودی تصویر بر حسب پیکسل

-depth <value>

عمق تصویر

-displace <horizontal scale>x<vertical scale>

جابه‌جایی پیکسل‌های تصویر طبق تعریف نقشه‌ی جابه‌جایی

-display <host:display[.screen]>

تعیین کارساز X برای اتصال

-dispose <method>

روش دفع (disposal method) فریم GIF

-dissolve <percent>

حل کردن یک تصویر در تصویری دیگر با درصد مشخص‌شده

-dither

اعمال انتشار خطای Floyd/Steinberg بر روی تصویر

-encoding <type>

مشخص کردن کدگذاری متن

-endian <type>

مشخص کردن ترتیب بایت‌ها یا پایان‌پذیری (MSB، LSB یا Native) تصویر

-filter <type>

استفاده از این نوع فیلتر هنگام تغییر اندازه تصویر

-font <name>

استفاده از این قلم هنگام حاشیه‌نویسی تصویر با متن

-geometry <width>x<height>{+-}<x>{+-}<y>{%}{@}{!}{^}{<}{>}

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

-gravity <type>

جهتی که عنصر اولیه هنگام حاشیه‌نویسی تصویر به سمت آن متمایل می‌شود.

-green-primary <x>,<y>

نقطه اصلی رنگینگی سبز

-help

چاپ دستورالعمل‌های استفاده

-interlace <type>

نوع طرح درهم‌بافی (interlacing)

-label <name>

تخصیص یک برچسب به تصویر

-limit <type> <value>

محدودیت منابع Disk، File، Images، Map، Memory، Pixels، Width، Height، Read، Threads یا Write

-log <string>

تعیین قالب لاگ اشکال‌زدایی

-matte

ذخیره کانال مات (matte) در صورت وجود در تصویر

-monitor

نمایش نشانگر پیشرفت

-monochrome

تبدیل تصویر به سیاه و سفید

-negate

جایگزینی هر پیکسل با رنگ مکمل آن

-page <width>x<height>{+-}<x>{+-}<y>{%}{!}{<}{>}

اندازه و موقعیت بوم (canvas) تصویر

-profile <filename>

افزودن پروفایل ICM، IPTC یا عمومی به تصویر

-quality <value>

سطح فشرده‌سازی JPEG/MIFF/PNG/TIFF

-recolor <matrix>

اعمال یک ماتریس تبدیل رنگ به کانال‌های تصویر

-red-primary <x>,<y>

نقطه اصلی رنگینگی قرمز

-render

رندر کردن عملیات برداری

-repage <width>x<height>+xoff+yoff[!]

تنظیم آفست‌های صفحه تصویر

-resize <width>x<height>{%}{@}{!}{<}{>}

تغییر اندازه تصویر

-rotate <degrees>{<}{>}

چرخاندن تصویر

-sampling-factor <horizontal_factor>x<vertical_factor>

ضریب‌های زیرنمونه‌برداری رنگ (chroma subsampling)

-scene <value>

تعیین شماره صحنه

-set <attribute> <value>

تعیین یک ویژگی تصویر

+set <attribute>

لغو تعیین یک ویژگی تصویر.TP -sharpen <radius>{x<sigma>} واضح‌سازی تصویر

-size <width>x<height>{+offset}

عرض و ارتفاع تصویر

-stegano <offset>

پنهان‌سازی واترمارک درون تصویر

-stereo

ترکیب دو تصویر برای ایجاد یک آناگلیف استریو

-strip

حذف تمام پروفایل‌ها و ویژگی‌های متنی از تصویر

-thumbnail <width>x<height>{%}{@}{!}{<}{>}

تغییر اندازه تصویر (به سرعت)

-treedepth <value>

عمق درخت برای الگوریتم کاهش رنگ

-trim

دوربری تصویر

-type <type>

نوع تصویر

-units <type>

واحدهای وضوح (رزولوشن) تصویر

-unsharp <radius>{x<sigma>}{+<amount>}{+<threshold>}

واضح‌سازی تصویر با عملگر ماسک محوشدگی (unsharp mask)

-verbose

چاپ اطلاعات دقیق درباره تصویر

-version

چاپ اطلاعات تفصیلی نسخه/ساخت GraphicsMagick

-version

چاپ اطلاعات فشرده نسخه GraphicsMagick به سبک GNU

-watermark <brightness>x<saturation>

درصد روشنایی و اشباع یک واترمارک

-white-point <x>,<y>

نقطه سفید رنگ‌پذیری (chromaticity)

-write <filename>

نوشتن یک تصویر میانی [convert, composite]

برای توضیحات دقیق‌تر درباره هر گزینه، بخش گزینه‌ها در بالا را ببینید.

GM CONJURE

زبان اسکریپت‌نویسی Magick (به اختصار MSL) در درجه اول به سود کسانی خواهد بود که می‌خواهند کارهای پردازش تصویر سفارشی را به انجام برسانند اما تمایلی به برنامه‌نویسی ندارند، یا دسترسی به یک مفسر Perl یا کامپایلر ندارند. این مفسر conjure نامیده می‌شود و در اینجا یک اسکریپت نمونه آمده است:

<?xml version="1.0" encoding="UTF-8"?>
<image size="400x400" >
  <read filename="image.gif" />
  <get width="base-width" height="base-height" />
  <resize geometry="%[dimensions]" />
  <get width="width" height="height" />
  <print output=
    "Image sized from %[base-width]x%[base-height]
     to %[width]x%[height].\n" />
  <write filename="image.png" />
</image>

که به صورت زیر فراخوانی می‌شود:

gm conjure -dimensions 400x400 incantation.msl

تمام عملیات‌ها دقیقاً از جفت‌های کلید/مقدار تعریف‌شده در PerlMagick پیروی خواهند کرد، مگر اینکه خلاف آن ذکر شده باشد.

گزینه‌ها (OPTIONS)

گزینه‌ها به ترتیب خط فرمان پردازش می‌شوند. هر گزینه‌ای که در خط فرمان مشخص کنید تا زمانی که با مشخص کردن دوباره آن با یک اثر متفاوت صراحتاً تغییر نکند، یا توسط یک دستور در زبان اسکریپت‌نویسی تغییر نیابد، معتبر و اثرگذار باقی می‌ماند.

شما می‌توانید جفت‌های کلیدواژه/مقدار خود را در خط فرمان تعریف کنید. اسکریپت سپس می‌تواند با گنجاندن %[keyword] درون رشته، هنگام مقداردهی از این اطلاعات استفاده کند. برای نمونه، اگر همان‌طور که در بالا نشان داده شد، "-dimensions 400x400"; را در خط فرمان قرار دهید، در هر رشته‌ای که شامل "%[dimensions]" باشد، مقدار 400x400 جایگزین خواهد شد. "%[string]" می‌تواند هم به عنوان یک رشته کامل، مانند geometry="%[dimensions]" و هم به عنوان بخشی از یک رشته مانند filename="%[basename].png" استفاده شود.

کلیدواژه می‌تواند هر رشته‌ای باشد به جز رشته‌های رزروشده زیر (در هر نگارشی از حروف بزرگ، کوچک، یا ترکیبی): debug، help و verbose که کاربرد آن‌ها در زیر شرح داده شده است.

مقدار می‌تواند هر رشته‌ای باشد. اگر کلیدواژه یا مقدار دارای فاصله یا هر نمادی است که برای پوسته شما معنای خاصی دارد، مانند "#"، "|"، یا "%"، رشته را درون علامت نقل‌قول قرار دهید یا از "\" برای فرار (escape) دادن فاصله‌ها و نویسه‌های خاص استفاده کنید.

کلیدواژه‌ها و مقادیر به بزرگی و کوچکی حروف حساس هستند (case-sensitive). مقادیر "Key"، "key"، و "KEY" سه کلیدواژه متفاوت خواهند بود.

برای توضیحات دقیق‌تر درباره هر گزینه، بخش گزینه‌ها در بالا را ببینید.

-debug <events>

فعال‌سازی چاپ اطلاعات اشکال‌زدایی

-define <key>{=<value>},...

افزودن گزینه‌های خاص کدر/دیکدر

-help

چاپ دستورالعمل‌های نحوه استفاده

-log <string>

مشخص کردن قالب گزارش اشکال‌زدایی

-verbose

چاپ اطلاعات دقیق درباره تصویر

-version

چاپ اطلاعات تفصیلی نسخه/ساخت GraphicsMagick

-version

چاپ اطلاعات فشرده نسخه GraphicsMagick به سبک GNU.SH "زبان اسکریپت‌نویسی MAGICK (MAGICK SCRIPTING LANGUAGE)"

زبان اسکریپت‌نویسی Magick (به اختصار MSL) در حال حاضر عناصر زیر و مشخصه‌های آن‌ها را تعریف می‌کند:

<image>


background, color, id, size

یک شیء تصویر جدید تعریف می‌کند. </image> آن را نابود می‌سازد. به همین دلیل، اگر می‌خواهید به چندین «زیرتصویر» (موسوم به صفحات یا لایه‌ها) ارجاع دهید، می‌توانید یک عنصر image را درون دیگری تعبیه کنید. برای مثال:

<image>
<read filename="input.png" />
<get width="base-width" height="base-height" />
<image height="base-height" width="base-width">
<image />
<write filename="output.mng" />
</image>

<image size="400x400" />

<group>

یک گروه جدید از اشیاء تصویر تعریف می‌کند. به‌طور پیش‌فرض، تصاویر فقط در طول حیات عنصر <image> خود معتبر هستند.

<image>   -- creates the image
.....     -- do stuff with it
</image>  -- dispose of the image

با این حال، در یک گروه، تمام تصاویر آن گروه در طول حیات گروه باقی خواهند ماند:

<group>                           -- start a group
    <image>                       -- create an image
    ....                          -- do stuff
    </image>                      -- NOOP
    <image>                       -- create another image
    ....                          -- do more stuff
    </image>                      -- NOOP
    <write filename="image.mng" />  -- output
</group>                          -- dispose of both images

<read>



filename

یک تصویر جدید را از فایلی روی دیسک می‌خواند.

<read filename="image.gif" />

برای خواندن دو تصویر از این شیوه استفاده کنید:

<read filename="image.gif" />
<read filename="image.png />

<write>



filename

تصویر(ها) را روی دیسک می‌نویسد، چه به صورت یک فایل تکین چندتصویری یا در صورت نیاز به صورت چندین فایل.

<write filename=image.tiff" />

<get>


هر مشخصه‌ای را که توسط GetAttribute() در PerlMagick شناخته می‌شود دریافت کرده و آن را به عنوان یک مشخصه تصویر برای استفاده بعدی ذخیره می‌کند. در حال حاضر فقط width و height پشتیبانی می‌شوند.

<get width="base-width" height="base-height" />
<print output="Image size is %[base-width]x%[base-height].\n" />

<set>


background, bordercolor, clip-mask, colorspace, density, magick, mattecolor, opacity. مشخصه‌ای را که توسط GetAttribute() در PerlMagick شناخته می‌شود تنظیم می‌کند.

<profile>



[profilename]

یک یا چند نمایه (profile) IPTC، ICC یا عمومی را از فایل خوانده و به تصویر اختصاص می‌دهد

<profile iptc="profile.iptc" generic="generic.dat" />

برای حذف یک نمایه مشخص، از «!» به عنوان نام فایل استفاده کنید، برای مثال:

<profile icm="!" iptc="profile.iptc" />

<border>



fill, geometry, height, width

<blur>



radius, sigma

<charcoal>



radius, sigma

<chop>



geometry, height, width, x, y

<crop>



geometry, height, width, x, y

<composite>



compose, geometry, gravity, image, x, y

<?xml version="1.0" encoding="UTF-8"?>
<group>
    <image id="image_01">
        <read filename="cloud3.gif"/>
        <resize geometry="250x90"/>
    </image>
    <image id="image_02">
        <read filename="cloud4.gif"/>
        <resize geometry="190x100"/>
    </image>
    <image>
        <read filename="background.jpg"/>
        <composite image="image_01" geometry="+740+470"/>
        <composite image="image_02" geometry="+390+415"/>
    </image>
    <write filename="result.png"/>
</group>

<despeckle>


<emboss>



radius, sigma

<enhance>


<equalize>


<edge>



radius

<flip>


<flop>


<frame>



fill, geometry, height, width, x, y, inner, outer

<flatten>


<get>



height, width

<gamma>



red, green, blue

<image>



background, color, id, size

<implode>



amount

<magnify>


<minify>


<medianfilter>



radius

<normalize>


<oilpaint>



radius

<print>



output

<profile>



[profilename]

<read>


<resize>



blur, filter, geometry, height, width

<roll>



geometry, x, y

<rotate>



degrees

<reducenoise>



radius

<sample>



geometry, height, width

<scale>



geometry, height, width

<sharpen>



radius, sigma

<shave>



geometry, height, width

<shear>



x, y

<solarize>



threshold

<spread>



radius

<stegano>



image

<stereo>



image

<swirl>



degrees

<texture>



image

<threshold>



threshold

<transparent>



color

<trim>

.SH "تبدیل GM (GM CONVERT)"

دستور Convert یک فایل ورودی را از یک قالب تصویری به یک فایل خروجی با قالب تصویری متفاوتی تبدیل می‌کند. علاوه بر این، در طول فرآیند تبدیل می‌توان انواع مختلفی از پردازش‌های تصویر را بر روی تصویر تبدیل‌شده اعمال کرد. Convert قالب‌های تصویر فهرست‌شده در GraphicsMagick(1) را شناسایی می‌کند.

مثال‌ها (EXAMPLES)

برای ساخت یک بندانگشتی از تصویر JPEG، از دستور زیر استفاده کنید:

gm convert -size 120x120 cockatoo.jpg -resize 120x120
        +profile "*" thumbnail.jpg

در این مثال، گزینه '-size 120x120' به رمزگشای JPEG اعلام می‌کند که مقیاس تصویر قرار است به 120x120 کاهش یابد؛ این کار با جلوگیری از ارسال تصاویر با وضوح کامل به GraphicsMagick برای عملیات تغییر اندازه بعدی، سرعت پردازش را افزایش می‌دهد. گزینه ´-resize 120x120' ابعاد مطلوب تصویر خروجی را تعیین می‌کند. تصویر طوری مقیاس‌بندی می‌شود که بزرگ‌ترین بعد آن ۱۲۰ پیکسل باشد. گزینه ´+profile "*"' هرگونه نمایه ICM، EXIF، IPTC یا سایر نمایه‌هایی را که ممکن است در ورودی موجود بوده و در تصویر بندانگشتی به آن‌ها نیازی نباشد حذف می‌کند.

برای تبدیل یک تصویر MIFF از یک طوطی کاکلی به یک تصویر رستری SUN، از دستور زیر استفاده کنید:

gm convert cockatoo.miff sun:cockatoo.ras

برای تبدیل یک سند چندصفحه‌ای PostScript به صفحات مجزای FAX، از دستور زیر استفاده کنید:

gm convert -monochrome document.ps fax:page

برای تبدیل یک تصویر TIFF به یک صفحه A4 در PostScript به‌گونه‌ای که تصویر در گوشه پایین سمت چپ قرار گیرد، از دستور زیر استفاده کنید:

gm convert -page A4+0+0 image.tiff document.ps

برای تبدیل یک تصویر خام در مقیاس خاکستری (Gray) با یک سرآیند ۱۲۸ بایتی به یک نقشه خاکستری قابل‌حمل (portable graymap)، از دستور زیر استفاده کنید:

gm convert -depth 8 -size 768x512+128 gray:raw
        image.pgm

در این مثال، "raw" فایل ورودی است. قالب آن "gray" بوده و ابعاد و تعداد بایت‌های سرآیند آن توسط گزینه -size و عمق نمونه توسط گزینه -depth تعیین شده است. فایل خروجی "image.pgm" است. پسوند ".pgm" قالب آن را مشخص می‌کند.

برای تبدیل یک تصویر Photo CD به یک تصویر TIFF، از دستور زیر استفاده کنید:

gm convert -size 1536x1024 img0009.pcd image.tiff
gm convert img0009.pcd[4] image.tiff

برای ساخت یک نمایه بصری (visual image directory) از تمامی تصاویر JPEG خود، از دستور زیر استفاده کنید:

gm convert 'vid:*.jpg' directory.miff

برای افزودن متن حاشیه‌نویسی آبی‌رنگ به یک تصویر با قلم 12x24 در موقعیت (100,100)، از دستور زیر استفاده کنید:

gm convert -font helvetica -fill blue
        -draw "text 100,100 Cockatoo"
        bird.jpg bird.miff

برای چیدن کاشی‌وار یک تصویر 640x480 با یک بافت ناهموار JPEG، از دستور زیر استفاده کنید:

gm convert -size 640x480 tile:bumps.jpg tiled.png

برای احاطه کردن یک آیکون با یک حاشیه تزئینی جهت استفاده در Mosaic(1)، از دستور زیر استفاده کنید:

gm convert -mattecolor "#697B8F" -frame 6x6 bird.jpg
        icon.png

برای ساخت یک پویانمایی MNG از یک توالی مولکول DNA، از دستور زیر استفاده کنید:

gm convert -delay 20 dna.* dna.mng

گزینه‌ها (OPTIONS)

گزینه‌ها به ترتیب خط فرمان پردازش می‌شوند. هر گزینه‌ای که در خط فرمان تعیین می‌کنید برای مجموعه تصاویری که در ادامه می‌آیند معتبر باقی می‌ماند، تا زمانی که آن مجموعه با ظاهر شدن گزینه‌ای دیگر یا -noop پایان یابد. برخی گزینه‌ها فقط بر رمزگشایی تصاویر اثر می‌گذارند و برخی دیگر فقط بر رمزگذاری آن‌ها. دسته دوم می‌توانند پس از گروه پایانی تصاویر ورودی مشخص شوند.

برای توضیحات کامل‌تر درباره هر گزینه، بخش گزینه‌ها را در بالا ببینید.

-adjoin

پیوستن تصاویر به یک فایل چندتصویری واحد

-affine <matrix>

ماتریس تبدیل رسم

-antialias

حذف شکستگی و ناصافی خطوط (aliasing) در پیکسل‌ها

-append

پیوست کردن یک مجموعه از تصاویر به یکدیگر

-asc-cdl <spec>

اعمال تبدیل رنگ ASC CDL

-authenticate <string>

رمزگشایی تصویر با این گذرواژه

-auto-orient

جهت‌دهی (چرخش) تصویر به‌گونه‌ای که رو به بالا باشد

-average

میانگین‌گیری از یک مجموعه تصویر

-background <color>

رنگ پس‌زمینه

-black-threshold red[,green][,blue][,opacity]

سیاه شدن پیکسل‌های پایین‌تر از حد آستانه

-blue-primary <x>,<y>

نقطه اصلی فام‌داری آبی

-blur <radius>{x<sigma>}

محو کردن تصویر با عملگر گوسی (Gaussian)

-border <width>x<height>

احاطه کردن تصویر با حاشیه‌ای از رنگ

-bordercolor <color>

رنگ حاشیه

-box <color>

تعیین رنگ کادر پیرامونی متن حاشیه‌نویسی

-channel <type>

نوع کانال

-charcoal <factor>

شبیه‌سازی نقاشی سیاه‌قلم

-chop <width>x<height>{+-}<x>{+-}<y>{%}

حذف پیکسل‌ها از بخش‌های داخلی تصویر

-clip

اعمال مسیر برش (clipping path)، در صورت وجود

-coalesce

ادغام توالی تصاویر

-colorize <value>

رنگ‌آمیزی تصویر با رنگ قلم

-colors <value>

تعداد رنگ‌های ترجیحی در تصویر

-colorspace <value>

نوع فضای رنگی

-comment <string>

حاشیه‌نویسی تصویر با یک یادداشت

-compose <operator>

نوع ترکیب تصویر

-compress <type>

نوع فشرده‌سازی تصویر

-contrast

افزایش یا کاهش کنتراست تصویر

-convolve <kernel>

پیچش (کانولوشن) تصویر با هسته مشخص‌شده

-crop <width>x<height>{+-}<x>{+-}<y>{%}

اندازه و موقعیت ترجیحی تصویر برش‌خورده

-cycle <amount>

جابه‌جایی جدول رنگ تصویر به میزان مشخص‌شده.TP -debug <events> فعال‌سازی چاپ پیام‌های اشکال‌زدایی

-deconstruct

تجزیه یک توالی تصویر به بخش‌های سازنده آن

-define <key>{=<value>},...

افزودن گزینه‌های خاص رمزگذار/رمزگشا (coder/decoder)

-delay <1/100ths of a second>

نمایش تصویر بعدی پس از مکث

-density <width>x<height>

وضوح افقی و عمودی تصویر برحسب پیکسل

-depth <value>

عمق بیت تصویر

-despeckle

کاهش لکه‌ها و دانه‌ها (نویز) درون تصویر

-display <host:display[.screen]>

کارگزار X مورد نظر برای برقراری ارتباط را مشخص می‌کند

-dispose <method>

روش دور انداختن فریم در GIF (disposal method)

-dither

اعمال انتشار خطای Floyd/Steinberg بر روی تصویر

-draw <string>

یادداشت‌گذاری یا ترسیم روی تصویر با استفاده از یک یا چند شکل پایه گرافیکی (graphic primitive)

-edge <radius>

تشخیص لبه‌ها درون تصویر

-emboss <radius>

برجسته‌سازی تصویر

-encoding <type>

مشخص کردن کدگذاری متن

-endian <type>

مشخص کردن ترتیب بایت‌ها (MSB، LSB یا Native) در تصویر

-enhance

اعمال یک فیلتر دیجیتال برای بهبود کیفیت تصویر نویزدار

-equalize

انجام تعدیل هیستوگرام روی تصویر

-extent <width>x<height>{+-}<x>{+-}<y>

ترکیب تصویر بر روی بوم تصویری با رنگ پس‌زمینه

-fill <color>

رنگ مورد استفاده هنگام پر کردن اشکال پایه گرافیکی

-filter <type>

استفاده از این نوع فیلتر هنگام تغییر اندازه تصویر

-flatten

ادغام و تخت کردن یک توالی تصویر

-flip

ایجاد یک «تصویر آینه‌ای» (انعکاس عمودی)

-flop

ایجاد یک «تصویر آینه‌ای» (انعکاس افقی)

-font <name>

استفاده از این قلم هنگام یادداشت‌گذاری متن روی تصویر

-format <string>

چاپ ویژگی‌های قالب‌بندی‌شده تصویر در خروجی

-frame <width>x<height>+<outer bevel width>+<inner bevel width>

احاطه کردن تصویر با یک کادر یا حاشیه تزیینی

-fuzz <distance>{%}

رنگ‌های واقع در این فاصله اقلیدسی، یکسان در نظر گرفته می‌شوند

-gamma <value>

میزان اصلاح گاما

-gaussian <radius>{x<sigma>}

تار کردن تصویر با یک عملگر گاوسی (Gaussian)

-geometry <width>x<height>{+-}<x>{+-}<y>{%}{@}{!}{^}{<}{>}

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

-gravity <type>

جهت تمایل یا تراز عنصر گرافیکی هنگام یادداشت‌گذاری روی تصویر.

-green-primary <x>,<y>

نقطه اصلی مختصات رنگینگی سبز (chromaticity)

-hald-clut <clut>

اعمال یک Hald CLUT روی تصویر

-help

چاپ راهنمای نحوه استفاده

-implode <factor>

درون‌پاشی پیکسل‌های تصویر حول مرکز

-intent <type>

استفاده از این نوع قصد رندر (rendering intent) هنگام مدیریت رنگ تصویر

-interlace <type>

نوع طرح درهم‌بافی (interlacing)

-label <name>

اختصاص یک برچسب به تصویر

-lat <width>x<height>{+-}<offset>{%}

انجام آستانه‌گذاری انطباقی محلی (local adaptive thresholding)

-level <black_point>{,<gamma>}{,<white_point>}{%}

تنظیم سطح کنتراست تصویر

-limit <type> <value>

محدودیت منابع Disk، File، Images، Map، Memory، Pixels، Width، Height، Read، Threads یا Write

-list <type>

نوع فهرست

-log <string>

مشخص کردن قالب گزارش اشکال‌زدایی

-loop <iterations>

افزودن افزونه حلقه Netscape به پویانمایی GIF

-magnify

بزرگ‌نمایی تصویر

-map <filename>

انتخاب یک مجموعه رنگ مشخص از این تصویر

-mask <filename>

مشخص کردن یک ماسک برش (clipping mask)

-matte

ذخیره کانال مات (matte channel) در صورت وجود در تصویر

-mattecolor <color>

مشخص کردن رنگ مورد استفاده همراه با گزینه -frame

-median <radius>

اعمال یک فیلتر میانه روی تصویر

-minify <factor>

کوچک‌نمایی تصویر

-modulate brightness[,saturation[,hue]]

تغییر دادن روشنایی، اشباع و فام (hue) تصویر

-monitor

نمایش نشانگر پیشرفت

-monochrome

تبدیل تصویر به سیاه و سفید

-morph <frames>

تبدیل تدریجی (morph) یک توالی تصویر

-mosaic

ایجاد یک موزاییک از یک تصویر یا یک توالی تصویر

-motion-blur <radius>{x<sigma>}{+angle}

شبیه‌سازی تاری حرکتی (motion blur)

-negate

جایگزین کردن هر پیکسل با رنگ مکمل آن

-noise <radius|type>

افزودن یا کاهش نویز در تصویر

-noop

دستور NOOP (بدون عملیات / بدون گزینه)

-normalize

تبدیل تصویر به نحوی که تمام دامنه مقادیر رنگی را پوشش دهد

-opaque <color>

تغییر این رنگ به رنگ قلم در تصویر

-operator channel operator rvalue[%]

اعمال یک عملگر ریاضی، بیتی یا مقداری روی کانال تصویر

-ordered-dither <channeltype> <NxN>

اعمال دیترینگ مرتب (ordered dither) روی تصویر

-orient <orientation>

تنظیم مشخصه جهت‌گیری تصویر

-page <width>x<height>{+-}<x>{+-}<y>{%}{!}{<}{>}

اندازه و مکان بوم تصویر

-paint <radius>

شبیه‌سازی نقاشی رنگ روغن.TP -pen <color> (این گزینه با گزینهٔ -fill جایگزین شده است)

-ping

تعیین بهینه و سریع مشخصات تصویر

-pointsize <value>

اندازه قلم (pointsize) برای قلم‌های PostScript، X11، یا TrueType

-preview <type>

نوع پیش‌نمایش تصویر

-process <command>

پردازش دنباله‌ای از تصاویر با استفاده از یک پودمان پردازش (process module)

-profile <filename>

افزودن نمایهٔ ICM، IPTC یا عمومی به تصویر

-quality <value>

سطح فشرده‌سازی JPEG/MIFF/PNG/TIFF

-raise <width>x<height>

روشن‌تر یا تیره‌تر کردن لبه‌های تصویر

-random-threshold <channeltype> <LOWxHIGH>

اعمال آستانه‌گذاری تصادفی بر روی تصویر

-recolor <matrix>

اعمال یک ماتریس تبدیل رنگ به کانال‌های تصویر

-map <filename>

انتخاب مجموعهٔ مشخصی از رنگ‌ها از این تصویر

-red-primary <x>,<y>

نقطهٔ اصلی رنگینگی قرمز

-region <width>x<height>{+-}<x>{+-}<y>

اعمال گزینه‌ها بر روی بخشی از تصویر

-render

رندر کردن عملیات برداری

-repage <width>x<height>+xoff+yoff[!]

تنظیم انحراف‌های صفحهٔ تصویر (offsets)

-resample <horizontal>x<vertical>

نمونه‌برداری مجدد تصویر به تفکیک‌پذیری افقی و عمودی مشخص‌شده

-resize <width>x<height>{%}{@}{!}{<}{>}

تغییر اندازهٔ یک تصویر

-roll {+-}<x>{+-}<y>

لغزاندن (roll) یک تصویر به‌صورت عمودی یا افقی

-rotate <degrees>{<}{>}

چرخاندن تصویر

-sample <geometry>

مقیاس‌بندی تصویر با استفاده از نمونه‌برداری پیکسلی

-sampling-factor <horizontal_factor>x<vertical_factor>

ضریب‌های زیرنمونه‌برداری رنگینگی (chroma subsampling)

-scale <geometry>

مقیاس‌بندی تصویر.

-scene <value>

تنظیم شمارهٔ صحنه

-set <attribute> <value>

تنظیم یک مشخصه برای تصویر

+set <attribute>

حذف یک مشخصه از تصویر

-segment <cluster threshold>x<smoothing threshold>

بخش‌بندی (قطعه‌بندی) یک تصویر

-shade <azimuth>x<elevation>

سایه‌روشن زدن تصویر با استفاده از یک منبع نور دوردست

-sharpen <radius>{x<sigma>}

واضح‌سازی (شارپ کردن) تصویر

-shave <width>x<height>{%}

تراشیدن پیکسل‌ها از لبه‌های تصویر

-shear <x degrees>x<y degrees>

اریب کردن (shear) تصویر در امتداد محور X یا Y

-size <width>x<height>{+offset}

عرض و طول تصویر

-solarize <factor>

نگاتیو کردن تمام پیکسل‌های بالاتر از سطح آستانه

-spread <amount>

جابه‌جایی تصادفی پیکسل‌های تصویر به میزان معین

-strip

حذف تمامی نمایه‌ها و مشخصه‌های متنی از تصویر

-stroke <color>

رنگ مورد استفاده هنگام خط‌کشی شکل‌های گرافیکی پایه

-strokewidth <value>

تنظیم پهنای خط‌کشی

-swirl <degrees>

چرخاندن گردابی پیکسل‌های تصویر حول مرکز

-texture <filename>

نام بافت جهت چیدمان کاشی‌وار بر روی پس‌زمینهٔ تصویر

-threshold <value>{%}

اعمال آستانه‌گذاری بر روی تصویر

-thumbnail <width>x<height>{%}{@}{!}{<}{>}

تغییر اندازهٔ یک تصویر (به‌سرعت)

-tile <filename>

چیدمان کاشی‌وار تصویر هنگام پر کردن شکل‌های گرافیکی پایه

-transform

تبدیل هندسی تصویر

-transparent <color>

شفاف کردن این رنگ در سراسر تصویر

-treedepth <value>

عمق درخت برای الگوریتم کاهش رنگ

-trim

برش حاشیه‌های زائد تصویر

-type <type>

نوع تصویر

-units <type>

واحدهای تفکیک‌پذیری تصویر

-unsharp <radius>{x<sigma>}{+<amount>}{+<threshold>}

واضح‌سازی تصویر با عملگر ماسک مات‌زدایی (unsharp mask)

-use-pixmap

استفاده از pixmap

-verbose

چاپ اطلاعات تفصیلی دربارهٔ تصویر

-version

چاپ اطلاعات دقیق نسخه/ساخت GraphicsMagick

-version

چاپ فشردهٔ اطلاعات نسخه GraphicsMagick به سبک GNU

-view <string>

پارامترهای نمایش FlashPix

-virtual-pixel <method>

مشخص کردن محتوای «پیکسل‌های مجازی»

-wave <amplitude>x<wavelength>

موج‌دار کردن تصویر در امتداد یک موج سینوسی

-white-point <x>,<y>

نقطهٔ سفید رنگینگی

-white-threshold red[,green][,blue][,opacity]

پیکسل‌های بالاتر از آستانه سفید می‌شوند

-write <filename>

نوشتن یک تصویر میانی [convert, composite]

برای شرح دقیق‌تر هر گزینه، به گزینه‌ها (Options) در بالا مراجعه کنید..SH GM DISPLAY

برنامهٔ Display یک ابزار پردازش و نمایش تصویر مستقل از معماری ماشین است. این ابزار می‌تواند تصویری را روی هر صفحه‌نمایش ایستگاه کاری که یک سرور X را اجرا می‌کند نمایش دهد. Display می‌تواند بسیاری از قالب‌های تصویری رایج‌تر (مانند JPEG، TIFF، PNM، Photo CD و غیره) را بخواند و بنویسد.

با display می‌توانید این عملیات را روی یک تصویر انجام دهید:

o بارگذاری تصویر از یک فایل
o نمایش تصویر بعدی
o نمایش تصویر قبلی
o نمایش توالی تصاویر به‌صورت اسلایدشو
o ذخیرهٔ تصویر در یک فایل
o چاپ تصویر با چاپگر PostScript
o حذف فایل تصویر
o ایجاد دایرکتوری تصویری بصری (Visual Image Directory)
o انتخاب تصویر برای نمایش از روی بندانگشتی آن به جای نام
o لغو آخرین تغییرات اعمال‌شده روی تصویر
o کپی کردن یک ناحیه از تصویر
o جای‌گذاری یک ناحیه در تصویر
o بازگرداندن تصویر به اندازهٔ اصلی آن
o تازه‌سازی تصویر
o نصف کردن اندازهٔ تصویر
o دو برابر کردن اندازهٔ تصویر
o تغییر اندازهٔ تصویر
o برش زدن (crop) تصویر
o بریدن بخشی از تصویر
o وارونگی افقی تصویر (flop)
o وارونگی عمودی تصویر (flip)
o چرخاندن تصویر به میزان ۹۰ درجه در جهت عقربه‌های ساعت
o چرخاندن تصویر به میزان ۹۰ درجه در خلاف جهت عقربه‌های ساعت
o چرخاندن تصویر
o اریب کردن تصویر (shear)
o غلتاندن تصویر (roll)
o پیرایش حاشیه‌های زائد تصویر (trim)
o معکوس کردن رنگ‌های تصویر
o تغییر میزان روشنایی رنگ
o تغییر غلظت رنگ (saturation)
o تغییر فام رنگ (hue) تصویر
o تصحیح گامای تصویر
o افزایش وضوح کنتراست تصویر
o کاهش و تعدیل کنتراست تصویر
o انجام متعادل‌سازی هیستوگرام روی تصویر
o انجام نرمال‌سازی هیستوگرام روی تصویر
o نگاتیو کردن رنگ‌های تصویر
o تبدیل تصویر به مقیاس خاکستری (grayscale)
o تنظیم حداکثر تعداد رنگ‌های یکتا در تصویر
o کاهش لکه‌ها (speckles) درون تصویر
o حذف نویزهای اوج (peak noise) از تصویر
o تشخیص لبه‌ها در تصویر
o برجسته‌نمایی تصویر (emboss)
o بخش‌بندی تصویر بر اساس رنگ
o شبیه‌سازی نقاشی رنگ‌روغن
o شبیه‌سازی طرح با زغال
o یادداشت‌گذاری روی تصویر با متن
o رسم روی تصویر
o ویرایش رنگ یک پیکسل از تصویر
o ویرایش اطلاعات مات (matte) تصویر
o ترکیب یک تصویر با تصویری دیگر
o افزودن حاشیه به تصویر
o احاطه کردن تصویر با یک کادر تزیینی
o اعمال روش‌های پردازش تصویر روی یک ناحیهٔ مدنظر
o نمایش اطلاعات دربارهٔ تصویر
o بزرگ‌نمایی بخشی از تصویر
o نمایش هیستوگرام تصویر
o نمایش تصویر در پس‌زمینهٔ یک پنجره
o تنظیم ترجیحات کاربر
o نمایش اطلاعات دربارهٔ این برنامه
o صرف‌نظر کردن از تمام تصاویر و خروج از برنامه
o تغییر سطح بزرگ‌نمایی
o نمایش تصاویر مشخص‌شده با نشانی اینترنتی وب جهان‌گستر (WWW) یا همان URL

مثال‌ها (EXAMPLES)

برای تغییر مقیاس تصویر یک طوطی به اندازهٔ دقیقاً ۶۴۰ پیکسل در پهنا و ۴۸۰ پیکسل در ارتفاع و قرار دادن پنجره در موقعیت (200,200)، استفاده کنید از:

gm display -geometry 640x480+200+200! cockatoo.miff

برای نمایش تصویر یک طوطی بدون حاشیه به‌صورت متمرکز روی پس‌زمینه، استفاده کنید از:

gm display +borderwidth -backdrop cockatoo.miff

برای چیدمان تکرارشوندهٔ (tile) یک بافت سنگ روی پنجرهٔ ریشه (root)، استفاده کنید از:

gm display -size 1280x1024 -window root slate.png

برای نمایش یک فهرست تصویری بصری از تمام تصاویر JPEG خود، استفاده کنید از:

gm display 'vid:*.jpg'

برای نمایش یک تصویر MAP با پهنای ۶۴۰ پیکسل و ارتفاع ۴۸۰ پیکسل با ۲۵۶ رنگ، استفاده کنید از:

gm display -size 640x480+256 cockatoo.map

برای نمایش تصویر یک طوطی که با مکان‌یاب یکنواخت منبع وب جهان‌گستر (WWW) یا همان (URL) مشخص شده است، استفاده کنید از:

gm display ftp://wizards.dupont.com/images/cockatoo.jpg

برای نمایش هیستوگرام یک تصویر، استفاده کنید از:

    gm gm convert file.jpg HISTOGRAM:- | gm display -
گزینه‌ها به ترتیب خط فرمان پردازش می‌شوند. هر گزینه‌ای که در خط فرمان تعیین
کنید، تا زمانی که با مشخص کردن مجدد همان گزینه با اثری متفاوت صراحتاً تغییر داده
نشود، به قوت خود باقی می‌ماند. برای مثال جهت نمایش سه تصویر، اولی با ۳۲ رنگ،
دومی با تعداد نامحدود رنگ، و سومی فقط با ۱۶ رنگ، استفاده کنید از:
    gm display -colors 32 cockatoo.miff -noop duck.miff
                 -colors 16 macaw.miff

گزینه‌های Display می‌توانند در خط فرمان یا در فایل منابع X شما قرار بگیرند. X(1) را ببینید. گزینه‌های خط فرمان نسبت به مقادیر مشخص‌شده در فایل منابع X اولویت دارند.

برای توضیحات دقیق‌تر درباره هر گزینه، بخش گزینه‌ها در بالا را ببینید.

-authenticate <string>

رمزگشایی تصویر با این گذرواژه

-backdrop

نمایش تصویر به‌صورت متمرکز روی یک پس‌زمینه (backdrop).

-background <color>

رنگ پس‌زمینه

-border <width>x<height>

احاطه کردن تصویر با حاشیه‌ای از رنگ

-bordercolor <color>

رنگ حاشیه

-borderwidth <geometry>

عرض حاشیه

-colormap <type>

تعریف نوع نقشه رنگ (colormap)

-colors <value>

تعداد رنگ ترجیحی در تصویر

-colorspace <value>

نوع فضای رنگی (colorspace)

-comment <string>

افزودن یادداشت به تصویر با یک دیدگاه (کامنت)

-compress <type>

نوع فشرده‌سازی تصویر

-contrast

افزایش یا کاهش کنتراست تصویر

-crop <width>x<height>{+-}<x>{+-}<y>{%}

اندازه و موقعیت ترجیحی تصویر برش‌خورده

-debug <events>

فعال‌سازی چاپ خروجی اشکال‌زدایی (debug)

-define <key>{=<value>},...

افزودن گزینه‌های خاص کُدگذار/کُدگشا (coder/decoder)

-delay <1/100ths of a second>

نمایش تصویر بعدی پس از مکث

-density <width>x<height>

وضوح افقی و عمودی تصویر بر حسب پیکسل

-depth <value>

عمق بیت تصویر

-despeckle

کاهش نویز و لکه‌های ریز درون تصویر

-display <host:display[.screen]>

کارساز X مورد نظر برای اتصال را مشخص می‌کند

-dispose <method>

روش پاک‌سازی فریم GIF (disposal method)

-dither

اعمال انتشار خطای فلوید/اشتاینبرگ (Floyd/Steinberg error diffusion) روی تصویر

-edge <radius>

تشخیص لبه‌ها درون تصویر

-endian <type>

مشخص کردن ترتیب بایت‌ها (MSB، LSB یا Native) در تصویر

-enhance

اعمال یک فیلتر دیجیتال برای بهبود کیفیت تصویر نویزدار

-filter <type>

استفاده از این نوع فیلتر هنگام تغییر اندازه تصویر

-flip

ایجاد یک «تصویر آینه‌ای» (وارونه‌سازی عمودی)

-flop

ایجاد یک «تصویر آینه‌ای» (وارونه‌سازی افقی)

-font <name>

استفاده از این فونت هنگام نوشتن متن روی تصویر

-foreground <color>

تعریف رنگ پیش‌زمینه

-frame <width>x<height>+<outer bevel width>+<inner bevel width>

احاطه کردن تصویر با یک قاب تزیینی

-gamma <value>

میزان اصلاح گاما (gamma correction)

-geometry <width>x<height>{+-}<x>{+-}<y>{%}{@}{!}{^}{<}{>}

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

-help

چاپ دستورالعمل‌های استفاده

-iconGeometry <geometry>

مشخص کردن ابعاد و مکان آیکون

-iconic

پویانمایی به‌صورت آیکون

-immutable

تغییرناپذیر کردن تصویر

-interlace <type>

نوع طرح درهم‌بافی (interlacing)

-label <name>

اختصاص یک برچسب به تصویر

-limit <type> <value>

محدودیت منابع Disk، File، Images، Map، Memory، Pixels، Width، Height، Read، Threads یا Write

-log <string>

مشخص کردن قالب گزارش اشکال‌زدایی (debug log)

-magnify <factor>

بزرگ‌نمایی تصویر

-map <type>

نمایش تصویر با استفاده از این نوع.

-matte

ذخیره کانال مات (آلفا) در صورت وجود در تصویر

-mattecolor <color>

مشخص کردن رنگ مورد استفاده همراه با گزینهٔ -frame

-monitor

نمایش نشانگر پیشرفت

-monochrome

تبدیل تصویر به سیاه و سفید

-name

نام‌گذاری یک تصویر

-negate

جایگزینی هر پیکسل با رنگ مکمل آن

-noop

دستور بی‌اثر NOOP (بدون گزینه)

-page <width>x<height>{+-}<x>{+-}<y>{%}{!}{<}{>}

اندازه و مکان بوم (canvas) تصویر

+progress

غیرفعال کردن ناظر پیشرفت و مکان‌نمای مشغول

-quality <value>

سطح فشرده‌سازی JPEG/MIFF/PNG/TIFF

-raise <width>x<height>

روشن یا تیره کردن لبه‌های تصویر

-remote

انجام یک عملیات از راه دور X11

-roll {+-}<x>{+-}<y>

غلتاندن تصویر به صورت عمودی یا افقی

-rotate <degrees>{<}{>}

چرخاندن تصویر

-sample <geometry>

مقیاس‌بندی تصویر با استفاده از نمونه‌برداری پیکسل

-sampling-factor <horizontal_factor>x<vertical_factor>

ضرایب زیرنمونه‌برداری رنگی (chroma subsampling)

-scenes <value-value>

محدوده شماره صحنه‌های تصویر برای خواندن.TP -set <attribute> <value> تنظیم یک صفت تصویر

+set <attribute>

لغو تنظیم یک صفت تصویر

-segment <cluster threshold>x<smoothing threshold>

بخش‌بندی یک تصویر

-shared-memory

استفاده از حافظه اشتراکی

-sharpen <radius>{x<sigma>}

واضح‌سازی تصویر

-size <width>x<height>{+offset}

عرض و ارتفاع تصویر

-text-font <name>

قلم برای نوشتن متن با عرض ثابت

-texture <filename>

نام بافت برای کاشی‌کاری در پس‌زمینه تصویر

-title <string>

تخصیص عنوان به تصویر نمایش‌داده‌شده [animate, display, montage]

-treedepth <value>

عمق درخت برای الگوریتم کاهش رنگ

-trim

پیراستن تصویر

-type <type>

نوع تصویر

-update <seconds>

تشخیص زمان تغییر فایل تصویر و نمایش مجدد آن.

-use-pixmap

استفاده از pixmap

-verbose

چاپ اطلاعات تفصیلی درباره تصویر

-version

چاپ اطلاعات تفصیلی نگارش و ساخت GraphicsMagick

-version

چاپ فشرده اطلاعات نگارش GraphicsMagick به سبک GNU

-visual <type>

پویانمایی تصاویر با استفاده از این نوع نمای بصری X

-window <id>

قرار دادن تصویر به عنوان پس‌زمینه یک پنجره

-window-group

مشخص کردن گروه پنجره

-write <filename>

نوشتن تصویر در یک فایل [display]

برای توضیحات مفصل‌تر درباره هر گزینه، بخش گزینه‌ها را در بالا ببینید.

دکمه‌های ماوس (MOUSE BUTTONS)

اثر فشرده‌شدن هر دکمه در زیر شرح داده شده است. سه دکمه مورد نیاز است. اگر ماوس دو‌دکمه‌ای دارید، دکمه‌های ۱ و ۳ گزارش می‌شوند. برای شبیه‌سازی دکمه ۲، کلید ALT و دکمه ۳ را فشار دهید.

1

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

2

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

3

کلیک کرده و بکشید تا از میان مجموعه‌ای منتخب از دستورهای display(1) انتخاب کنید. رفتار این دکمه در صورتی که تصویرِ در حال نمایش یک دایرکتوری بصری تصویر باشد، متفاوت خواهد بود. کاشی خاصی از دایرکتوری را انتخاب کرده و این دکمه را فشرده و بکشید تا فرمانی از یک منوی جهنده (pop-up) انتخاب شود. از میان این موارد منو انتخاب کنید:

Open
Next
Former
Delete
Update

اگر Open را انتخاب کنید، تصویر متناظر با کاشی نمایش داده می‌شود. برای بازگشت به دایرکتوری بصری تصویر، Next را از ابزارک فرمان انتخاب کنید (به ابزارک فرمان مراجعه نمایید). گزینه‌های Next و Former به‌ترتیب به تصویر بعدی یا قبلی حرکت می‌کنند. Delete را برای حذف کاشی یک تصویر خاص انتخاب کنید. در نهایت، Update را برای همگام‌سازی تمامی کاشی‌های تصویر با تصاویر متناظرشان انتخاب کنید. برای جزئیات بیشتر montage و miff را ببینید.

ابزارک فرمان (COMMAND WIDGET)

ابزارک فرمان فهرستی از چندین زیرمنو و دستور را نمایش می‌دهد. این موارد عبارتند از:

File

Open...
Next
Former
Select...
Save...
Print...
Delete...
Canvas...
Visual Directory...
Quit

Edit

Undo
Redo
Cut
Copy
Paste

View

Half Size
Original Size
Double Size
Resize...
Apply
Refresh
Restore

Transform

Crop
Chop
Flop
Flip
Rotate Right
Rotate Left
Rotate...
Shear...
Roll...
Trim Edges

Enhance

Hue...
Saturation...
Brightness...
Gamma...
Spiff...
Dull
Equalize
Normalize
Negate
GRAYscale
Quantize...

Effects

Despeckle
Emboss
Reduce Noise
Add Noise
Sharpen...
Blur...
Threshold...
Edge Detect...
Spread...
Shade...
Raise...
Segment...

F/X

Solarize...
Swirl...
Implode...
Wave...
Oil Paint...
Charcoal Draw...

Image Edit

Annotate...
Draw...
Color...
Matte...
Composite...
Add Border...
Add Frame...
Comment...
Launch...
Region of Interest...

Miscellany

Image Info
Zoom Image
Show Preview...
Show Histogram
Show Matte
Background...
Slide Show
Preferences...

Help

Overview
Browse Documentation
About Display

موارد منو که دارای یک مثلث تو‌رفته هستند، دارای یک زیرمنو می‌باشند. این موارد در بالا به صورت موارد دندانه‌دار نشان داده شده‌اند. برای دسترسی به یک مورد زیرمنو، نشانگر ماوس را به منوی مربوطه برده و دکمه ۱ را فشرده و بکشید. هنگامی که مورد دلخواه زیرمنو را یافتید، دکمه را رها کنید تا دستور اجرا شود. در صورتی که تصمیم گرفتید دستور خاصی را اجرا نکنید، نشانگر ماوس را از زیرمنو دور کنید..SH "کلیدهای میان‌بر (KEYBOARD ACCELERATORS)"

کلیدهای میان‌بر فشردن یک یا دو کلید هستند که دستور خاصی را به اجرا درمی‌آورند. کلیدهای میان‌بری که display پشتیبانی می‌کند عبارت‌اند از:

Ctl+O     برای بارگذاری یک تصویر از فایل بفشارید.
space     برای نمایش تصویر بعدی بفشارید.

اگر تصویر یک سند چندصفحه‌ای مانند یک سند PostScript باشد، می‌توانید با قرار دادن یک عدد پیش از این دستور، چندین صفحه به جلو بروید. برای نمونه جهت نمایش چهارمین صفحه بعد از صفحه جاری، 4space را بفشارید.

backspace برای نمایش تصویر پیشین بفشارید.

اگر تصویر یک سند چندصفحه‌ای مانند یک سند PostScript باشد، می‌توانید با قرار دادن یک عدد پیش از این دستور، چندین صفحه به عقب بروید. برای نمونه جهت نمایش چهارمین صفحه پیش از صفحه جاری، 4n را بفشارید.

Ctl-S    برای ذخیره تصویر در یک فایل بفشارید.
Ctl-P    برای چاپ تصویر روی یک چاپگر
         PostScript بفشارید.
Ctl-D    برای حذف یک فایل تصویر بفشارید.
Ctl-N    برای ایجاد یک بوم خالی بفشارید.
Ctl-Q    برای دور انداختن تمام تصاویر و خروج از برنامه بفشارید.
Ctl+Z    برای واگرد آخرین تبدیل تصویر بفشارید.
Ctl+R    برای بازانجام آخرین تبدیل تصویر بفشارید.
Ctl-X    برای برش بخشی از
         تصویر بفشارید.
Ctl-C    برای رونوشت از بخشی از
         تصویر بفشارید.
Ctl-V    برای جای‌گذاری یک ناحیه در
         تصویر بفشارید.
<        برای نصف کردن اندازه تصویر بفشارید.
.        برای بازگشت به اندازه اصلی تصویر بفشارید.
>        برای دو برابر کردن اندازه تصویر بفشارید.
%        برای تغییر اندازه تصویر به عرض و ارتفاع
         مشخص‌شده توسط شما بفشارید.
Cmd-A    برای دائمی کردن هرگونه تبدیل تصویر
         بفشارید.
         به‌طور پیش‌فرض، هرگونه تبدیل اندازه تصویر روی
         تصویر اصلی اعمال می‌شود تا تصویری ایجاد شود که
         روی کارگزار X نمایش داده می‌شود. با این حال، این
         تبدیل‌ها دائمی نیستند (یعنی اندازه تصویر اصلی
         تغییر نمی‌کند و فقط تصویر X تغییر می‌کند). برای نمونه،
         اگر «>» را بفشارید، اندازه تصویر X دو برابر به نظر
         می‌رسد، اما اندازه تصویر اصلی در واقع همان باقی
         می‌ماند. برای وادار کردن تصویر اصلی به دو برابر شدن
         اندازه، «>» و به دنبال آن «Cmd-A» را بفشارید.
@        برای نوسازی پنجره تصویر بفشارید.
C        برای کادربندی (crop) تصویر بفشارید.
[        برای قطعه‌کردن (chop) تصویر بفشارید.
H        برای قرینه‌سازی افقی تصویر بفشارید.
V        برای وارونه‌سازی عمودی تصویر بفشارید.
/        برای چرخاندن ۹۰ درجه‌ای تصویر در جهت عقربه‌های ساعت بفشارید.
\        برای چرخاندن ۹۰ درجه‌ای تصویر در خلاف جهت
         عقربه‌های ساعت بفشارید.
*        برای چرخاندن تصویر به تعداد درجات
         مشخص‌شده توسط شما بفشارید.
S        برای کج کردن (shear) تصویر به میزان درجات
         مشخص‌شده توسط شما بفشارید.
R        برای غلتاندن (roll) تصویر بفشارید.
T        برای پیراستن لبه‌های تصویر بفشارید.
Shft-H   برای تغییر فام رنگ بفشارید.
Shft-S   برای تغییر غلظت رنگ بفشارید.
Shft-L   برای تغییر درخشندگی تصویر بفشارید.
Shft-G   برای تصحیح گامای تصویر بفشارید.
Shft-C   برای تقویت کنتراست تصویر بفشارید.
Shft-Z   برای کاهش کنتراست تصویر بفشارید.
=        برای اعمال تعدیل هیستوگرام بر روی
         تصویر بفشارید.
Shft-N   برای اعمال نرمال‌سازی هیستوگرام بر روی
         تصویر بفشارید.
Shft-~   برای نگاتیو کردن رنگ‌های تصویر بفشارید.
.        برای تبدیل رنگ‌های تصویر به خاکستری بفشارید.
Shft-#   برای تنظیم بیشینه تعداد رنگ‌های یکتا
         در تصویر بفشارید.
F2       برای کاهش لکه‌ها در یک تصویر بفشارید.
F2       برای برجسته‌سازی یک تصویر بفشارید.
F4       برای حذف نوفه اوج از یک تصویر بفشارید.
F5       برای افزودن نوفه به یک تصویر بفشارید.
F6       برای شارپ کردن (افزایش وضوح) یک تصویر بفشارید.
F7       برای تار و محو کردن یک تصویر بفشارید.
F8       برای آستانه‌گذاری تصویر بفشارید.
F9       برای تشخیص لبه‌ها درون یک تصویر بفشارید.
F10      برای جابه‌جا کردن پیکسل‌ها به مقداری تصادفی بفشارید.
F11      برای سایه‌پردازی تصویر با استفاده از یک منبع نور
         دوردست بفشارید.
F12      برای روشن‌تر یا تیره‌تر کردن لبه‌های تصویر جهت
         ایجاد جلوه سه‌بعدی بفشارید.
F13      برای بخش‌بندی تصویر بر پایه رنگ بفشارید.
Meta-S   برای چرخش حلزونی پیکسل‌های تصویر حول مرکز بفشارید.
Meta-I   برای درون‌پاشی پیکسل‌های تصویر حول مرکز بفشارید.
Meta-W   برای تغییر شکل تصویر در امتداد یک موج سینوسی بفشارید.
Meta-P   برای شبیه‌سازی یک نقاشی رنگ روغن بفشارید.
Meta-C   برای شبیه‌سازی یک طرح زغالی بفشارید.
Alt-X    برای ترکیب کردن تصویر
         با تصویری دیگر بفشارید.
Alt-A    برای حاشیه‌نویسی متنی روی تصویر بفشارید.
Alt-D    برای رسم یک خط روی تصویر بفشارید.
Alt-P    برای ویرایش رنگ یک پیکسل تصویر بفشارید.
Alt-M    برای ویرایش اطلاعات مات (matte) تصویر بفشارید.
Alt-X    برای ترکیب کردن تصویر با تصویری دیگر بفشارید.
Alt-A    برای افزودن حاشیه (border) به تصویر بفشارید.
Alt-F    برای افزودن یک قاب تزیینی به تصویر بفشارید.
Alt-Shft-!   برای افزودن نظر/یادداشت به تصویر بفشارید.
Ctl-A    برای اعمال فنون پردازش تصویر روی یک
         ناحیه مورد نظر بفشارید.
Shft-?   برای نمایش اطلاعات درباره تصویر بفشارید.
Shft-+   برای نگاشت پنجره بزرگ‌نمایی تصویر بفشارید.
Shft-P   برای پیش‌نمایش بهسازی، جلوه،
         یا f/x تصویر بفشارید.
F1       برای نمایش اطلاعات راهنما درباره
         ابزار «display» بفشارید.
Find     برای مرور مستندات مربوط به
         GraphicsMagick بفشارید.
1-9      برای تغییر سطح بزرگ‌نمایی بفشارید.

از کلیدهای جهت‌نما برای جابه‌جایی تصویر به اندازه یک پیکسل به بالا، پایین، چپ یا راست در پنجره بزرگ‌نمایی استفاده کنید. مطمئن شوید که ابتدا با فشردن دکمه ۲ پنجره بزرگ‌نمایی را نگاشت (نمایان) کرده‌اید.

برای بریدن یک پیکسل از هر طرف تصویر، کلید ALT و یکی از کلیدهای جهت‌نما را بفشارید..SH "منابع اکس (X RESOURCES)"

گزینه‌های Display می‌توانند در خط فرمان یا در فایل منابع X شما مشخص شوند. گزینه‌های خط فرمان بر مقادیر مشخص‌شده در فایل منابع X اولویت دارند. برای اطلاعات بیشتر درباره منابع X، به X(1) مراجعه کنید.

بیشتر گزینه‌های display یک منبع X متناظر دارند. علاوه بر این، display از منابع X زیر استفاده می‌کند:

background (class Background)

رنگ ترجیحی مورد استفاده برای پس‌زمینه پنجره تصویر را مشخص می‌کند. پیش‌فرض #ccc است.

borderColor (class BorderColor)

رنگ ترجیحی مورد استفاده برای حاشیه پنجره تصویر را مشخص می‌کند. پیش‌فرض #ccc است.

borderWidth (class BorderWidth)

عرض حاشیه پنجره تصویر را بر حسب پیکسل مشخص می‌کند. پیش‌فرض 2 است.

browseCommand (class browseCommand)

نام مرورگر ترجیحی را هنگام نمایش مستندات GraphicsMagick مشخص می‌کند. پیش‌فرض netscape %s است.

confirmExit (class ConfirmExit)

هنگام خروج از برنامه، Display یک کادر محاوره‌ای را برای تأیید خروج نمایش می‌دهد. این منبع را روی False تنظیم کنید تا برنامه بدون درخواست تأیید بسته شود.

displayGamma (class DisplayGamma)

مقدار گامای سرور X را مشخص می‌کند. می‌توانید با استفاده از فهرستی از مقادیر گاما که با خط مایل (اسلش) از هم جدا شده‌اند (مانند 1.7/2.3/1.2)، مقادیر گامای جداگانه‌ای را روی کانال‌های قرمز، سبز و آبی تصویر اعمال کنید. پیش‌فرض 2.2 است.

displayWarnings (class DisplayWarnings)

هر زمان که پیام هشداری صادر شود، Display یک کادر محاوره‌ای را نمایش می‌دهد. این منبع را روی False تنظیم کنید تا پیام‌های هشدار نادیده گرفته شوند.

font (class FontList)

نام قلم ترجیحی را برای استفاده در متن‌های قالب‌بندی‌شده عادی مشخص می‌کند. پیش‌فرض 14 point Helvetica است.

font[1-9] (class Font[1-9])

نام قلم ترجیحی را برای حاشیه‌نویسی متنی روی پنجره تصویر مشخص می‌کند. قلم‌های پیش‌فرض عبارتند از: fixed،‏ variable،‏ 5x8،‏ 6x10،‏ 7x13bold،‏ 8x13bold،‏ 9x15bold،‏ 10x20 و 12x24.

foreground (class Foreground)

رنگ ترجیحی برای متن درون پنجره تصویر را مشخص می‌کند. پیش‌فرض black است.

gammaCorrect (class gammaCorrect)

این منبع، در صورت true بودن، تصویر با گامای معلوم را روشن‌تر یا تیره‌تر می‌کند تا با گامای نمایشگر همخوانی پیدا کند (منبع displayGamma را ببینید). پیش‌فرض True است.

geometry (class Geometry)

اندازه و موقعیت ترجیحی پنجره تصویر را مشخص می‌کند. این مقدار لزوماً توسط همه مدیرهای پنجره رعایت نمی‌شود.

انحراف‌ها (offsets)، در صورت وجود، به سبک X(1) مدیریت می‌شوند. انحراف منفی x از لبه راست صفحه تا لبه راست آیکون، و انحراف منفی y از لبه پایین صفحه تا لبه پایین آیکون محاسبه می‌شود.

iconGeometry (class IconGeometry)

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

انحراف‌ها، در صورت وجود، به همان شیوه کلاس Geometry مدیریت می‌شوند.

iconic (class Iconic)

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

magnify (class Magnify)

یک ضریب عدد صحیح را مشخص می‌کند که تصویر باید به آن میزان بزرگ‌نمایی شود. پیش‌فرض 3 است. این مقدار فقط بر پنجره بزرگ‌نمایی که پس از نمایش تصویر با دکمه شماره 3 ماوس فعال می‌شود تأثیر می‌گذارد.

matteColor (class MatteColor)

رنگ پنجره‌ها را مشخص می‌کند. این مقدار برای پس‌زمینه پنجره‌ها، منوها و اعلان‌ها استفاده می‌شود. جلوه سه‌بعدی با استفاده از رنگ‌های روشنایی و سایه به‌دست‌آمده از این رنگ ایجاد می‌شود. مقدار پیش‌فرض: #697B8F است.

name (class Name)

این منبع نامی را مشخص می‌کند که منابع برنامه باید تحت آن جستجو شوند. این منبع در نام‌های مستعار پوسته (shell aliases) برای تمایز بین فراخوانی‌های مختلف یک برنامه، بدون نیاز به ایجاد پیوندها برای تغییر نام فایل اجرایی، مفید است. پیش‌فرض نام برنامه است.

pen[1-9] (class Pen[1-9])

رنگ قلم ترجیحی را هنگام حاشیه‌نویسی متنی روی پنجره تصویر مشخص می‌کند. رنگ‌های پیش‌فرض عبارتند از: black،‏ blue،‏ green،‏ cyan،‏ gray،‏ red،‏ magenta،‏ yellow و white.

printCommand (class PrintCommand)

این دستور هر زمان که عملیات چاپ صادر شود اجرا می‌شود. به‌طور کلی، این دستوری برای چاپ PostScript روی چاپگر شما است. مقدار پیش‌فرض: lp -c -s %i است.

sharedMemory (class SharedMemory)

این منبع مشخص می‌کند که آیا display باید تلاش کند برای pixmapها از حافظه اشتراکی استفاده کند یا خیر. GraphicsMagick باید با پشتیبانی از حافظه اشتراکی کامپایل شده باشد، و نمایشگر نیز باید از افزونه MIT-SHM پشتیبانی کند. در غیر این صورت، این منبع نادیده گرفته می‌شود. پیش‌فرض True است.

textFont (class textFont)

نام قلم ترجیحی را برای استفاده در متن‌های قالب‌بندی‌شده با عرض ثابت (سبک ماشین‌تحریر) مشخص می‌کند. پیش‌فرض 14 point Courier است.

title (class Title)

این منبع عنوان مورد استفاده برای پنجره تصویر را مشخص می‌کند. این اطلاعات گاهی توسط مدیر پنجره برای ارائه یک سربرگ جهت شناسایی پنجره استفاده می‌شود. پیش‌فرض نام فایل تصویر است.

undoCache (class UndoCache)

میزان حافظه نهان برای عملیات واگرد (undo) را بر حسب مگابایت مشخص می‌کند. هر بار که تصویر را ویرایش می‌کنید، تا زمانی که حافظه در دسترس باشد تغییرات در حافظه نهان ذخیره می‌شود. پس از آن می‌توانید یک یا چند مورد از این دگرگونی‌ها را واگردانی (undo) کنید. پیش‌فرض 16 Megabytes است.

usePixmap (class UsePixmap)

تصاویر به‌طور پیش‌فرض به‌عنوان یک XImage نگهداری می‌شوند. این منبع را روی True تنظیم کنید تا به جای آن از یک Pixmap سمت سرور استفاده شود. این گزینه زمانی مفید است که ابعاد تصویر از صفحه نمایش سرور شما بزرگتر باشد و قصد پیمایش (pan) روی تصویر را داشته باشید. پیمایش با Pixmap بسیار سریع‌تر از XImage انجام می‌شود. از آنجا که Pixmapها منبعی محدود و ارزشمند محسوب می‌شوند، از آن‌ها با احتیاط استفاده کنید.

برای تنظیم موقعیت و ابعاد (geometry) پنجره Magnify یا Pan، از منبع geometry استفاده کنید. برای مثال، برای تنظیم هندسه پنجره Pan روی 256x256، از دستور زیر استفاده کنید:

    gm display.pan.geometry: 256x256
برای انتخاب یک تصویر جهت نمایش، گزینه Open را از زیرمنوی File
در ابزارک Command انتخاب کنید. یک مرورگر فایل نمایش داده می‌شود.
برای انتخاب یک فایل تصویر خاص، نشانگر را روی نام فایل برده و
هر کلیدی را فشار دهید. نام فایل در پنجره متنی رونوشت می‌شود. سپس، Open
را انتخاب کرده یا کلید RETURN را فشار دهید. همچنین می‌توانید نام فایل تصویر
را مستقیماً در پنجره متنی تایپ کنید. برای رفتن به دایرکتوری‌های زیرین، نام یک
دایرکتوری را انتخاب کرده و دکمه را دو بار سریع فشار دهید. یک نوار پیمایش به شما
امکان می‌دهد در صورتی که تعداد نام‌های فایل از اندازه پنجره بیشتر باشد، فهرست را
پیمایش کنید.
می‌توانید با استفاده از نویسه‌های تطبیق الگوی پوسته (shell globbing)، فهرست نام‌های فایل را محدود کنید.
برای مثال، عبارت *.jpg را تایپ کنید تا فقط فایل‌هایی که پسوند
برای انتخاب تصویر از روی صفحه X server به جای یک فایل، گزینه
Grab را از ابزارک Open انتخاب کنید.