magick(1)

hey bestie 💖 welcome to the magick(1) page from the General Commands Manual. this is the main-character tool from the ImageMagick(1) suite, and she does. so. much. no cap. ✨

---

🌸 NAME 🌸

magick — convert between image formats as well as resize an image, blur, crop, despeckle, dither, draw on, flip, join, re-sample, and much more.

okay so that's already a lot of verbs. she's booked and busy. 💅

---

🦋 SYNOPSIS 🦋

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

---

💖 OVERVIEW 💖

The magick program is a member of the ImageMagick(1) suite of tools. Use it to convert between image formats as well as resize an image, blur, crop, despeckle, dither, draw on, flip, join, re-sample, and much more.

For more information about the magick command, point your browser to file:///usr/share/doc/ImageMagick-7/www/magick.html or https://imagemagick.org/script/magick.php.

bestie, if you need the full tea, those links have it. 🌈

---

🎀 DESCRIPTION 🎀

okay so under DESCRIPTION we have Image Settings, and it's giving giant menu of options. every single one matters, so we're listing them all. no skipping. periodt. 👑

✨ Image Settings ✨

• -adjoin — join images into a single multi-image file 💖
• -affine matrix — affine transform matrix 💅
• -antialias — remove pixel-aliasing 🦋
• -authenticate value — decrypt image with this password 🔐
• -background color — background color 🌸
• -bias value — add bias when convolving an image ✨
• -black-point-compensation — use black point compensation 🖤
• -blue-primary point — chromaticity blue primary point 💙
• -bordercolor color — border color 🎀
• -caption string — assign a caption to an image 💬
• -cdl filename — color correct with a color decision list 🎨
• -colors value — preferred number of colors in the image 🌈
• -colorspace type — alternate image colorspace 🎨
• -comment string — annotate image with comment 💬
• -compose operator — set image composite operator 🧩
• -compress type — type of pixel compression when writing the image 📦
• -decipher filename — magick cipher pixels to plain pixels 🔓
• -define format:option — define one or more image format options 📝
• -delay centiseconds — display the next image after pausing ⏳
• -density geometry — horizontal and vertical density of the image 📐
• -depth value — image depth 🕳️
• -direction type — render text right-to-left or left-to-right ↔️
• -display server — get image or font from this X server 🖥️
• -dispose method — layer disposal method 🗑️
• -dither method — apply error diffusion to image 🌫️
• -encipher filename — magick plain pixels to cipher pixels 🔒
• -encoding type — text encoding type 🔤
• -endian type — endianness (MSB or LSB) of the image 🔄
• -family name — render text with this font family 👨‍👩‍👧‍👦
• -fill color — color to use when filling a graphic primitive 🎨
• -filter type — use this filter when resizing an image 🔍
• -flatten — flatten a sequence of images 🥞
• -font name — render text with this font 🔠
• -format "string" — output formatted image characteristics 📊
• -fuzz distance — colors within this distance are considered equal 🌫️
• -gravity type — horizontal and vertical text placement ⚖️
• -green-primary point — chromaticity green primary point 💚
• -intent type — type of rendering intent when managing the image color 🎯
• -interlace type — type of image interlacing scheme 🧵
• -interpolate method — pixel color interpolation method 🎨
• -kerning value — set the space between two letters 🔤
• -label string — assign a label to an image 🏷️
• -limit type value — pixel cache resource limit 🚦
• -loop iterations — add Netscape loop extension to your GIF animation 🔁
• -mask filename — associate a mask with the image 🎭
• -matte — store matte channel if the image has one 🎞️
• -mattecolor color — frame color 🖼️
• -monitor — monitor progress 📈
• -orient type — image orientation 🧭
• -origin geometry — image origin 📍
• -page geometry — size and location of an image canvas (setting) 📄
• -ping — efficiently determine image attributes 🏓
• -pointsize value — font point size 🔠
• -preview type — image preview type 👀
• -quality value — JPEG/MIFF/PNG compression level 📉
• -quiet — suppress all warning messages 🤫
• -red-primary point — chromaticity red primary point ❤️
• -regard-warnings — pay attention to warning messages ⚠️
• -repage geometry — size and location of an image canvas 📄
• -sampling-factor geometry — horizontal and vertical sampling factor 📊
• -scene value — image scene number 🎬
• -seed value — seed a new sequence of pseudo-random numbers 🎲
• -size geometry — width and height of image 📏
• -statistic type geometry — replace each pixel with corresponding statistic from the neighborhood 📈
• -stretch type — render text with this font stretch ↔️
• -stroke color — graphic primitive stroke color 🖌️
• -strokewidth value — graphic primitive stroke width 🖌️
• -style type — render text with this font style ✍️
• -support factor — resize support: > 1.0 is blurry, < 1.0 is sharp 🔍
• -synchronize — synchronize image to storage device 💾
• -taint — declare the image as modified 🏷️
• -texture filename — name of texture to tile onto the image background 🧱
• -tile-offset geometry — tile offset 🧩
• -treedepth value — color tree depth 🌳
• -transparent-color color — transparent color 👻
• -undercolor color — annotation bounding box color 🟪
• -units type — the units of image resolution 📏
• -verbose — print detailed information about the image 🗣️
• -view — FlashPix viewing transforms 👓
• -virtual-pixel method — virtual pixel access method 👾
• -weight type — render text with this font weight ⚖️
• -white-point point — chromaticity white point 🤍

🌸 Image Operators 🌸

Bestie, this is the main character list right here — every single one of these is an operator you can slap onto your command. Let's go 💅

• -adaptive-blur geometry — blurs pixels but adaptively, meaning the blur effect gets weaker near the edges 🦋
• -adaptive-resize geometry — resizes the image adaptively, using data dependent triangulation ✨
• -adaptive-sharpen geometry — sharpens pixels but adaptively, so the sharpening effect gets stronger near the edges 🔥
• -annotate geometry text — annotates the image with text, iykyk 🎀
• -auto-orient — automatically orients the image, no notes, it just does it 💫
• -bilateral-blur geometry — a non-linear, edge-preserving, and noise-reducing smoothing filter 😌
• -black-threshold value — forces all pixels below the threshold straight into black 🖤
• -blur geometry — reduces image noise and reduces detail levels (yes, both, that's the deal)
• -border geometry — surrounds the image with a border of color 🖼️
• -channel mask — sets the image channel mask
• -charcoal radius — simulates a charcoal drawing 🖤✏️
• -chop geometry — removes pixels from the image interior
• -clip — clips along the first path from the 8BIM profile
• -clip-mask filename — associates a clip mask with the image
• -clip-path id — clips along a named path from the 8BIM profile
• -colorize value — colorizes the image with the fill color 🌈
• -color-matrix matrix — applies color correction to the image
• -contrast — enhances or reduces the image contrast
• -contrast-stretch geometry — improves contrast by `stretching' the intensity range
• -convolve coefficients — applies a convolution kernel to the image
• -cycle amount — cycles the image colormap 🎡
• -despeckle — reduces the speckles within an image ✨
• -draw string — annotates the image with a graphic primitive
• -edge radius — applies a filter to detect edges in the image
• -emboss radius — embosses an image
• -enhance — applies a digital filter to enhance a noisy image
• -equalize — performs histogram equalization to an image
• -evaluate operator value — evaluates an arithmetic, relational, or logical expression 🧮
• -extent geometry — sets the image size
• -extract geometry — extracts an area from the image
• -fft — implements the discrete Fourier transform (DFT) 🌊
• -flip — flips the image vertically
• -floodfill geometry color — floodfills the image with color 🎨
• -flop — flops the image horizontally
• -frame geometry — surrounds the image with an ornamental border 🖼️✨
• -function name — applies a function to the image
• -gamma value — level of gamma correction
• -gaussian-blur geometry — reduces image noise and reduces detail levels
• -geometry geometry — preferred size or location of the image
• -identify — identifies the format and characteristics of the image 🔍
• -ift — implements the inverse discrete Fourier transform (DFT)
• -implode amount — implodes image pixels about the center
• -integral — calculates the sum of values (pixel values) in the image
• -lat geometry — local adaptive thresholding
• -layers method — optimizes or compares image layers
• -level value — adjusts the level of image contrast
• -linear-stretch geometry — improves contrast by `stretching with saturation' the intensity range
• -median geometry — applies a median filter to the image
• -mode geometry — makes each pixel the 'predominant color' of the neighborhood
• -modulate value — varies the brightness, saturation, and hue 🌈
• -monochrome — transforms the image to black and white
• -morphology method kernel — applies a morphology method to the image
• -motion-blur geometry — simulates motion blur 💨
• -negate — replaces each pixel with its complementary color 🔄
• -noise geometry — adds or reduces noise in an image
• -normalize — transforms the image to span the full range of colors
• -opaque color — changes this color to the fill color
• -ordered-dither NxN — adds a noise pattern to the image with specific amplitudes
• -paint radius — simulates an oil painting 🖌️
• -polaroid angle — simulates a Polaroid picture 📸
• -posterize levels — reduces the image to a limited number of color levels
• -print string — interprets string and prints to console 🖨️
• -profile filename — adds, deletes, or applies an image profile
• -quantize colorspace — reduces colors in this colorspace
• -radial-blur angle — radial blurs the image
• -raise value — lightens/darkens image edges to create a 3-D effect
• -random-threshold low,high — random thresholds the image
• -range-threshold values — performs either hard or soft thresholding within some range of values in an image
• -region geometry — applies options to a portion of the image
• -render — renders vector graphics
• -resample geometry — changes the resolution of an image
• -resize geometry — resizes the image
• -roll geometry — rolls an image vertically or horizontally
• -rotate degrees — applies Paeth rotation to the image
• -sample geometry — scales the image with pixel sampling
• -scale geometry — scales the image
• -segment values — segments an image
• -selective-blur geometry — selectively blurs pixels within a contrast threshold
• -sepia-tone threshold — simulates a sepia-toned photo 🍂
• -set property value — sets an image property
• -shade degrees — shades the image using a distant light source 💡
• -shadow geometry — simulates an image shadow
• -sharpen geometry — sharpens the image
• -shave geometry — shaves pixels from the image edges ✂️
• -shear geometry — slides one edge of the image along the X or Y axis
• -sigmoidal-contrast geometry — lightness rescaling using sigmoidal contrast enhancement
• -sketch geometry — simulates a pencil sketch ✏️
• -solarize threshold — negates all pixels above the threshold level
• -sort-pixels — sorts each scanline in ascending order of intensity
• -splice geometry — splices the background color into the image
• -spread amount — displaces image pixels by a random amount
• -strip — strips the image of all profiles and comments 🫧
• -swirl degrees — swirls image pixels about the center 🌀
• -threshold value — thresholds the image
• -thumbnail geometry — creates a thumbnail of the image
• -tile filename — tiles the image when filling a graphic primitive
• -tint value — tints the image with the fill color
• -transform — affine transforms the image
• -transparent color — makes this color transparent within the image 👻
• -transpose — flips the image vertically and rotates 90 degrees
• -transverse — flops the image horizontally and rotates 270 degrees
• -trim — trims image edges ✂️
• -type type — image type
• -unique-colors — discards all but one of any pixel color
• -unsharp geometry — sharpens the image
• -vignette geometry — softens the edges of the image in vignette style
• -wave geometry — alters an image along a sine wave 〰️
• -white-threshold value — forces all pixels above the threshold into white 🤍

---

🎀 Image Channel Operators 🎀

• -channel-extract channel-list — extracts the channels, in order
• -channel-inject channel-list — injects the channels, in order
• -channel-swap channel,channel — swaps the channels 🔁

---

🦋 Image Sequence Operators 🦋

• -affinity filename — transforms image colors to match this set of colors
• -append — appends an image sequence top to bottom (use +append for left to right)
• -clut — applies a color lookup table to the image
• -coalesce — merges a sequence of images
• -combine — combines a sequence of images
• -composite — composites the image
• -crop geometry — cuts out a rectangular region of the image ✂️
• -deconstruct — breaks down an image sequence into constituent parts
• -evaluate-sequence operator — evaluates an arithmetic, relational, or logical expression
• -flatten — flattens a sequence of images
• -fx expression — applies a mathematical expression to an image channel(s)
• -hald-clut — applies a Hald color lookup table to the image
• -morph value — morphs an image sequence
• -mosaic — creates a mosaic from an image sequence
• -process arguments — processes the image with a custom image filter
• -separate — separates an image channel into a grayscale image
• -smush geometry — smushes an image sequence together
• -write filename — writes images to this file

---

👑 Image Stack Operators 👑

• -clone indexes — clones an image
• -delete indexes — deletes the image from the image sequence
• -duplicate count,indexes — duplicates an image one or more times
• -insert index — inserts the last image into the image sequence
• -swap indexes — swaps two images in the image sequence

---

💅 Miscellaneous Options 💅

• -debug events — displays copious debugging information
• -help — prints program options
• -log format — format of debugging information
• -list type — prints a list of supported option arguments
• -version — prints version information

---

Okay so here's the tea about settings, bestie: use any setting or operator as an output-option. Only a limited number of settings are input-options though. The ones that qualify are: -antialias, -caption, -density, -define, -encoding, -font, -pointsize, -size, and -texture — plus any of the miscellaneous options. Slay 💖

And now, the format detective moment: by default, the image format of file is determined by its magic number 🔮. Wanna force a specific image format? Precede the filename with an image format name and a colon (i.e. ps:image), or just specify the image type as the filename suffix (i.e. image.ps). And if you want standard input or output, specify 'file' as -. Periodt. 💅

---

🔗 SEE ALSO 🔗

• ImageMagick(1)

---

📜 COPYRIGHT 📜

Copyright (C) 1999 ImageMagick Studio LLC. Additional copyrights and licenses apply to this software, see file:///usr/share/doc/ImageMagick-7/www/license.html or https://imagemagick.org/license/

---

and that's the whole page, bestie 🫶 this was the ImageMagick manual page, dated Date: 2009/01/10 01:00:00 — go forth and edit those images, you absolute icon 👑✨