magick(1)

🌸 NAME 🌸

okay so bestie, this is the magick(1) manual page, and the main character is magick-script — a scripting language that converts between image formats as well as resize an image, blur, crop, despeckle, dither, draw on, flip, join, re-sample, and much more. 💅✨

🎀 SYNOPSIS 🎀

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

🌈 OVERVIEW 🌈

The magick-script 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. Here is an example script, bestie:

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

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

💖 DESCRIPTION 💖

okay so here's the whole Image Settings menu, and I mean every single flag. no cap, no skipping. 🫶

🧸 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 🔥

okay bestie, this is the big one — the glow-up station. every single one of these bad boys tweaks your picture somehow. let's get into it 💅

• -adaptive-blur geometry — blurs your pixels adaptively, meaning the blur gets weaker the closer you get to the edges. it's giving "soft focus but keep the outline, queen"
• -adaptive-resize geometry — resizes your image with data-dependent triangulation. fancy resize, no cap
• -adaptive-sharpen geometry — the sharpening cousin: cranks the sharpening up near the edges. literally the opposite energy of adaptive-blur 🦋
• -annotate geometry text — slaps some text on your image
• -auto-orient — auto-fixes the orientation. your image knows which way is up now ⭐
• -black-threshold value — every pixel below the threshold gets forced to black. brutal. iconic.
• -blur geometry — smooths out noise and drops the detail level. the "soft launch" of filters ✨
• -border geometry — wraps your image in a border of color
• -channel mask — sets the image channel mask
• -charcoal radius — makes it look like a charcoal drawing. art hoe era 🎨
• -chop geometry — removes pixels from the interior of the image (yes, the middle, not the edges, bestie)
• -clip — clips along the first path it finds in the 8BIM profile
• -clip-mask filename — attaches a clip mask to your image
• -clip-path id — clips along a named path from the 8BIM profile
• -colorize value — colorizes the image using the fill color
• -color-matrix matrix — applies color correction to the image
• -contrast — turns the image contrast up or down
• -contrast-stretch geometry — improves contrast by "stretching" the intensity range
• -convolve coefficients — applies a convolution kernel to the image. math girlies rise 🧚
• -cycle amount — cycles the image colormap
• -despeckle — reduces the speckles hanging out inside an image
• -draw string — annotates the image with a graphic primitive
• -edge radius — runs a filter that detects the edges in your image
• -emboss radius — embosses the image. texture era 💅
• -enhance — a digital filter that enhances a noisy image
• -equalize — performs histogram equalization on the image
• -evaluate operator value — evaluates an arithmetic, relational, or logical expression
• -extent geometry — sets the image size
• -extract geometry — extracts an area out of 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. fancy frame, main character energy 👑
• -function name — applies a function to the image
• -gamma value — sets the level of gamma correction
• -gaussian-blur geometry — reduces image noise and drops the detail levels
• -geometry geometry — the 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 the image pixels around the center. dramatic 💀
• -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 every pixel the 'predominant color' of its 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 — swaps every pixel for its complementary color
• -noise geometry — adds noise to or reduces noise in an image
• -normalize — transforms the image so it spans 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 down to a limited number of color levels
• -print string — interprets the string and prints it to the console
• -profile filename — adds, deletes, or applies an image profile
• -quantize colorspace — reduces colors in this colorspace
• -radial-blur angle — radially blurs the image
• -raise value — lightens/darkens the image edges to create a 3-D effect
• -random-threshold low,high — randomly 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 just 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 the 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. vintage aesthetic unlocked 🌸
• -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 off 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 every pixel above the threshold level
• -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. decluttering, we love to see it 🧹
• -swirl degrees — swirls the image pixels around 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 transform on the image
• -transparent color — makes this color transparent inside the image
• -transpose — flips the image vertically and rotates it 90 degrees
• -transverse — flops the image horizontally and rotates it 270 degrees
• -trim — trims the image edges
• -type type — sets the image type
• -unique-colors — throws out all but one of every pixel color
• -unsharp geometry — sharpens the image
• -vignette geometry — softens the image edges, vignette style
• -wave geometry — alters the image along a sine wave 〰️
• -white-threshold value — forces every pixel above the threshold to white

---

✨ IMAGE CHANNEL OPERATORS ✨

channel girlies, this section is for you 💜

• -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 🦋

when you're working with more than one image, this is your moment bestie

• -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 an image
• -crop geometry — cuts out a rectangular region of the image ✂️
• -deconstruct — breaks an image sequence down into its 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 (or channels)
• -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 the images to this file

---

🌈 IMAGE STACK OPERATORS 🌈

stack management, aka keeping your little image pile in order 🎀

• -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 💖

the lil helpers, the emotional support flags 🫶

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

---

⭐ THE IMPORTANT FINE PRINT ⭐

Use any setting or operator as an output-option. Only a limited number of settings are input-options. They include: -antialias, -caption, -density, -define, -encoding, -font, -pointsize, -size, and -texture, as well as any of the miscellaneous options.

By default, the image format of file is determined by its magic number. To specify a particular image format, precede the filename with an image format name and a colon (i.e. ps:image) or specify the image type as the filename suffix (i.e. image.ps). Specify file as - for standard input or output.

lowkey memorize that magic-number bit, bestie, it comes up constantly and it makes you look so smart 😭

---

👀 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 — you made it to the end 🎉 this one's from the ImageMagick crew, dated 2009/01/10 01:00:00, and it's the magick(1) page. go forth and edit some pixels, you absolute icon 💅✨