mogrify-im6.q16hdri(1)

📦
version 6.9.12.98 · 2 versions
, in ubuntu noble

💖 mogrify-im6.q16hdri(1) — the glow-up your image files have been waiting for 💖

okay so bestie. you found the manual page for mogrify-im6.q16hdri(1). yes that name is a whole mouthful, no we are not changing it, it's iconic actually. buckle up 🎀

🌸 NAME 🌸

mogrify — resize an image, blur, crop, despeckle, dither, draw on, flip, join, re-sample, and much more. Mogrify overwrites the original image file, whereas convert-im6.q16hdri(1) writes to a different image file.

fr fr that's the whole personality of this tool: it edits in place. no copy, no backup, no "oops let me undo". the original file is the canvas. 💀

✨ SYNOPSIS ✨

mogrify-im6.q16hdri [options] input-file

🦋 OVERVIEW 🦋

The mogrify-im6.q16hdri program is a member of the ImageMagick-im6.q16hdri(1) suite of tools. Use it to resize an image, blur, crop, despeckle, dither, draw on, flip, join, re-sample, and much more. This tool is similar to convert-im6.q16hdri(1) except the original image file is overwritten with any changes you request.

so like. imagine convert but it has main character energy and zero impulse control. you asked for a resize, it gave you a resize, and the old file? gone. replaced. evolved. 🦋

For more information about the mogrify command, point your browser to:

file:///usr/share/doc/imagemagick-6-common/html/www/mogrify.html

(on debian system you may install the imagemagick-6 package) or

https://www.imagemagick.org/script/mogrify.php

👑 DESCRIPTION 👑

💅 Image Settings: 💅

  • -adjoin — join images into a single multi-image file
  • -affine matrix — affine transform matrix
  • -alpha option — activate, deactivate, reset, or set the alpha channel
  • -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
  • -channel type — apply option to select image channels
  • -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 — 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
  • -mask filename — associate a mask with the image
  • -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
  • -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
  • -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
  • -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

and that's literally just the image settings section bestie, we are NOT done, there is so much more coming 🫶 keep scrolling, the rest is on its way ✨

✨ Image Operators ✨

okay so these are the operators that work on a single image, bestie. They're the main character moves for transforming your pics. Let's go. 💅

  • -adaptive-blur geometry — adaptively blurs pixels; the effect gets weaker near the edges. It's like a soft glow that knows where to chill. ✨
  • -adaptive-resize geometry — adaptively resizes the image with data dependent triangulation. Fancy, right? 🦋
  • -adaptive-sharpen geometry — adaptively sharpens pixels; the effect increases near the edges. So edges get extra crispy. 🔥
  • -alpha option — the option can be on, activate, off, deactivate, set, opaque, copy, transparent, extract, background, or shape. Alpha channel vibes. 💫
  • -annotate geometry text — annotates the image with text. Put some words on it, periodt. ✍️
  • -auto-gamma — automagically adjusts the gamma level of the image. It just knows. ✨
  • -auto-level — automagically adjusts the color levels of the image. Balance restored. 🧘
  • -auto-orient — automatically orients the image. No more sideways pics. 🙈
  • -bench iterations — measures performance with the given number of iterations. Speed test but make it image. ⏱️
  • -black-threshold value — forces all pixels below the threshold into black. If you're under the limit, you're out. 💀
  • -blue-shift — simulates a scene at nighttime in the moonlight. Moody blue vibes. 🌙
  • -blur geometry — reduces image noise and reduces detail levels. Soften it up, bestie. 🌸
  • -border geometry — surrounds the image with a border of color. Frame it. 🖼️
  • -bordercolor color — sets the border color. Pick your shade. 🎀
  • -brightness-contrast geometry — improves brightness / contrast of the image. Glow up. ✨
  • -cdl filename — color corrects with a color decision list from the file. Pro-level color grading. 🎬
  • -canny geometry — detects edges in the image. Canny edge detection, iconic. 🔍
  • -charcoal radius — simulates a charcoal drawing. Artsy filter, no cap. 🎨
  • -chop geometry — removes pixels from the image interior. Chop chop. ✂️
  • -clamp — keeps pixel values in range (0-QuantumRange). Stay in your lane. 🚧
  • -clip — clips along the first path from the 8BIM profile. Clipping path magic. 🪄
  • -clip-mask filename — associates a clip mask with the image. Mask on. 😷
  • -clip-path id — clips along a named path from the 8BIM profile. Path vibes. 🛤️
  • -colorize value — colorizes the image with the fill color. Tint it. 🌈
  • -color-matrix matrix — applies color correction to the image using the matrix. Math but make it fashion. 🧮
  • -connected-component connectivity — connected-components uniquely labeled. Find the clusters. 🔗
  • -contrast — enhances or reduces the image contrast. Make it pop or make it soft. 🎚️
  • -contrast-stretch geometry — improves contrast by `stretching' the intensity range. Stretch it out. 🤸
  • -convolve coefficients — applies a convolution kernel to the image. Kernel panic? No, kernel magic. 🪄
  • -cycle amount — cycles the image colormap. Rotate those colors. 🔄
  • -decipher filename — converts cipher pixels to plain pixels. Decode the mystery. 🔓
  • -deskew threshold — straightens an image. Tilted no more. 📐
  • -despeckle — reduces the speckles within an image. Clean it up. 🧼
  • -distort method args — distorts images according to given method and args. Warp zone. 🌀
  • -draw string — annotates the image with a graphic primitive. Draw something. 🖌️
  • -edge radius — applies a filter to detect edges in the image. Edge lord energy. 🔪
  • -encipher filename — converts plain pixels to cipher pixels. Secret message. 🤫
  • -emboss radius — embosses an image. 3D-ish texture. 🏔️
  • -enhance — applies a digital filter to enhance a noisy image. Glow up for grainy pics. ✨
  • -equalize — performs histogram equalization to an image. Balance the tones. ⚖️
  • -evaluate operator value — evaluates an arithmetic, relational, or logical expression. Math class but make it image. 🧮
  • -extent geometry — sets the image size. Resize the canvas. 📏
  • -extract geometry — extracts area from image. Cut it out. ✂️
  • -features distance — analyzes image features (e.g. contrast, correlation). Feature detective. 🔍
  • -fft — implements the discrete Fourier transform (DFT). Frequency domain, bestie. 🌐
  • -flip — flips image vertically. Upside down. 🙃
  • -floodfill geometry color — floodfills the image with color. Paint bucket energy. 🪣
  • -flop — flops image horizontally. Mirror, mirror. 🪞
  • -frame geometry — surrounds image with an ornamental border. Fancy frame. 🖼️
  • -function name parameters — applies function over image values. Function time. 📊
  • -gamma value — sets the level of gamma correction. Gamma glow. ✨
  • -gaussian-blur geometry — reduces image noise and reduces detail levels. Smooth like butter. 🧈
  • -geometry geometry — sets the preferred size or location of the image. Geometry class. 📐
  • -grayscale method — converts image to grayscale. Black and white, but make it method. 🖤
  • -ift — implements the inverse discrete Fourier transform (DFT). Back from frequency. 🔄
  • -help — prints program options. Help me help you. 🆘
  • -hough-lines geometry — identifies lines in the image. Line detection, slay. 📏
  • -identify — identifies the format and characteristics of the image. Get to know your pic. 🕵️
  • -ift — implements the inverse discrete Fourier transform (DFT). Yes, it's listed again, bestie. It's that iconic. 💅
  • -implode amount — implodes image pixels about the center. Suck it in. 🌀
  • -lat geometry — local adaptive thresholding. Threshold but local. 🏘️
  • -layers method — optimizes or compares image layers. Layer cake. 🍰
  • -level value — adjusts the level of image contrast. Level up. 🎚️
  • -level-colors color,color — levels image with the given colors. Two colors enter, one image leaves. 🌈
  • -linear-stretch geometry — improves contrast by `stretching with saturation' the intensity range. Stretch with saturation. 🤸
  • -liquid-rescale geometry — rescales image with seam-carving. Liquid rescale, so cool. 💧
  • -magnify — doubles the size of the image with pixel art scaling. Bigger and pixelated. 🔍
  • -mean-shift geometry — delineates arbitrarily shaped clusters in the image. Cluster vibes. 🫧
  • -median geometry — applies a median filter to the image. Median filter, no cap. 📊
  • -mode geometry — makes each pixel the 'predominant color' of the neighborhood. Mode mode. 🎨
  • -modulate value — varies the brightness, saturation, and hue. Modulate it. 🌈
  • -monochrome — transforms image to black and white. Monochrome moment. 🖤
  • -morphology method kernel — applies a morphology method to the image. Shape-shift. 🧬
  • -motion-blur geometry — simulates motion blur. Zoom zoom. 💨
  • -negate — replaces each pixel with its complementary color. Invert the vibe. 🔄
  • -noise geometry — adds or reduces noise in an image. Noise control. 📻
  • -normalize — transforms image to span the full range of colors. Normalize it. 📊
  • -opaque color — changes this color to the fill color. Opaque swap. 🎨
  • -ordered-dither NxN — adds a noise pattern to the image with specific amplitudes. Dither me this. 🌫️
  • -paint radius — simulates an oil painting. Paint by numbers, but cooler. 🎨
  • -perceptible epsilon — pixel values less than |epsilon| become epsilon or -epsilon. Perceptible difference. 👀
  • -polaroid angle — simulates a Polaroid picture. Instant photo vibes. 📸
  • -posterize levels — reduces the image to a limited number of color levels. Posterize it. 🎨
  • -print string — interprets string and prints to console. Print it out. 🖨️
  • -profile filename — adds, deletes, or applies an image profile. Profile management. 👤
  • -quantize colorspace — reduces colors in this colorspace. Quantize it. 🌈
  • -radial-blur angle — radial blurs the image. Spin blur. 🌀
  • -raise value — lightens/darkens image edges to create a 3-D effect. Pop out. 🎈
  • -random-threshold low,high — random thresholds the image. Randomness rules. 🎲
  • -region geometry — applies options to a portion of the image. Region locked. 🔒
  • -render — renders vector graphics. Vector vibes. ✏️
  • -resample geometry — changes the resolution of an image. Resample it. 📐
  • -resize geometry — resizes the image. Resize, obviously. 📏
  • -roll geometry — rolls an image vertically or horizontally. Roll it. 🎲
  • -rotate degrees — applies Paeth rotation to the image. Rotate it. 🔄
  • -sample geometry — scales image with pixel sampling. Sample scale. 🔬
  • -scale geometry — scales the image. Scale it. 📈
  • -segment values — segments an image. Segment it. 🧩
  • -selective-blur geometry — selectively blurs pixels within a contrast threshold. Selective blur, fancy. 🎯
  • -sepia-tone threshold — simulates a sepia-toned photo. Old-timey vibes. 📜
  • -set property value — sets an image property. Set it. ⚙️
  • -shade degrees — shades the image using a distant light source. Shade it. 💡
  • -shadow geometry — simulates an image shadow. Drop shadow. 🌑
  • -sharpen geometry — sharpens the image. Crispy. 🔪
  • -shave geometry — shaves pixels from the image edges. Shave it. 🪒
  • -shear geometry — slides one edge of the image along the X or Y axis. Shear it. 📐
  • -sigmoidal-contrast geometry — lightness rescaling using sigmoidal contrast enhancement. Sigmoid curve, slay. 📈
  • -sketch geometry — simulates a pencil sketch. Sketchy vibes. ✏️
  • -solarize threshold — negates all pixels above the threshold level. Solarize it. ☀️
  • -sparse-color method args — fills in a image based on a few color points. Sparse color, fill it in. 🎨
  • -splice geometry — splices the background color into the image. Splice it. 🧬
  • -spread amount — displaces image pixels by a random amount. Spread it. 🌫️
  • -statistic type geometry — replaces each pixel with corresponding statistic from the neighborhood. Stats class. 📊
  • -strip — strips image of all profiles and comments. Strip it down. 🧼
  • -swirl degrees — swirls image pixels about the center. Swirl it. 🌀
  • -threshold value — thresholds the image. Threshold it. 🚦
  • -thumbnail geometry — creates a thumbnail of the image. Thumbnail time. 🖼️
  • -tile filename — tiles image when filling a graphic primitive. Tile it. 🧱
  • -tint value — tints the image with the fill color. Tint it. 🌈
  • -transform — affine transforms image. Transform it. 🔄
  • -transparent color — makes this color transparent within the image. See-through. 👻
  • -transpose — flips image vertically and rotates 90 degrees. Transpose it. 🔄
  • -transverse — flops image horizontally and rotates 270 degrees. Transverse it. 🔄
  • -trim — trims image edges. Trim it. ✂️
  • -type type — sets the image type. Type it. 🔤
  • -unique-colors — discards all but one of any pixel color. Unique colors only. 🌈
  • -unsharp geometry — sharpens the image. Unsharp mask, sharp result. 🔪
  • -vignette geometry — softens the edges of the image in vignette style. Vignette vibes. 🌸
  • -wave geometry — alters an image along a sine wave. Wave it. 🌊
  • -wavelet-denoise threshold — removes noise from the image using a wavelet transform. Denoise it. 🧼
  • -white-threshold value — forces all pixels above the threshold into white. White out. ⚪

✨ Image Sequence Operators ✨

okay now we're doing sequences, bestie. These operators work on multiple images at once. It's giving group project energy. 🌈

  • -affinity filename — transforms image colors to match this set of colors. Color matching. 🎨
  • -append — appends an image sequence top to botto (use +append for left to right). Stack 'em. 📚
  • -clut — applies a color lookup table to the image. CLUT it. 🌈
  • -coalesce — merges a sequence of images. Coalesce it. 🧩
  • -combine — combines a sequence of images. Combine it. 🧬
  • -compare — mathematically and visually annotates the difference between an image and its reconstruction. Compare and contrast. 🔍
  • -complex operator — performs complex mathematics on an image sequence. Complex math, no cap. 🧮
  • -composite — composites image. Composite it. 🖼️
  • -copy geometry offset, — copies pixels from one area of an image to another. Copy-paste. 📋
  • -crop geometry — cuts out a rectangular region of the image. Crop it. ✂️
  • -deconstruct — breaks down an image sequence into constituent parts. Deconstruct it. 🧩
  • -evaluate-sequence operator — evaluates an arithmetic, relational, or logical expression. Sequence evaluation. 📊
  • -flatten — flattens a sequence of images. Flatten it. 🗜️
  • -fx expression — applies mathematical expression to an image channel(s). FX magic. ✨
  • -hald-clut — applies a Hald color lookup table to the image. Hald CLUT. 🌈
  • -morph value — morphs an image sequence. Morph it. 🦋
  • -mosaic — creates a mosaic from an image sequence. Mosaic it. 🧱
  • -poly terms — builds a polynomial from the image sequence and the corresponding terms (coefficients and degree pairs). Polynomial time. 📈
  • -process arguments — processes the image with a custom image filter. Process it. ⚙️
  • -separate — separates an image channel into a grayscale image. Separate it. 🎨
  • -smush geometry — smushes an image sequence together. Smush it. 🫠
  • -write filename — writes images to this file. Write it. 💾

🌈 Image Stack Operators 🌈

okay bestie these ones are literally about shuffling your pics around inside the sequence like a little deck of cards 💅

  • -delete indexes — yeet that image right out of the image sequence. gone. not invited to the group chat anymore 🫶
  • -duplicate count,indexes — make one or more copies of an image, like when you send the same selfie to three different people 😭
  • -insert index — slide the last image into the image sequence at the spot you want ✨
  • -reverse — flip the whole image sequence backwards, it's giving "watch it in reverse" energy 👑
  • -swap indexes — trade two images' positions in the sequence, no questions asked 🌸

🎀 Miscellaneous Options 🎀

the little extras, the side quests, the iykyk section 💖

  • -debug events — spill the tea, show copious debugging information 🔍
  • -distribute-cache port — set up a distributed pixel cache that spans one or more servers, lowkey iconic for big workloads 🦋
  • -help — print the program options, the classic "wait what do I do" button 🙈
  • -log format — choose the format of your debugging information 📝
  • -list type — print out a whole list of supported option arguments, very "let me check the menu" of it ⭐
  • -version — print version information, main character stats reveal 💅

🔮 the format thing 🔮

By default, the image format of file is determined by its magic number. (not me calling it a magic number, that's literally what it's called, it's real, no cap ✨)

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.

🌟 tiny but mighty detail: that lone - is how you pipe stuff in or out, and yes it slays.

👀 SEE ALSO 👀

go read that one too bestie, it's the sibling page 🫶

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

and that's the whole page, bestie!! 🎀 this one came from ImageMagick, dated 2009/01/10 01:00:00, and it lives under the name mogrify-im6.q16hdri(1) — go forth and mogrify responsibly, mwah 💖✨

📦 where this page comes from