convert-im7.q16(1)

💅 convert-im7.q16(1) — part 1, bestie 💅

okay so welcome to the convert-im7.q16(1) manual page, part 1. this is the convert command from the ImageMagick suite, and she does a lot. grab a boba, because we are going through every single flag. no skips. 💖

---

✨ 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. it's giving multitool main character energy 🦋

🎀 SYNOPSIS 🎀

magick-im7.q16 convert [input-options] input-file [output-options] output-file

🦋 OVERVIEW 🦋

The convert-im7.q16 program is a member of the ImageMagick-ims7.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-7-common/html/www/convert.html (on debian system you may install the imagemagick-7 package) or https://www.imagemagick.org/script/convert.php.

👑 DESCRIPTION 👑

okay so here's where it gets long, and we love that for us. the Image Settings: section is next, and every option is staying. no cuts. periodt. 💅

💖 Image Settings: 💖

• -adjoin — join images into a single multi-image file. one file, multi-image energy.
• -affine matrix — affine transform matrix. give it the matrix.
• -alpha option — activate, deactivate, reset, or set the alpha channel. alpha decisions are real decisions.
• -antialias — remove pixel-aliasing. bye jagged edges.
• -authenticate value — decrypt image with this password. keep it secret, keep it safe.
• -attenuate value — lessen (or intensify) when adding noise to an image. turn the noise down or up.
• -background color — background color. the backdrop of the whole vibe.
• -bias value — add bias when convolving an image. convolution bias moment.
• -black-point-compensation — use black point compensation. bpc, but make it cute.
• -blue-primary point — chromaticity blue primary point. blue primary coordinates.
• -bordercolor color — border color. frame it up.
• -caption string — assign a caption to an image. caption time.
• -cdl filename — color correct with a color decision list. CDL file says what it says.
• -clip — clip along the first path from the 8BIM profile. first path from the 8BIM profile.
• -clip-mask filename — associate a clip mask with the image. clip mask file.
• -clip-path id — clip along a named path from the 8BIM profile. named path from the 8BIM profile.
• -colorspace type — alternate image colorspace. change the color space.
• -comment string — annotate image with comment. add a comment.
• -compose operator — set image composite operator. compose operator, set.
• -compress type — type of pixel compression when writing the image. compression type on write.
• -decipher filename — convert cipher pixels to plain pixels. decrypt those pixels.
• -define format:option — define one or more image format options. format-specific define.
• -delay centiseconds — display the next image after pausing. delay in centiseconds.
• -density geometry — horizontal and vertical density of the image. x/y density.
• -depth value — image depth. bit depth.
• -direction type — render text right-to-left or left-to-right. text direction.
• -display server — get image or font from this X server. X display.
• -dispose method — layer disposal method. disposal method.
• -dither method — apply error diffusion to image. dither method.
• -encipher filename — convert plain pixels to cipher pixels. encrypt those pixels.
• -encoding type — text encoding type. encoding.
• -endian type — endianness (MSB or LSB) of the image. endian.
• -family name — render text with this font family. font family.
• -features distance — analyze image features (e.g. contrast, correlation). feature analysis.
• -fill color — color to use when filling a graphic primitive. fill color.
• -filter type — use this filter when resizing an image. resize filter.
• -flatten — flatten a sequence of images. flatten the sequence.
• -font name — render text with this font. font.
• -format "string" — output formatted image characteristics. formatted output.
• -fuzz distance — colors within this distance are considered equal. fuzz distance.
• -gravity type — horizontal and vertical text placement. gravity.
• -green-primary point — chromaticity green primary point. green primary.
• -intensity method — method to generate intensity value from pixel. intensity method.
• -intent type — type of rendering intent when managing the image color. rendering intent.
• -interlace type — type of image interlacing scheme. interlace scheme.
• -interline-spacing value — set the space between two text lines. line spacing.
• -interpolate method — pixel color interpolation method. interpolation method.
• -interword-spacing value — set the space between two words. word spacing.
• -kerning value — set the space between two letters. kerning.
• -label string — assign a label to an image. label.
• -limit type value — pixel cache resource limit. resource limit.
• -loop iterations — add Netscape loop extension to your GIF animation. loop that GIF.
• -matte — store matte channel if the image has one. matte channel.
• -mattecolor color — frame color. matte color.
• -metric type — measure differences between images with this metric. metric.
• -moments — report image moments. moments.
• -monitor — monitor progress. progress monitor.
• -orient type — image orientation. orientation.
• -page geometry — size and location of an image canvas (setting). page geometry setting.
• -ping — efficiently determine image attributes. ping attributes.
• -pointsize value — font point size. point size.
• -precision value — maximum number of significant digits to print. precision.
• -preview type — image preview type. preview type.
• -quality value — JPEG/MIFF/PNG compression level. quality.
• -quiet — suppress all warning messages. quiet warnings.
• -read-mask filename — associate a read mask with the image. read mask.
• -red-primary point — chromaticity red primary point. red primary.
• -regard-warnings — pay attention to warning messages. warnings matter.
• -remap filename — transform image colors to match this set of colors. remap colors.
• -repage geometry — size and location of an image canvas. repage.
• -respect-parentheses — settings remain in effect until parenthesis boundary. respect parentheses.
• -sampling-factor geometry — horizontal and vertical sampling factor. sampling factor.
• -scene value — image scene number. scene number.
• -seed value — seed a new sequence of pseudo-random numbers. random seed.
• -size geometry — width and height of image. size.
• -statistic type geometry — replace each pixel with corresponding statistic from the neighborhood. statistic.
• -stretch type — render text with this font stretch. font stretch.
• -stroke color — graphic primitive stroke color. stroke color.
• -strokewidth value — graphic primitive stroke width. stroke width.
• -style type — render text with this font style. font style.
• -support factor — resize support: > 1.0 is blurry, < 1.0 is sharp. support factor.
• -synchronize — synchronize image to storage device. sync to storage.
• -taint — declare the image as modified. taint modified.
• -texture filename — name of texture to tile onto the image background. texture tile.
• -tile-offset geometry — tile offset. offset.
• -treedepth value — color tree depth. tree depth.
• -transparent-color color — transparent color. transparent color.
• -undercolor color — annotation bounding box color. undercolor.
• -units type — the units of image resolution. resolution units.
• -verbose — print detailed information about the image. verbose details.
• -virtual-pixel method — virtual pixel access method. virtual pixel method.
• -weight type — render text with this font weight. font weight.
• -white-point point — chromaticity white point. white point.
• -write-mask filename — associate a write mask with the image. write mask.

✨ Image Operators ✨

okay bestie, this is the whole operator menu and it's giving main character energy — every single one is here, no cap 🫶

• -adaptive-blur geometry — adaptively blurs pixels; the effect gets weaker near the edges 🌸
• -adaptive-resize geometry — adaptively resizes the image using data-dependent triangulation 💫
• -adaptive-sharpen geometry — adaptively sharpens pixels; the effect increases near the edges 🔥
• -annotate geometry text — annotates the image with text 💬
• -auto-gamma — automagically adjusts the gamma level of the image ✨
• -auto-level — automagically adjusts the color levels of the image 🌈
• -auto-orient — automatically orients the image 🧭
• -auto-threshold method — automatically performs image thresholding ⚡
• -bench iterations — measures performance 📊
• -bilateral-blur geometry — a non-linear, edge-preserving, and noise-reducing smoothing filter 🧼
• -black-threshold value — forces all pixels below the threshold into black 🖤
• -blue-shift factor — simulates a scene at nighttime in the moonlight 🌙
• -blur geometry — reduces image noise and reduces detail levels 🌫️
• -border geometry — surrounds the image with a border of color 🖼️
• -brightness-contrast geometry — improves brightness / contrast of the image ☀️
• -canny geometry — detects edges in the image 🔍
• -channel mask — sets the image channel mask 🎚️
• -charcoal radius — simulates a charcoal drawing ✏️
• -chop geometry — removes pixels from the image interior ✂️
• -clahe geometry — contrast limited adaptive histogram equalization 📈
• -clamp — keeps pixel values in range (0-QuantumRange) 🔒
• -clip — clips along the first path from the 8BIM profile 📎
• -clip-mask filename — associates a clip mask with the image 🎭
• -clip-path id — clips along a named path from the 8BIM profile 🛤️
• -colorize value — colorizes the image with the fill color 🎨
• -color-matrix matrix — applies color correction to the image 🧪
• -colors value — preferred number of colors in the image 🌈
• -color-threshold start_color-stop_color — forces all pixels in the color range to white, otherwise black ⚪⚫
• -connected-component connectivity — connected-components uniquely labeled 🧩
• -contrast — enhances or reduces the image contrast 🌗
• -contrast-stretch geometry — improves contrast by ‘stretching’ the intensity range 📏
• -convolve coefficients — applies a convolution kernel to the image 🌀
• -cycle amount — cycles the image colormap 🔄
• -deskew threshold — straightens an image 📐
• -despeckle — reduces the speckles within an image ✨
• -distort method args — distorts images according to the given method and args 🌪️
• -draw string — annotates the image with a graphic primitive 🖌️
• -edge radius — applies a filter to detect edges in the image 🔪
• -emboss radius — embosses an image 🏔️
• -enhance — applies a digital filter to enhance a noisy image ✨
• -equalize — performs histogram equalization to an image 📊
• -evaluate operator value — evaluates an arithmetic, relational, or logical expression 🧮
• -extent geometry — sets the image size 📏
• -extract geometry — extracts area from image ✂️
• -fft — implements the discrete Fourier transform (DFT) 🌊
• -flip — flips image vertically 🔃
• -floodfill geometry color — floodfills the image with color 🌊
• -flop — flops image horizontally ↔️
• -frame geometry — surrounds image with an ornamental border 🖼️
• -function name — applies a function to the image 🧠
• -gamma value — level of gamma correction 🌞
• -gaussian-blur geometry — reduces image noise and reduces detail levels 🌫️
• -geometry geometry — preferred size or location of the image 📍
• -grayscale method — converts image to grayscale 🩶
• -hough-lines geometry — identifies lines in the image 📏
• -identify — identifies the format and characteristics of the image 🪪
• -ift — implements the inverse discrete Fourier transform (DFT) 🔄
• -implode amount — implodes image pixels about the center 💥
• -integral — calculates the sum of values (pixel values) in the image ➕
• -interpolative-resize geometry — resizes image using interpolation 🧵
• -kmeans geometry — K means color reduction 🎨
• -lat geometry — local adaptive thresholding 🧱
• -layers method — optimizes or compares image layers 🧅
• -level value — adjusts the level of image contrast 🎚️
• -level-colors color,color — levels image with the given colors 🌈
• -linear-stretch geometry — improves contrast by ‘stretching with saturation’ the intensity range 📏
• -liquid-rescale geometry — rescales image with seam-carving ✂️
• -mean-shift geometry — delineates arbitrarily shaped clusters in the image 🧩
• -median geometry — applies a median filter to the image 🧹
• -mode geometry — makes each pixel the 'predominant color' of the neighborhood 🎨
• -modulate value — varies the brightness, saturation, and hue 🌈
• -monochrome — transforms image to black and white ⚫⚪
• -morphology method kernel — applies a morphology method to the image 🧬
• -motion-blur geometry — simulates motion blur 💨
• -negate — replaces each pixel with its complementary color 🔄
• -noise geometry — adds or reduces noise in an image 📺
• -normalize — transforms image to span 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 🎨
• -perceptible epsilon — pixel value less than |epsilon| become epsilon or -epsilon 👀
• -polaroid angle — simulates a Polaroid picture 📸
• -posterize levels — reduces the image to a limited number of color levels 🎨
• -print string — interprets string and prints to console 🖨️
• -profile filename — adds, deletes, or applies an image profile 🧾
• -quantize colorspace — reduces colors in this colorspace 🎨
• -radial-blur angle — radial blurs the image 🌀
• -raise value — lightens/darkens image edges to create a 3-D effect 🏔️
• -random-threshold low,high — random 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 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 an image vertically or horizontally 🔄
• -rotate degrees — applies Paeth rotation to the image 🔄
• -sample geometry — scales 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 📷
• -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 from 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 all pixels above the threshold level ☀️
• -sort-pixels — sorts each scanline in ascending order of intensity 📊
• -sparse-color method args — fills in an image based on a few color points 🎨
• -splice geometry — splices the background color into the image 🧬
• -spread amount — displaces image pixels by a random amount 🎲
• -strip — strips image of all profiles and comments 🧼
• -swirl degrees — swirls image pixels about the center 🌀
• -threshold value — thresholds the image ⚫⚪
• -thumbnail geometry — creates a thumbnail of the image 🖼️
• -tile filename — tiles image when filling a graphic primitive 🧱
• -tint value — tints the image with the fill color 🎨
• -transform — affine transform image 🔄
• -transparent color — makes this color transparent within the image 👻
• -transpose — flips image vertically and rotates 90 degrees 🔄
• -transverse — flops image horizontally and rotates 270 degrees 🔄
• -trim — trims image edges ✂️
• -type type — image type 🏷️
• -unique-colors — discards all but one of any pixel color 🎨
• -unsharp geometry — sharpens the image 🔪
• -vignette geometry — softens the edges of the image in vignette style 🌫️
• -wave geometry — alters an image along a sine wave 🌊
• -wavelet-denoise threshold — removes noise from the image using a wavelet transform 🧼
• -white-balance — automagically adjusts white balance of image ⚪
• -white-threshold value — forces all pixels above the threshold into white ⚪

✨ Image Channel Operators ✨

• -channel-fx expression — exchanges, extracts, or transfers one or more image channels 🔀
• -separate — separates an image channel into a grayscale image 🩶

💫 Image Sequence Operators 💫

these ones are all about sequences, bestie — when you're working with a whole stack of images instead of just one lonely lil pic ✨

• -append — stick an image sequence together top-to-bottom. oh and if you want left-to-right instead? use +append. iconic behavior fr
• -clut — apply a color lookup table to the image 🎨
• -coalesce — merge a sequence of images together
• -combine — combine a sequence of images
• -compare — mathematically and visually annotate the difference between an image and its reconstruction. yes it does both, she's multifaceted 💅
• -complex operator — perform complex mathematics on an image sequence
• -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 ✂️
• -deconstruct — break down an image sequence into its constituent parts
• -evaluate-sequence operator — evaluate an arithmetic, relational, or logical expression
• -flatten — flatten a sequence of images
• -fx expression — apply a mathematical expression to an image channel(s)
• -hald-clut — apply a Hald color lookup table to the image
• -morph value — morph an image 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)
• -process arguments — process the image with a custom image filter
• -smush geometry — smush an image sequence together
• -write filename — write images to this file

---

🧺 Image Stack Operators 🧺

this is your lil image stack management era — cloning, deleting, swapping, the whole vibe

• -clone indexes — clone an image
• -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 random-but-essential besties of the option world

• -debug events — display copious debugging information
• -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 so here's a lil rule you gotta internalize: use any setting or operator as an output-option. but bestie, only a limited number of settings are input-options 😭 and those are:

-antialias, -caption, -density, -define, -encoding, -font, -pointsize, -size, and -texture

plus any of the miscellaneous options. that's the whole list, no cap.

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). and specify file as - for standard input or output. 🫶

---

👀 SEE ALSO 👀

• ImageMagick-im7.q16(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

---

and that's a wrap on the whole page, bestie!! 🎀 this was ImageMagick, dated 2009/01/10 01:00:00, living in the convert-im7.q16(1) man page. go forth and convert, you absolute icon 👑💖