convert-im6.q16hdri(1)

🦋 convert-im6.q16hdri(1) 🦋

okay bestie, sit DOWN. you just typed man convert-im6.q16hdri and honestly? iconic of you. this is the manual page for convert-im6.q16hdri, and it's giving main character energy for real — it's the glow-up tool of the ImageMagick universe. 💅

---

✨ 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.

bestie that list is NOT done. "and much more" is carrying so much weight here it's basically a gym influencer. 🏋️♀️

---

🌸 SYNOPSIS 🌸

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

like, that's the whole shape of it. input stuff, input file, output stuff, output file. slay. 🫶

---

👑 OVERVIEW 👑

The convert-im6.q16hdri program is a member of the ImageMagick-ims6.q16hdri(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.

fr fr, if you're stuck, those links are your group chat. go read them. 📚

---

💖 DESCRIPTION 💖

okay so this next bit is a LONG list of Image Settings. it's basically the entire wardrobe of options. no skimming, bestie — every single one is here. 🎀

🌈 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

💀 ninety-six settings, bestie. and that's just part one. hydrate. stretch. we are SO not done yet. 🍓

✨ Image Operators ✨

• -adaptive-blur geometry — adaptively blur pixels; decrease effect near edges 💅
• -adaptive-resize geometry — adaptively resize image with data dependent triangulation ✨
• -adaptive-sharpen geometry — adaptively sharpen pixels; increase effect near edges 🔥
• -annotate geometry text — annotate the image with text 📝
• -auto-gamma — automagically adjust gamma level of image 👑
• -auto-level — automagically adjust color levels of image 🌈
• -auto-orient — automatically orient image 🙈
• -bench iterations — measure performance ⏱️
• -black-threshold value — force all pixels below the threshold into black 🖤
• -blue-shift factor — simulate a scene at nighttime in the moonlight 🌙
• -blur geometry — reduce image noise and reduce detail levels 💫
• -border geometry — surround image with a border of color 🎀
• -brightness-contrast geometry — improve brightness / contrast of the image ✨
• -canny geometry — detect edges in the image 🔍
• -charcoal radius — simulate a charcoal drawing 🖤
• -chop geometry — remove pixels from the image interior ✂️
• -clamp — keep pixel values in range (0-QuantumRange) 🫶
• -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 🪄
• -colorize value — colorize the image with the fill color 🎨
• -color-matrix matrix — apply color correction to the image 💅
• -connected-component connectivity — connected-components uniquely labeled 🔗
• -contrast — enhance or reduce the image contrast 🌗
• -contrast-stretch geometry — improve contrast by `stretching' the intensity range 📈
• -convolve coefficients — apply a convolution kernel to the image 🌀
• -cycle amount — cycle the image colormap 🔄
• -deskew threshold — straighten an image 📐
• -despeckle — reduce the speckles within an image ✨
• -distort method args — distort images according to given method and args 🌀
• -draw string — annotate the image with a graphic primitive 🖌️
• -edge radius — apply a filter to detect edges in the image 🔍
• -emboss radius — emboss an image 🗿
• -enhance — apply a digital filter to enhance a noisy image ✨
• -equalize — perform histogram equalization to an image 📊
• -evaluate operator value — evaluate an arithmetic, relational, or logical expression 🧮
• -extent geometry — set the image size 📏
• -extract geometry — extract area from image 🧲
• -fft — implements the discrete Fourier transform (DFT) 🪄
• -flip — flip image vertically 🙃
• -floodfill geometry color — floodfill the image with color 🌊
• -flop — flop image horizontally 🐟
• -frame geometry — surround image with an ornamental border 🖼️
• -function name — apply a function to the image 🧪
• -gamma value — level of gamma correction 🌞
• -gaussian-blur geometry — reduce image noise and reduce detail levels 🌫️
• -geometry geometry — preferred size or location of the image 📍
• -grayscale method — convert image to grayscale 🩶
• -hough-lines geometry — identify lines in the image 📏
• -identify — identify the format and characteristics of the image 🔎
• -ift — implements the inverse discrete Fourier transform (DFT) 🪄
• -implode amount — implode image pixels about the center 💥
• -interpolative-resize geometry — resize image using 'point sampled' interpolation 🧵
• -lat geometry — local adaptive thresholding 🎚️
• -layers method — optimize or compare image layers 🧅
• -level value — adjust the level of image contrast 🎛️
• -level-colors color,color — level image with the given colors 🌈
• -linear-stretch geometry — improve contrast by `stretching with saturation' the intensity range 📈
• -liquid-rescale geometry — rescale image with seam-carving 🌊
• -magnify — double the size of the image with pixel art scaling 🔍
• -mean-shift geometry — delineate arbitrarily shaped clusters in the image 🎯
• -median geometry — apply a median filter to the image 🧴
• -mode geometry — make each pixel the 'predominant color' of the neighborhood 👑
• -modulate value — vary the brightness, saturation, and hue 🎚️
• -monochrome — transform image to black and white 🖤🤍
• -morphology method kernel — apply a morphology method to the image 🧬
• -motion-blur geometry — simulate motion blur 🏃
• -negate — replace each pixel with its complementary color 🎨
• -noise geometry — add or reduce noise in an image 🎛️
• -normalize — transform image to span the full range of colors 🌈
• -opaque color — change this color to the fill color 🎨
• -ordered-dither NxN — add a noise pattern to the image with specific amplitudes ✨
• -paint radius — simulate an oil painting 🎨
• -perceptible epsilon — pixel value less than |epsilon| become epsilon or -epsilon 👀
• -polaroid angle — simulate a Polaroid picture 📸
• -posterize levels — reduce the image to a limited number of color levels 🎨
• -print string — interpret string and print to console 🖨️
• -profile filename — add, delete, or apply an image profile 📁
• -quantize colorspace — reduce colors in this colorspace 🎨
• -radial-blur angle — radial blur the image 🌀
• -raise value — lighten/darken image edges to create a 3-D effect 🧊
• -random-threshold low,high — random threshold the image 🎲
• -region geometry — apply options to a portion of the image 🎯
• -render — render vector graphics 🖋️
• -resample geometry — change the resolution of an image 📐
• -resize geometry — resize the image 📏
• -roll geometry — roll an image vertically or horizontally 🎳
• -rotate degrees — apply Paeth rotation to the image 🔄
• -sample geometry — scale image with pixel sampling 🧪
• -scale geometry — scale the image 📐
• -segment values — segment an image 🧩
• -selective-blur geometry — selectively blur pixels within a contrast threshold 🌫️
• -sepia-tone threshold — simulate a sepia-toned photo 📷
• -set property value — set an image property 🏷️
• -shade degrees — shade the image using a distant light source 💡
• -shadow geometry — simulate an image shadow 🌑
• -sharpen geometry — sharpen the image 🔪
• -shave geometry — shave pixels from the image edges ✂️
• -shear geometry — slide one edge of the image along the X or Y axis 📐
• -sigmoidal-contrast geometry — lightness rescaling using sigmoidal contrast enhancement 📈
• -sketch geometry — simulate a pencil sketch ✏️
• -solarize threshold — negate all pixels above the threshold level ☀️
• -sparse-color method args — fill in a image based on a few color points 🎨
• -splice geometry — splice the background color into the image 🧵
• -spread amount — displace image pixels by a random amount 🎲
• -strip — strip image of all profiles and comments 🧼
• -swirl degrees — swirl image pixels about the center 🌀
• -threshold value — threshold the image 🎚️
• -thumbnail geometry — create a thumbnail of the image 🖼️
• -tile filename — tile image when filling a graphic primitive 🧱
• -tint value — tint the image with the fill color 🎨
• -transform — affine transform image 📐
• -transparent color — make this color transparent within the image 👻
• -transpose — flip image vertically and rotate 90 degrees 🔄
• -transverse — flop image horizontally and rotate 270 degrees 🌀
• -trim — trim image edges ✂️
• -type type — image type 🏷️
• -unique-colors — discard all but one of any pixel color 🎨
• -unsharp geometry — sharpen the image 🔪
• -vignette geometry — soften the edges of the image in vignette style 🌸
• -wave geometry — alter an image along a sine wave 🌊
• -wavelet-denoise threshold — removes noise from the image using a wavelet transform 🌊
• -white-threshold value — force all pixels above the threshold into white 🤍

---

🦋 Image Sequence Operators 🦋

• -append — append an image sequence top to bottom (use +append for left to right) 📚
• -clut — apply a color lookup table to the image 🎨
• -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 📊
• -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 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 🦋
• -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 🛠️
• -separate — separate an image channel into a grayscale image 🩶
• -smush geometry — smush an image sequence together 🫂
• -write filename — write images to this file 💾

---

💅 Image Stack Operators 💅

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

okay bestie these are the lil extra-special ones, the ones that don't fit anywhere else but are SO useful 💅

• -debug events — spills ALL the debugging tea, like genuinely copious amounts of it, so you can see exactly what's going on inside 🫖
• -distribute-cache port — sets up a distributed pixel cache spread across one or more servers, iykyk, it's giving networked cache energy ✨
• -help — just prints out the program options for you, no thoughts, just help 🎀
• -log format — tells it what format you want your debugging info in
• -list type — prints a whole list of the supported option arguments for whatever type you ask for, iconic behavior honestly 📋
• -version — prints version information, the classic "who even am I" moment 💖

---

🌸 Settings & Operators, the Rules 🌸

so here's the vibe: you can use any setting or operator as an output-option. periodt. 🫶

but bestie, listen — only a limited number of settings work as input-options. like, the guest list is short. and it includes:

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

plus literally any of the miscellaneous options too. so yeah, that whole crew 💜

---

🦋 How It Knows What Your File Even Is 🦋

by default, the image format of file gets figured out from its magic number ✨ (yes, magic, we love a mystical queen).

but if you wanna be specific and tell it the format, you've got two moves:

1. put an image format name in front of the filename with a colon, like ps:image
2. or just name the file with the image type as the suffix, like image.ps

and one more thing — if you pass - as file, that means standard input or output. classic. 🌈

---

👑 SEE ALSO 👑

ImageMagick-im6.q16hdri(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 bestie!! this was ImageMagick, dated 2009/01/10 01:00:00, living in the man page convert-im6.q16hdri(1) — you understood it, you slayed it, go convert some images 💅✨🎀