.TH gm 1 "2026/05/12" "GraphicsMagick" .TP .in 15 .in 15 .in 20 .SH "نام (NAME)" gm \- ابزار خط فرمان برای ایجاد، ویرایش، مقایسه، تبدیل یا نمایش تصاویر .SH "خلاصه دستور (SYNOPSIS)" \fBgm animate\fP \fB[\fP \fIoptions ...\fP \fB]\fP \fIfile\fP \fB[ [\fP \fIoptions ...\fP \fB]\fP \fIfile ...\fP \fB]\fP \fBgm batch\fP \fB[\fP \fIoptions ...\fP \fB]\fP \fB[\fP \fIscript\fP \fB]\fP \fBgm benchmark\fP \fB[\fP \fIoptions ...\fP \fB]\fP subcommand \fBgm compare\fP \fB[\fP \fIoptions\fP \fB... ]\fP \fIreference-image\fP \fB[\fP \fIoptions\fP \fB... ]\fP \fIcompare-image\fP \fB[\fP \fIoptions\fP \fB... ]\fP \fBgm composite\fP \fB[\fP \fIoptions ...\fP \fB]\fP \fIchange-image base-image\fP \fB[\fP \fImask-image\fP \fB]\fP \fIoutput-image\fP \fBgm conjure\fP \fB[\fP \fIoptions\fP \fB]\fP \fIscript.msl\fP \fB[ [\fP \fIoptions\fP \fB]\fP \fIscript.msl\fP \fB]\fP \fBgm convert\fP \fB[ [\fP \fIoptions ...\fP \fB] [\fP \fIinput-file ...\fP \fB] [\fP \fIoptions ...\fP \fB] ]\fP \fIoutput-file\fP \fBgm display\fP \fB[\fP \fIoptions ...\fP \fB]\fP \fIfile ...\fP \fB[ [\fP\fIoptions ...\fP \fB]\fP\fIfile ...\fP \fB]\fP \fBgm identify\fP \fIfile\fP \fB[\fP \fIfile ...\fP \fB]\fP \fBgm import\fP \fB[\fP \fIoptions ...\fP \fB]\fP \fIfile\fP \fBgm mogrify\fP \fB[\fP \fIoptions ...\fP \fB]\fP \fIfile ...\fP \fBgm montage\fP \fB[\fP \fIoptions ...\fP \fB]\fP \fIfile\fP \fB[ [\fP \fIoptions ...\fP \fB]\fP \fIfile ...\fP \fB]\fP \fIoutput-file\fP \fBgm time\fP subcommand \fBgm version\fP .SH "توضیحات (DESCRIPTION)" برنامهٔ \fBgm\fP متعلق به GraphicsMagick مجموعه‌ای از ابزارها را برای ایجاد، مقایسه، تبدیل، ویرایش و نمایش تصاویر فراهم می‌کند. تمامی این ابزارها به صورت زیرفرمان‌هایی از یک فایل اجرایی واحد به نام \fBgm\fP ارائه می‌شوند. فایل اجرایی \fBgm\fP وضعیت خروج 0 را به نشانهٔ موفقیت و 1 را به نشانهٔ شکست برمی‌گرداند: \fBanimate\fP یک پویانمایی (مانند یک فایل GIF) را بر روی هر نمایشگر ایستگاه کاری که یک کارساز \fIX\fP را اجرا می‌کند، نمایش می‌دهد. \fBbatch\fP تعداد دلخواهی از دستورهای این ابزار (مانند \fBconvert\fP) را در قالب یک اسکریپت دسته‌ای (batch) خطی ساده اجرا می‌کند تا بازدهی اجرا را بهبود بخشد و/یا امکان استفاده به عنوان یک فرآیند همکار (co-process) زیرمجموعه تحت کنترل یک اسکریپت یا برنامهٔ دلخواه را فراهم سازد. \fBbenchmark\fP یکی از دستورهای دیگر ابزار (مانند \fBconvert\fP) را برای تعداد تکرار مشخص یا مدت زمان اجرای تعیین‌شده اجرا کرده و زمان اجرا و سایر اطلاعات تحلیل کارایی (profiling) مانند میزان استفاده از CPU را گزارش می‌دهد. \fBBenchmark\fP حالت‌های عملیاتی مختلفی از جمله اجرای دستور با تعداد متغیر ریسه‌ها (threads) و قالب‌های گزارش‌دهی جایگزین مانند مقادیر جداشده با کاما (CSV) را ارائه می‌دهد. \fBcompare\fP دو تصویر را مقایسه کرده و آمار تفاوت‌ها را بر اساس معیارهای مشخص‌شده گزارش می‌دهد و/یا تصویری شامل نمای بصری تفاوت‌ها تولید می‌کند. همچنین می‌تواند برای آزمایش اینکه آیا تصاویر در یک محدودهٔ خاص و بر اساس معیاری مشخص مشابه یکدیگر هستند استفاده شود و یک مقدار درستی (truth value) را به محیط اجرا بازگرداند. \fBcomposite\fP تصاویر را ترکیب می‌کند (ترکیب یا ادغام تصاویر با یکدیگر) تا تصاویر جدیدی ایجاد شوند. \fBconjure\fP اسکریپت‌های نوشته‌شده به زبان اسکریپت‌نویسی مجیک (MSL) را تفسیر و اجرا می‌کند. \fBconvert\fP یک فایل ورودی با یک قالب تصویری را به یک فایل خروجی با همان قالب یا قالبی دیگر تبدیل می‌کند، در حالی که تعداد دلخواهی از تبدیلات تصویری را بر روی آن اعمال می‌نماید. \fBdisplay\fP امکانی برای پردازش و نمایش تصویر، مستقل از معماری ماشین است. این دستور می‌تواند تصویری را روی هر نمایشگر ایستگاه کاری که یک کارساز \fIX\fP را اجرا می‌کند، نمایش دهد. \fBidentify\fP قالب و ویژگی‌های یک یا چند فایل تصویری را توصیف می‌کند. همچنین در صورتی که تصویری ناقص یا خراب باشد، گزارش می‌دهد. \fBimport\fP تصویری را از هر پنجرهٔ نمایان روی یک کارساز \fIX\fP می‌خواند و آن را به عنوان یک فایل تصویری ذخیره می‌کند. شما می‌توانید یک پنجرهٔ منفرد، کل صفحه یا هر بخش مستطیلی از صفحه را ضبط کنید. \fBmogrify\fP یک تصویر یا توالی‌ای از تصاویر را دگرگون می‌کند. این دگرگونی‌ها شامل \fBمقیاس‌بندی تصویر\fP، \fBچرخش تصویر\fP، \fBکاهش رنگ\fP و موارد دیگر می‌شود. تصویر دگرگون‌شده بر روی تصویر اصلی \fBبازنویسی می‌شود (overwrites)\fP. \fBmontage\fP با ترکیب چندین تصویر مجزا، یک تصویر ترکیبی ایجاد می‌کند. تصاویر بر روی تصویر مرکب به صورت کاشی‌کاری چیده می‌شوند و نام تصویر نیز می‌تواند به صورت اختیاری درست در زیر هر کاشی نمایش یابد. \fBtime\fP یک زیرفرمان را اجرا کرده و زمان مصرف‌شدهٔ کاربر، سیستم و کل زمان اجرا را گزارش می‌دهد. \fBversion\fP نسخهٔ انتشار GraphicsMagick، حداکثر عمق نمونه (sample-depth)، اعلان حق نشر، ویژگی‌های پشتیبانی‌شده و گزینه‌های استفاده‌شده هنگام ساخت نرم‌افزار را گزارش می‌دهد. ابزارهای \fBGraphicsMagick\fP قالب‌های تصویری زیر را شناسایی می‌کنند: \fBنام\fP \fBحالت\fP \fBتوضیحات\fP 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) \fIپشتیبانی از برخی از این قالب‌ها نیازمند برنامه‌ها یا کتابخانه‌های جانبی است. برای آگاهی از نحوهٔ یافتن نرم‌افزارهای اختیاری اضافی، پروندهٔ README موجود در بستهٔ کد منبع را ببینید\fP. توجه داشته باشید قالبی که با علامت + مشخص شده است به این معناست که در صورت مشخص کردن بیش از یک تصویر، فریم‌ها در یک فایل چند تصویری واحد ادغام می‌شوند. در صورتی که می‌خواهید برای هر فریم یک تصویر مجزا تولید شود، از گزینهٔ \fB+adjoin\fP استفاده کنید. ممکن است نصب فعلی شما از تمام قالب‌های موجود در این فهرست پشتیبانی نکند. برای دریافت فهرستی دقیق از قالب‌های پشتیبانی‌شده توسط پیکربندی خاص خود، فرمان \(lqgm convert \-list format\(rq را اجرا کنید. انتظار می‌رود تصاویر خام دارای یک بایت به ازای هر پیکسل باشند، مگر آنکه \fBgm\fP در حالت کوانتومی ۱۶ بیتی یا ۳۲ بیتی کامپایل شده باشد. در این حالت‌ها، داده‌های خام به ترتیب با دو یا چهار بایت به ازای هر پیکسل، با اولویت بایت باارزش‌تر (most-significant-byte-first) ذخیره می‌شوند. برای نمونه، می‌توانید با وارد کردن فرمان \(lqgm version\(rq بدون هیچ گزینه‌ای و بررسی وجود عبارت \(lqQ:16\(rq در سطر نخست خروجی، متوجه شوید که آیا \fBgm\fP در حالت ۱۶ بیتی کامپایل شده است یا خیر..SH "فایل‌ها و قالب‌ها (FILES AND FORMATS)" به‌طور پیش‌فرض، قالب تصویر با شماره جادویی (magic number) آن، یعنی چند بایت اول فایل، تعیین می‌شود. برای مشخص کردن یک قالب تصویر خاص، نام قالب تصویر را همراه با دونقطه پیش از نام فایل بیاورید (\fIi.e.\fP\fBps:image\fP) یا نوع تصویر را به‌عنوان پسوند نام فایل مشخص کنید (\fIi.e.\fP\fBimage.ps\fP). در فایل‌های ورودی، شماره جادویی نسبت به پسوند نام فایل اولویت دارد و پیشوند نسبت به شماره جادویی و پسوند اولویت دارد. هنگامی که فایلی خوانده می‌شود، شماره جادویی آن در رشته "image->magick" ذخیره می‌گردد. در فایل‌های خروجی، پیشوند نسبت به پسوند نام فایل اولویت دارد، و پسوند نام فایل نسبت به رشته "image->magick" اولویت دارد. برای خواندن قالب‌های «توکار» (GRANITE، H، LOGO، NETSCAPE، PLASMA و ROSE) از یک پیشوند (شامل دونقطه) بدون نام فایل یا پسوند استفاده کنید. برای خواندن قالب XC، پس از دونقطه یک مشخصه رنگ بیاورید. برای خواندن قالب CAPTION، پس از دونقطه یک رشته متنی یا نام فایلی که نماد ات‌ساین (\fB@\fP) در ابتدای آن قرار دارد را وارد کنید. هنگامی که \fBX\fP را به‌عنوان نوع تصویر مشخص می‌کنید، نام فایل معنای خاصی دارد. این نام یک پنجره X را با \fBid، name\fP یا \fBroot\fP مشخص می‌کند. اگر هیچ نام فایلی مشخص نشود، پنجره با کلیک کردن ماوس روی پنجره مورد نظر انتخاب می‌شود. مقدار \fIinput_file\fP را برای ورودی استاندارد برابر \fB-\fP و \fIoutput_file\fP را برای خروجی استاندارد برابر \fB-\fP قرار دهید. اگر \fIinput_file\fP دارای پسوند \fB.Z\fP یا \fB.gz\fP باشد، فایل به‌ترتیب با \fBuncompress\fP یا \fBgunzip\fP از حالت فشرده خارج می‌شود. اگر \fIoutput_file\fP دارای پسوند \fB.Z\fP یا \fB.gz\fP باشد، فایل به‌ترتیب با استفاده از \fIcompress\fP یا \fIgzip\fP فشرده‌سازی می‌شود. برای تعیین زیر‌تصویر دلخواه در یک قالب تصویر چندوضوحی مانند Photo CD از یک نمایه اختیاری درون کروشه بعد از نام فایل ورودی استفاده کنید (مانند "img0001.pcd[4]") یا برای تصاویر MPEG از یک محدوده استفاده کنید (مانند "video.mpg[50-75]"). مشخصه زیر‌تصویر می‌تواند ناپیوسته باشد (مانند "image.tiff[2,7,4]"). برای تصاویر خام (raw)، یک زیر‌تصویر را با یک هندسه مشخص کنید (مانند \-size 640x512 "image.rgb[320x256+50+50]"). نام تصویر را در علامت نقل‌قول قرار دهید تا پوسته شما کروشه‌ها را تفسیر نکند. تصاویر تکی با همان نام فایلی که مشخص کرده‌اید نوشته می‌شوند. با این حال، تصاویر چندبخشی (مانند یک سند چندصفحه‌ای PostScript با مشخص بودن گزینه \fB+adjoin\fP) ممکن است همراه با شماره صحنه به‌عنوان بخشی از نام فایل نوشته شوند. برای گنجاندن شماره صحنه در نام فایل، لازم است یک مشخصه قالب‌بندی به سبک printf مانند %d در نام فایل گنجانده شود و از گزینه +adjoin استفاده گردد. برای مثال، .nf image%02d.miff .fi فایل‌های \fIimage00.miff، image01.miff\fP و غیره را می‌نویسد. تنها یک مشخصه منفرد در نام فایل خروجی مجاز است. اگر بیش از یک مشخصه وجود داشته باشد، نادیده گرفته خواهد شد. بهتر است شماره صحنه را در بخش اصلی نام فایل قرار دهید، نه در پسوند، زیرا در این صورت پسوند به‌عنوان یک نوع تصویر شناخته‌شده تشخیص داده نخواهد شد. هنگام اجرای یک ابزار خط فرمان، می‌توانید نماد ات‌ساین @ را به ابتدای نام فایل اضافه کنید تا فهرستی از نام‌های فایل‌های تصویری از آن فایل خوانده شود. این ویژگی در مواردی که تعداد نام‌های فایل‌های تصویری برای قرار گرفتن در خط فرمان بیش از حد زیاد است، مناسب می‌باشد. .SH "گزینه‌ها (OPTIONS)" گزینه‌ها به ترتیب خط فرمان پردازش می‌شوند. هر گزینه‌ای که در خط فرمان مشخص می‌کنید، برای مجموعه تصاویر پس از آن معتبر باقی می‌ماند، تا زمانی که آن مجموعه با ظاهر شدن هر گزینه دیگری یا \fB-noop\fP خاتمه یابد. برخی گزینه‌ها فقط بر رمزگشایی تصاویر تأثیر می‌گذارند و برخی دیگر فقط بر رمزگذاری آن‌ها. مورد دوم می‌تواند پس از گروه نهایی تصاویر ورودی ظاهر شود. این یک فهرست ترکیبی از گزینه‌های خط فرمان است که توسط ابزارهای GraphicsMagick استفاده می‌شوند (\fIanimate\fP، \fIcompare\fP، \fIcomposite\fP، \fIconvert\fP، \fIdisplay\fP، \fIidentify\fP، \fIimport\fP، \fImogrify\fP و \fImontage\fP). در این سند، علامت‌های کوچکتر/بزرگتر ("<>") متغیرها را در بر می‌گیرند و آکولادها ("{}") پارامترهای اختیاری را مشخص می‌کنند. برای مثال، "\fB-fuzz {%}\fP" به این معنی است که می‌توانید از گزینه "-fuzz 10" یا "-fuzz 2%" استفاده کنید. .TP .B "-adjoin" \fRپیوستن تصاویر در یک فایل چند‌تصویری واحد به‌طور پیش‌فرض، تمام تصاویر یک دنباله تصویری در همان فایل ذخیره می‌شوند. با این حال، برخی قالب‌ها (مانند JPEG) از ذخیره بیش از یک تصویر در هر فایل پشتیبانی نمی‌کنند و تنها فریم اول در یک دنباله ذخیره خواهد شد مگر اینکه نتیجه در فایل‌های جداگانه ذخیره شود. از \fB+adjoin\fP برای اجبار به ذخیره چندین فریم در چندین فایل شماره‌گذاری‌شده استفاده کنید. در صورت استفاده از \fB+adjoin\fP، نام فایل خروجی باید شامل یک مشخصه قالب‌بندی به سبک printf برای بخش عددی نام فایل باشد. برای مثال، .nf image%02d.miff .fi .TP .B "-affine \fI"\fP \fRماتریس تبدیل رسم این گزینه یک ماتریس تبدیل {sx,rx,ry,sy,tx,ty} را برای استفاده توسط گزینه‌های بعدی \fB-draw\fP یا \fB-transform\fP فراهم می‌کند. .TP .B "-antialias" \fRحذف شکستگی و پلگی (aliasing) پیکسل‌ها به‌طور پیش‌فرض هنگام رسم اشیاء (مانند خطوط) یا رندر کردن قالب‌های برداری (مانند WMF و Postscript) از الگوریتم‌های هموارسازی (antialiasing) استفاده می‌شود. برای غیرفعال کردن استفاده از الگوریتم‌های هموارسازی از +antialias استفاده کنید. دلایل غیرفعال کردن هموارسازی شامل جلوگیری از افزایش رنگ‌ها در تصویر یا بهبود سرعت رندر است. .TP .B "-append" \fRپیوست کردن مجموعه‌ای از تصاویر این گزینه یک تصویر واحد ایجاد می‌کند که در آن تصاویر مجموعه اصلی از بالا به پایین روی هم چیده می‌شوند. اگر عرض آن‌ها یکسان نباشد، هر تصویر باریک‌تر با استفاده از رنگ پس‌زمینه گسترش می‌یابد تا اندازه شود. برای چیدن تصاویر از چپ به راست از \fB+append\fP استفاده کنید. مجموعه تصاویر با ظاهر شدن هر گزینه‌ای خاتمه می‌یابد. اگر گزینه \fB-append\fP بعد از تمام تصاویر ورودی ظاهر شود، همه تصاویر پیوست می‌شوند. .TP .B "-asc-cdl \fI"\fP \fRاعمال تبدیل رنگ ASC CDL فرمت ASC CDL را اعمال (تثبیت) می‌کند، که قالبی برای تبادل اطلاعات پایه‌ای درجه‌بندی رنگ اولیه بین تجهیزات و نرم‌افزارهای سازندگان مختلف است. این قالب روابط ریاضی را برای سه تابع تعریف می‌کند: شیب (slope)، آفست (offset) و توان (power). هر تابع از یک عدد برای کانال‌های رنگ قرمز، سبز و آبی استفاده می‌کند که در مجموع نه عدد تشکیل‌دهنده یک تصمیم رنگی واحد است. عدد دهم (اختیاری) برای خلوص رنگ یا اشباع (saturation) است که توسط ASC CDL 1.2 مشخص شده است. رشته آرگومان با کاما جدا می‌شود و به شکل زیر است (اما بدون فاصله‌ها یا شکست‌های خط میانی): .nf redslope,redoffset,redpower: greenslope,greenoffset,greenpower: blueslope,blueoffset,bluepower: saturation .fi که مشخصه همانی (بدون تغییر) آن به صورت زیر است: .nf "1.0,0.0,1.0:1.0,0.0,1.0:1.0,0.0,1.0:1.0" .fi .TP .B "-authenticate \fI"\fP \fRرمزگشایی تصویر با این گذرواژه از این گزینه برای ارائه یک گذرواژه جهت رمزگشایی یک تصویر یا دنباله‌ای از تصاویر استفاده کنید، در صورتی که تصویر از قالبی مانند PDF که از رمزگذاری پشتیبانی می‌کند خوانده شود. رمزگذاری تصاویری که در حال ذخیره هستند پشتیبانی نمی‌شود. .TP .B "-auto-orient" \fRجهت‌دهی (چرخاندن) تصویر به گونه‌ای که عمودی و درست باشد جهت تصویر را به گونه‌ای تنظیم می‌کند که برای مشاهده مناسب باشد. از برچسب جهت‌گیری به‌دست‌آمده از فایل تصویر یا مقدار ارائه‌شده توسط گزینه \fB-orient\fP استفاده می‌کند. .TP .B "-average" \fRمیانگین‌گیری از مجموعه‌ای از تصاویر مجموعه تصاویر با ظاهر شدن هر گزینه‌ای خاتمه می‌یابد. اگر گزینه \fB-average\fP بعد از تمام تصاویر ورودی ظاهر شود، از تمام تصاویر میانگین گرفته می‌شود. .TP .B "-backdrop" \fRنمایش تصویر به‌صورت متمرکز روی یک پرده پس‌زمینه (backdrop). این پرده پس‌زمینه کل صفحه ایستگاه کاری را می‌پوشاند و برای پنهان کردن سایر فعالیت‌های پنجره X هنگام مشاهده تصویر مفید است. رنگ پرده پس‌زمینه به‌عنوان رنگ پیش‌زمینه مشخص می‌شود (پیش‌فرض X11 سیاه است). برای جزئیات به بخش "X Resources" در زیر مراجعه کنید. .TP .B "-background \fI"\fP \fRرنگ پس‌زمینه رنگ با استفاده از قالب شرح‌داده‌شده ذیل گزینه \fB-fill\fP مشخص می‌شود. .TP .B "-black-threshold \fIred[,green][,blue][,opacity]"\fP \fRپیکسل‌های زیر مقدار آستانه سیاه می‌شوند از \fB-black-threshold\fP برای تنظیم پیکسل‌های با مقادیر کمتر از آستانه مشخص‌شده به حداقل مقدار (سیاه) استفاده کنید. اگر فقط یک مقدار ارائه شود، یا مقادیر قرمز، سبز و آبی یکسان باشند، آستانه‌گذاری شدت روشنایی استفاده می‌شود. اگر مقادیر آستانه رنگ یکسان نباشند، آستانه‌گذاری مبتنی بر کانال استفاده می‌شود و اعوجاج رنگ رخ خواهد داد. اگر می‌خواهید یک کانال نادیده گرفته شود اما تمایل دارید آستانه‌گذاری را برای کانال بعدی در فهرست اعمال کنید، یک مقدار منفی (مانند -1) مشخص نمایید. اگر نماد درصد (%) اضافه شود، مقادیر به‌عنوان درصدی از حداکثر دامنه در نظر گرفته می‌شوند..TP .B "-blue-primary \fI,"\fP \fRنقطه اصلی رنگینگی آبی .TP .B "-blur \fI{x}"\fP \fRمات کردن تصویر با یک عملگر گاوسی مات کردن با شعاع و انحراف معیار (سیگما) مشخص‌شده. .TP .B "-border \fIx"\fP \fRاحاطه کردن تصویر با حاشیه‌ای از رنگ برای جزئیات درباره مشخصات هندسی، به \fB-geometry\fP مراجعه کنید. .TP .B "-bordercolor \fI"\fP \fRرنگ حاشیه رنگ با استفاده از قالبی که ذیل گزینه \fB-fill\fP شرح داده شده است، مشخص می‌شود. .TP .B "-borderwidth \fI"\fP \fRعرض حاشیه .TP .B "-box \fI"\fP \fRتنظیم رنگ کادر احاطه‌کننده زیرنویس رنگ با استفاده از قالبی که ذیل گزینه \fB-fill\fP شرح داده شده است، مشخص می‌شود. برای جزئیات بیشتر به \fB-draw\fP مراجعه کنید. .TP .B "-channel \fI"\fP \fRنوع کانال انتخاب از میان: \fBRed\fP، \fBGreen\fP، \fBBlue\fP، \fBOpacity\fP، \fBMatte\fP، \fBCyan\fP، \fBMagenta\fP، \fBYellow\fP، \fBBlack\fP یا \fBGray\fP. از این گزینه برای استخراج یک \fIکانال\fP خاص از تصویر استفاده کنید. به‌عنوان مثال، \fBOpacity\fP برای استخراج مقادیر مات بودن از تصویر کاربرد دارد. .TP .B "-charcoal \fI"\fP \fRشبیه‌سازی نقاشی با زغال .TP .B "-chop \fIx{+-}{+-}{%}"\fP \fRحذف پیکسل‌ها از درون یک تصویر \fIWidth\fP و \fIheight\fP تعداد ستون‌ها و سطرهای قابل حذف را مشخص می‌کنند، و \fIx\fP و \fIy\fP فاصله‌هایی هستند که مکان چپ‌ترین ستون و بالاترین سطر را برای حذف تعیین می‌کنند. فاصله \fIx\fP به‌طور معمول چپ‌ترین ستون را برای حذف مشخص می‌کند. اگر گزینه \fB-gravity\fP همراه با جهت‌های \fINorthEast، East\fP یا \fISouthEast\fP حضور داشته باشد، فاصله به سمت چپ را از لبه راست تصویر به راست‌ترین ستون برای حذف مشخص می‌کند. به همین ترتیب، فاصله \fIy\fP به‌طور معمول بالاترین سطر را برای حذف مشخص می‌کند، اما اگر گزینه \fB-gravity\fP همراه با جهت‌های \fISouthWest، South\fP یا \fISouthEast\fP باشد، فاصله رو به بالا را از لبه پایینی تصویر به پایین‌ترین سطر برای حذف مشخص می‌کند. گزینه \fB-chop\fP تمام سطرها و ستون‌ها را حذف می‌کند و بلوک‌های گوشه‌ای باقی‌مانده را به سمت چپ و بالا جابه‌جا می‌کند تا شکاف‌ها پر شوند. .TP .B "-clip" \fRاعمال مسیر برش (clipping path)، در صورت وجود اگر یک مسیر برش وجود داشته باشد، بر روی عملیات بعدی اعمال خواهد شد. به‌عنوان مثال، اگر دستور زیر را وارد کنید: .nf gm convert -clip -negate cockatoo.tif negated.tif .fi تنها پیکسل‌های درون مسیر برش نگاتیو می‌شوند. قابلیت \fB-clip\fP نیازمند کتابخانه XML است. اگر کتابخانه XML موجود نباشد، این گزینه نادیده گرفته می‌شود. .TP .B "-coalesce" \fRادغام توالی تصاویر هر تصویر N در توالی پس از تصویر 0 با تصویری جایگزین می‌شود که از یکدست‌سازی (flattening) تصاویر 0 تا N ایجاد شده است. مجموعه تصاویر با ظاهر شدن هر گزینه‌ای خاتمه می‌یابد. اگر گزینه \fB-coalesce\fP پس از تمام تصاویر ورودی بیاید، همه تصاویر ادغام می‌شوند. .TP .B "-colorize \fI"\fP \fRرنگ‌آمیزی تصویر با رنگ قلم میزان رنگ‌آمیزی را بر حسب درصد مشخص کنید. می‌توانید مقادیر رنگ‌آمیزی جداگانه‌ای را بر روی کانال‌های قرمز، سبز و آبی تصویر با یک فهرست از مقادیر رنگ‌آمیزی جدا شده با خط مورب اعمال کنید (مانند 0/0/50). گزینه \fB-colorize\fP ممکن است در کنار \fB-modulate\fP برای ایجاد تصویری با رنگ‌مایه سپیا (sepia) مناسب به کار رود، مانند: .nf gm convert input.ppm -modulate 115,0,100 \\ -colorize 7,21,50 output.ppm. .fi .TP .B "-colormap \fI"\fP \fRتعریف نوع جدول رنگ (colormap) بین \fBshared\fP یا \fBprivate\fP انتخاب کنید. این گزینه تنها زمانی اعمال می‌شود که حالت بصری (visual) پیش‌فرض کارساز X برابر با \fIPseudoColor\fP یا \fIGRAYScale\fP باشد. برای جزئیات بیشتر به \fB-visual\fP مراجعه کنید. به‌طور پیش‌فرض، یک جدول رنگ اشتراکی تخصیص داده می‌شود. تصویر رنگ‌ها را با سایر کلاینت‌های X به اشتراک می‌گذارد. برخی از رنگ‌های تصویر ممکن است تقریبی باشند، بنابراین ممکن است تصویر شما بسیار متفاوت از آنچه در نظر گرفته شده به نظر برسد. گزینه \fBPrivate\fP را انتخاب کنید تا رنگ‌های تصویر دقیقاً همان‌طور که تعریف شده‌اند نمایش داده شوند. با این حال، هنگامی که جدول رنگ تصویر نصب می‌شود، ممکن است رنگ‌های سایر کلاینت‌ها دچار به‌هم‌ریختگی (\fItechnicolor\fP) شود. .TP .B "-colors \fI"\fP \fRتعداد رنگ‌های ترجیحی در تصویر تعداد واقعی رنگ‌های تصویر ممکن است کمتر از درخواست شما باشد، اما هرگز بیشتر نخواهد بود. توجه داشته باشید که این یک گزینه کاهش رنگ است. تصاویری که دارای رنگ‌های یکتای کمتر از مقدار مشخص‌شده در این گزینه هستند، رنگ‌های تکراری یا استفاده‌نشده آن‌ها حذف خواهد شد. ترتیب یک پالت رنگی موجود ممکن است تغییر کند. هنگام تبدیل یک تصویر از رنگی به مقیاس خاکستری، پیش از کاهش تعداد رنگ‌ها تصویر را به فضای رنگی خاکستری تبدیل کنید چرا که این روش کارآمدتر است. برای جزئیات بیشتر به quantize مراجعه کنید. توجه داشته باشید که گزینه‌های \fB-dither\fP، \fB-colorspace\fP و \fB-treedepth\fP بر الگوریتم کاهش رنگ تأثیر می‌گذارند. .TP .B "-colorspace \fI"\fP \fRنوع فضای رنگی انتخاب‌ها عبارتند از: \fBCineonLog\fP، \fBCMYK\fP، \fBGRAY\fP، \fBHSL\fP، \fBHWB\fP، \fBOHTA\fP، \fBRGB\fP، \fBRec601Luma\fP، \fBRec709Luma\fP، \fBRec601YCbCr\fP، \fBRec709YCbCr\fP، \fBTransparent\fP، \fBXYZ\fP، \fBYCbCr\fP، \fBYIQ\fP، \fBYPbPr\fP یا \fBYUV\fP. کاهش رنگ، به‌طور پیش‌فرض در فضای رنگی RGB انجام می‌شود. شواهد تجربی نشان می‌دهند که فاصله‌ها در فضاهای رنگی مانند YUV یا YIQ نسبت به فاصله‌ها در فضای RGB، با تفاوت‌های رنگی ادراکی مطابقت نزدیک‌تری دارند. این فضاهای رنگی ممکن است هنگام کاهش رنگ یک تصویر نتایج بهتری به دست دهند. برای جزئیات بیشتر به quantize مراجعه کنید. دو فضای رنگی خاکستری پشتیبانی می‌شوند. فضای \fBRec601Luma\fP بر اساس توصیه‌های تلویزیون سنتی NTSC (ITU-R BT.601-5) است. فضای \fBRec709Luma\fP بر اساس توصیه‌های HDTV (Rec. ITU-R BT.709-5) بوده و برای استفاده در گرافیک رایانه‌ای و نمایشگرهای CRT امروزی مناسب است. فضای رنگی \fBGRAY\fP در حال حاضر به‌دلایل سازگاری با گذشته، به‌طور پیش‌فرض فضای رنگی \fBRec601Luma\fP را انتخاب می‌کند. این پیش‌فرض ممکن است در آینده مورد تجدیدنظر قرار گیرد. دو فضای رنگی YCbCr پشتیبانی می‌شوند. فضای \fBRec601YCbCr\fP بر اساس توصیه‌های تلویزیون سنتی NTSC (ITU-R BT.601-5) است. فضای \fBRec709CbCr\fP بر اساس توصیه‌های HDTV (Rec. ITU-R BT.709-5) بوده و برای استفاده در گرافیک رایانه‌ای و نمایشگرهای CRT امروزی مناسب است. مشخصه فضای رنگی \fBYCbCr\fP معادل \fBRec601YCbCr\fP است. فضای رنگی \fBTransparent\fP رفتاری منحصر‌به‌فرد دارد به‌طوری‌که در صورت وجود، کانال مات (matte) تصویر را حفظ می‌کند. برای اثرگذاری این گزینه، استفاده از گزینه \fB-colors\fP یا \fB-monochrome\fP، یا ذخیره در یک قالب فایل که نیازمند کاهش رنگ باشد، الزامی است. .TP .B "-comment \fI"\fP \fRافزودن یادداشت به تصویر از این گزینه برای اختصاص یک یادداشت خاص به تصویر، هنگام ذخیره در یک قالب تصویری که از یادداشت‌ها پشتیبانی می‌کند، استفاده کنید. می‌توانید نام فایل تصویر، نوع، عرض، ارتفاع، یا سایر ویژگی‌های تصویر را با گنجاندن نویسه‌های قالب‌بندی خاص فهرست‌شده ذیل گزینه \fB-format\fP اضافه کنید. این یادداشت بر روی تصویر کشیده نمی‌شود، بلکه از طریق یک برچسب "Comment" یا سازوکاری مشابه در جریان داده تصویر تعبیه می‌گردد. اگر می‌خواهید یادداشت بر روی خود تصویر قابل مشاهده باشد، در عوض از گزینه \fB-draw\fP استفاده کنید. برای مثال، .nf -comment "%m:%f %wx%h" .fi یادداشت تصویری به صورت \fBMIFF:bird.miff 512x480\fP برای تصویری با عنوان \fBbird.miff\fP که عرض آن 512 و ارتفاع آن 480 است، ایجاد می‌کند. اگر اولین نویسه \fIstring\fP برابر با \fI@\fP باشد، یادداشت تصویر از فایلی خوانده می‌شود که نام آن با نویسه‌های باقی‌مانده رشته مشخص شده است. لطفاً توجه داشته باشید که اگر رشته از یک منبع غیرقابل‌اعتماد باشد، باید پیش از استفاده اعتبارسنجی و پاکسازی شود؛ در غیر این صورت محتوای یک فایل خواندنی دلخواه می‌تواند در یادداشت فایل خروجی گنجانده شود (یک خطر امنیتی). اگر گزینه \-comment چندین بار ظاهر شود، تنها آخرین یادداشت ذخیره خواهد شد. در تصاویر PNG، یادداشت در یک قطعه (chunk) از نوع \fBtEXt\fP یا \fBzTXt\fP با کلمه کلیدی "comment" ذخیره می‌شود..TP .B "-compose \fI"\fP \fRنوع ترکیب تصویر توضیحات ترکیب تصویر از اصطلاحات انتزاعی استفاده می‌کند تا توصیف واضح‌تر باشد و در عین حال از مقادیر ثابتی که مختص یک پیکربندی ساخت خاص هستند پرهیز شود. هر پیکسل تصویر با سطوح قرمز، سبز و آبی (که برای یک پیکسل خاکستری برابر هستند) نمایش داده می‌شود. مقدار MaxRGB حداکثر مقدار عدد صحیحی است که می‌تواند در کانال‌های قرمز، سبز یا آبی تصویر ذخیره شود. هر پیکسل تصویر همچنین می‌تواند به صورت اختیاری (در صورت فعال بودن کانال matte تصویر) دارای یک سطح کدر بودن (opacity) مرتبط باشد (در دامنه‌ای از کدر تا شفاف)، که ممکن است برای تعیین میزان اثرگذاری رنگ پیکسل هنگام ترکیب با پیکسل یک تصویر دیگر استفاده شود. اگر کانال matte تصویر غیرفعال باشد، همهٔ پیکسل‌ها در تصویر کدر در نظر گرفته می‌شوند. رنگ یک پیکسل \fIکدر\fP کاملاً قابل مشاهده است، در حالی که رنگ یک پیکسل \fIشفاف\fP کاملاً غایب است (رنگ پیکسل نادیده گرفته می‌شود). بر پایه تعریف، تصاویر شطرنجی (raster) شکلی مستطیلی دارند. تمام ردیف‌های تصویر طول یکسانی دارند و تمام ستون‌های تصویر دارای تعداد ردیف‌های برابری هستند. با در نظر گرفتن کانال کدر بودن (opacity) به عنوان یک «ماسک» بصری، می‌توان با استفاده از کانال opacity همانند یک قالب برش، به تصویر مستطیلی یک «شکل» داد. پیکسل‌های درون این شکل کدر هستند، در حالی که پیکسل‌های بیرون شکل شفاف‌اند. پیکسل‌های واقع در مرز شکل می‌توانند مقداری بین کدر و شفاف داشته باشند تا قابلیت antialiasing (لبه‌های بصری صاف و هموار) فراهم شود. توصیف عملگرهای ترکیب از این مفهومِ «شکل» تصویر استفاده می‌کند تا درک رفتار عملگرها ساده‌تر شود. اگرچه توصیف عملگرها با استفاده از «شکل‌ها» کار را راحت‌تر می‌کند، اما آن‌ها به هیچ وجه محدود به عملیات‌های سبکِ ماسک نیستند، چرا که بر پایه محاسبات ریاضی ممیز شناور پیوسته عمل می‌کنند نه عملیات بولی ساده. به‌طور پیش‌فرض، عملگر ترکیب \fIOver\fP استفاده می‌شود. عملگرهای ترکیب زیر در دسترس هستند: .nf Over In Out Atop Xor Plus Minus Add Subtract Difference Divide Multiply Bumpmap Copy CopyRed CopyGreen CopyBlue CopyOpacity CopyCyan CopyMagenta CopyYellow CopyBlack .fi رفتار هر یک از عملگرها در ادامه شرح داده شده است. .in 15 .in 15 .B "Over" .in 20 \fR .in 20 نتیجه، اجتماع شکل‌های دو تصویر خواهد بود، به‌طوری که نواحی کدر \fIchange-image\fP در ناحیهٔ هم‌پوشانی، \fIbase-image\fP را می‌پوشانند. .in 15 .in 15 .B "In" .in 20 \fR .in 20 نتیجه صرفاً \fIchange-image\fP است که با شکل \fIbase-image\fP برش خورده است. هیچ‌یک از داده‌های تصویر \fIbase-image\fP در نتیجه وجود نخواهد داشت. .in 15 .in 15 .B "Out" .in 20 \fR .in 20 تصویر حاصل، \fIchange-image\fP است در حالی که شکل \fIbase-image\fP از آن بریده شده است. .in 15 .in 15 .B "Atop" .in 20 \fR .in 20 نتیجه دارای همان شکل \fIbase-image\fP است، به‌طوری که در محل هم‌پوشانی شکل‌های تصویر، \fIchange-image\fP روی \fIbase-image\fP را می‌پوشاند. توجه داشته باشید که این حالت با \fBover\fP تفاوت دارد، زیرا بخشی از \fIchange-image\fP که خارج از شکل \fIbase-image\fP قرار دارد در نتیجه ظاهر نمی‌شود. .in 15 .in 15 .B "Xor" .in 20 \fR .in 20 نتیجه، داده‌های تصویری از هر دو تصویر \fIchange-image\fP و \fIbase-image\fP است که خارج از ناحیهٔ هم‌پوشانی قرار دارند. ناحیهٔ هم‌پوشانی خالی خواهد بود. .in 15 .in 15 .B "Plus" .in 20 \fR .in 20 نتیجه صرفاً حاصل‌جمع داده‌های تصویر است. مقادیر خروجی به MaxRGB محدود می‌شوند (بدون سرریز). این عملیات مستقل از کانال‌های matte است. .in 15 .in 15 .B "Minus" .in 20 \fR .in 20 نتیجهٔ \fIchange-image\fP - \fIbase-image\fP، با محدود شدن زیرریز (underflow) به صفر. کانال matte نادیده گرفته می‌شود (بر روی کدر، پوشش کامل تنظیم می‌شود). .in 15 .in 15 .B "Add" .in 20 \fR .in 20 نتیجهٔ \fIchange-image\fP + \fIbase-image\fP، با سرریز چرخشی (\fImod\fP MaxRGB+1). .in 15 .in 15 .B "Subtract" .in 20 \fR .in 20 نتیجهٔ \fIchange-image\fP - \fIbase-image\fP، با زیرریز چرخشی (\fImod\fP MaxRGB+1). عملگرهای \fBadd\fP و \fBsubtract\fP می‌توانند برای انجام تبدیلات برگشت‌پذیر استفاده شوند. .in 15 .in 15 .B "Difference" .in 20 \fR .in 20 نتیجهٔ abs(\fIchange-image\fP - \fIbase-image\fP). این عملگر برای مقایسهٔ دو تصویر بسیار مشابه مفید است. .in 15 .in 15 .B "Divide" .in 20 \fR .in 20 نتیجهٔ \fIchange-image\fP / \fIbase-image\fP. این عملگر برای بهبود خوانایی متن در عکس‌هایی با نورپردازی ناهمگن مفید است (با استفاده از یک نسخهٔ تارشده با فیلتر گوسی از change-image به عنوان base-image). .in 15 .in 15 .B "Multiply" .in 20 \fR .in 20 نتیجهٔ \fIchange-image\fP * \fIbase-image\fP. این عملگر برای ایجاد سایه (drop-shadow) مفید است. .in 15 .in 15 .B "Bumpmap" .in 20 \fR .in 20 نتیجه، \fIbase-image\fP است که توسط \fIchange-image\fP سایه‌پردازی شده است. .in 15 .in 15 .B "Copy" .in 20 \fR .in 20 تصویر حاصل، \fIbase-image\fP است که با \fIchange-image\fP جایگزین شده است. در اینجا اطلاعات matte نادیده گرفته می‌شود. .in 15 .in 15 .B "CopyRed" .in 20 \fR .in 20 تصویر حاصل، کانال قرمز در \fIbase-image\fP است که با کانال قرمز در \fIchange-image\fP جایگزین شده است. سایر کانال‌ها دست‌نخورده کپی می‌شوند. .in 15 .in 15 .B "CopyGreen" .in 20 \fR .in 20 تصویر حاصل، کانال سبز در \fIbase-image\fP است که با کانال سبز در \fIchange-image\fP جایگزین شده است. سایر کانال‌ها دست‌نخورده کپی می‌شوند. .in 15 .in 15 .B "CopyBlue" .in 20 \fR .in 20 تصویر حاصل، کانال آبی در \fIbase-image\fP است که با کانال آبی در \fIchange-image\fP جایگزین شده است. سایر کانال‌ها دست‌نخورده کپی می‌شوند. .in 15 .in 15 .B "CopyOpacity" .in 20 \fR .in 20 تصویر حاصل، کانال opacity در \fIbase-image\fP است که با کانال opacity در \fIchange-image\fP جایگزین شده است. سایر کانال‌ها دست‌نخورده کپی می‌شوند. .in 15 .in 15 .B "CopyCyan" .in 20 \fR .in 20 تصویر حاصل، کانال cyan (فیروزه‌ای) در \fIbase-image\fP است که با کانال cyan در \fIchange-image\fP جایگزین شده است. سایر کانال‌ها دست‌نخورده کپی می‌شوند. استفاده از این عملگر نیازمند آن است که base-image در فضای رنگی CMYK(A) باشد. .in 15 .in 15 .B "CopyMagenta" .in 20 \fR .in 20 تصویر حاصل، کانال magenta (سرخابی) در \fIbase-image\fP است که با کانال magenta در \fIchange-image\fP جایگزین شده است. سایر کانال‌ها دست‌نخورده کپی می‌شوند. استفاده از این عملگر نیازمند آن است که base-image در فضای رنگی CMYK(A) باشد. .in 15 .in 15 .B "CopyYellow" .in 20 \fR .in 20 تصویر حاصل، کانال yellow (زرد) در \fIbase-image\fP است که با کانال yellow در \fIchange-image\fP جایگزین شده است. سایر کانال‌ها دست‌نخورده کپی می‌شوند. استفاده از این عملگر نیازمند آن است که base-image در فضای رنگی CMYK(A) باشد. .in 15 .in 15 .B "CopyBlack" .in 20 \fR .in 20 تصویر حاصل، کانال black (سیاه) در \fIbase-image\fP است که با کانال black در \fIchange-image\fP جایگزین شده است. سایر کانال‌ها دست‌نخورده کپی می‌شوند. استفاده از این عملگر نیازمند آن است که base-image در فضای رنگی CMYK(A) باشد. اگر change-image در فضای رنگی CMYK نباشد، از شدت روشنایی پیکسل‌های change-image استفاده خواهد شد. .in 15.TP .B "-compress \fI"\fP \fRنوع فشرده‌سازی تصویر انتخاب‌ها عبارتند از: \fINone\fP، \fIBZip\fP، \fIFax\fP، \fIGroup3\fP، \fIGroup4\fP، \fIJPEG\fP، \fILossless\fP، \fILZW\fP، \fIRLE\fP، \fIZip\fP، \fILZMA\fP، \fIJPEG2000\fP، \fIJPEG2000\fP، \fIJBIG\fP، \fIJBIG2\fP، \fIWebP\fP، یا \fIZSTD\fP. برای ذخیره تصویر باینری در قالبی فشرده‌نشده، \fB+compress\fP را مشخص کنید. پیش‌فرض، نوع فشرده‌سازی فایل تصویر مشخص‌شده است. عبارت \fI"Lossless"\fP به JPEG بدون اتلاف اشاره دارد که فقط در صورتی در دسترس است که کتابخانه JPEG برای پشتیبانی از آن وصله خورده باشد. استفاده از JPEG بدون اتلاف عموماً توصیه نمی‌شود. از گزینه \fB-quality\fP برای تنظیم سطح فشرده‌سازی مورد استفاده توسط رمزگذارهای JPEG، JPEG-2000، PNG، MIFF، MPEG و TIFF استفاده کنید. از گزینه \fB-sampling-factor\fP برای تنظیم ضریب نمونه‌برداری مورد استفاده توسط رمزگذارهای DPX، JPEG، MPEG و YUV جهت کاهش نمونه‌برداری (downsampling) کانال‌های کروما استفاده کنید. .TP .B "-contrast" \fRافزایش یا کاهش کنتراست تصویر این گزینه تفاوت شدت روشنایی بین عناصر روشن‌تر و تیره‌تر تصویر را تقویت می‌کند. از \fB-contrast\fP برای بهبود کنتراست تصویر یا از \fB+contrast\fP برای کاهش کنتراست تصویر استفاده کنید. برای اثربخشی بیشتر می‌توانید گزینه را تکرار کنید: .nf gm convert rose: -contrast -contrast rose_c2.png .fi .TP .B "-convolve \fI"\fP \fRپیچش (کانولوشن) تصویر با هسته کانولوشن مشخص‌شده هسته به صورت فهرستی از مقادیر ممیز شناور که با کاما از هم جدا شده‌اند، مرتب‌شده از چپ به راست، و با شروع از سطر بالا مشخص می‌شود. مرتبه هسته بر اساس جذر تعداد درایه‌ها تعیین می‌شود. در حال حاضر تنها هسته‌های مربعی پشتیبانی می‌شوند. .TP .B "-create-directories" \fRایجاد دایرکتوری خروجی در صورت نیاز اگر مسیرهای ورودی شامل زیردایرکتوری‌ها هستند و تمایل دارید زیردایرکتوری‌های مشابهی در دایرکتوری خروجی ایجاد شوند، این گزینه را به همراه \fB-output-directory\fP به کار ببرید. بدون این گزینه، در صورتی که دایرکتوری خروجی مورد نیاز وجود نداشته باشد، اجرای \fBmogrify\fP با شکست مواجه خواهد شد. .TP .B "-crop \fIx{+-}{+-}{%}"\fP \fRاندازه و مکان ترجیحی برای تصویر برش‌خورده برای جزئیات درباره مشخصات هندسی (geometry) به \fB-geometry\fP مراجعه کنید. عرض (width) و ارتفاع (height) اندازه تصویری را که پس از برش باقی می‌ماند مشخص می‌کنند، و \fIx\fP و \fIy\fP انحراف‌هایی (offset) هستند که مکان گوشه بالای سمت چپ تصویر برش‌خورده را نسبت به تصویر اصلی تعیین می‌کنند. برای مشخص کردن مقداری که باید حذف شود، در عوض از \fB-shave\fP استفاده کنید. اگر انحراف‌های \fIx\fP و \fIy\fP وجود داشته باشند، یک تصویر منفرد متشکل از پیکسل‌های ناحیه برش ایجاد می‌شود. این انحراف‌ها موقعیت گوشه بالای سمت چپ ناحیه برش را که به سمت پایین و راست نسبت به گوشه بالای سمت چپ تصویر اندازه گرفته می‌شود، مشخص می‌کنند. اگر گزینه \fB-gravity\fP همراه با جهت \fINorthEast، East\fP یا \fISouthEast\fP مشخص شده باشد، فاصله به سمت چپ را از لبه راست تصویر تا لبه راست ناحیه برش مشخص می‌کند. به همین ترتیب، اگر گزینه \fB-gravity\fP همراه با جهت \fISouthWest، South\fP یا \fISouthEast\fP مشخص شده باشد، فاصله به سمت بالا بین لبه‌های پایینی اندازه‌گیری می‌شود. اگر انحراف‌های \fIx\fP و \fIy\fP حذف شوند، مجموعه‌ای از کاشی‌ها (tiles) با هندسه مشخص‌شده که کل تصویر ورودی را پوشش می‌دهند، تولید می‌شود. در صورتی که هندسه مشخص‌شده فراتر از ابعاد تصویر ورودی برود، راست‌ترین کاشی‌ها و کاشی‌های پایینی کوچک‌تر خواهند بود. .TP .B "-cycle \fI"\fP \fRجابجایی نقشه رنگ (colormap) تصویر به مقدار مشخص‌شده مقدار (\fIAmount\fP) تعداد موقعیت‌هایی را که هر مدخل نقشه رنگ جابجا می‌شود مشخص می‌کند. .TP .B "-debug \fI"\fP \fRفعال‌سازی چاپ خروجی اشکال‌زدایی پارامتر 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، از دستور زیر استفاده کنید: .nf gm convert -debug "Cache,Blob" rose: rose.png .fi دامنه "User" معمولاً خالی است، اما توسعه‌دهندگان می‌توانند رویدادهای "User" را در نسخه اختصاصی GraphicsMagick خود ثبت کنند. برای تعیین قالب خروجی اشکال‌زدایی از گزینه \fB-log\fP استفاده کنید. برای خاموش کردن تمام ثبت‌های گزارش از \fB+debug\fP استفاده کنید. یک جایگزین برای استفاده از \fB-debug\fP، استفاده از متغیر محیطی \fBMAGICK_DEBUG\fP است. مقادیر مجاز برای متغیر محیطی \fBMAGICK_DEBUG\fP مشابه مقادیر گزینه \fB-debug\fP هستند. .TP .B "-deconstruct" \fRتجزیه یک توالی تصویر به بخش‌های تشکیل‌دهنده این گزینه هر تصویر را با تصویر بعدی در یک توالی مقایسه کرده و بزرگ‌ترین ناحیه مرزی مربوط به هرگونه تفاوت پیکسلی کشف‌شده را برمی‌گرداند. این روش می‌تواند یک توالی ادغام‌شده (coalesced) را که توسط گزینه \fB-coalesce\fP برگردانده شده خنثی کند، و برای حذف اطلاعات زائد از پویانمایی‌های GIF یا MNG مفید است. توالی تصاویر با ظاهر شدن هر گزینه‌ای خاتمه می‌یابد. اگر گزینه \fB-deconstruct\fP پس از تمام تصاویر ورودی ظاهر شود، تمامی تصاویر تجزیه می‌شوند. .TP .B "-define \fI{=},..."\fP \fRافزودن گزینه‌های مختص رمزگذار/رمزگشا (coder/decoder) این گزینه یک یا چند تعریف را برای استفاده رمزگذارها و رمزگشاها هنگام خواندن و نوشتن داده‌های تصویر ایجاد می‌کند. تعاریف می‌توانند برای کنترل گزینه‌هایی که مختص فرمت‌های تصویری خاصی هستند به رمزگذارها و رمزگشاها ارسال شوند. اگر \fIvalue\fP برای یک تعریف ذکر نشود، تعریفی با مقدار خالی برای یک پرچم (flag) با آن نام ایجاد خواهد شد. این کار برای کنترل گزینه‌های روشن/خاموش استفاده می‌شود. از +define ,... برای حذف تعاریفی که پیش‌تر ایجاد شده‌اند استفاده کنید. از +define "*" برای حذف تمام تعاریف موجود استفاده کنید. تعاریف زیر می‌توانند ایجاد شوند: .in 15 .in 15 .B "bmp:allow-jpeg={true|false}" .in 20 \fR .in 20 اگر مقدار bmp:allow-jpeg روی true تنظیم شود، فایل‌های BMP با استفاده از فشرده‌سازی JPEG، تحت کنترل گزینه فشرده‌سازی (که اگر فایل ورودی JPEG باشد ممکن است از قبل JPEG باشد) فعال می‌شوند. فایل‌های BMP با فشرده‌سازی JPEG بسیار نادر هستند، بنابراین این گزینه به عنوان یک محافظ عمل می‌کند تا اطمینان حاصل شود که تنظیمات فشرده‌سازی فعلی به طور تصادفی فایل‌های BMP فشرده‌شده با JPEG تولید نکند که اکثر نرم‌افزارهای دیگر قادر به خواندن آن نیستند. .in 15 .in 15 .B "cineon:colorspace={rgb|cineonlog}" .in 20 \fR .in 20 هنگام خواندن یک فایل Cineon، از گزینه cineon:colorspace برای مشخص کردن فضای رنگی مورد استفاده فایل Cineon استفاده کنید. این مقدار، نوع فضای رنگی ضمنی سرآیند DPX (در صورت وجود) را نادیده می‌گیرد. .in 15 .in 15 .B "dpx:bits-per-sample=" .in 20 \fR .in 20 اگر کلید dpx:bits-per-sample تعریف شود، GraphicsMagick تصاویر DPX را با بیت‌های مشخص‌شده در هر نمونه می‌نویسد و هرگونه مقدار عمق (depth) موجود را نادیده می‌گیرد. اگر این گزینه مشخص نشود، مقدار بر اساس مقدار عمق تصویر موجود از فایل تصویر اصلی تعیین می‌شود. استاندارد DPX از مقادیر بیت در هر نمونه ۱، ۸، ۱۰، ۱۲ و ۱۶ پشتیبانی می‌کند. بسیاری از خواننده‌های DPX اندازه نمونه ۱۰ بیتی با فاصله‌گذاری نوع A را طلب می‌کنند (به پایین مراجعه کنید). .in 15 .in 15 .B "dpx:colorspace={rgb|cineonlog}" .in 20 \fR .in 20 هنگام خواندن یک فایل DPX، از گزینه dpx:colorspace برای مشخص کردن فضای رنگی مورد استفاده فایل DPX استفاده کنید. این مقدار، نوع فضای رنگی ضمنی سرآیند DPX (در صورت وجود) را نادیده می‌گیرد. .in 15 .in 15 .B "dpx:packing-method={packed|a|b|lsbpad|msbpad}" .in 20 \fR .in 20 نمونه‌های DPX درون کلمات ۳۲ بیتی خروجی داده می‌شوند. آن‌ها می‌توانند به طور فشرده سر‌به‌سر در کلمات بسته‌بندی شوند ("packed")، با بیت‌های خالی در سمت راست نمونه فاصله‌گذاری شوند ("a" یا "lsbpad")، یا با بیت‌های خالی در سمت چپ نمونه فاصله‌گذاری شوند ("b" یا "msbpad"). این گزینه تنها برای اندازه نمونه‌های ۱۰ یا ۱۲ بیتی تأثیر دارد. اگر نمونه‌ها فشرده (packed) نشده باشند، استاندارد DPX فاصله‌گذاری نوع A را توصیه می‌کند. بسیاری از خواننده‌های DPX اندازه نمونه ۱۰ بیتی با فاصله‌گذاری نوع A را طلب می‌کنند. .in 15 .in 15 .B "dpx:pixel-endian={lsb|msb}" .in 20 \fR .in 20 به کاربر امکان می‌دهد ترتیب اندیان (endian) پیکسل‌ها را هنگام خواندن یا نوشتن فایل‌های DPX مشخص کند. این گزینه گاهی اوقات در صورتی که فایل به اشتباه نوشته شده باشد (یا باید نوشته شود) به طوری که سرآیند فایل و پیکسل‌ها از ترتیب اندیان متفاوتی استفاده کنند، مفید است. .in 15 .in 15 .B "dpx:swap-samples={true|false}" .in 20 \fR .in 15 .B "dpx:swap-samples-read={true|false}" .in 20 \fR .in 15 .B "dpx:swap-samples-write={true|false}" .in 20 \fR .in 20 برنامه GraphicsMagick تلاش می‌کند از استاندارد DPX پیروی کند اما جنبه‌های خاصی از این استاندارد می‌تواند بسیار گیج‌کننده باشد. در نتیجه، در برخی فایل‌های ۱۰ بیتی DPX به دلیل تفسیر متفاوتی از استاندارد یا اشتباه در اتصالات، جای Red و Blue با هم عوض شده است، یا Cb و Cr جابجا شده‌اند. گزینه swap-samples می‌تواند هنگام خواندن یا نوشتن ارائه شود تا خواندن یا نوشتن با ترتیب نمونه مورد نیاز انجام گیرد. زمانی که جابجایی فقط باید در خواننده رخ دهد از swap-samples-read استفاده کنید، یا زمانی که جابجایی فقط باید در نویسنده رخ دهد از swap-samples-write استفاده کنید. .in 15 .in 15 .B "heif:ignore-transformations={true|false}" .in 20 \fR .in 20 تصویر HEIF (مانند HEIC/AVIF) را بدون اعمال هیچ‌گونه تبدیلی (مانند چرخش) برمی‌گرداند. در حالت 'ping' (پیش‌فرض identify) مقدار پیش‌فرض true است، اما در غیر این صورت false است. زمانی که ignore-transformations برابر false باشد، ممکن است identify بسیار کندتر عمل کند. .in 15 .in 15 .B "heif:interleaved-rgb-decode={true|false}" .in 20 \fR .in 20 درخواست می‌کند که libheif پیکسل‌ها را به جای نمایش صفحه‌ای (planar)، در نمایش درهم‌تنیده (interleaved) برگرداند. این موضوع نباید تأثیری بر نتیجه رمزگشایی‌شده داشته باشد، اما عملکرد ممکن است متفاوت باشد. .in 15 .in 15 .B "heif:preserve-colorspace={true|false}" .in 20 \fR .in 20 تصویر HEIF را در فضای رنگی اصلی‌اش بازمی‌گرداند. این گزینه اجازه می‌دهد تصویر به جای RGB در فضای رنگی اصلی YCbCr برگردانده شود. .in 15 .in 15 .B "heif:tile-threads=number" .in 20 \fR .in 20 اگر یک تصویر HEIF از چندین کاشی تشکیل شده باشد، هر کاشی می‌تواند توسط یک نخ (thread) رمزگشایی شود، و چندین کاشی می‌توانند به طور هم‌زمان با استفاده از نخ‌های بیشتر رمزگشایی شوند. حداکثر مقدار معقول، کمینه بین تعداد هسته‌های CPU در دسترس یا تعداد کاشی‌های موجود در فایل HEIF است (هر کدام که کوچک‌تر باشد). اگر OpenMP در دسترس باشد، مقدار پیش‌فرض تعداد نخ‌های OpenMP است، در غیر این صورت پیش‌فرض ۴ است. .in 15 .in 15 .B "heif:max-image-size-pixels=number" .in 20 \fR .in 20 یک تصویر ممکن است از پیکسل‌های فراوانی تشکیل شده باشد. در صورت وجود تعداد بسیار زیادی پیکسل، بازگرداندن یک تصویر ممکن است زمان زیادی ببرد. لطفاً برای 'max_image_size_pixels' به کد منبع (یا مستندات) libheif مراجعه کنید. توجه داشته باشید که GraphicsMagick از پیش مقداری را برای این پارامتر بر اساس محدودیت کل پیکسل‌ها یا محدودیت‌های عرض/ارتفاع محاسبه می‌کند، بنابراین ارائه این پارامتر مقدار محاسبه‌شده را لغو خواهد کرد. .in 15 .in 15 .B "heif:max-number-of-tiles=number" .in 20 \fR .in 20 یک تصویر ممکن است از کاشی‌های متعددی تشکیل شده باشد. در صورت وجود تعداد بسیار زیادی کاشی، بازگرداندن یک تصویر ممکن است زمان زیادی ببرد. لطفاً برای 'max_number_of_tiles' به کد منبع (یا مستندات) libheif مراجعه کنید. .in 15 .in 15 .B "heif:max-bayer-pattern-pixels=number" .in 20 \fR .in 20 لطفاً برای \'max_bayer_pattern_pixels' به کد منبع (یا مستندات) libheif مراجعه کنید. .in 15 .in 15 .B "heif:max-items=number" .in 20 \fR .in 20 لطفاً برای 'max_items' به کد منبع (یا مستندات) libheif مراجعه کنید. .in 15 .in 15 .B "heif:max-color-profile-size=number" .in 20 \fR .in 20 لطفاً برای 'max_color_profile_size' به کد منبع (یا مستندات) libheif مراجعه کنید. .in 15 .in 15 .B "heif:max-memory-block-size=number" .in 20 \fR .in 20 لطفاً برای 'max_memory_block_size' به کد منبع (یا مستندات) libheif مراجعه کنید. .in 15 .in 15 .B "heif:max-components=number" .in 20 \fR .in 20 لطفاً برای 'max_components' به کد منبع (یا مستندات) libheif مراجعه کنید. .in 15 .in 15 .B "heif:max-iloc-extents-per-item=number" .in 20 \fR .in 20 لطفاً برای \'max_iloc_extents_per_item' به کد منبع (یا مستندات) libheif مراجعه کنید. .in 15 .in 15 .B "heif:max-size-entity-group=number" .in 20 \fR .in 20 لطفاً برای \'max_size_entity_group' به کد منبع (یا مستندات) libheif مراجعه کنید. .in 15 .in 15 .B "heif:max-children-per-box=number" .in 20 \fR .in 20 لطفاً برای \'max_children_per_box' به کد منبع (یا مستندات) libheif مراجعه کنید. .in 15 .in 15 .B "heif:max-total-memory=number" .in 20 \fR .in 20 لطفاً برای \'max_total_memory' به کد منبع (یا مستندات) libheif مراجعه کنید. .in 15 .in 15 .B "heif:max-sample-description-box-entries=number" .in 20 \fR .in 20 لطفاً برای \'max_sample_description_box_entries' به کد منبع (یا مستندات) libheif مراجعه کنید. .in 15 .in 15 .B "heif:max-sample-group-description-box-entries=number" .in 20 \fR .in 20 لطفاً برای \'max_sample_group_description_box_entries' به کد منبع (یا مستندات) libheif مراجعه کنید. .in 15 .in 15 .B "gradient:direction={South|North|West|East|NorthWest|NorthEast|SouthWest|SouthEast}" .in 20 \fR .in 20 به‌طور پیش‌فرض، رمزگذار گرادیان، گرادیانی از بالا به پایین ("South") تولید می‌کند. از نسخه 1.3.35 نرم‌افزار GraphicsMagick، جهت گرادیان می‌تواند مشخص شود تا بردارهای گرادیان را مطابق با مشخصاتی شبیه به جاذبه (gravity) تولید کند. آرگومان‌ها عبارتند از: \fBSouth\fP (بالا به پایین)، \fBNorth\fP (پایین به بالا)، \fBWest\fP (راست به چپ)، \fBEast\fP (چپ به راست)، \fBNorthWest\fP (پایین-راست به بالا-چپ)، \fBNorthEast\fP (پایین-چپ به بالا-راست)، \fBSouthWest\fP (بالا-راست به پایین-چپ)، و \fBSouthEast\fP (بالا-چپ به پایین-راست). .in 15 .in 15 .B "jp2:rate=" .in 20 \fR .in 20 ضریب فشرده‌سازی مورد استفاده هنگام نوشتن فایل‌های JPEG-2000 را مشخص می‌کند. ضریب فشرده‌سازی معکوس نسبت فشرده‌سازی است. محدوده معتبر 0.0 تا 1.0 است که در آن 1.0 نشان‌دهنده فشرده‌سازی بدون اتلاف است. در صورت تعریف شدن، این مقدار تنظیمات -quality را نادیده می‌گیرد. تنظیم پیش‌فرض کیفیت یعنی 75، منجر به مقدار نرخ 0.06641 می‌شود. .in 15 .in 15 .B "jpeg:arithmetic-coding={true|false}" .in 20 \fR .in 20 در صورت پشتیبانی کتابخانه JPEG، کدگذاری حسابی (arithmetic encoding) را فعال یا غیرفعال می‌کند (پیش‌فرض غیرفعال است). هنگامی که این گزینه فعال باشد، optimize-coding لزوماً غیرفعال می‌شود. .in 15 .in 15 .B "jpeg:block-smoothing={true|false}" .in 20 \fR .in 20 صاف‌سازی بلوک (block smoothing) را هنگام خواندن یک فایل JPEG فعال یا غیرفعال می‌کند (پیش‌فرض فعال است). .in 15 .in 15 .B "jpeg:dct-method=" .in 20 \fR .in 20 پیاده‌سازی DCT کتابخانه IJG JPEG مورد استفاده را انتخاب می‌کند. پیاده‌سازی‌های رمزگذاری در سرعت و خطای رمزگذاری متفاوت هستند. انتخاب‌های در دسترس برای \fBvalue\fP عبارتند از \fBislow\fP، \fBifast\fP، \fBfloat\fP، \fBdefault\fP و \fBfastest\fP. توجه داشته باشید که بسته به انتخاب‌های صورت‌گرفته هنگام ساخت کتابخانه JPEG و نحوه رفتار پردازنده شما، \fBfastest\fP ممکن است لزوماً سریع‌ترین روی پردازنده شما نباشد. .in 15 .in 15 .B "jpeg:fancy-upsampling={true|false}" .in 20 \fR .in 20 افزایش نمونه‌برداری دقیق (fancy upsampling) را هنگام خواندن یک فایل JPEG فعال یا غیرفعال می‌کند (پیش‌فرض فعال است). .in 15 .in 15 .B "jpeg:data-precision=" .in 20 \fR .in 20 اندازه ذخیره‌سازی نمونه JPEG را انتخاب می‌کند. فرمت معمولی JPEG از ۸ استفاده می‌کند. کتابخانه Turbo-jpeg و برخی گونه‌های IJG JPEG از ۱۲ و ۱۶ بیت نیز پشتیبانی می‌کنند. .in 15 .in 15 .B "jpeg:lossless-precision=" .in 20 \fR .in 20 درجه‌ای از دقت را برای استفاده هنگام انجام فشرده‌سازی مبتنی بر DPCM انتخاب می‌کند. محدوده در دسترس 0 تا precision-1 است. برای مثال، اگر عمق خروجی ۱۶ باشد، محدوده در دسترس ۰ تا ۱۵ است. هنگامی که دقت غیرصفر باشد، پیکسل‌ها به سمت راست شیفت داده می‌شوند تا به طور مؤثری از بیت‌های کمتر (رنگ‌های کمتر) پشتیبانی کنند، اما در عوض نسبت فشرده‌سازی بهتری ارائه می‌دهند. برای دستیابی به فشرده‌سازی بدون اتلاف از مقدار 0 استفاده کنید. .in 15 .in 15 .B "jpeg:lossless-predictor=" .in 20 \fR .in 20 پیش‌بینی‌کننده مورد استفاده برای فشرده‌سازی بدون اتلاف را انتخاب می‌کند. مقادیر پشتیبانی‌شده در محدوده ۱ تا ۷ هستند و یک الگوریتم پیش‌بینی‌کننده از پیش تعریف‌شده را برای استفاده انتخاب می‌کنند که پیکسل‌های اطراف را در نظر می‌گیرد. بهترین پیش‌بینی‌کننده برای یک تصویر خاص به خود تصویر بستگی دارد. .in 15 .in 15 .B "jpeg:max-scan-number=" .in 20 \fR .in 20 یک مقدار عدد صحیح برای حداکثر تعداد پویش‌های پیش‌رونده (progressive scans) مجاز در یک فایل JPEG مشخص می‌کند. حداکثر پیش‌فرض ۱۰۰ پویش است. این محدودیت به دلیل ضعفی در استاندارد JPEG اعمال شده است که به فایل‌های کوچک JPEG اجازه می‌دهد خواندن آن‌ها دقیقه‌ها یا ساعت‌ها به طول بینجامد. .in 15 .in 15 .B "jpeg:max-warnings=" .in 20 \fR .in 20 یک مقدار عدد صحیح را برای تعداد هشدارهای مجاز در هر نوع خطای خاص قبل از ارتقا به یک خطای قطعی (hard error) مشخص می‌کند. فایل‌های JPEG که هشدارهای بیش از حد تولید می‌کنند، نشان‌دهنده وجود مشکل در فایل هستند. .in 15 .in 15 .B "jpeg:optimize-coding={true|false}" .in 20 \fR .in 20 تعیین می‌کند که آیا کدگذاری هافمن باید استفاده شود یا خیر. کدگذاری هافمن به‌طور پیش‌فرض فعال است، اما ممکن است برای تصاویر بسیار بزرگ غیرفعال شود زیرا رمزگذاری آن نیازمند بافر شدن کل تصویر در حافظه است. کدگذاری هافمن به قیمت افزایش زمان فشرده‌سازی و مصرف حافظه، فایل‌های JPEG کوچک‌تری تولید می‌کند. .in 15 .in 15 .B "jpeg:preserve-settings" .in 20 \fR .in 20 اگر پرچم jpeg:preserve-settings تعریف شده باشد، رمزگذار JPEG از همان تنظیمات "quality" و "sampling-factor" استفاده خواهد کرد که در صورت JPEG بودن ورودی، در فایل ورودی یافت شده بودند. این تنظیمات همچنین در صورتی که ورودی یک فایل JPEG و خروجی یک فایل JNG باشد نیز حفظ می‌شوند. اگر فضای رنگی فایل خروجی با فایل ورودی متفاوت باشد، تنظیم کیفیت حفظ می‌شود اما ضرایب نمونه‌برداری حفظ نمی‌شوند. .in 15 .in 15 .B "jxl:effort=" .in 20 \fR .in 20 میزان تلاش رمزگذار. مقادیر بالاتر محاسبات بیشتری را ممکن می‌سازند و عموماً خروجی کوچک‌تری را در همان کیفیت به دست می‌آورند. برای رمزگذاری اتلافی، تلاش بیشتر باید کیفیت دقیق‌تری به همراه داشته باشد. لطفاً برای 'JXL_ENC_FRAME_SETTING_EFFORT' به کد منبع (یا مستندات) libjxl مراجعه کنید. .in 15 .in 15 .B "jxl:decodingspeed=" .in 20 \fR .in 20 سرعت رمزگشایی. مقادیر بالاتر سرعت رمزگشایی را به بهای کاهش کیفیت یا تراکم بهبود می‌بخشند. لطفاً برای 'JXL_ENC_FRAME_SETTING_DECODING_SPEED' به کد منبع (یا مستندات) libjxl مراجعه کنید. .in 15 .in 15 .B "pcl:fit-to-page" .in 20 \fR .in 20 اگر پرچم pcl:fit-to-page تعریف شود، از چاپگر درخواست می‌شود تا اندازه تصویر را متناسب با اندازه صفحه (عرض و/یا ارتفاع) تغییر مقیاس دهد. .in 15 .in 15 .B "png:chunk-malloc-max=" .in 20 \fR .in 20 گزینه png:chunk-malloc-max حداکثر اندازه تکه‌ای (chunk size) را که libpng مجاز به خواندن آن خواهد بود مشخص می‌کند. پیش‌فرض libpng معمولاً ۸٬۰۰۰٬۰۰۰ بایت است. بسیار به ندرت، ممکن است با یک فایل PNG معتبر مواجه شوید که خطای "chunk data is too large" برای آن گزارش شود. در این حالت، این محدودیت می‌تواند با استفاده از این گزینه افزایش یابد. هنگام افزایش این محدودیت احتیاط کنید، زیرا یک محدودیت بیش از حد بزرگ می‌تواند به فایل‌های غیرقابل اعتماد اجازه دهد حافظه بیش از حدی مصرف کنند. .in 15 .in 15 .B "mng:maximum-loops=" .in 20 \fR .in 20 گزینه mng:maximum-loops حداکثر تعداد حلقه‌های مجاز برای مشخص شدن توسط یک تکه MNG LOOP را تعیین می‌کند. بدون اعمال محدودیت، یک فایل MNG می‌تواند تا ۲۱۴۷۴۸۳۶۴۷ حلقه را درخواست کند که ممکن است برای مدت بسیار طولانی اجرا شود. حد پیش‌فرض فعلی ۵۱۲ حلقه است. .in 15 .in 15 .B "pdf:use-cropbox={true|false}" .in 20 \fR .in 20 اگر پرچم pdf:use-cropbox روی \fBtrue\fP تنظیم شود، از Ghostscript درخواست می‌شود تا کادر برش (crop box) فایل PDF را اعمال کند. .in 15 .in 15 .B "pdf:stop-on-error={true|false}" .in 20 \fR .in 20 اگر پرچم pdf:stop-on-error روی \fBtrue\fP تنظیم شود، از Ghostscript درخواست می‌شود هنگام مواجهه با اولین خطا، پردازش PDF را متوقف کند. در غیر این صورت تلاش خواهد کرد تمام صفحات درخواست‌شده را پردازش کند. .in 15 .in 15 .B "ps:imagemask" .in 20 \fR .in 20 اگر پرچم ps:imagemask تعریف شود، رمزگذارهای PS3 و EPS3 فایل‌های Postscript تولید می‌کنند که تصاویر دوسطحی (bilevel) را به جای عملگر image، با عملگر imagemask زبان Postscript رسم (render) می‌کنند. .in 15 .in 15 .B "ptif:minimum-geometry=" .in 20 \fR .in 20 اگر کلید ptif:minimum-geometry تعریف شود، GraphicsMagick از آن برای تعیین حداقل اندازه فریم خروجی هنگام نوشتن یک فایل pyramid TIFF (یک فایل TIFF شامل توالی نسخه‌های کوچک‌شده از فریم اول) استفاده خواهد کرد. هندسه حداقل پیش‌فرض 32x32 است. .in 15 .in 15 .B "tiff:alpha={unspecified|associated|unassociated}" .in 20 \fR .in 20 نوع کانال آلفای TIFF را هنگام خواندن یا نوشتن فایل‌های TIFF مشخص می‌کند، و مقدار عادی را نادیده می‌گیرد. نوع پیش‌فرض کانال آلفا برای فایل‌های جدید، unspecified alpha است. تنظیمات آلفای موجود هنگام تبدیل از یک فایل TIFF به فایل دیگر حفظ می‌شوند. هنگامی که یک فایل TIFF از associated alpha استفاده می‌کند، پیکسل‌های تصویر از پیش در کانال آلفا ضرب (دگرگون) می‌شوند. فایل‌های دارای آلفای "associated" هنگامی که کانال مات (matte) غیرفعال باشد، طوری به نظر می‌رسند که گویی روی یک پس‌زمینه سیاه ترکیب آلفا شده‌اند. اگر نوع unassociated alpha انتخاب شود، کانال آلفا بدون تغییر دادن پیکسل‌ها ذخیره می‌شود. نرم‌افزار Photoshop آلفای associated را به عنوان اطلاعات شفافیت تشخیص می‌دهد؛ اگر فایل با unassociated alpha ذخیره شود، اطلاعات آلفا به عنوان یک کانال مستقل بارگذاری می‌شود. توجه داشته باشید که برای سال‌ها، ImageMagick و GraphicsMagick فایل‌های TIFF را بدون ضرب پیش‌فرض مناسب پیکسل‌ها، به عنوان فایل‌های دارای associated alpha علامت‌گذاری می‌کردند. .in 15 .in 15 .B "tiff:fill-order={msb2lsb|lsb2msb}" .in 20 \fR .in 20 اگر کلید tiff:fill-order تعریف شده باشد، GraphicsMagick از آن برای تعیین ترتیب پر کردن بیت (bit fill order) مورد استفاده هنگام نوشتن فایل‌های TIFF استفاده خواهد کرد. پیش‌فرض عادی "msb2lsb" است که با ترتیب بیت بومی تمامی پردازنده‌های مدرن مطابقت دارد. تنها استثنا در این مورد زمانی است که فشرده‌سازی فکس Group3 یا Group4 درخواست شود، زیرا دستگاه‌های فکس داده‌ها را با ترتیب بیت معکوس ارسال می‌کنند و بنابراین RFC 2301 استفاده از ترتیب معکوس را توصیه می‌کند. .in 15 .in 15 .B "tiff:group-three-options=" .in 20 \fR .in 20 اگر کلید tiff:group-three-options تعریف شود، GraphicsMagick از آن برای تنظیم برچسب گزینه‌های group3 هنگام نوشتن TIFF فشرده‌شده با group3 استفاده خواهد کرد. لطفاً برای نحوه استفاده از این برچسب به مشخصات TIFF مراجعه کنید. مقدار پیش‌فرض ۴ است. .in 15 .in 15 .B "tiff:ignore-tags=" .in 20 \fR .in 20 اگر کلید tiff:ignore-tags تعریف شود، به عنوان فهرستی از مقادیر صحیح برچسب‌های TIFF جداشده با کاما برای نادیده گرفتن در هنگام خواندن فایل TIFF استفاده می‌شود. این ویژگی برای امکان خواندن فایل‌هایی که در غیر این صورت به دلیل مشکلاتی در برچسب‌های TIFF با شکست مواجه می‌شوند، مفید است. توجه داشته باشید که برخی از برچسب‌های TIFF برای اینکه بتوان داده‌های تصویر را خواند، کاملاً ضروری هستند. .in 15 .in 15 .B "tiff:lerc-maxzerror=" .in 20 \fR .in 20 هنگامی که فشرده‌سازی LERC انتخاب شده باشد (از طریق `\-compress lerc`)، حداکثر خطای ممیز شناور مجاز برای فشرده‌سازی با اتلاف را مشخص می‌کند (مثلاً 0.5). مقدار پیش‌فرض فشرده‌سازی 0 (بدون اتلاف) است. .in 15 .in 15 .B "tiff:lerc-compression={1|deflate|zip|2|zstd}" .in 20 \fR .in 20 پس از انجام فشرده‌سازی LERC، یک مرحله فشرده‌سازی دوم اختیاری با استفاده از فشرده‌سازی Deflate یا Zstd می‌تواند انجام شود. برای استفاده از فشرده‌سازی Deflate مقدار 1، deflate یا zip، و برای استفاده از فشرده‌سازی Zstd مقدار 2 یا zstd را مشخص کنید. این آرگومان به بزرگی یا کوچکی حروف حساس نیست. .in 15 .in 15 .B "tiff:lerc-zip-quality=" .in 20 \fR .in 20 هنگامی که فشرده‌سازی LERC فعال است و فشرده‌سازی مرحله دوم با استفاده از Deflate انتخاب شده است، مقداری در محدوده ۱ تا ۱۲ را برای مشخص کردن سطح فشرده‌سازی Deflate ارائه دهید (مقدار بزرگ‌تر به معنای فشرده‌سازی بیشتر است). سطح پیش‌فرض برای فشرده‌سازی Deflate مقدار ۶ است. .in 15 .in 15 .B "tiff:lerc-zstd-level=" .in 20 \fR .in 20 هنگامی که فشرده‌سازی LERC فعال است و فشرده‌سازی مرحله دوم با استفاده از Zstd انتخاب شده است، مقداری بین ۱ و ۱۹ (یا ۲۲ با مصرف حافظه بسیار بیشتر) را برای تعیین سطح فشرده‌سازی Zstd ارائه دهید (مقدار بزرگ‌تر به معنای فشرده‌سازی بیشتر است). سطح پیش‌فرض برای فشرده‌سازی Zstd مقدار ۳ است. .in 15 .in 15 .B "tiff:photometric={minisblack|miniswhite}" .in 20 \fR .in 20 برای تصاویر مقیاس خاکستری و دوسطحی، برنامه GraphicsMagick معمولاً نورسنجی (photometric) را بر اساس عمق بیت و فشرده‌سازی انتخاب می‌کند. اگر کلید tiff:photometric تعریف شود، GraphicsMagick از آن برای تعیین نورسنجی مورد استفاده هنگام نوشتن تصاویر مقیاس خاکستری و دوسطحی استفاده خواهد کرد. معمولاً تصاویر دوسطحی miniswhite و تصاویر مقیاس خاکستری minisblack هستند. .in 15 .in 15 .B "tiff:report-warnings={false|true}" .in 20 \fR .in 20 اگر کلید tiff:report-warnings تعریف شده و روی \fBtrue\fP تنظیم شود، هشدارهای TIFF به عنوان یک استثنای هشدار به جای پیام لاگ رمزگذار گزارش می‌شوند. چنین هشدارهایی پس از خوانده شدن یا نوشته شدن تصویر گزارش می‌شوند. بیشتر هشدارهای TIFF بی‌خطر هستند اما گاهی می‌توانند به شناسایی مشکلات فایل TIFF کمک کنند، یا به تشخیص اینکه فایل TIFF به دلیل استفاده از افزونه‌های اختصاصی یا تخصصی برای خوانده شدن موفقیت‌آمیز به یک برنامه ویژه نیاز دارد، یاری رسانند. .in 15 .in 15 .B "tiff:sample-format={unsigned|ieeefp}" .in 20 \fR .in 20 اگر کلید tiff:sample-format تعریف شود، GraphicsMagick از آن برای تعیین قالب نمونه مورد استفاده در هنگام نوشتن فایل‌های TIFF استفاده خواهد کرد. پیش‌فرض "unsigned" است. برای نوشتن فایل‌های TIFF ممیز شناور با مقادیر float (۳۲ بیتی) یا double (۶۴ بیتی)، مقدار "ieeefp" را مشخص کنید. از تعریف tiff:bits-per-sample برای تعیین نوع مقدار ممیز شناور مورد استفاده بهره ببرید. .in 15 .in 15 .B "tiff:max-sample-value=" .in 20 \fR .in 20 اگر کلید tiff:max-sample-value تعریف شود، GraphicsMagick از مقدار اختصاص‌یافته به عنوان حداکثر مقدار ممیز شناور هنگام خواندن یا نوشتن TIFFهای ممیز شناور IEEE استفاده خواهد کرد. در غیر این صورت مقدار حداکثر 1.0 یا مقدار به‌دست‌آمده از برچسب SMaxSampleValue فایل (در صورت وجود) است. داده‌های ممیز شناور در حال حاضر از قبل برای تعیین بهترین مقدار نمونه حداکثری پویش نمی‌شوند، بنابراین اگر محدوده 1.0 نباشد یا برچسب SMaxSampleValue وجود نداشته باشد، ممکن است لازم باشد (به صورت هوشمندانه) از این پارامتر برای خواندن صحیح یک فایل استفاده کنید. .in 15 .in 15 .B "tiff:min-sample-value=" .in 20 \fR .in 20 اگر کلید tiff:min-sample-value تعریف شود، GraphicsMagick از مقدار اختصاص‌یافته به عنوان حداقل مقدار ممیز شناور هنگام خواندن یا نوشتن TIFFهای ممیز شناور IEEE استفاده خواهد کرد. در غیر این صورت مقدار حداقل 0.0 یا مقدار به‌دست‌آمده از برچسب SMinSampleValue فایل (در صورت وجود) خواهد بود. .in 15 .in 15 .B "tiff:bits-per-sample=" .in 20 \fR .in 20 اگر کلید tiff:bits-per-sample تعریف شود، GraphicsMagick تصاویر را با بیت‌های مشخص‌شده در هر نمونه می‌نویسد و هرگونه مقدار عمق موجود را نادیده می‌گیرد. مقدار می‌تواند هر عددی در محدوده ۱ تا ۳۲ یا هنگام نوشتن قالب پیش‌فرض \'unsigned' برابر با ۶۴ باشد، یا در صورت نوشتن قالب IEEEFP برابر با 16/32/24/64 باشد. لطفاً توجه داشته باشید که مشخصات پایه TIFF 6.0 تنها خواننده‌ها را ملزم می‌کند که توان‌های خاصی از دو را مدیریت کنند، و مقادیری که باید مدیریت شوند به ماهیت تصویر بستگی دارند (مانند نقشه‌رنگی، مقیاس خاکستری، RGB، CMYK). .in 15 .in 15 .B "tiff:samples-per-pixel=" .in 20 \fR .in 20 اگر کلید tiff:samples-per-pixel روی مقداری تعریف شود، رمزگذار TIFF تصاویر TIFF را با نمونه‌های تعریف‌شده در هر پیکسل می‌نویسد و هرگونه مقدار ذخیره‌شده در تصویر را نادیده می‌گیرد. این گزینه معمولاً نباید استفاده شود. .in 15 .in 15 .B "tiff:rows-per-strip=" .in 20 \fR .in 20 به کاربر اجازه می‌دهد تعداد سطرها در هر نوار (strip) TIFF را مشخص کند. هنگام استفاده از فشرده‌سازی JPEG، به مضربی از ۱۶ به سمت بالا گرد می‌شود. در صورت استفاده از کاشی‌ها نادیده گرفته می‌شود. .in 15 .in 15 .B "tiff:strip-per-page=true" .in 20 \fR .in 20 درخواست می‌کند که تصویر در یک نوار TIFF تکی نوشته شود. این معمولاً در زمانی که فشرده‌سازی group3 یا group4 در محدوده‌های معقول درخواست شود پیش‌فرض است. درخواست یک نوار منفرد برای تصاویر بزرگ ممکن است به دلیل مصرف منابع در نویسنده یا خواننده منجر به شکست شود. .in 15 .in 15 .B "tiff:tile" .in 20 \fR .in 20 نوشتن TIFF کاشی‌کاری‌شده (به جای نواری) را با استفاده از اندازه پیش‌فرض کاشی فعال می‌کند. TIFF کاشی‌کاری‌شده تصویر را به صورت آرایه‌ای از تصاویر کوچک‌تر (کاشی‌ها) سازمان‌دهی می‌کند تا امکان دسترسی تصادفی فراهم شود. .in 15 .in 15 .B "tiff:tile-geometry=x" .in 20 \fR .in 20 اندازه کاشی مورد استفاده هنگام نوشتن TIFF کاشی‌کاری‌شده را مشخص می‌کند. عرض و ارتفاع باید مضربی از ۱۶ باشند. اگر مقدار مضربی از ۱۶ نباشد، به سمت پایین گرد می‌شود. در صورتی که TIFF کاشی‌کاری‌شده قبلاً فعال نشده باشد، آن را فعال می‌کند. برنامه GraphicsMagick در داخل خود از ذخیره‌سازی کاشی‌کاری‌شده استفاده نمی‌کند، بنابراین کاشی‌ها باید از ذخیره‌سازی خط‌روبشی (scanline) داخلی به ذخیره‌سازی کاشی‌محور و برعکس تبدیل شوند. آزمایش با تصاویر معمولی RGB نشان می‌دهد که مقادیر اندازه کاشی مربعیِ کاربردی بین 128x128 تا 1024x1024 متغیر است. تصاویر بزرگی که نیازمند استفاده از حافظه پنهان پیکسل مبتنی بر دیسک هستند از اندازه‌های بزرگ کاشی بهره می‌برند، در حالی که تصاویری که در حافظه رم جا می‌شوند با اندازه‌های کوچک‌تر کاشی به خوبی کار می‌کنند. .in 15 .in 15 .B "tiff:tile-width=" .in 20 \fR .in 20 عرض کاشی مورد استفاده هنگام نوشتن TIFF کاشی‌کاری‌شده را مشخص می‌کند. سپس ارتفاع کاشی به‌طور پیش‌فرض به اندازه‌ای مناسب تنظیم می‌شود. عرض باید مضربی از ۱۶ باشد. اگر مقدار مضربی از ۱۶ نباشد، به سمت پایین گرد خواهد شد. در صورت عدم فعال بودن قبلی، TIFF کاشی‌کاری‌شده را فعال می‌کند. .in 15 .in 15 .B "tiff:tile-height=" .in 20 \fR .in 20 ارتفاع کاشی مورد استفاده هنگام نوشتن TIFF کاشی‌کاری‌شده را مشخص می‌کند. سپس عرض کاشی به‌طور پیش‌فرض به اندازه‌ای مناسب تنظیم می‌شود. ارتفاع باید مضربی از ۱۶ باشد. اگر مقدار مضربی از ۱۶ نباشد، به سمت پایین گرد خواهد شد. در صورت عدم فعال بودن قبلی، TIFF کاشی‌کاری‌شده را فعال می‌کند. .in 15 .in 15 .B "tiff:webp-lossless={TRUE|FALSE}" .in 20 \fR .in 20 برای فعال‌سازی حالت بدون اتلاف هنگام نوشتن فایل‌های TIFF با فشرده‌سازی WebP، مقدار \fBTRUE\fP را مشخص کنید. گزینه WebP یعنی \fBwebp:lossless\fP نیز می‌تواند استفاده شود. ضریب کیفیتی که توسط گزینه \fB-quality\fP تنظیم می‌شود می‌تواند برای تأثیرگذاری بر سطح تلاش صرف‌شده هنگام فشرده‌سازی استفاده شود. .in 15 .in 15 .B "tiff:zstd-compress-level=" .in 20 \fR .in 20 سطح فشرده‌سازی مورد استفاده هنگام نوشتن فایل‌های TIFF با فشرده‌سازی Zstd را مشخص می‌کند. محدوده معتبر ۱ تا ۲۲ است. اگر این تعریف مشخص نشود، از مقدار 'quality' استفاده می‌شود، به طوری که تنظیم پیش‌فرض کیفیت یعنی ۷۵ به سطح فشرده‌سازی ۹ ترجمه می‌شود، به نحوی که \'quality' در صورت استفاده برای این منظور دارای محدوده کاربردی ۱۰-۱۸۴ خواهد بود. .in 15 .in 15 .B "webp:exact={true|false}" .in 20 \fR .in 20 حفظ مقادیر دقیق RGB در زیر نواحی شفاف. پیش‌فرض false است. .in 15 .in 15 .B "webp:lossless={true|false}" .in 20 \fR .in 20 فعال‌سازی رمزگذاری بدون اتلاف. همچنین حالت 'exact' را فعال می‌کند. .in 15 .in 15 .B "webp:method={0-6}" .in 20 \fR .in 20 موازنه کیفیت/سرعت. .in 15 .in 15 .B "webp:image-hint={default,graph,photo,picture}" .in 20 \fR .in 20 راهنمایی برای تعیین نوع تصویر. .in 15 .in 15 .B "webp:target-size=" .in 20 \fR .in 20 اندازه هدف بر حسب بایت. .in 15 .in 15 .B "webp:target-psnr=" .in 20 \fR .in 20 حداقل اعوجاج برای تلاش در جهت دستیابی. .in 15 .in 15 .B "webp:segments={1-4}" .in 20 \fR .in 20 حداکثر تعداد قطعه‌ها (segments) برای استفاده. .in 15 .in 15 .B "webp:sns-strength={0-100}" .in 20 \fR .in 20 شکل‌دهی مکانی نویز (Spatial Noise Shaping). .in 15 .in 15 .B "webp:filter-strength={0-100}" .in 20 \fR .in 20 قدرت فیلتر. .in 15 .in 15 .B "webp:filter-sharpness={0-7}" .in 20 \fR .in 20 وضوح فیلتر. .in 15 .in 15 .B "webp:filter-type={0,1}" .in 20 \fR .in 20 نوع فیلترسازی. 0 = ساده، 1 = قوی (تنها در صورتی استفاده می‌شود که filter-strength > 0 باشد یا autofilter فعال باشد). .in 15 .in 15 .B "webp:auto-filter={true|false}" .in 20 \fR .in 20 تنظیم خودکار قدرت فیلتر. .in 15 .in 15 .B "webp:alpha-compression=" .in 20 \fR .in 20 الگوریتم رمزگذاری صفحه آلفا (0 = هیچ، 1 = فشرده‌شده با WebP بدون اتلاف). پیش‌فرض 1 است. .in 15 .in 15 .B "webp:alpha-filtering=" .in 20 \fR .in 20 روش فیلترسازی پیش‌بینانه برای صفحه آلفا. 0: هیچ، 1: سریع، 2: بهترین. پیش‌فرض 1 است. .in 15 .in 15 .B "webp:alpha-quality={0-100}" .in 20 \fR .in 20 بین 0 (کوچک‌ترین اندازه) و 100 (بدون اتلاف). پیش‌فرض 100 است. .in 15 .in 15 .B "webp:pass=[1..10]" .in 20 \fR .in 20 تعداد دفعات پویش تحلیل آنتروپی. .in 15 .in 15 .B "webp:show-compressed={true|false}" .in 20 \fR .in 20 صادر کردن مجدد تصویر فشرده‌شده به بیرون. فیلترسازی درون‌حلقه‌ای اعمال نمی‌شود. .in 15 .in 15 .B "webp:preprocessing=[0,1,2]" .in 20 \fR .in 20 0=هیچ، 1=هموارسازی قطعه، 2=دیترینگ شبه‌تصادفی .in 15 .in 15 .B "webp:partitions=[0-3]" .in 20 \fR .in 20 log2(تعداد افرازهای توکن) در [0..3]. پیش‌فرض جهت رمزگشایی پیش‌رونده آسان‌تر 0 است. .in 15 .in 15 .B "webp:partition-limit={0-100}" .in 20 \fR .in 20 افت کیفیت مجاز برای جای‌گیری در محدودیت 512k روی کدگذاری حالت‌های پیش‌بینی (0: بدون افت، 100: بیشترین افت ممکن). .in 15 .in 15 .B "webp:emulate-jpeg-size={true|false}" .in 20 \fR .in 20 اگر true باشد، پارامترهای فشرده‌سازی دوباره نگاشت می‌شوند تا با اندازه خروجی مورد انتظار از فشرده‌سازی JPEG تطابق بهتری داشته باشند. به‌طور کلی، اندازه خروجی مشابه خواهد بود اما میزان افت کیفیت کمتر است. .in 15 .in 15 .B "webp:thread-level=" .in 20 \fR .in 20 اگر غیرصفر باشد، برای استفاده از رمزگذاری چندنخی تلاش می‌کند. .in 15 .in 15 .B "webp:low-memory={true|false}" .in 20 \fR .in 20 در صورت تنظیم، مصرف حافظه را کاهش می‌دهد (اما مصرف CPU را افزایش می‌دهد) .in 15 .in 15 .B "webp:use-sharp-yuv={true|false}" .in 20 \fR .in 20 در صورت تنظیم، در صورت نیاز از تبدیل دقیق (و کند) RGB->YUV استفاده می‌کند .in 15 برای مثال، جهت ایجاد یک فایل postscript که تنها پیکسل‌های سیاه یک تصویر دوسطحی را رسم می‌کند، از دستور زیر استفاده کنید: .nf gm convert bilevel.tif -define ps:imagemask eps3:stencil.ps .fi.TP .B "-delay \fI<1/100ths of a second>"\fP \fRنمایش تصویر بعدی پس از مکث این گزینه برای تنظیم پویانمایی توالی تصاویر مفید است. پیش از نمایش تصویر بعدی باید \fIDelay/100\fP ثانیه سپری شود. حالت پیش‌فرض بدون تاخیر بین هر بار نمایش توالی تصویر است. بیشینه تاخیر 65535 است. می‌توانید یک بازه تاخیر مشخص کنید (مثلاً \fI-delay 10-500\fP) که حداقل و حداکثر تاخیر را تعیین می‌کند. .TP .B "-density \fIx"\fP \fRتفکیک‌پذیری افقی و عمودی تصویر بر حسب پیکسل این گزینه تفکیک‌پذیری تصویر را جهت ذخیره‌سازی هنگام کدگذاری یک تصویر شطرنجی یا تفکیک‌پذیری بوم را هنگام رندر کردن (خواندن) قالب‌های برداری مانند Postscript، PDF، WMF و SVG به یک تصویر شطرنجی مشخص می‌کند. تفکیک‌پذیری تصویر، واحد اندازه‌گیری مورد استفاده هنگام رندر کردن روی یک دستگاه خروجی یا تصویر شطرنجی را فراهم می‌کند. واحد اندازه‌گیری پیش‌فرض نقطه در اینچ (DPI) است. از گزینهٔ \fB-units\fP می‌توان برای انتخاب نقطه در سانتی‌متر به جای آن استفاده کرد. تفکیک‌پذیری پیش‌فرض 72 نقطه در اینچ است که معادل یک پوینت به ازای هر پیکسل است (استاندارد Macintosh و Postscript). صفحه‌نمایش‌های رایانه معمولاً 72 یا 96 نقطه در اینچ هستند در حالی که چاپگرها معمولاً از 150، 300، 600 یا 1200 نقطه در اینچ پشتیبانی می‌کنند. برای تعیین تفکیک‌پذیری نمایشگر خود، با خط‌کش عرض صفحه‌نمایش را بر حسب اینچ اندازه گرفته و بر تعداد پیکسل‌های افقی تقسیم کنید (1024 در یک نمایشگر 1024x768). اگر قالب فایل پشتیبانی کند، می‌توان از این گزینه برای به‌روزرسانی تفکیک‌پذیری ذخیره‌شدهٔ تصویر استفاده کرد. توجه داشته باشید که Photoshop تفکیک‌پذیری تصویر را در یک نمایهٔ اختصاصی جاسازی‌شده ذخیره و دریافت می‌کند. اگر این نمایه از تصویر حذف نشود، Photoshop همچنان با تصویر با استفاده از تفکیک‌پذیری پیشین آن رفتار خواهد کرد و تفکیک‌پذیری مشخص‌شده در سرآیند استاندارد فایل را نادیده می‌گیرد. گزینهٔ density یک صفت است و تصویر شطرنجی زیرین را تغییر نمی‌دهد. می‌توان از آن برای تنظیم اندازه رندرشده برای اهداف نشر رومیزی با تنظیم مقیاس اعمال‌شده بر پیکسل‌ها استفاده کرد. برای تغییر اندازهٔ تصویر به‌گونه‌ای که در یک تفکیک‌پذیری دیگر همان اندازه را داشته باشد، از گزینهٔ \fB-resample\fP استفاده کنید. .TP .B "-depth \fI"\fP \fRعمق تصویر این مقدار تعداد بیت‌های رنگی است که باید در تصویر حفظ شوند. هر مقداری بین 1 و \fBQuantumDepth\fP (گزینه ساخت) می‌تواند مشخص شود، هرچند 8 یا 16 رایج‌ترین مقادیر هستند. از این گزینه برای مشخص کردن عمق تصاویر خام که عمق آن‌ها ناشناخته است مانند GRAY، RGB یا CMYK، یا برای تغییر عمق هر تصویری پس از خوانده شدن آن استفاده کنید. برای روشی (از طریق \(aq-operator All Depth N\(aq) جهت اعمال فوری محدودیت عمق به پیکسل‌ها به جای تنظیم یک صفت تصویر، گزینهٔ -operator را ببینید. .TP .B "-descend" \fRبه‌دست آوردن تصویر با پیمایش سلسله‌مراتب پنجره به پایین .TP .B "-despeckle" \fRکاهش لکه‌ها و نویزهای نقطه‌ای در یک تصویر .TP .B "-displace \fIx"\fP \fRتغییر مکان پیکسل‌های تصویر مطابق با تعریف یک نگاشت جابه‌جایی با این گزینه، \fIcomposite image\fP به عنوان یک نگاشت جابه‌جایی استفاده می‌شود. رنگ سیاه در نگاشت جابه‌جایی، بیشینه جابه‌جایی مثبت است. رنگ سفید بیشینه جابه‌جایی منفی بوده و خاکستری میانه خنثی است. جابه‌جایی مقیاس‌بندی می‌شود تا میزان تغییر مکان پیکسل تعیین گردد. به‌طور پیش‌فرض، جابه‌جایی در هر دو جهت افقی و عمودی اعمال می‌شود. با این حال، اگر \fImask\fP را مشخص کنید، \fIcomposite image\fP جابه‌جایی افقی X و \fImask\fP جابه‌جایی عمودی Y خواهد بود. .TP .B "-display \fI"\fP \fRمشخص کردن کارساز X برای ارتباط این گزینه همراه با convert برای دریافت تصویر یا قلم از این کارساز X استفاده می‌شود. \fIX(1)\fP را ببینید. .TP .B "-dispose \fI"\fP \fRروش دور انداختن در GIF روش دور انداختن، نحوهٔ رفتار با گرافیک پس از نمایش داده شدن را نشان می‌دهد. روش‌های معتبر عبارتند از: .nf Undefined عدم تعیین دور انداختن. None عدم دور انداختن بین فریم‌ها. Background بازنویسی ناحیه تصویر با رنگ پس‌زمینه. Previous بازنویسی ناحیه تصویر با آنچه پیش از رندر تصویر در آنجا بود. .fi .TP .B "-dissolve \fI"\fP \fRمحو/ترکیب کردن یک تصویر در تصویر دیگر با درصد داده‌شده کدری (opacity) تصویر مرکب در درصد داده‌شده ضرب می‌شود و سپس بر روی تصویر اصلی ترکیب می‌گردد. .TP .B "-dither" \fRاعمال انتشار خطای Floyd/Steinberg بر روی تصویر راهبرد اساسی dithering، تبادل تفکیک‌پذیری شدت با تفکیک‌پذیری مکانی از طریق میانگین‌گیری از شدت‌های چندین پیکسل مجاور است. تصاویری که هنگام کاهش رنگ دچار نواربندی یا خطوط تراز شدید (contouring) می‌شوند، می‌توانند با این گزینه بهبود یابند. گزینهٔ \fB-colors\fP یا \fB-monochrome\fP برای اعمال اثر این گزینه الزامی است. از \fB+dither\fP برای خاموش کردن dithering و رندر کردن PostScript بدون پله‌ای شدن (aliasing) متن یا گرافیک استفاده کنید. غیرفعال کردن dithering اغلب (اما نه همیشه) منجر به کاهش زمان پردازش می‌شود. .TP .B "-draw \fI"\fP \fRحاشیه‌نویسی یا ترسیم روی تصویر با یک یا چند عنصر اولیّهٔ گرافیکی از این گزینه برای حاشیه‌نویسی روی یک تصویر با یک یا چند عنصر اولیّهٔ گرافیکی استفاده کنید. این عناصر اولیه شامل اشکال، متن، تبدیلات، و عملیات پیکسلی هستند. عناصر اولیه شکل عبارتند از: .nf 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 .fi عنصر اولیهٔ متن عبارت است از: .nf text x0,y0 string .fi عنصر اولیهٔ جاذبه متن عبارت است از: .nf gravity NorthWest, North, NorthEast, West, Center, East, SouthWest, South, or SouthEast .fi عنصر اولیهٔ جاذبه متن تنها بر جای‌گذاری متن اثر می‌گذارد و با سایر عناصر اولیه تداخلی ندارد. این مورد معادل استفاده از گزینهٔ خط فرمان \fB-gravity\fP است، با این تفاوت که دامنهٔ اثر آن به گزینهٔ \fB-draw\fP که در آن ظاهر شده محدود می‌شود. عناصر اولیه تبدیل عبارتند از: .nf rotate degrees translate dx,dy scale sx,sy skewX degrees skewY degrees .fi عناصر اولیه عملیات پیکسلی عبارتند از: .nf color x0,y0 method matte x0,y0 method .fi عناصر اولیه شکل با رنگ مشخص‌شده در گزینهٔ \fB-stroke\fP پیشین رسم می‌شوند. به‌جز عناصر اولیهٔ \fBline\fP و \fBpoint\fP، آن‌ها با رنگ مشخص‌شده در گزینهٔ \fB-fill\fP پیشین پر می‌شوند. برای اشکال بدون پرشدگی، از \-fill none استفاده کنید. عنصر \fBPoint\fP به یک مختصات نیاز دارد. عنصر \fBLine\fP به یک مختصات شروع و پایان نیاز دارد. عنصر \fBRectangle\fP مختصات بالا-چپ و پایین-راست را انتظار دارد. عنصر \fBRoundRectangle\fP مختصات بالا-چپ و پایین-راست و پهنا و ارتفاع گوشه‌ها را دریافت می‌کند. عنصر \fBCircle\fP یک مختصات مرکز و یک مختصات برای لبهٔ بیرونی دارد. از \fBArc\fP برای محاط کردن یک کمان بیضوی درون یک مستطیل استفاده کنید. کمان‌ها به نقطه شروع و پایان و همچنین درجه چرخش نیاز دارند (مانند 130,30 200,100 45,90). از \fBEllipse\fP برای ترسیم یک بیضی ناقص به مرکزیت نقطه داده‌شده، همراه با شعاع محور x و محور y و شروع و پایان کمان بر حسب درجه استفاده کنید (مانند 100,100 100,150 0,360). در نهایت، \fBpolyline\fP و \fBpolygon\fP برای تعریف مرزهای خود به سه یا چند مختصات نیاز دارند. مختصات‌ها اعداد صحیحی هستند که با یک ویرگول اختیاری جدا می‌شوند. برای مثال، برای تعریف دایره‌ای با مرکز در 100,100 که تا 150,150 گسترش می‌یابد از دستور زیر استفاده کنید: .nf -draw 'circle 100,100 150,150' .fi عنصر \fBPaths\fP (بخش Paths را ببینید) نمایانگر طرح کلی یک شیء است که بر حسب عناصر moveto (تعیین یک نقطه جاری جدید)، lineto (رسم یک خط راست)، curveto (رسم یک منحنی با بزیه درجه سه)، arc (کمان بیضوی یا دایره‌ای) و closepath (بستن شکل جاری با رسم خط به آخرین moveto) تعریف می‌شود. مسیرهای مرکب (یعنی مسیری با زیرمسیرها که هرکدام شامل یک moveto منفرد و در ادامه یک یا چند عملیات خط یا منحنی هستند) برای ایجاد جلوه‌هایی نظیر \(lqسوراخ‌های دونات\(rq در اشیاء امکان‌پذیر هستند. از \fBimage\fP برای ترکیب یک تصویر با تصویری دیگر استفاده کنید. پس از کلیدواژهٔ image، عملگر ترکیب، مکان تصویر، اندازه تصویر، و نام فایل می‌آید: .nf -draw 'image Over 100,100 225,225 image.jpg' .fi می‌توانید از 0,0 برای اندازه تصویر استفاده کنید، که به معنی استفاده از ابعاد واقعی موجود در سرآیند تصویر است. در غیر این صورت، به ابعاد داده‌شده مقیاس‌بندی خواهد شد. برای شرح عملگرهای ترکیب، \fB-compose\fP را ببینید. از \fBtext\fP برای حاشیه‌نویسی یک تصویر با متن استفاده کنید. پس از مختصات متن، یک رشته قرار می‌گیرد. اگر رشته دارای فاصله‌های خالی است، آن را در علامت‌های نقل‌قول تکی یا دوتایی محصور کنید. به‌طور اختیاری می‌توانید با گنجاندن نویسه‌های قالب‌بندی خاص، نام فایل تصویر، نوع، پهنا، ارتفاع یا سایر صفات تصویر را درج کنید. برای جزئیات به \fB-comment\fP مراجعه کنید. برای مثال، .nf -draw 'text 100,100 "%m:%f %wx%h"' تصویر را با MIFF:bird.miff 512x480 برای تصویری با عنوان bird.miff و پهنای 512 و ارتفاع 480 حاشیه‌نویسی می‌کند. اگر نخستین نویسهٔ \fIstring\fP نویسهٔ \fI@\fP باشد، متن از فایلی خوانده می‌شود که نام آن نویسه‌های باقی‌مانده در رشته است. لطفاً توجه داشته باشید که اگر رشته از یک منبع غیرقابل‌اعتماد باشد، باید پیش از استفاده پاک‌سازی شود (یک ریسک امنیتی). عنصر \fBRotate\fP عناصر اولیه شکل و متن بعدی را حول مبدأ تصویر اصلی می‌چرخاند. اگر گزینهٔ \fB-region\fP پیش از گزینهٔ \fB-draw\fP بیاید، مبدأ تبدیلات گوشهٔ بالا-چپ ناحیه خواهد بود. عنصر \fBTranslate\fP آن‌ها را جابه‌جا (انتقال) می‌کند. عنصر \fBScale\fP آن‌ها را مقیاس‌بندی می‌کند. عناصر \fBSkewX\fP و \fBSkewY\fP آن‌ها را نسبت به مبدأ تصویر اصلی یا ناحیه مورب می‌کنند. تبدیلات، ماتریس آفین جاری را تغییر می‌دهند که از ماتریس آفین اولیّهٔ تعریف‌شده توسط گزینهٔ \fB-affine\fP مقداردهی اولیه شده است. تبدیلات در درون گزینهٔ \fB-draw\fP تجمعی هستند. ماتریس آفین اولیه دست‌نخورده می‌ماند؛ آن ماتریس تنها با ظاهر شدن یک گزینهٔ \fB-affine\fP دیگر تغییر می‌کند. اگر گزینهٔ \fB-draw\fP دیگری ظاهر شود، ماتریس آفین جاری مجدداً از ماتریس آفین اولیه مقداردهی خواهد شد. از \fBcolor\fP برای تغییر رنگ یک پیکسل به رنگ پرکردن استفاده کنید (گزینهٔ \fB-fill\fP را ببینید). پس از مختصات پیکسل یک روش می‌آید: .nf point replace floodfill filltoborder reset .fi پیکسل هدف را همان پیکسلی در نظر بگیرید که توسط مختصات شما مشخص شده است. روش \fBpoint\fP پیکسل هدف را مجدداً رنگ‌آمیزی می‌کند. روش \fBreplace\fP هر پیکسلی را که با رنگ پیکسل هدف تطابق داشته باشد مجدداً رنگ‌آمیزی می‌کند. روش \fBFloodfill\fP هر پیکسلی را که با رنگ پیکسل هدف تطابق داشته و همسایهٔ آن باشد مجدداً رنگ‌آمیزی می‌کند، در حالی که \fBfilltoborder\fP هر پیکسل همسایه‌ای را که رنگ حاشیه نباشد مجدداً رنگ‌آمیزی می‌کند. در نهایت، \fBreset\fP همهٔ پیکسل‌ها را مجدداً رنگ‌آمیزی می‌نماید. از \fBmatte\fP برای تغییر مقدار مات پیکسل به شفاف استفاده کنید. پس از مختصات پیکسل یک روش قرار می‌گیرد (برای شرح روش‌ها به عنصر اولیهٔ \fBcolor\fP مراجعه کنید). روش \fBpoint\fP مقدار مات پیکسل هدف را تغییر می‌دهد. روش \fBreplace\fP مقدار مات هر پیکسلی را که با رنگ پیکسل هدف تطابق دارد تغییر می‌دهد. روش \fBFloodfill\fP مقدار مات هر پیکسلی را که با رنگ پیکسل هدف یکسان بوده و همسایهٔ آن است تغییر می‌دهد، در حالی که \fBfilltoborder\fP مقدار مات هر پیکسل همسایه‌ای را که رنگ حاشیه (\fB-bordercolor\fP) نباشد تغییر می‌دهد. در نهایت \fBreset\fP مقدار مات تمام پیکسل‌ها را تغییر می‌دهد. می‌توانید رنگ عنصر اولیه، قلم، و رنگ جعبهٔ احاطه‌کنندهٔ قلم را به ترتیب با \fB-fill\fP، \fB-font\fP و \fB-box\fP تعیین کنید. گزینه‌ها به ترتیب خط فرمان پردازش می‌شوند، بنابراین مطمئن شوید که از این گزینه‌ها \fIپیش از\fP گزینهٔ \fB-draw\fP استفاده می‌کنید..TP .B "-edge \fI"\fP \fRتشخیص لبه‌ها درون یک تصویر .TP .B "-emboss \fI"\fP \fRبرجسته‌سازی تصویر .TP .B "-encoding \fI"\fP \fRتعیین رمزگذاری متن از میان موارد زیر انتخاب کنید: \fIAdobeCustom, AdobeExpert, AdobeStandard, AppleRoman, BIG5, GB2312, Latin 2, None, SJIScode, Symbol, Unicode, Wansung.\fP .TP .B "-endian \fI"\fP \fRتعیین ترتیب بایت (MSB، LSB یا Native) تصویر \fIMSB\fP نشان‌دهنده ترتیب بزرگ‌بایتی (مانند SPARC، Motorola 68K) است در حالی که \fILSB\fP نشان‌دهنده ترتیب کوچک‌بایتی (مانند Intel 'x86، VAX) است. \fINative\fP بیانگر استفاده از ترتیب بایت پیش‌فرض برای پردازنده (CPU) فعلی است. این گزینه در حال حاضر تنها بر قالب‌های CMYK، DPX، GRAY، RGB و TIFF تأثیر می‌گذارد. برای بازگشت به ترتیب بایت نامشخص از \fB+endian\fP استفاده کنید. .TP .B "-enhance" \fRاعمال یک فیلتر دیجیتال برای بهبود تصویر نویزدار .TP .B "-equalize" \fRاجرای متعادل‌سازی هیستوگرام روی تصویر .TP .B "-extent \fIx{+-}{+-}"\fP \fRترکیب تصویر روی یک تصویر بوم با رنگ پس‌زمینه این گزینه تصویر را روی یک بوم جدید با رنگ پس‌زمینه (\fB-background\fP) و به ابعاد x ترکیب می‌کند. محتوای تصویر موجود در موقعیتی که توسط آفست‌های هندسی x و y یا جهت‌گیری مورد نظر (\fB-gravity\fP) مشخص شده، با استفاده از روش ترکیب تصویر فعلی (\fB-compose\fP) قرار می‌گیرد. بخش‌هایی از تصویر که خارج از ابعاد تصویر جدید قرار بگیرند، دور ریخته می‌شوند. برای مثال، دستور زیر یک بندانگشتی از تصویر ساخته و آن را در مرکز یک تصویر پس‌زمینه قرمز قرار می‌دهد، در حالی که بوم را با توجه به بندانگشتی، ده پیکسل به چپ و پنج پیکسل به بالا منتقل می‌کند: .nf gm convert infile.jpg -thumbnail 120x80 -background red -gravity center \\ -extent 140x100-10-5 outfile.jpg .fi این دستور یک تصویر JPEG را جهت تناسب با یک نمایشگر 800x600 کوچک یا بزرگ می‌کند: .nf gm convert -size 800x600 input.jpg \\ -resize 800x600 -background black \\ -compose Copy -gravity center \\ -extent 800x600 \\ -quality 92 output.jpg .fi اگر نسبت ابعاد تصویر ورودی دقیقاً 4:3 نباشد، تصویر در مرکز یک بوم سیاه 800x600 قرار داده می‌شود. .TP .B "-file \fI"\fP \fRنوشتن تصویر تفاضلی نشانه‌گذاری‌شده در فایل اگر \fB-file\fP تعیین شده باشد، یک تصویر تفاضلی نشانه‌گذاری‌شده تولید شده و در فایل مشخص‌شده ذخیره می‌شود. پیکسل‌هایی که میان تصاویر \fBreference\fP و \fBcompare\fP متفاوت هستند، در تصویر \fBcompare\fP اصلاح می‌شوند تا تغییرات واضح‌تر به چشم بیایند. ممکن است در برخی تصاویر پیش از آشکار شدن تغییرات، نیاز به استفاده از یک سبک برجسته‌سازی دیگر (ببینید \fB-highlight-style\fP) یا رنگ برجسته‌سازی دیگر (ببینید \fB-highlight-color\fP) باشد. .TP .B "-fill \fI"\fP \fRرنگ مورد استفاده برای پر کردن یک عنصر گرافیکی اولیه تعریف‌های عددی رنگ‌ها در GraphicsMagick مشابه مقادیر رنگی RGB و RGBA است که در SVG و CSS Color Module Level 3 استفاده می‌شوند (). برای مشاهده فهرست نام‌های رنگ از دستور "gm convert -list color" استفاده کنید: .nf 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%) .fi مشخصه رنگ را داخل علامت نقل‌قول قرار دهید تا از تفسیر "#" یا پرانتزها توسط شل جلوگیری شود. برای مثال، .nf gm convert -fill blue ... gm convert -fill "#ddddff" ... gm convert -fill "rgb(65000,65000,65535)" ... .fi حالت‌های کوتاه‌تر، در صورت نیاز با تکرار ارقام به ابعاد بزرگ‌تر بسط داده می‌شوند. برای مثال، مقادیر #3af، #33aaff و #3333aaaaffff همگی معادل یکدیگرند. برای جزئیات بیشتر به \fB-draw\fP مراجعه کنید. .TP .B "-filter \fI"\fP \fRاستفاده از این نوع فیلتر هنگام تغییر اندازه تصویر از این گزینه برای تأثیرگذاری بر عملیات تغییر اندازه تصویر استفاده کنید (ببینید \fB-geometry\fP). از میان فیلترهای زیر انتخاب کنید (به ترتیب تقریبی افزایش زمان مصرف CPU): .nf Point Box Triangle Hermite Hanning Hamming Blackman Gaussian Quadratic Cubic Catrom Mitchell Lanczos Bessel Sinc .fi فیلتر پیش‌فرض به‌صورت خودکار انتخاب می‌شود تا بهترین کیفیت را با صرف زمانی معقول ارائه دهد. اگر تصویر از پالت رنگ یا کانال شفافیت (matte) پشتیبانی کند یا در حال بزرگ‌نمایی باشد، از فیلتر \fBMitchell\fP استفاده می‌شود؛ در غیر این صورت از فیلتر \fBLanczos\fP استفاده خواهد شد. .TP .B "-flatten" \fRمسطح‌سازی (تخت‌کردن) دنباله‌ای از تصاویر در برخی قالب‌های پرونده (مانند PSD فتوشاپ)، ممکن است تصاویر پیچیده توسط «لایه‌ها» (تصاویر مجزا) نمایش داده شوند که برای دستیابی به خروجی نهایی باید با هم ترکیب شوند. گزینه \fB-flatten\fP این ترکیب را به انجام می‌رساند. دنباله تصاویر با یک تصویر تکی که حاصل ترکیب نوبتی هر تصویر با رعایت عملگرهای ترکیب و آفست‌های صفحه است جایگزین می‌شود. اگرچه \fB-flatten\fP در اصل برای حذف لایه‌ها به کار می‌رود، اما به عنوان ابزاری همه‌منظوره برای ترکیب تصاویر نیز سودمند است. دنباله تصاویر با ظاهر شدن هر گزینه‌ای خاتمه می‌یابد. اگر گزینه \fB-flatten\fP پس از تمام تصاویر ورودی آورده شود، همه تصاویر تخت می‌شوند. همچنین گزینه \fB-mosaic\fP را ببینید که مشابه \fB-flatten\fP عمل می‌کند اما یک تصویر بوم پایه با اندازه مناسب نیز به آن اضافه می‌نماید. برای مثال، این دستور یک تصویر را روی یک بوم سیاه شفاف با اندازه 640x400 ترکیب می‌کند: .nf gm convert -size 640x300 xc:transparent \\ -compose over -page +0-100 \\ frame.png -flatten output.png .fi و این دستور یک پرونده فتوشاپ PSD را مسطح می‌کند: .nf gm convert input.psd -flatten output.png .fi .TP .B "-flip" \fRایجاد «تصویر آینه‌ای» وارونه کردن خطوط پویش (scanlines) در راستای عمودی. .TP .B "-flop" \fRایجاد «تصویر آینه‌ای» وارونه کردن خطوط پویش (scanlines) در راستای افقی. .TP .B "-font \fI"\fP \fRاستفاده از این قلم هنگام نوشتن متن روی تصویر می‌توانید نوع قلم را مشخص کنید تا تعیین شود از نوع PostScript، TrueType، یا X11 است. برای مثال، Arial.ttf یک قلم TrueType،‏ ps:helvetica یک قلم PostScript، و x:fixed یک قلم X11 است. .TP .B "-foreground \fI"\fP \fRتعیین رنگ پیش‌زمینه رنگ با قالبی که تحت گزینه \fB-fill\fP شرح داده شده است، تعیین می‌شود..TP .B "-format \fI"\fP \fRنوع قالب تصویر هنگامی که با ابزار \fBmogrify\fP استفاده می‌شود، این گزینه هر تصویری را به قالب تصویر مشخص‌شده تبدیل خواهد کرد. برای دیدن فهرستی از انواع قالب‌های تصویر پشتیبانی‌شده توسط \fBGraphicsMagick\fP، به \fIGraphicsMagick(1)\fP مراجعه کنید یا خروجی 'gm -list format' را بررسی نمایید. به‌طور پیش‌فرض فایل با نام اصلی خود نوشته می‌شود. با این حال، اگر پسوند نام فایل با یک قالب پشتیبانی‌شده مطابقت داشته باشد، پسوند با نوع قالب تصویر مشخص‌شده با \fB-format\fP جایگزین می‌شود. برای مثال، اگر \fItiff\fP را به عنوان نوع قالب مشخص کنید و نام فایل تصویر ورودی \fIimage.gif\fP باشد، نام فایل تصویر خروجی به \fIimage.tiff\fP تبدیل می‌شود. .TP .B "-format \fI"\fP \fRویژگی‌های قالب‌بندی‌شده تصویر در خروجی هنگامی که با ابزار \fBidentify\fP یا ابزار \fBconvert\fP (با خروجی نوشته‌شده در مشخصه فایل 'info:-') استفاده می‌شود، از این گزینه برای چاپ اطلاعات تصویر در قالبی به انتخاب خود استفاده کنید. می‌توانید با قرار دادن نویسه‌های قالب‌بندی ویژه، مواردی چون نام فایل تصویر، نوع، عرض، ارتفاع، داده‌های Exif یا سایر ویژگی‌های تصویر را در خروجی بگنجانید: .nf %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) %% % .fi برای مثال، .nf -format "%m:%f %wx%h" .fi برای تصویری با نام \fBbird.miff\fP که عرض آن 512 و ارتفاع آن 480 است، مقدار \fBMIFF:bird.miff 512x480\fP را نمایش می‌دهد. اگر نخستین نویسه از \fIstring\fP برابر \fB@\fP باشد، قالب از فایلی خوانده می‌شود که نام آن توسط نویسه‌های باقی‌مانده در رشته تعیین می‌گردد. لطفاً توجه داشته باشید که اگر رشته از یک منبع غیرقابل‌اعتماد باشد، باید پیش از استفاده پاک‌سازی (sanitize) شود، چرا که ممکن است برای گنجاندن هر فایل قابل خواندنی روی سیستم مورد سوءاستفاده قرار گیرد (یک خطر امنیتی). مقادیری از نوع تصویر (\fB%r\fP) که ممکن است بازگردانده شوند شامل موارد زیر است: .nf Bilevel Grayscale GrayscaleMatte Palette PaletteMatte TrueColor TrueColorMatte ColorSeparation ColorSeparationMatte Optimize .fi همچنین می‌توانید از نحو قالب‌بندی ویژه زیر برای چاپ اطلاعات Exif موجود در فایل استفاده کنید: .nf %[EXIF:] .fi که در آن «» می‌تواند یکی از موارد زیر باشد: .nf * (چاپ تمام برچسب‌های 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 .fi اطلاعات ویژه JPEG (حاصل از خواندن یک فایل JPEG) را می‌توان به این صورت به دست آورد: .nf %[JPEG-] .fi که در آن «» می‌تواند یکی از موارد زیر باشد: .nf * (تمام برچسب‌های مرتبط با JPEG، در قالب keyword=data) Quality تخمین «کیفیت» IJG JPEG Colorspace شناسه عددی فضای رنگ JPEG Colorspace-Name نام فضای رنگ JPEG Sampling-factors عوامل نمونه‌برداری JPEG .fi لطفاً توجه داشته باشید که JPEG هیچ مفهومی از «کیفیت» ندارد و معیار کیفیتی که توسط نرم‌افزار استفاده و تخمین زده می‌شود، بر اساس معیار کیفیت تعیین‌شده توسط IJG JPEG 6b است. سایر رمزگذارها (مانند رمزگذار استفاده‌شده در Adobe Photoshop) از معیارهای کدگذاری متفاوتی استفاده می‌کنند. مشخصه قالب را داخل علامت نقل‌قول قرار دهید تا پوسته (shell) شما فاصله‌ها و قلاب‌ها را به اشتباه تفسیر نکند..TP .B "-frame \fIx++"\fP \fRاحاطه کردن تصویر با یک کادر تزئینی برای جزئیات مربوط به مشخصات هندسه (geometry)، به \fB-geometry\fP مراجعه کنید. گزینهٔ \fB-frame\fP تحت تأثیر گزینهٔ \fB-gravity\fP قرار نمی‌گیرد. رنگ حاشیه با گزینهٔ خط فرمان \fB-mattecolor\fP مشخص می‌شود. .TP .B "-frame" \fRگنجاندن قاب پنجرهٔ X در تصویر واردشده .TP .B "-fuzz \fI{%}"\fP \fRرنگ‌های درون این فاصلهٔ اقلیدسی، یکسان در نظر گرفته می‌شوند تعدادی از الگوریتم‌ها به دنبال یک رنگ هدف می‌گردند. به‌طور پیش‌فرض رنگ باید دقیقاً یکسان باشد. از این گزینه برای مطابقت دادن رنگ‌هایی استفاده کنید که در فضای سه‌بعدی RGB به رنگ هدف نزدیک هستند (بر حسب فاصلهٔ اقلیدسی). برای مثال، اگر می‌خواهید با \fB-trim\fP لبه‌های یک تصویر را به‌طور خودکار برش بزنید، اما تصویر اسکن شده است و رنگ پس‌زمینهٔ هدف ممکن است تفاوت اندکی داشته باشد، این گزینه می‌تواند چنین تفاوت‌هایی را به حساب آورد. مقدار \fIdistance\fP می‌تواند در واحدهای شدت مطلق یا با افزودن \fI"%"\fP، به صورت درصدی از حداکثر شدت ممکن (۲۵۵، ۶۵۵۳۵، یا ۴۲۹۴۹۶۷۲۹۵) باشد. .TP .B "-gamma \fI"\fP \fRمیزان تصحیح گاما یک تصویر رنگی یکسان ممکن است هنگام نمایش در دو ایستگاه کاری مختلف، به دلیل تفاوت در مانیتور نمایشگر، متفاوت به نظر برسد. از تصحیح گاما برای تنظیم این اختلاف رنگ استفاده کنید. مقادیر معقول از \fB0.8\fP تا \fB2.3\fP هستند. گامای کمتر از 1.0 تصویر را تیره‌تر و گامای بزرگ‌تر از 1.0 آن را روشن‌تر می‌کند. تنظیمات بزرگ در گامای تصویر ممکن است در صورتی که اندازهٔ کوانتوم پیکسل تنها هشت بیت باشد (محدودهٔ کوانتوم 0 تا 255)، منجر به از دست رفتن بخشی از اطلاعات تصویر شود. می‌توانید مقادیر گامای جداگانه‌ای را برای کانال‌های قرمز، سبز و آبی تصویر با فهرستی از مقادیر گاما که با اسلش از هم جدا شده‌اند اعمال کنید (مانند \fB1.7\fP/\fB2.3\fP/\fB1.2\fP). از \fB+gamma\fP \fIvalue\fP برای تنظیم سطح گامای تصویر بدون دستکاری واقعی پیکسل‌های تصویر استفاده کنید. این گزینه زمانی مفید است که تصویر دارای گامای مشخصی باشد اما به عنوان یک صفت تصویر ثبت نشده باشد (مانند تصاویر PNG). .TP .B "-gaussian \fI{x}"\fP \fRتار کردن تصویر با عملگر گاوسی از شعاع و انحراف معیار (سیگما) داده‌شده استفاده می‌کند. .TP .B "-geometry \fIx{+-}{+-}{%}{@}{!}{^}{<}{>}"\fP \fRمشخص کردن ابعاد، آفست و گزینه‌های تغییر اندازه. گزینهٔ \fB-geometry\fP بسته به ابزاری که همراه آن استفاده می‌شود، برای اهداف مختلفی به کار می‌رود. برای دستورهای X11 (مانند 'animate'، 'display' و 'import')، اندازه و مکان ترجیحی پنجرهٔ تصویر را مشخص می‌کند. به‌طور پیش‌فرض، اندازهٔ پنجره همان اندازهٔ تصویر است و مکان آن هنگام نگاشت پنجره توسط شما (یا مدیر پنجره‌تان) تعیین می‌شود. برای دستورهای ابزاری 'import'، 'convert' و 'mogrify' ممکن است برای مشخص کردن اندازهٔ دلخواه هنگام تغییر اندازهٔ تصویر به کار رود. در این حالت، نمادهایی که معرف گزینه‌های تغییر اندازه هستند را می‌توان به رشتهٔ هندسه الحاق کرد تا بر نحوهٔ برخورد با درخواست تغییر اندازه اثر بگذارند. یادداشت‌های بعدی متناظر با کاربرد در هر دستور خاص را ببینید. یادداشت‌های زیر مربوط به زمانی است که \fB-geometry\fP برای بیان یک درخواست تغییر اندازه، با در نظر گرفتن ویژگی‌های کنونی تصویر به کار می‌رود. به‌طور پیش‌فرض، عرض و ارتفاع مقادیر حداکثری هستند؛ یعنی تصویر به گونه‌ای بزرگ یا کوچک می‌شود تا با حفظ نسبت ابعاد (aspect ratio) تصویر، در مقادیر عرض و ارتفاع بگنجد. یک ^ را به انتهای هندسه الحاق کنید تا نسبت ابعاد تصویر هنگام تغییر اندازه حفظ شود، اما عرض یا ارتفاع حاصل‌شده به جای مقادیر بیشینه، به عنوان مقادیر کمینه در نظر گرفته شوند. یک ! (علامت تعجب) را به هندسه الحاق کنید تا اندازهٔ تصویر دقیقاً به همان اندازه‌ای که مشخص کرده‌اید تحمیل شود. برای مثال، اگر 640x480! را تعیین کنید، عرض تصویر روی ۶۴۰ پیکسل و ارتفاع روی ۴۸۰ تنظیم می‌شود و در صورت لزوم نسبت ابعاد تصویر تغییر می‌یابد. اگر فقط عرض مشخص شود، بدون 'x' پایانی، ارتفاع برابر با عرض تنظیم می‌شود (برای مثال، -geometry 100 همانند -geometry 100x100 است). اگر فقط عرض مشخص شود اما همراه با 'x' پایانی باشد، عرض مقدار تعیین‌شده را می‌گیرد و ارتفاع به منظور حفظ نسبت ابعاد تصویر انتخاب می‌شود. به همین ترتیب، اگر فقط ارتفاع با پیشوند 'x' مشخص شود (مانند -geometry x256)، عرض به گونه‌ای انتخاب می‌شود که نسبت ابعاد حفظ شود. برای تعیین درصدی عرض یا ارتفاع به جای آن، علامت % را الحاق کنید. اندازهٔ تصویر در درصدهای عرض و ارتفاع ضرب می‌شود تا ابعاد نهایی تصویر به دست آید. برای افزایش اندازهٔ تصویر، از مقداری بیشتر از ۱۰۰ استفاده کنید (مانند 125%). برای کاهش اندازهٔ تصویر، از درصدی کمتر از ۱۰۰ استفاده کنید. از @ برای تعیین حداکثر مساحت تصویر بر حسب پیکسل استفاده کنید. از > برای تغییر ابعاد تصویر \fIتنها\fP در صورتی که عرض یا ارتفاع آن از مشخصات هندسه بیشتر باشد، استفاده کنید. علامت < تصویر را \fIتنها\fP در صورتی تغییر اندازه می‌دهد که هر دو بعد آن از مشخصات هندسه کمتر باشند. برای مثال، اگر '640x480>' را مشخص کنید و اندازهٔ تصویر 256x256 باشد، اندازهٔ تصویر تغییر نمی‌کند. اما اگر اندازهٔ تصویر 512x512 یا 1024x1024 باشد، اندازهٔ آن به 480x480 تغییر می‌یابد. مشخصات هندسه را درون گیومه قرار دهید تا از تفسیر شدن < یا > به عنوان هدایت مجدد فایل (redirection) توسط شل جلوگیری شود. هنگامی که با \fIanimate\fP و \fIdisplay\fP استفاده می‌شود، آفست‌ها به همان شیوه‌ای که در \fIX(1)\fP آمده مدیریت می‌شوند و گزینهٔ \fB-gravity\fP به کار نمی‌رود. اگر \fIx\fP منفی باشد، آفست به سمت چپ و از لبهٔ راست صفحه تا لبهٔ راست تصویرِ در حال نمایش اندازه‌گیری می‌شود. به همین ترتیب، \fIy\fP منفی بین لبه‌های پایینی اندازه‌گیری می‌شود. آفست‌ها تحت تأثیر "%" قرار نمی‌گیرند؛ آن‌ها همیشه بر حسب پیکسل سنجیده می‌شوند. هنگامی که به عنوان یک گزینهٔ \fIcomposite\fP استفاده می‌شود، \fB-geometry\fP ابعاد تصویر و موقعیت آن را نسبت به تصویر ترکیبی نشان می‌دهد. اگر گزینهٔ \fB-gravity\fP همراه با جهت‌گیری‌های \fINorthEast، East\fP یا \fISouthEast\fP باشد، \fIx\fP بیانگر فاصله از لبهٔ راست تصویر تا لبهٔ راست تصویر ترکیبی است. به همین ترتیب، اگر گزینهٔ \fB-gravity\fP همراه با جهت‌گیری‌های \fISouthWest، South\fP یا \fISouthEast\fP باشد، \fIy\fP بین لبه‌های پایینی اندازه‌گیری می‌شود. در نتیجه، یک آفست مثبت هرگز به جهتی بیرون از تصویر اشاره نخواهد کرد. آفست‌ها تحت تأثیر "%" قرار نمی‌گیرند؛ آن‌ها همواره بر حسب پیکسل اندازه‌گیری می‌شوند. برای مشخص کردن ابعاد تصویر ترکیبی، از گزینهٔ \fB-resize\fP استفاده کنید. هنگامی که به عنوان گزینه‌ای برای \fIconvert\fP، \fIimport\fP یا \fImogrify\fP استفاده می‌شود، \fB-geometry\fP مترادف با \fB-resize\fP است و اندازهٔ تصویر خروجی را تعیین می‌کند. آفست‌ها در صورت وجود، نادیده گرفته می‌شوند. هنگامی که به عنوان گزینه‌ای برای \fImontage\fP استفاده می‌شود، \fB-geometry\fP اندازهٔ تصویر و اندازهٔ حاشیه را برای هر کاشی (tile) مشخص می‌کند؛ مقدار پیش‌فرض 256x256+0+0 است. آفست‌های منفی (ابعاد حاشیه) بی‌معنی هستند. گزینهٔ \fB-gravity\fP بر جای‌گیری تصویر در درون کاشی تأثیر می‌گذارد؛ جهت‌گیری پیش‌فرض برای این منظور \fICenter\fP است. اگر علامت "%" در مشخصات هندسه بیاید، اندازهٔ کاشی برابر با درصد مشخص‌شده از ابعاد اولیهٔ اولین کاشی خواهد بود. برای مشخص کردن ابعاد مونتاژ، از گزینهٔ \fB-resize\fP استفاده کنید. .TP .B "-gravity \fI"\fP \fRجهتی که عنصر اولیه هنگام حاشیه‌نویسی تصویر به سمت آن متمایل می‌شود. گزینه‌ها عبارتند از: NorthWest، North، NorthEast، West، Center، East، SouthWest، South، SouthEast. جهتی که انتخاب می‌کنید مشخص می‌کند که هنگام حاشیه‌نویسی، متن در کجای تصویر قرار گیرد. برای مثال، جهت‌گیری \fICenter\fP متن را مجبور می‌کند تا در مرکز تصویر قرار گیرد. به‌طور پیش‌فرض، جهت‌گیری تصویر \fINorthWest\fP است. برای جزئیات بیشتر دربارهٔ عناصر ترسیمی، به \fB-draw\fP مراجعه کنید. تنها عناصر متنی تحت تأثیر گزینهٔ \fB-gravity\fP قرار می‌گیرند. گزینهٔ \fB-gravity\fP همچنین در هماهنگی با گزینهٔ \fB-geometry\fP و سایر گزینه‌هایی که \fB\fP را به عنوان یک پارامتر می‌پذیرند (مانند گزینهٔ \fB-crop\fP) استفاده می‌شود. برای جزئیات چگونگی تعامل گزینهٔ \fB-gravity\fP با پارامترهای \fB\fP و \fB\fP در مشخصات یک هندسه، به \fB-geometry\fP مراجعه کنید. هنگامی که به عنوان گزینه‌ای برای \fIcomposite\fP استفاده می‌شود، \fB-gravity\fP جهتی را که تصویر درون تصویر ترکیبی به سمت آن متمایل می‌شود نشان می‌دهد. هنگامی که به عنوان گزینه‌ای برای \fImontage\fP استفاده می‌شود، \fB-gravity\fP جهتی را که تصویر درون یک کاشی متمایل می‌شود تعیین می‌کند. جهت‌گیری پیش‌فرض برای این منظور \fICenter\fP است. .TP .B "-green-primary \fI,"\fP \fRنقطهٔ اصلی رنگینگی سبز .TP .B "-hald-clut \fI"\fP \fRاعمال یک 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 همانی از طریق کدگذار \fBIDENTITY\fP است. برای مثال، خواندن از نام فایل \fPIDENTITY:8\fP یک CLUT همانی با مرتبهٔ ۸ بازمی‌گرداند. تصاویر همانی Hald CLUT معمولاً مرتبه‌ای بین ۸ و ۱۶ دارند. مرتبهٔ پیش‌فرض برای تولیدکنندهٔ CLUT با کدگذار \fBIDENTITY\fP مقدار ۸ است. از درون‌یابی (interpolation) استفاده می‌شود، بنابراین معمولاً نیازی نیست که تصاویر CLUT بسیار بزرگ باشند. قالب پرونده‌ای PNG برای ذخیرهٔ تصاویر Hald CLUT ایدئال است زیرا آن‌ها را بسیار خوب فشرده می‌کند..TP .B "-help" \fRچاپ دستورالعمل‌های نحوه استفاده .TP .B "-highlight-color \fI"\fP \fRرنگ نشانه‌گذاری پیکسل‌ها رنگ مورد استفاده برای نشانه‌گذاری پیکسل‌های تفاوت را مشخص می‌کند. .TP .B "-highlight-style \fI