convert-im6.q16(1)

hiii bestie 💖 you're reading the convert-im6.q16(1) page from the General Commands Manual — and ngl, this one is a whole main character. It's the ImageMagick glow-up tool that does so much. Let's get into it, no cap. ✨

---

✨ NAME ✨

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

---

🌸 SYNOPSIS 🌸

convert-im6.q16 [input-option] input-file [output-option] output-file

---

💫 OVERVIEW 💫

The convert-im6.q16 program is a member of the ImageMagick-ims6.q16(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 convert command, point your browser to file:///usr/share/doc/imagemagick-6-common/html/www/convert.html (on debian system you may install the imagemagick-6 package) or https://www.imagemagick.org/script/convert.php. ✨

---

🎀 DESCRIPTION 🎀

okay so this part is literally the settings menu. It's giving control freak in the best way. 🫶

💖 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 💅
• -clip — clip along the first path from the 8BIM profile ✨
• -clip-mask filename — associate a clip mask with the image 🫶
• -clip-path id — clip along a named path from the 8BIM profile ✨
• -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 "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 ✨
• -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 🎀
• -moments — report image moments 💅
• -monitor — monitor progress ✨
• -orient type — image orientation 🫶
• -page geometry — size and location of an image canvas (setting) ✨
• -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 💅
• -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 — every image operator in the lineup. It’s giving spellbook but make it pixels. ✨

• -adaptive-blur geometry — blur pixels but adaptively, so the effect gets softer near the edges. It’s giving blur with boundaries. 🦋
• -adaptive-resize geometry — resize with data-dependent triangulation. Fancy adaptive resizing, no cap. 💅
• -adaptive-sharpen geometry — sharpen pixels adaptively, cranking the effect up near edges. Edge girlies stay sharp. 🔥
• -annotate geometry text — write text on your image. Annotation era. ✍️
• -auto-gamma — automagically adjusts the gamma level. Not manually, bestie — automagically. ✨
• -auto-level — automagically adjusts color levels. Same energy, different levels. 🌈
• -auto-orient — automatically orients the image. It just knows. 🧚
• -bench iterations — measures performance. Benchmarking, but make it cute. ⏱️
• -black-threshold value — forces every pixel below the threshold into black. Below the line? Black. Periodt. 🖤
• -blue-shift factor — simulates a scene at nighttime in the moonlight. Moonlight vibes only. 🌙
• -blur geometry — reduces image noise and detail levels. Soft focus, no thoughts. ☁️
• -border geometry — surrounds your image with a border of color. Frame it, bestie. 🎀
• -brightness-contrast geometry — improves brightness and/or contrast. Glow-up for your pixels. 💡
• -canny geometry — detects edges in the image. Canny said edge detection. 👑
• -charcoal radius — simulates a charcoal drawing. Art hoe mode activated. 🖤
• -chop geometry — removes pixels from the image interior. Interior design, but make it deletion. ✂️
• -clamp — keeps pixel values in range (0-QuantumRange). No overflow drama. 🛑
• -clip — clips along the first path from the 8BIM profile. Path girlie. 🛤️
• -clip-mask filename — associates a clip mask with the image. Mask on, bestie. 🎭
• -clip-path id — clips along a named path from the 8BIM profile. Named path? We love specificity. 💅
• -colorize value — colorizes the image with the fill color. Tint it, slay it. 🎨
• -color-matrix matrix — applies color correction to the image. Matrix math but make it fashion. 🧮
• -connected-component connectivity — finds connected components, uniquely labeled. Connected, not confused. 🔗
• -contrast — enhances or reduces the image contrast. Contrast is a personality trait. ⚡
• -contrast-stretch geometry — improves contrast by stretching the intensity range. Stretch, bestie. 🧘
• -convolve coefficients — applies a convolution kernel to the image. Kernel panic? No, kernel glam. 🌽
• -cycle amount — cycles the image colormap. Colormap go round and round. 🎠
• -deskew threshold — straightens an image. Posture check for pixels. 📐
• -despeckle — reduces the speckles within an image. Speckles? Not today. 🧹
• -distort method args — distorts images according to the given method and args. Chaos, but specified. 🌪️
• -draw string — annotates the image with a graphic primitive. Draw something, bestie. 🖍️
• -edge radius — applies a filter to detect edges in the image. Edge detection, but make it filter. 🔍
• -emboss radius — embosses an image. Raised edges, fancy. 🏔️
• -enhance — applies a digital filter to enhance a noisy image. Noise cancellation for the girlies. 🎧
• -equalize — performs histogram equalization on an image. Equalize the histogram, equalize the vibe. 📊
• -evaluate operator value — evaluates an arithmetic, relational, or logical expression. Math class but make it image. ➗
• -extent geometry — sets the image size. Size matters, but here it’s literal. 📏
• -extract geometry — extracts an area from the image. Extraction, but cute. 🧲
• -fft — implements the discrete Fourier transform (DFT). Fourier said hey. 🌀
• -flip — flips the image vertically. Upside down, but on purpose. 🙃
• -floodfill geometry color — floodfills the image with color. Fill it up, bestie. 🌊
• -flop — flops the image horizontally. Horizontal flip, not a bad dance move. 💃
• -frame geometry — surrounds the image with an ornamental border. Ornamental, not optional. 🖼️
• -function name — applies a function to the image. Function call, but visual. 📞
• -gamma value — sets the level of gamma correction. Gamma rays but make it color. ☢️
• -gaussian-blur geometry — reduces image noise and detail levels. Gaussian blur, soft launch. 🌫️
• -geometry geometry — preferred size or location of the image. Geometry class but useful. 📐
• -grayscale method — converts image to grayscale. Gray area? More like grayscale area. 🩶
• -hough-lines geometry — identifies lines in the image. Line detection, no cap. 📏
• -identify — identifies the format and characteristics of the image. ID check, but for pixels. 🪪
• -ift — implements the inverse discrete Fourier transform (DFT). Inverse Fourier, the sequel. 🔄
• -implode amount — implodes image pixels about the center. Implosion, but artistic. 💥
• -interpolative-resize geometry — resizes image using 'point sampled' interpolation. Point sampled, point taken. 📍
• -lat geometry — local adaptive thresholding. LAT girlies rise. 🌟
• -layers method — optimizes or compares image layers. Layer cake, but technical. 🍰
• -level value — adjusts the level of image contrast. Level up the contrast. 🎚️
• -level-colors color,color — levels the image with the given colors. Two colors, one level. 🎨
• -linear-stretch geometry — improves contrast by stretching with saturation the intensity range. Stretch with saturation, periodt. 🌈
• -liquid-rescale geometry — rescales image with seam-carving. Liquid rescale, glowy. 💧
• -magnify — doubles the size of the image with pixel art scaling. Pixel art magnify, iconic. 🔍
• -mean-shift geometry — delineates arbitrarily shaped clusters in the image. Clusters? Delineated. 🫧
• -median geometry — applies a median filter to the image. Median filter, middle child energy. ⚖️
• -mode geometry — makes each pixel the 'predominant color' of the neighborhood. Predominant color, main character. 👑
• -modulate value — varies the brightness, saturation, and hue. Modulate the vibe. 🎛️
• -monochrome — transforms image to black and white. Black and white, no gray area. ⚫⚪
• -morphology method kernel — applies a morphology method to the image. Morphology, but make it method and kernel. 🧬
• -motion-blur geometry — simulates motion blur. Moving fast, blurry. 🏃‍♀️💨
• -negate — replaces each pixel with its complementary color. Negate, invert, serve. 🔄
• -noise geometry — adds or reduces noise in an image. Noise? Added or reduced, your call. 📢
• -normalize — transforms image to span the full range of colors. Full range, no skips. 🌈
• -opaque color — changes this color to the fill color. Opaque? Not anymore. 🎨
• -ordered-dither NxN — adds a noise pattern to the image with specific amplitudes. Ordered dither, chaotic cute. 🔲
• -paint radius — simulates an oil painting. Oil painting, but digital. 🎨
• -perceptible epsilon — pixel value less than |epsilon| become epsilon or -epsilon. Perceptible, epsilon, math bestie. 🔬
• -polaroid angle — simulates a Polaroid picture. Polaroid, but angled. 📸
• -posterize levels — reduces the image to a limited number of color levels. Posterize, limited palette, unlimited slay. 🎨
• -print string — interprets string and prints to console. Print it, bestie. 🖨️
• -profile filename — adds, deletes, or applies an image profile. Profile pic, but for images. 👤
• -quantize colorspace — reduces colors in this colorspace. Quantize, don’t minimize the vibe. 🎨
• -radial-blur angle — radial blurs the image. Radial blur, spinning. 🌀
• -raise value — lightens/darkens image edges to create a 3-D effect. 3-D effect, raised. 🧊
• -random-threshold low,high — random thresholds the image. Random threshold, random slay. 🎲
• -region geometry — applies options to a portion of the image. Region girlies, this one’s for you. 🗺️
• -render — renders vector graphics. Render it, periodt. 🎬
• -resample geometry — changes the resolution of an image. Resample, resolution refresh. 🔄
• -resize geometry — resizes the image. Resize, but make it geometry. 📐
• -roll geometry — rolls an image vertically or horizontally. Roll it, bestie. 🎳
• -rotate degrees — applies Paeth rotation to the image. Paeth rotation, rotate with a name. 🔄
• -sample geometry — scales image with pixel sampling. Pixel sampling, sample sale. 🛍️
• -scale geometry — scales the image. Scale it up, scale it down. ⚖️
• -segment values — segments an image. Segmentation, but cute. ✂️
• -selective-blur geometry — selectively blurs pixels within a contrast threshold. Selective blur, selective slay. 🎯
• -sepia-tone threshold — simulates a sepia-toned photo. Sepia tone, vintage vibe. 📜
• -set property value — sets an image property. Set it, bestie. ⚙️
• -shade degrees — shades the image using a distant light source. Distant light, dramatic shade. 💡
• -shadow geometry — simulates an image shadow. Shadow work, but visual. 🌑
• -sharpen geometry — sharpens the image. Sharp, like your wit. 🔪
• -shave geometry — shaves pixels from the image edges. Shave the edges, not the vibe. 🪒
• -shear geometry — slides one edge of the image along the X or Y axis. Shear, slide, serve. 📐
• -sigmoidal-contrast geometry — lightness rescaling using sigmoidal contrast enhancement. Sigmoidal contrast, fancy math. 📈
• -sketch geometry — simulates a pencil sketch. Pencil sketch, but make it digital. ✏️
• -solarize threshold — negates all pixels above the threshold level. Solarize, above the threshold. ☀️
• -sparse-color method args — fills in an image based on a few color points. Sparse color, few points, big impact. 🎨
• -splice geometry — splices the background color into the image. Splice it in. 🧬
• -spread amount — displaces image pixels by a random amount. Spread pixels, spread love. 🫶
• -strip — strips image of all profiles and comments. Strip it down, no comments. 🧼
• -swirl degrees — swirls image pixels about the center. Swirl, twirl, slay. 🍭
• -threshold value — thresholds the image. Threshold, but make it value. 🚪
• -thumbnail geometry — creates a thumbnail of the image. Thumbnail, tiny but mighty. 🖼️
• -tile filename — tiles image when filling a graphic primitive. Tile it, bestie. 🧱
• -tint value — tints the image with the fill color. Tint, not too much. 🎨
• -transform — affine transforms image. Affine transform, fancy. 🧬
• -transparent color — makes this color transparent within the image. Transparent, see-through slay. 👻
• -transpose — flips image vertically and rotates 90 degrees. Transpose, flip and rotate. 🔄
• -transverse — flops image horizontally and rotates 270 degrees. Transverse, flop and rotate. 🔃
• -trim — trims image edges. Trim the edges, keep the content. ✂️
• -type type — image type. Type check, but visual. 🔠
• -unique-colors — discards all but one of any pixel color. Unique colors only, duplicates not invited. 🌈
• -unsharp geometry — sharpens the image. Unsharp sharpen, make it make sense. 🔪
• -vignette geometry — softens the edges of the image in vignette style. Vignette, soft edges, mood. 🌫️
• -wave geometry — alters an image along a sine wave. Sine wave, but make it image. 🌊
• -wavelet-denoise threshold — removes noise from the image using a wavelet transform. Wavelet denoise, bye noise. 👋
• -white-threshold value — forces all pixels above the threshold into white. Above the threshold? White. Periodt. 🤍

---

🎀 Image Sequence Operators 🎀

Sequence operators, bestie — this is where images start moving as a group. Group chat energy, but visual. 🫶

• -append — appends an image sequence top to bottom (use +append for left to right). Top to bottom, unless you want left to right. 💫
• -clut — applies a color lookup table to the image. CLUT, color lookup, cute. 🎨
• -coalesce — merges a sequence of images. Coalesce, merge, unite. 🤝
• -combine — combines a sequence of images. Combine, but make it sequence. 🔗
• -compare — mathematically and visually annotates the difference between an image and its reconstruction. Compare and contrast, literally. 🧐
• -complex operator — performs complex mathematics on an image sequence. Complex math, complex slay. 🧮
• -composite — composites image. Composite, layer it up. 🧅
• -copy geometry offset, — copies pixels from one area of an image to another. Copy-paste, but for pixels. 📋
• -crop geometry — cuts out a rectangular region of the image. Crop it, bestie. ✂️
• -deconstruct — breaks down an image sequence into constituent parts. Deconstruct, break it down. 🧩
• -evaluate-sequence operator — evaluates an arithmetic, relational, or logical expression. Sequence evaluation, math but sequenced. ➗
• -flatten — flattens a sequence of images. Flatten, no layers left. 🫓
• -fx expression — applies a mathematical expression to an image channel(s). FX, but math. 🎛️
• -hald-clut — applies a Hald color lookup table to the image. Hald CLUT, specific and slay. 🎨
• -morph value — morphs an image sequence. Morph, transform, serve. 🦋
• -mosaic — creates a mosaic from an image sequence. Mosaic, tile it up. 🧱
• -poly terms — builds a polynomial from the image sequence and the corresponding terms (coefficients and degree pairs). Polynomial, terms, coefficients, degree pairs — math bestie. 📐
• -process arguments — processes the image with a custom image filter. Custom filter, custom vibe. 🎛️
• -separate — separates an image channel into a grayscale image. Separate, grayscale. 🌫️
• -smush geometry — smushes an image sequence together. Smush, squish, together. 🫂
• -write filename — writes images to this file. Write it to a file, bestie. 💾

---

🧚 Image Stack Operators 🧚

Stack operators, the final boss of this part — this is how you clone, delete, duplicate, insert, reverse and swap images in the sequence. Organized chaos, but make it iconic. 👑

• -clone indexes — clones an image. Clone, but make it image. 👯
• -delete indexes — deletes the image from the image sequence. Delete, remove, bye. 🗑️
• -duplicate count,indexes — duplicates an image one or more times. Duplicate, copy, repeat. 🔁
• -insert index — inserts last image into the image sequence. Insert, place, done. 📥
• -reverse — reverses image sequence. Reverse, backwards, serve. 🔄
• -swap indexes — swaps two images in the image sequence. Swap, trade, switch. 🔀

🌈 Miscellaneous Options 🌈

• -debug events — spills the copious amounts of debugging tea, like literally so much info, bestie, prepare yourself 💅
• -distribute-cache port — a distributed pixel cache that stretches across one or more servers ✨
• -help — prints the program options, i.e. the menu of what this thing can do 🎀
• -log format — sets the format of that debugging information
• -list type — prints out a list of the supported option arguments, a whole lil catalogue fr fr
• -version — prints the version information, the origin story 🦋

---

Okay so here's a thing that's lowkey iconic: you can use any setting or operator as an output-option. But only a limited number of settings work as an input-option. The ones that do are:

• -antialias
• -caption
• -density
• -define
• -encoding
• -font
• -pointsize
• -size
• -texture

…plus any of the miscellaneous options 💖

---

Now, the detective work: by default, the image format of file gets figured out from its magic number ✨ (yes it's literally called that, slay). Wanna pick a specific format yourself? Two ways, bestie:

1. Put an image format name and a colon in front of the filename — like ps:image
2. Or just make the image type the filename suffix — like image.ps

And if you want standard input or standard output? Hand it '-' as the file 🌸

---

👀 SEE ALSO 👀

ImageMagick-im6.q16(1)

---

💜 COPYRIGHT 💜

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 a wrap on the whole page, bestie!! 🫶 this lil manual is from ImageMagick, version-dated 2009/01/10 01:00:00, and it lives as convert-im6.q16(1). go forth and convert some images, you absolute main character 👑💖