mogrify-im7.q16hdri(1)

✨ NAME ✨

okay so mogrify — she resizes an image, blurs, crops, despeckles, dithers, draws on, flips, joins, re-samples, and honestly does so much more. 🌈

the one thing you HAVE to know before you touch her: mogrify overwrites the original image file, whereas convert-im7.q16hdri(1) writes to a different image file. that's the whole personality. she edits in place, no take-backsies 💅

---

🌸 SYNOPSIS 🌸

magick-im7.q16hdri mogrify [options] input-file

---

🦋 OVERVIEW 🦋

mogrify-im7.q16hdri is a member of the ImageMagick-ims7.q16hdri(1) suite of tools. use her to resize an image, blur, crop, despeckle, dither, draw on, flip, join, re-sample, and much more.

this tool is similar to convert-im7.q16hdri(1) except — and this is the part that eats, bestie — the original image file is overwritten with any changes you request. 🔥

for more information about the mogrify command, point your browser to file:///usr/share/doc/imagemagick-7-common/html/www/mogrify.html (on debian system you may install the imagemagick-7 package) or https://www.imagemagick.org/script/mogrify.php. 💖

---

👑 DESCRIPTION 👑

🎀 Image Settings 🎀

this is the settings block, the whole wardrobe, the fit check. every single one, no skips ✨

• -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
• -attenuate value — lessen (or intensify) when adding noise to an image
• -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
• -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 — convert 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 — convert 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
• -features distance — analyze image features (e.g. contrast, correlation)
• -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 type — image format type
• -function name — apply a function to the image
• -fuzz distance — colors within this distance are considered equal
• -gravity type — horizontal and vertical text placement
• -green-primary point — chromaticity green primary point
• -intensity method — method to generate intensity value from pixel
• -intent type — type of rendering intent when managing the image color
• -interlace type — type of image interlacing scheme
• -interline-spacing value — set the space between two text lines
• -interpolate method — pixel color interpolation method
• -interword-spacing value — set the space between two words
• -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
• -matte — store matte channel if the image has one
• -mattecolor color — frame color
• -metric type — measure differences between images with this metric
• -monitor — monitor progress
• -morphology method kernel — apply a morphology method to the image
• -orient type — image orientation
• -page geometry — size and location of an image canvas (setting)
• -path path — write images to this path on disk
• -perceptible epsilon — pixel value less than |epsilon| become epsilon or -epsilon
• -ping — efficiently determine image attributes
• -pointsize value — font point size
• -precision value — maximum number of significant digits to print
• -preview type — image preview type
• -quality value — JPEG/MIFF/PNG compression level
• -quiet — suppress all warning messages
• -read-mask filename — associate a read mask with the image
• -red-primary point — chromaticity red primary point
• -regard-warnings — pay attention to warning messages
• -remap filename — transform image colors to match this set of colors
• -repage geometry — size and location of an image canvas
• -respect-parentheses — settings remain in effect until parenthesis boundary
• -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
• -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
• -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
• -virtual-pixel method — virtual pixel access method
• -weight type — render text with this font weight
• -white-point point — chromaticity white point
• -write-mask filename — associate a write mask with the image

✨ Image Operators ✨

okay bestie, this is the big one — every image operator, all lined up. No cap, no skips. 💅

• -adaptive-blur geometry — adaptively blur pixels; decrease effect near edges. It's giving soft-focus-but-only-where-it-matters energy. ✨
• -adaptive-resize geometry — adaptively resize image with data dependent triangulation. Lowkey fancy resize, fr fr. 🦋
• -adaptive-sharpen geometry — adaptively sharpen pixels; increase effect near edges. The way it just knows where to crisp things up. 🔥
• -alpha option — on, activate, off, deactivate, set, opaque, copy transparent, extract, background, or shape. All the alpha moods, bestie. 💅
• -annotate geometry text — annotate the image with text. Put your name on it, main character style. 🎀
• -auto-gamma — automagically adjust gamma level of image. Automagically, yes that's the word. ✨
• -auto-level — automagically adjust color levels of image. Let it do the leveling for you. 🌈
• -auto-orient — automatically orient image. No more sideways selfies. 🙈
• -auto-threshold method — automatically perform image thresholding. Threshold, but make it automatic. ⭐
• -bench iterations — measure performance. Speed test for your pixels. ⏱️
• -bilateral-blur geometry — non-linear, edge-preserving, and noise-reducing smoothing filter. Smooth but keep the edges, iykyk. 🧚
• -black-threshold value — force all pixels below the threshold into black. Below the line? Straight to black. 💀
• -blue-shift — simulate a scene at nighttime in the moonlight. Moonlight vibes only. 🌙
• -blur geometry — reduce image noise and reduce detail levels. Soft blur, less detail, no thoughts. ☁️
• -border geometry — surround image with a border of color. Frame it up, bestie. 🖼️
• -brightness-contrast geometry — improve brightness / contrast of the image. Glow-up for your pic. ✨
• -canny geometry — detect edges in the image. Edge detection, but make it Canny. 🔍
• -channel mask — set the image channel mask. Mask on, mask off. 🎭
• -charcoal radius — simulate a charcoal drawing. Art class but make it digital. 🎨
• -chop geometry — remove pixels from the image interior. Chop chop, interior edition. ✂️
• -clahe geometry — contrast limited adaptive histogram equalization. Say that five times fast. 😭
• -clamp — keep pixel values in range (0-QuantumRange). Stay in your lane, pixels. 🫶
• -clip — clip along the first path from the 8BIM profile. 8BIM path? Clipped. 💅
• -clip-mask filename — associate a clip mask with the image. Mask + image = besties. 🎀
• -clip-path id — clip along a named path from the 8BIM profile. Named path, clipped path. 🦋
• -colorize value — colorize the image with the fill color. Fill color goes brrr. 🌈
• -color-matrix matrix — apply color correction to the image. Matrix math but make it fashion. 💜
• -colors value — preferred number of colors in the image. You get this many colors, periodt. 🎨
• -color-threshold start_color-stop_color — force all pixels in the color range to white otherwise black. In range? White. Out of range? Black. No in-between. ⚫⚪
• -connected-component connectivity — connected-components uniquely labeled. Labeling the connected girlies. 👑
• -contrast — enhance or reduce the image contrast. More contrast, less contrast, your call. 🔥
• -contrast-stretch geometry — improve contrast by `stretching' the intensity range. Stretch it out. 🧘
• -convolve coefficients — apply a convolution kernel to the image. Kernel goes convolve. 🌀
• -cycle amount — cycle the image colormap. Round and round the colors go. 🎠
• -deskew threshold — straighten an image. Fix that tilt, bestie. 📐
• -despeckle — reduce the speckles within an image. Speckles? Not today. ✨
• -distort method args — distort images according to given method and args. Warp it, twist it, distort it. 🌀
• -draw string — annotate the image with a graphic primitive. Draw something iconic. 🖍️
• -edge radius — apply a filter to detect edges in the image. Edges found. 🔍
• -emboss radius — emboss an image. Raised edges, fancy vibe. 🏔️
• -enhance — apply a digital filter to enhance a noisy image. Noisy? Enhanced. 🔥
• -equalize — perform histogram equalization to an image. Equalize the histogram, slay. 📊
• -evaluate operator value — evaluate an arithmetic, relational, or logical expression. Math but make it image. 🧮
• -extent geometry — set the image size. Size matters, okay? 📏
• -extract geometry — extract area from image. Snip snip, just that area. ✂️
• -fft — implements the discrete Fourier transform (DFT). Fourier transform, no cap. 🌀
• -flip — flip image vertically. Upside down, but vertically. 🙃
• -floodfill geometry color — floodfill the image with color. Flood it with color, bestie. 🌊
• -flop — flop image horizontally. Sideways flip, horizontally. 🔄
• -frame geometry — surround image with an ornamental border. Ornamental border? Fancy. 🖼️
• -gamma value — level of gamma correction. Gamma correction level: yes. ✨
• -gaussian-blur geometry — reduce image noise and reduce detail levels. Gaussian blur, classic. ☁️
• -geometry geometry — preferred size or location of the image. Preferred size or location, your choice. 📍
• -grayscale method — convert image to grayscale. Gray is a vibe too. 🩶
• -help — print program options. Help me help you. 🆘
• -hough-lines geometry — identify lines in the image. Lines identified. 📏
• -identify — identify the format and characteristics of the image. Tell me what you are. 🔍
• -ift — implements the inverse discrete Fourier transform (DFT). Inverse Fourier, we love to see it. 🌀
• -implode amount — implode image pixels about the center. Implode inward, dramatic. 💥
• -integral — calculate the sum of values (pixel values) in the image. Sum it up, bestie. ➕
• -interpolative-resize geometry — resize image using interpolation. Resize with interpolation, smooth. 🦋
• -kmeans geometry — K means color reduction. K means business. 🎨
• -lat geometry — local adaptive thresholding. Local adaptive thresholding, lowkey iconic. ⭐
• -layers method — optimize or compare image layers. Layers, optimized or compared. 🧅
• -level value — adjust the level of image contrast. Level up the contrast. 🎚️
• -level-colors color,color — level image with the given colors. Two colors, one level. 🌈
• -linear-stretch geometry — improve contrast by `stretching with saturation' the intensity range. Stretch with saturation, okay? 🧘
• -liquid-rescale geometry — rescale image with seam-carving. Seam-carving rescale, liquid style. 💧
• -magnify — double the size of the image with pixel art scaling. Double it, pixel art style. 🔍
• -mean-shift geometry — delineate arbitrarily shaped clusters in the image. Clusters, delineated. 🫧
• -median geometry — apply a median filter to the image. Median filter, applied. 📊
• -mode geometry — make each pixel the 'predominant color' of the neighborhood. Predominant color energy. 👑
• -modulate value — vary the brightness, saturation, and hue. Brightness, saturation, hue — vary it. 🎨
• -monochrome — transform image to black and white. Black and white, no color. ⚫⚪
• -motion-blur geometry — simulate motion blur. Zoom zoom, motion blur. 💨
• -negate — replace each pixel with its complementary color. Complementary color, periodt. 🔄
• -noise geometry — add or reduce noise in an image. Noise: add it or reduce it. 📺
• -normalize — transform image to span the full range of colors. Full range, normalized. 🌈
• -opaque color — change this color to the fill color. This color becomes that color. 🎨
• -ordered-dither NxN — add a noise pattern to the image with specific amplitudes. Dither it, ordered. 🌀
• -paint radius — simulate an oil painting. Oil painting but make it digital. 🖌️
• -polaroid angle — simulate a Polaroid picture. Polaroid pic, angle included. 📸
• -posterize levels — reduce the image to a limited number of color levels. Limited colors, posterized. 🎨
• -print string — interpret string and print to console. Print it to console, bestie. 🖨️
• -profile filename — add, delete, or apply an image profile. Profile: add, delete, or apply. 📁
• -quantize colorspace — reduce colors in this colorspace. Quantize in this colorspace. 🌈
• -radial-blur angle — radial blur the image. Radial blur, spinny vibes. 🌀
• -raise value — lighten/darken image edges to create a 3-D effect. 3-D effect, raised. 🏔️
• -random-threshold low,high — random threshold the image. Random threshold, low to high. 🎲
• -range-threshold values — perform either hard or soft thresholding within some range of values in an image. Hard or soft, within range. ⚖️
• -region geometry — apply options to a portion of the image. Just a portion, not the whole thing. ✂️
• -render — render vector graphics. Render those vectors. 🖼️
• -resample geometry — change the resolution of an image. Resolution change, resampled. 📐
• -resize geometry — resize the image. Resize it, bestie. 📏
• -roll geometry — roll an image vertically or horizontally. Roll it, vertically or horizontally. 🎳
• -rotate degrees — apply Paeth rotation to the image. Paeth rotation, degrees. 🔄
• -sample geometry — scale image with pixel sampling. Pixel sampling scale. 🔍
• -scale geometry — scale the image. Scale it up or down. 📏
• -segment values — segment an image. Segment it, values included. 🧩
• -selective-blur geometry — selectively blur pixels within a contrast threshold. Selective blur, within threshold. 🎯
• -sepia-tone threshold — simulate a sepia-toned photo. Sepia tone, vintage vibes. 📜
• -set property value — set an image property. Set that property, value included. ⚙️
• -shade degrees — shade the image using a distant light source. Distant light source, shaded. 💡
• -shadow geometry — simulate an image shadow. Shadow simulation, spooky. 👻
• -sharpen geometry — sharpen the image. Sharpen it, crisp. 🔪
• -shave geometry — shave pixels from the image edges. Shave those edges. ✂️
• -shear geometry — slide one edge of the image along the X or Y axis. Slide along X or Y. 🛝
• -sigmoidal-contrast geometry — lightness rescaling using sigmoidal contrast enhancement. Sigmoidal contrast, lightness rescale. 📈
• -sketch geometry — simulate a pencil sketch. Pencil sketch, simulated. ✏️
• -solarize threshold — negate all pixels above the threshold level. Above threshold? Negated. ☀️
• -sort-pixels — sort each scanline in ascending order of intensity. Sort those scanlines, ascending. 📊
• -sparse-color method args — fill in a image based on a few color points. A few color points, filled in. 🎨
• -splice geometry — splice the background color into the image. Splice that background color in. 🧬
• -spread amount — displace image pixels by a random amount. Random displacement, spread out. 🎲
• -statistic type geometry — replace each pixel with corresponding statistic from the neighborhood. Statistic from the neighborhood, swapped in. 📊
• -strip — strip image of all profiles and comments. Strip it all, no profiles, no comments. 🫥
• -swirl degrees — swirl image pixels about the center. Swirl it, center-focused. 🌀
• -threshold value — threshold the image. Threshold it, value included. ⚖️
• -thumbnail geometry — create a thumbnail of the image. Thumbnail time, bestie. 🖼️
• -tile filename — tile image when filling a graphic primitive. Tile it when filling. 🧱
• -tint value — tint the image with the fill color. Tint it with fill color. 🎨
• -transform — affine transform image. Affine transform, slay. 🔄
• -transparent color — make this color transparent within the image. This color? Transparent now. 👻
• -transpose — flip image vertically and rotate 90 degrees. Flip vertically, rotate 90. 🔄
• -transverse — flop image horizontally and rotate 270 degrees. Flop horizontally, rotate 270. 🔄
• -trim — trim image edges. Trim those edges, clean. ✂️
• -type type — image type. Type: image type. 🏷️
• -unique-colors — discard all but one of any pixel color. One of each color, discard the rest. 🎨
• -unsharp geometry — sharpen the image. Unsharp but sharpens, iconic. 🔪
• -vignette geometry — soften the edges of the image in vignette style. Vignette style, soft edges. 🌸
• -wave geometry — alter an image along a sine wave. Sine wave alteration, wavy. 🌊
• -wavelet-denoise threshold — removes noise from the image using a wavelet transform. Wavelet transform, denoised. 🌊
• -white-balance — automagically adjust white balance of image. Automagically adjust that white balance. ⚪
• -white-threshold value — force all pixels above the threshold into white. Above threshold? White. ⚪

---

🦋 Image Channel Operators 🦋

• -channel-fx expression — exchange, extract, or transfer one or more image channels. Channel exchange, extract, or transfer. 🔀
• -separate — separate an image channel into a grayscale image. Separate that channel, grayscale it. 🩶

🌈 Image Sequence Operators 🌈

Okay bestie, these ones work on a whole sequence of images at once, not just one. Iconic group-chat energy.

• -affinity filename — transforms the image colors to match this set of colors from filename. Like a matching-glow-up moment. 💖
• -append — appends an image sequence top to bottom (use +append for left to right). Stack 'em up. ✨
• -clut — applies a color lookup table to the image. Color theory but make it code.
• -coalesce — merges a sequence of images. Bringing the girls together, fr.
• -combine — combines a sequence of images.
• -compare — mathematically and visually annotates the difference between an image and its reconstruction. It's giving diff, but make it fashion. 💅
• -complex operator — performs complex mathematics on an image sequence. Math girlies, rise. 🧮
• -composite — composites an image.
• -copy geometry offset — copies pixels from one area of an image to another. You pass the geometry and the offset.
• -crop geometry — cuts out a rectangular region of the image. Cropping is self-care. 🎀
• -deconstruct — breaks down an image sequence into its constituent parts. Main character breakup energy.
• -evaluate-sequence operator — evaluates an arithmetic, relational, or logical expression. Yes, operator is the thing you hand it.
• -flatten — flattens a sequence of images. Bye bye, layers. 🦋
• -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. value is how much morphing, okay?
• -mosaic — creates a mosaic from an image sequence.
• -poly terms — builds a polynomial from the image sequence and the corresponding terms (coefficients and degree pairs). Algebra class but make it art. 🔥
• -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. Smush is a technical term, periodt. 💀
• -write filename — writes images to this file.

---

🎀 Image Stack Operators 🎀

These ones rearrange the stack, bestie. Very "reorganize your camera roll" vibes.

• -delete indexes — deletes the image from the image sequence. Just say bye. 👋
• -duplicate count,indexes — duplicates an image one or more times. You specify count and indexes.
• -insert index — inserts the last image into the image sequence.
• -reverse — reverses the image sequence. Backwards but cute.
• -swap indexes — swaps two images in the image sequence.

---

✨ Miscellaneous Options ✨

The little extras. Lowkey essential.

• -debug events — displays copious debugging information. events tells it what to spill. 🫖
• -distribute-cache port — distributed pixel cache spanning one or more servers. Fancy networked cache vibes.
• -help — prints program options. Bestie behavior, honestly. 🫶
• -log format — format of debugging information.
• -list type — prints a list of supported option arguments.
• -version — prints version information.

---

By default, the image format of file is figured out from its magic number. If you wanna force a specific image format, put an image format name and a colon before the filename (like ps:image), or just set the image type as the filename suffix (like image.ps). And if you pass file as -, that means standard input or output. 💖

---

👀 SEE ALSO 👀

ImageMagick-im7.q16hdri(1)

---

📜 COPYRIGHT 📜

Copyright (C) 1999 ImageMagick Studio LLC. Additional copyrights and licenses apply to this software, see file:///usr/share/doc/imagemagick-7-common/html/www/license.html (on debian system you may install the imagemagick-7 package) or https://www.imagemagick.org/script/license.php

---

That's a wrap, bestie! This iconic page is from ImageMagick, dated 2009/01/10 01:00:00, and it's for mogrify-im7.q16hdri(1). Stay slay, read your manpages, and hydrate. 💖✨🦋