mogrify-im7.q16(1)

📦
version 7.1.2.31 · 2 versions
, in ubuntu resolute, ubuntu stonking

💖 mogrify-im7.q16(1) 💖

okay bestie, listen up — this is the manual page for mogrify-im7.q16, from the General Commands Manual section. yes it's a lot. yes you're gonna be obsessed. let's go ✨

✨ 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-im7.q16(1) writes to a different image file. 🫶

okay so this is the big difference and it's giving permanent-marker energy — mogrify edits in place, no undo, no take-backs. convert-im7.q16(1) makes a whole new file like a polite little angel. iykyk 💅

✨ SYNOPSIS ✨

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

✨ OVERVIEW ✨

The mogrify-im7.q16 program is a member of the ImageMagick-ims7.q16(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-im7.q16(1) except the original image file is overwritten with any changes you request. no cap. 😭

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:

the whole setting menu, bestie. every single one. don't skip, we don't do that here 💜

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

and that's just the Image Settings section, bestie — there's more coming, don't you dare close the tab 🌸

✨ Image Operators ✨

okay bestie, this is the big one — the whole operator menu. every single flag is here, no skips, no cap. grab a boba and let's go. 🧋💖

  • -adaptive-blur geometry — adaptively blurs pixels; the blur effect decreases near the edges, so it's soft but not messy. ✨
  • -adaptive-resize geometry — adaptively resizes the image using data-dependent triangulation. smart resize behavior, fr fr.
  • -adaptive-sharpen geometry — adaptively sharpens pixels; the sharpen effect increases near the edges. edge girlies stay winning. 💅
  • -alpha option — set alpha behavior to one of on, activate, off, deactivate, set, opaque, copy, transparent, extract, background, or shape. pick your fighter. 🎀
  • -annotate geometry text — annotate the image with text. put words on the picture, periodt. 💬
  • -auto-gamma — automagically adjust the gamma level of the image. it just knows. 🔮
  • -auto-level — automagically adjust the color levels of the image. auto-level, no cap.
  • -auto-orient — automatically orient the image. no more sideways pics. 📸
  • -auto-threshold method — automatically perform image thresholding. let it cook. 🍳
  • -bench iterations — measure performance over the given iterations. benchmark era. ⏱️
  • -bilateral-blur geometry — a non-linear, edge-preserving, and noise-reducing smoothing filter. it's giving smooth skin while keeping the edges crisp. 🫧
  • -black-threshold value — force all pixels below the threshold into black. below this value? straight to black. 🖤
  • -blue-shift — simulate a scene at nighttime in the moonlight. moonlit vibe, unlocked. 🌙
  • -blur geometry — reduce image noise and reduce detail levels. classic blur, still iconic. 💗
  • -border geometry — surround the image with a border of color. frame it up. 🖼️
  • -brightness-contrast geometry — improve brightness / contrast of the image. glow-up mode. ✨
  • -canny geometry — detect edges in the image with Canny. edge detection, served. 🔍
  • -channel mask — set the image channel mask. channel control, iykyk.
  • -charcoal radius — simulate a charcoal drawing. artsy era. 🎨
  • -chop geometry — remove pixels from the image interior. chop chop. ✂️
  • -clahe geometry — contrast limited adaptive histogram equalization. say that three times fast. 😭
  • -clamp — keep pixel values in range (0-QuantumRange). no out-of-bounds nonsense. 🚧
  • -clip — clip along the first path from the 8BIM profile. profile clipping, periodt.
  • -clip-mask filename — associate a clip mask with the image. mask file, linked. 🎭
  • -clip-path id — clip along a named path from the 8BIM profile. named path, clipped. 🛤️
  • -colorize value — colorize the image with the fill color. tint it, bestie. 🎨
  • -color-matrix matrix — apply color correction to the image. matrix math but make it fashion. 💅
  • -colors value — preferred number of colors in the image. set the palette limit. 🌈
  • -color-threshold start_color-stop_color — force all pixels in the color range to white otherwise black. in-range = white, out-of-range = black. ⚫⚪
  • -connected-component connectivity — connected-components uniquely labeled. label those blobs. 🫧
  • -contrast — enhance or reduce the image contrast. contrast check. ✅
  • -contrast-stretch geometry — improve contrast by `stretching' the intensity range. stretch it out. 🧘
  • -convolve coefficients — apply a convolution kernel to the image. kernel time. 🍿
  • -cycle amount — cycle the image colormap. color cycle, go round. 🔄
  • -deskew threshold — straighten an image. fix that tilt. 📐
  • -despeckle — reduce the speckles within an image. bye speckles. 🧹
  • -distort method args — distort images according to given method and args. bend it, warp it. 🌀
  • -draw string — annotate the image with a graphic primitive. draw string, do your thing. 🖌️
  • -edge radius — apply a filter to detect edges in the image. edge filter, activated. 🔎
  • -emboss radius — emboss an image. 3D-ish texture, hello. 🏔️
  • -enhance — apply a digital filter to enhance a noisy image. clean it up. 🧼
  • -equalize — perform histogram equalization to an image. histogram said equality. 📊
  • -evaluate operator value — evaluate an arithmetic, relational, or logical expression. math but make it image. 🧮
  • -extent geometry — set the image size. extent set. 📏
  • -extract geometry — extract area from image. grab that region. ✂️
  • -fft — implements the discrete Fourier transform (DFT). frequency domain era. 📡
  • -flip — flip image vertically. upside down, but vertical. 🙃
  • -floodfill geometry color — floodfill the image with color. fill it up. 🪣
  • -flop — flop image horizontally. horizontal flip, flop era. ↔️
  • -frame geometry — surround image with an ornamental border. fancy frame, unlocked. 🖼️
  • -gamma value — level of gamma correction. gamma adjust. 🌗
  • -gaussian-blur geometry — reduce image noise and reduce detail levels. Gaussian blur, the classic. 💗
  • -geometry geometry — preferred size or location of the image. geometry says where and how big. 📐
  • -grayscale method — convert image to grayscale. grayscale method, pick one. 🩶
  • -help — print program options. help me help you. 🆘
  • -hough-lines geometry — identify lines in the image. line detection, Hough style. 📏
  • -identify — identify the format and characteristics of the image. spill the tea, image. 🕵️
  • -ift — implements the inverse discrete Fourier transform (DFT). inverse DFT, back to pixels. 🔁
  • -implode amount — implode image pixels about the center. inward collapse, dramatic. 💥
  • -integral — calculate the sum of values (pixel values) in the image. sum it up. ➕
  • -interpolative-resize geometry — resize image using interpolation. smooth resize. 🫧
  • -kmeans geometry — K means color reduction. K means, reduce colors. 🎨
  • -lat geometry — local adaptive thresholding. LAT, local and adaptive. 🗺️
  • -layers method — optimize or compare image layers. layer logic, engaged. 🧅
  • -level value — adjust the level of image contrast. level up. 🆙
  • -level-colors color,color — level image with the given colors. colors as levels. 🌈
  • -linear-stretch geometry — improve contrast by `stretching with saturation' the intensity range. stretch with saturation, periodt. 🧘
  • -liquid-rescale geometry — rescale image with seam-carving. liquid rescale, seam-carving magic. 🪄
  • -magnify — double the size of the image with pixel art scaling. pixel art zoom. 🔍
  • -mean-shift geometry — delineate arbitrarily shaped clusters in the image. cluster delineation. 🫧
  • -median geometry — apply a median filter to the image. median filter, smooth operator. 🧴
  • -mode geometry — make each pixel the 'predominant color' of the neighborhood. mode filter, majority rules. 👑
  • -modulate value — vary the brightness, saturation, and hue. modulate the vibe. 🎛️
  • -monochrome — transform image to black and white. monochrome moment. ⚫⚪
  • -motion-blur geometry — simulate motion blur. zoom zoom blur. 💨
  • -negate — replace each pixel with its complementary color. negative, but make it color. 🔄
  • -noise geometry — add or reduce noise in an image. noise control. 📻
  • -normalize — transform image to span the full range of colors. normalize the range. 🌈
  • -opaque color — change this color to the fill color. opaque swap. 🎨
  • -ordered-dither NxN — add a noise pattern to the image with specific amplitudes. ordered dither, NxN style. 🔲
  • -paint radius — simulate an oil painting. oil paint filter, art era. 🖼️
  • -polaroid angle — simulate a Polaroid picture. Polaroid angle, vintage vibes. 📸
  • -posterize levels — reduce the image to a limited number of color levels. posterize, limited palette. 🎚️
  • -print string — interpret string and print to console. print string, console says hi. 🖨️
  • -profile filename — add, delete, or apply an image profile. profile management, periodt. 📁
  • -quantize colorspace — reduce colors in this colorspace. quantize in colorspace. 🎨
  • -radial-blur angle — radial blur the image. radial blur, spinny. 🌀
  • -raise value — lighten/darken image edges to create a 3-D effect. raised 3D edge. 🧊
  • -random-threshold low,high — random threshold the image. random threshold, chaos but controlled. 🎲
  • -range-threshold values — perform either hard or soft thresholding within some range of values in an image. hard or soft, in range. 🎚️
  • -region geometry — apply options to a portion of the image. region-specific options. 📍
  • -render — render vector graphics. vector render, slay. 🖋️
  • -resample geometry — change the resolution of an image. resample resolution. 📐
  • -resize geometry — resize the image. resize era. 📏
  • -roll geometry — roll an image vertically or horizontally. roll it. 🎳
  • -rotate degrees — apply Paeth rotation to the image. Paeth rotation, degrees. 🔄
  • -sample geometry — scale image with pixel sampling. sample scale. 🔍
  • -scale geometry — scale the image. scale it. ⚖️
  • -segment values — segment an image. segmentation. 🧩
  • -selective-blur geometry — selectively blur pixels within a contrast threshold. selective blur, contrast-aware. 🫧
  • -sepia-tone threshold — simulate a sepia-toned photo. sepia tone, vintage. 📜
  • -set property value — set an image property. set property, value. 🏷️
  • -shade degrees — shade the image using a distant light source. distant light shading. 💡
  • -shadow geometry — simulate an image shadow. shadow sim. 🌑
  • -sharpen geometry — sharpen the image. sharpen, 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. shear along X or Y. 📐
  • -sigmoidal-contrast geometry — lightness rescaling using sigmoidal contrast enhancement. sigmoidal contrast, fancy. 📈
  • -sketch geometry — simulate a pencil sketch. pencil sketch filter. ✏️
  • -solarize threshold — negate all pixels above the threshold level. solarize above threshold. ☀️
  • -sort-pixels — sort each scanline in ascending order of intensity. sort pixels, ascending. 🔢
  • -sparse-color method args — fill in a image based on a few color points. sparse color fill. 🎨
  • -splice geometry — splice the background color into the image. splice background color. 🧬
  • -spread amount — displace image pixels by a random amount. random spread. 🎲
  • -statistic type geometry — replace each pixel with corresponding statistic from the neighborhood. statistic neighborhood. 📊
  • -strip — strip image of all profiles and comments. strip it all. 🫥
  • -swirl degrees — swirl image pixels about the center. swirl around center. 🌀
  • -threshold value — threshold the image. threshold. 🚦
  • -thumbnail geometry — create a thumbnail of the image. thumbnail time. 🖼️
  • -tile filename — tile image when filling a graphic primitive. tile fill. 🧱
  • -tint value — tint the image with the fill color. tint with fill color. 🎨
  • -transform — affine transform image. affine transform. 🔄
  • -transparent color — make this color transparent within the image. transparent color. 🫥
  • -transpose — flip image vertically and rotate 90 degrees. transpose, flip + rotate. 🔄
  • -transverse — flop image horizontally and rotate 270 degrees. transverse, flop + rotate. 🔃
  • -trim — trim image edges. trim the edges. ✂️
  • -type type — image type. set the type. 🏷️
  • -unique-colors — discard all but one of any pixel color. unique colors only. 🌈
  • -unsharp geometry — sharpen the image. unsharp sharpen. 🔪
  • -vignette geometry — soften the edges of the image in vignette style. vignette soft edges. 🌫️
  • -wave geometry — alter an image along a sine wave. wave sine. 🌊
  • -wavelet-denoise threshold — removes noise from the image using a wavelet transform. wavelet denoise. 🧼
  • -white-balance — automagically adjust white balance of image. auto white balance. ⚪
  • -white-threshold value — force all pixels above the threshold into white. above this value? straight to white. ⚪

✨ Image Channel Operators ✨

  • -channel-fx expression — exchange, extract, or transfer one or more image channels. channel fx, do your thing. 🔀
  • -separate — separate an image channel into a grayscale image. separate channel, grayscale result. 🩶

💖 Image Sequence Operators 💖

okay bestie, this batch is for when you're not working with one pic but a whole sequence of them. group-project energy, fr fr. 🫶

  • -affinity filename — transform image colors to match this set of colors. it's a full vibe-match makeover ✨
  • -append — append an image sequence top to bottom (use +append for left to right). yes the plus sign changes the whole direction, iykyk 💅
  • -clut — apply a color lookup table to the image. glow-up via lookup table 🎀
  • -coalesce — merge a sequence of images.
  • -combine — combine a sequence of images.
  • -compare — mathematically and visually annotate the difference between an image and its reconstruction. detective mode, no cap 🔍
  • -complex operator — perform complex mathematics on an image sequence. math girlies rise 🧮
  • -composite — composite image.
  • -copy geometry offset, — copy pixels from one area of an image to another.
  • -crop geometry — cut out a rectangular region of the image. scissors behavior ✂️
  • -deconstruct — break down an image sequence into constituent parts.
  • -evaluate-sequence operator — evaluate an arithmetic, relational, or logical expression.
  • -flatten — flatten a sequence of images.
  • -fx expression — apply mathematical expression to an image channel(s).
  • -hald-clut — apply a Hald color lookup table to the image.
  • -morph value — morph an image sequence. it's giving transformation sequence 🌈
  • -mosaic — create a mosaic from an image sequence.
  • -poly terms — build a polynomial from the image sequence and the corresponding terms (coefficients and degree pairs). yes bestie, actual coefficients AND degree pairs 💀
  • -process arguments — process the image with a custom image filter.
  • -separate — separate an image channel into a grayscale image.
  • -smush geometry — smush an image sequence together. "smush" is the technical term, I don't make the rules 🦋
  • -write filename — write images to this file.

🧚 Image Stack Operators 🧚

these ones are all about arranging the stack — deleting, duplicating, shuffling. it's the group chat admin toolkit fr.

  • -delete indexes — delete the image from the image sequence.
  • -duplicate count,indexes — duplicate an image one or more times.
  • -insert index — insert last image into the image sequence.
  • -reverse — reverse image sequence.
  • -swap indexes — swap two images in the image sequence.

🌸 Miscellaneous Options 🌸

the lil extras. not the main character of the page but absolutely essential, lowkey 👑

  • -debug events — display copious debugging information. "copious" is doing a LOT of heavy lifting here, and it's accurate 💀
  • -distribute-cache port — distributed pixel cache spanning one or more servers.
  • -help — print program options.
  • -log format — format of debugging information.
  • -list type — print a list of supported option arguments.
  • -version — print version information.

okay and here's the format tea, because it matters:

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.

so like, - means stdin/stdout. the little dash is the main character. periodt 💅

👑 SEE ALSO 👑

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

and that's the whole page bestie, we made it 🫶 this iconic little manual is brought to you by ImageMagick, dated 2009/01/10 01:00:00, and the page itself is mogrify-im7.q16(1) — go forth and mogrify responsibly ✨

📦 where this page comes from