نام (NAME)

magick-script - زبان اسکریپت‌نویسی برای تبدیل میان قالب‌های تصویری و همچنین تغییر اندازه تصویر، مات‌سازی، برش، حذف نویز، ترام‌ریزی (dither)، رسم، قرینه‌سازی، پیوند، نمونه‌برداری مجدد و موارد دیگر.

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

magick-script [input-options] input-file [output-options] output-file

نمای کلی (OVERVIEW)

برنامه magick-script عضوی از مجموعه ابزارهای ImageMagick(1) است. از آن برای تبدیل بین قالب‌های تصویری و همچنین تغییر اندازه تصویر، مات‌سازی، برش، حذف نویز، ترام‌ریزی، رسم روی تصویر، قرینه‌سازی، اتصال، نمونه‌برداری مجدد و بسیاری موارد دیگر استفاده می‌شود. در اینجا یک نمونه اسکریپت آورده شده است:

#!/bin/env magick-script
-size 100x100 xc:red ( rose: -rotate -90 ) +append -write show:

برای اطلاعات بیشتر درباره دستور magick-script، مرورگر خود را به نشانی file:///usr/share/doc/ImageMagick-7/www/magick-script.html یا https://imagemagick.org/script/magick-script.php هدایت کنید.

توضیحات (DESCRIPTION)

تنظیمات تصویر:
-adjoin اتصال تصاویر در یک فایل چندتصویری واحد
-affine matrix ماتریس تبدیل آفین
-antialias حذف پله‌پله‌شدگی پیکسل‌ها (aliasing)
-authenticate value رمزگشایی تصویر با این گذرواژه
-background color رنگ پس‌زمینه
-bias value افزودن مقدار بایاس هنگام کانولوشن تصویر
-black-point-compensation
استفاده از جبران‌سازی نقطه سیاه
-blue-primary point نقطه فام‌داری آبی اولیه
-bordercolor color رنگ حاشیه
-caption string اختصاص یک بالانویس یا زیرنویس به تصویر
-cdl filename تصحیح رنگ با فهرست تصمیم رنگ (CDL)
-colors value تعداد ترجیحی رنگ‌ها در تصویر
-colorspace type فضای رنگی جایگزین تصویر
-comment string افزودن یادداشت به تصویر
-compose operator تنظیم عملگر ترکیب‌بندی تصویر
-compress type نوع فشرده‌سازی پیکسل هنگام نوشتن تصویر
-decipher filename تبدیل پیکسل‌های رمزنگاری‌شده magick به پیکسل‌های عادی
-define format:option
تعریف یک یا چند گزینه برای قالب تصویر
-delay centiseconds نمایش تصویر بعدی پس از مکث مشخص (صدم ثانیه)
-density geometry چگالی افقی و عمودی تصویر
-depth value عمق تصویر
-direction type رندر متن از راست‌به‌چپ یا از چپ‌به‌راست
-display server دریافت تصویر یا قلم از این کارساز X
-dispose method روش بازیافت لایه
-dither method اعمال انتشار خطا (ترام‌ریزی) بر تصویر
-encipher filename تبدیل پیکسل‌های عادی به پیکسل‌های رمزنگاری‌شده magick
-encoding type نوع کدگذاری متن
-endian type ترتیب بایت (MSB یا LSB) تصویر
-family name رندر متن با این خانواده قلم
-fill color رنگ مورد استفاده برای پر کردن شکل‌های اولیه گرافیکی
-filter type استفاده از این فیلتر هنگام تغییر اندازه تصویر
-flatten تخت کردن یا ادغام یک توالی از تصاویر
-font name رندر متن با این قلم
-format "string" خروجی مشخصات قالب‌بندی‌شده تصویر
-fuzz distance رنگ‌های داخل این فاصله یکسان در نظر گرفته می‌شوند
-gravity type موقعیت‌دهی افقی و عمودی متن
-green-primary point نقطه فام‌داری سبز اولیه
-intent type نوع هدف بازتولید رنگ هنگام مدیریت رنگ تصویر
-interlace type نوع طرح درهم‌بافی (interlacing) تصویر
-interpolate method روش درون‌یابی رنگ پیکسل
-kerning value تنظیم فاصله میان دو نویسه
-label string اختصاص یک برچسب به تصویر
-limit type value محدودیت منبع حافظه نهان پیکسل
-loop iterations افزودن افزونه حلقه Netscape به پویانمایی GIF
-mask filename مرتبط ساختن یک ماسک با تصویر
-matte ذخیره کانال مات در صورت وجود در تصویر
-mattecolor color رنگ قاب
-monitor پایش پیشرفت
-orient type جهت‌گیری تصویر
-origin geometry مبدأ تصویر
-page geometry اندازه و موقعیت بوم تصویر (تنظیم)
-ping تعیین کارآمد مشخصات تصویر
-pointsize value اندازه قلم برحسب پوینت
-preview type نوع پیش‌نمایش تصویر
-quality value سطح فشرده‌سازی JPEG/MIFF/PNG
-quiet فرونشاندن تمام پیام‌های هشدار
-red-primary point نقطه فام‌داری قرمز اولیه
-regard-warnings توجه به پیام‌های هشدار
-repage geometry اندازه و موقعیت بوم تصویر
-sampling-factor geometry
ضریب نمونه‌برداری افقی و عمودی
-scene value شماره صحنه تصویر
-seed value مقداردهی اولیه به دنباله اعداد شبه‌تصادفی جدید
-size geometry عرض و ارتفاع تصویر
-statistic type geometry
جایگزینی هر پیکسل با آماره مربوطه از همسایگی آن
-stretch type رندر متن با این کشیدگی قلم
-stroke color رنگ خط دور اشکال اولیه گرافیکی
-strokewidth value عرض خط دور اشکال اولیه گرافیکی
-style type رندر متن با این سبک قلم
-support factor پشتیبانی از تغییر اندازه: > 1.0 مات، < 1.0 شارپ
-synchronize همگام‌سازی تصویر با دستگاه ذخیره‌سازی
-taint علامت‌گذاری تصویر به عنوان تغییریافته
-texture filename نام بافت جهت کاشی‌کاری در پس‌زمینه تصویر
-tile-offset geometry
آفست کاشی‌کاری
-treedepth value عمق درخت رنگ
-transparent-color color
رنگ شفاف
-undercolor color رنگ کادر پس‌زمینه حاشیه‌نویسی
-units type واحدهای تفکیک‌پذیری تصویر
-verbose چاپ اطلاعات دقیق درباره تصویر
-view تبدیلات نمایشی FlashPix
-virtual-pixel method
روش دسترسی به پیکسل مجازی
-weight type رندر متن با این وزن (ضخامت) قلم
-white-point point نقطه سفید فام‌داری

عملگرهای تصویر:
-adaptive-blur geometry
مات کردن انطباقی پیکسل‌ها؛ کاهش اثر در نزدیکی لبه‌ها
-adaptive-resize geometry
تغییر اندازه انطباقی تصویر با مثلث‌بندی وابسته به داده
-adaptive-sharpen geometry
شارپ کردن انطباقی پیکسل‌ها؛ افزایش اثر در نزدیکی لبه‌ها
-annotate geometry text
حاشیه‌نویسی متن روی تصویر
-auto-orient جهت‌دهی خودکار تصویر
-black-threshold value
تبدیل اجباری تمام پیکسل‌های زیر آستانه به رنگ سیاه
-blur geometry کاهش نویز تصویر و کاهش سطح جزئیات
-border geometry احاطه تصویر با یک کادر رنگی
-channel mask تنظیم ماسک کانال تصویر
-charcoal radius شبیه‌سازی نقاشی با زغال
-chop geometry حذف پیکسل‌ها از بخش‌های درونی تصویر
-clip برش در امتداد نخستین مسیر از پروفایل 8BIM
-clip-mask filename مرتبط ساختن یک ماسک برش با تصویر
-clip-path id برش در امتداد یک مسیر نام‌گذاری‌شده از پروفایل 8BIM
-colorize value رنگ‌آمیزی تصویر با رنگ پرکننده
-color-matrix matrix اعمال ماتریس تصحیح رنگ بر تصویر
-contrast افزایش یا کاهش کنتراست تصویر
-contrast-stretch geometry
بهبود کنتراست با «کشش» دامنه شدت روشنایی
-convolve coefficients
اعمال هسته کانولوشن روی تصویر
-cycle amount چرخش نقشه رنگ تصویر
-despeckle کاهش لکه‌ها و دانه‌های نویز در تصویر
-draw string رسم یک شکل اولیه گرافیکی روی تصویر
-edge radius اعمال فیلتر برای تشخیص لبه‌ها در تصویر
-emboss radius برجسته‌سازی تصویر
-enhance اعمال فیلتر دیجیتال برای بهبود تصویر نویزدار
-equalize انجام یکسان‌سازی هیستوگرام بر روی تصویر
-evaluate operator value
ارزیابی یک عبارت حسابی، رابطه‌ای یا منطقی
-extent geometry تنظیم اندازه تصویر
-extract geometry استخراج ناحیه‌ای از تصویر
-fft پیاده‌سازی تبدیل فوریه گسسته (DFT)
-flip معکوس کردن عمودی تصویر
-floodfill geometry color
رنگ‌آمیزی یکپارچه ناحیه هم‌رنگ در تصویر
-flop معکوس کردن افقی تصویر
-frame geometry احاطه تصویر با یک قاب تزئینی
-function name اعمال یک تابع روی تصویر
-gamma value میزان تصحیح گاما
-gaussian-blur geometry
کاهش نویز تصویر و کاهش سطح جزئیات با فیلتر گاوسی
-geometry geometry اندازه یا مکان ترجیحی تصویر
-identify تشخیص قالب و مشخصات تصویر
-ift پیاده‌سازی معکوس تبدیل فوریه گسسته (DFT)
-implode amount فشردن و کشیدن پیکسل‌های تصویر حول مرکز
-lat geometry آستانه‌گذاری انطباقی محلی
-layers method بهینه‌سازی یا مقایسه لایه‌های تصویر
-level value تنظیم سطح کنتراست تصویر
-linear-stretch geometry
بهبود کنتراست با «کشش همراه با اشباع» در دامنه شدت روشنایی
-median geometry اعمال فیلتر میانه بر تصویر
-mode geometry تبدیل هر پیکسل به «رنگ غالب» همسایگی آن
-modulate value تغییر روشنایی، اشباع و رنگ‌مایه
-monochrome تبدیل تصویر به سیاه و سفید خالص
-morphology method kernel
اعمال یک روش ریخت‌شناسی (مورفولوژی) روی تصویر
-motion-blur geometry
شبیه‌سازی تاری حرکتی
-negate جایگزینی هر پیکسل با رنگ مکمل آن
-noise geometry افزودن یا کاهش نویز در تصویر
-normalize تبدیل تصویر جهت گسترش در کل دامنه رنگ‌ها
-opaque color تغییر این رنگ به رنگ پرکننده
-ordered-dither NxN
افزودن الگوی نویز با دامنه‌های مشخص به تصویر
-paint radius شبیه‌سازی نقاشی رنگ روغن
-polaroid angle شبیه‌سازی عکس پولاروید
-posterize levels کاهش تصویر به تعداد محدودی از سطوح رنگی
-print string تفسیر رشته و چاپ در کنسول
-profile filename افزودن، حذف یا اعمال یک پروفایل تصویر
-quantize colorspace کاهش رنگ‌ها در این فضای رنگی
-radial-blur angle مات‌سازی شعاعی تصویر
-raise value روشن یا تیره کردن لبه‌های تصویر برای ایجاد جلوه سه‌بعدی
-random-threshold low,high
آستانه‌گذاری تصادفی تصویر
-range-threshold values
اعمال آستانه‌گذاری نرم یا سخت درون محدوده‌ای از مقادیر در تصویر
-region geometry اعمال گزینه‌ها به بخشی از تصویر
-render رندر گرافیک‌های برداری
-resample geometry تغییر تفکیک‌پذیری تصویر
-resize geometry تغییر اندازه تصویر
-roll geometry پیمایش چرخشی تصویر به صورت عمودی یا افقی
-rotate degrees اعمال چرخش Paeth روی تصویر
-sample geometry مقیاس‌بندی تصویر با نمونه‌برداری پیکسلی
-scale geometry مقیاس‌بندی تصویر
-segment values قطعه‌بندی تصویر
-selective-blur geometry
مات‌سازی انتخابی پیکسل‌ها درون یک آستانه کنتراست
-sepia-tone threshold
شبیه‌سازی عکس به رنگ قهوه‌ای سپیا
-set property value تنظیم مشخصه تصویر
-shade degrees سایه‌زنی تصویر با استفاده از یک منبع نور دوردست
-shadow geometry شبیه‌سازی سایه تصویر
-sharpen geometry شارپ کردن تصویر
-shave geometry تراشیدن پیکسل‌ها از لبه‌های تصویر
-shear geometry لغزاندن یک لبه تصویر در امتداد محور X یا Y
-sigmoidal-contrast geometry
مقیاس‌بندی مجدد روشنایی با بهبود کنتراست سیگموئیدی
-sketch geometry شبیه‌سازی طرح با مداد
-solarize threshold مکمل کردن تمام پیکسل‌های بالاتر از سطح آستانه
-splice geometry پیوند زدن رنگ پس‌زمینه درون تصویر
-spread amount جابه‌جایی پیکسل‌های تصویر به مقداری تصادفی
-strip پاک‌سازی تمام پروفایل‌ها و یادداشت‌ها از تصویر
-swirl degrees پیچش گردابی پیکسل‌های تصویر حول مرکز
-threshold value اعمال آستانه‌گذاری بر روی تصویر
-thumbnail geometry ایجاد تصویر بندانگشتی از تصویر
-tile filename کاشی‌کاری تصویر هنگام پر کردن شکل اولیه گرافیکی
-tint value رنگ‌آمیزی ملایم تصویر با رنگ پرکننده
-transform تبدیل آفین تصویر
-transparent color شفاف کردن این رنگ درون تصویر
-transpose معکوس کردن عمودی تصویر و چرخش ۹۰ درجه
-transverse معکوس کردن افقی تصویر و چرخش ۲۷۰ درجه
-trim بریدن لبه‌های زاید تصویر
-type type نوع تصویر
-unique-colors حذف رنگ‌های تکراری پیکسل‌ها به جز یک نمونه
-unsharp geometry شارپ کردن تصویر
-vignette geometry نرم کردن لبه‌های تصویر به شیوه وینیِت
-wave geometry تغییر شکل تصویر در امتداد موج سینوسی
-white-threshold value
تبدیل اجباری تمام پیکسل‌های بالاتر از آستانه به رنگ سفید

عملگرهای کانال تصویر:
-channel-extract channel-list
استخراج کانال‌ها به ترتیب
-channel-inject channel-list
تزریق کانال‌ها به ترتیب
-channel-swap channel,channel
جابه‌جایی کانال‌ها با یکدیگر

عملگرهای توالی تصویر:
-affinity filename تبدیل رنگ‌های تصویر جهت تطابق با این مجموعه رنگ
-append الصاق توالی تصاویر از بالا به پایین (برای چپ به راست از +append استفاده کنید)
-clut اعمال جدول جستجوی رنگ بر تصویر
-coalesce ادغام یک توالی از تصاویر
-combine ترکیب یک توالی از تصاویر
-composite تصویر ترکیبی
-crop geometry برش یک ناحیه مستطیلی از تصویر
-deconstruct تجزیه یک توالی تصویر به اجزای سازنده
-evaluate-sequence operator
ارزیابی یک عبارت حسابی، رابطه‌ای یا منطقی
-flatten تخت کردن یک توالی از تصاویر
-fx expression اعمال عبارت ریاضی بر کانال(های) تصویر
-hald-clut اعمال جدول جستجوی رنگ Hald بر تصویر
-morph value دگرریسی (مورف) یک توالی از تصاویر
-mosaic ایجاد موزاییک از توالی تصاویر
-process arguments پردازش تصویر با یک فیلتر سفارشی
-separate تفکیک یک کانال تصویر به تصویر در مقیاس خاکستری
-smush geometry چسباندن توالی تصاویر به یکدیگر
-write filename نوشتن تصاویر در این فایل

عملگرهای پشته تصویر:
-clone indexes کلون کردن یک تصویر
-delete indexes حذف تصویر از توالی تصاویر
-duplicate count,indexes
تکثیر یک تصویر به تعداد یک یا چند بار
-insert index درج آخرین تصویر در توالی تصاویر
-swap indexes جابه‌جایی دو تصویر در توالی تصاویر

گزینه‌های متفرقه:
-debug events نمایش اطلاعات اشکال‌زدایی با جزئیات کامل
-help چاپ گزینه‌های برنامه
-log format قالب اطلاعات اشکال‌زدایی
-list type چاپ فهرستی از آرگومان‌های پشتیبانی‌شده گزینه
-version چاپ اطلاعات نسخه

از هر تنظیم یا عملگری می‌توان به عنوان output-option استفاده کرد. تنها تعداد محدودی از تنظیمات input-option هستند که عبارتند از: -antialias، -caption، -density، -define، -encoding، -font، -pointsize، -size و -texture و همچنین هر یک از گزینه‌های متفرقه.

به طور پیش‌فرض، قالب تصویر «file» بر اساس عدد جادویی (magic number) آن تعیین می‌شود. برای مشخص کردن یک قالب تصویر خاص، نام قالب را به همراه یک دونقطه پیش از نام فایل قرار دهید (مانند ps:image) یا نوع تصویر را به عنوان پسوند نام فایل مشخص کنید (مانند image.ps). برای ورودی یا خروجی استاندارد، «file» را برابر «-» قرار دهید.

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

ImageMagick(1)

کپی‌رایت و تکثیر (COPYRIGHT)