convert-im7.q16hdri(1)

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

💖 convert-im7.q16hdri — the manual, but make it make sense

okay bestie, you're looking at convert-im7.q16hdri, and yeah, the manual name is a whole mouthful (it's giving "why is there a q16hdri in here" 💀) but don't let that scare you. this is the page for the convert command, straight out of the ImageMagick-ims7.q16hdri(1) suite. let's get into it 🫶

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

like. it does EVERYTHING. it's the main character of image tooling, no cap. 👑

🌸 SYNOPSIS

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

that's the shape of it: you got your input-options, then your input-file, then your output-options, then your output-file. order matters, bestie, it's not a vibe suggestion. 🎀

🦋 OVERVIEW

so convert-im7.q16hdri is a member of the ImageMagick-ims7.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. (yes, the NAME section said that too. they're committed. we respect the commitment. 💅)

want more lore about the convert command? point your browser at:

file:///usr/share/doc/imagemagick-7-common/html/www/convert.html

(and on a debian system you may install the imagemagick-7 package to get that good stuff) — or hit up https://www.imagemagick.org/script/convert.php if the internet is your thing. 🌈

💜 DESCRIPTION

okay so here's the big one. this whole section is the settings — the stuff you set up before/around the actual work. there are a LOT of them. grab a snack. 🍓

✨ Image Settings ✨

  • -adjoin — join images into a single multi-image file. one file, many pics, they're a unit now 🫶
  • -affine matrix — affine transform matrix.
  • -alpha option — activate, deactivate, reset, or set the alpha channel.
  • -antialias — remove pixel-aliasing. smooth those jagged little edges out, slay ✨
  • -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.
  • -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.
  • -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. 🔁
  • -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. 🤐
  • -read-mask filename — associate a read mask with the image.
  • -red-primary point — chromaticity red primary point. ❤️
  • -regard-warnings — pay attention to warning messages. (the opposite of -quiet, basically. eyes OPEN. 👀)
  • -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. 🗣️
  • -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 the settings lineup, bestie — every single one of them, exactly as written, no edits, no skips. there's more of this page coming, so hold that thought 💖

✨ Image Operators ✨

  • -adaptive-blur geometry — adaptively blur pixels; the effect gets weaker near the edges 🦋
  • -adaptive-resize geometry — adaptively resize the image with data-dependent triangulation ✨
  • -adaptive-sharpen geometry — adaptively sharpen pixels; the effect gets stronger near the edges 💅
  • -annotate geometry text — annotate the image with text 🎀
  • -auto-gamma — automagically adjust the gamma level of the image 🌈
  • -auto-level — automagically adjust the color levels of the image ✨
  • -auto-orient — automatically orient the image 🧚
  • -auto-threshold method — automatically perform image thresholding using the given method ⭐
  • -bench iterations — measure performance over the given number of iterations 🔥
  • -bilateral-blur geometry — a non-linear, edge-preserving, and noise-reducing smoothing filter 🫶
  • -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 the image with a border of color 🎀
  • -brightness-contrast geometry — improve brightness / contrast of the image ✨
  • -canny geometry — detect edges in the image 🔥
  • -channel mask — set the image channel mask 🫶
  • -charcoal radius — simulate a charcoal drawing with the given radius 🎀
  • -chop geometry — remove pixels from the image interior 💀
  • -clahe geometry — contrast limited adaptive histogram equalization ✨
  • -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 using the given filename 🦋
  • -clip-path id — clip along a named path from the 8BIM profile, using the given id ✨
  • -colorize value — colorize the image with the fill color 🌈
  • -color-matrix matrix — apply color correction to the image using the given matrix 💜
  • -colors value — set the preferred number of colors in the image 🎀
  • -color-threshold start_color-stop_color — force all pixels in the color range to white, otherwise black 💀
  • -connected-component connectivity — connected-components uniquely labeled with the given connectivity 🫶
  • -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 by the given amount 🦋
  • -deskew threshold — straighten an image using the given threshold ✨
  • -despeckle — reduce the speckles within an image 🫶
  • -distort method args — distort images according to the given method and args 🌈
  • -draw string — annotate the image with a graphic primitive given as a string 💅
  • -edge radius — apply a filter to detect edges in the image 🦋
  • -emboss radius — emboss an image with the given radius ✨
  • -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 using the given operator and value 💜
  • -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, using the given name 💜
  • -gamma value — set the level of gamma correction 🫶
  • -gaussian-blur geometry — reduce image noise and reduce detail levels 💅
  • -geometry geometry — set the preferred size or location of the image 🎀
  • -grayscale method — convert image to grayscale using the given method ✨
  • -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 🫶
  • -integral — calculate the sum of values (pixel values) in the image ✨
  • -interpolative-resize geometry — resize image using interpolation 💅
  • -kmeans geometry — K means color reduction 🎀
  • -lat geometry — local adaptive thresholding 🦋
  • -layers method — optimize or compare image layers using the given method 🌈
  • -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 ✨
  • -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 with the given method and kernel 🫶
  • -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 🎀
  • -range-threshold values — perform either hard or soft thresholding within some range of values in an 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 🎀
  • -sort-pixels — sort each scanline in ascending order of intensity 🦋
  • -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-balance — automagically adjust white balance of image 🦋
  • -white-threshold value — force all pixels above the threshold into white 🌈

✨ Image Channel Operators ✨

  • -channel-fx expression — exchange, extract, or transfer one or more image channels 💜
  • -separate — separate an image channel into a grayscale image 🫶

🎀 Image Sequence Operators 🎀

okay bestie, these ones are all about sequences, like when you've got a whole lil squad of images and you wanna do stuff to them together. iconic behavior fr.

  • -append — glues an image sequence together top to bottom. and if you want left to right instead? use +append, periodt 💅
  • -clut — applies a color lookup table to the image, slay
  • -coalesce — merges a sequence of images together
  • -combine — combines a sequence of images
  • -compare — mathematically and visually annotates the difference between an image and its reconstruction. it's giving detective energy 🔍
  • -complex operator — does complex mathematics on an image sequence
  • -composite — composites an image
  • -copy geometry offset, — copies pixels from one area of an image to another
  • -crop geometry — cuts out a rectangular region of the image ✂️
  • -deconstruct — breaks down an image sequence into its constituent parts
  • -evaluate-sequence operator — evaluates an arithmetic, relational, or logical expression
  • -flatten — flattens a sequence of images
  • -fx expression — applies a mathematical expression to an image channel(s)
  • -hald-clut — applies a Hald color lookup table to the image
  • -morph value — morphs an image sequence 🦋
  • -mosaic — creates a mosaic from an image sequence
  • -poly terms — builds a polynomial from the image sequence and the corresponding terms (coefficients and degree pairs)
  • -process arguments — processes the image with a custom image filter
  • -smush geometry — smushes an image sequence together (yes that's the real name, no I'm not kidding)
  • -write filename — writes images to this file

🌸 Image Stack Operators 🌸

these are the ones that mess with your stack — cloning, deleting, reordering. main character energy for your image list 💖

  • -clone indexes — clones an image
  • -delete indexes — deletes the image from the image sequence
  • -duplicate count,indexes — duplicates an image one or more times
  • -insert index — inserts the last image into the image sequence
  • -reverse — reverses the image sequence 🔄
  • -swap indexes — swaps two images in the image sequence

✨ Miscellaneous Options ✨

the lil grab-bag of extras, we love her

  • -debug events — displays copious debugging information 🐛
  • -distribute-cache port — distributed pixel cache spanning one or more servers
  • -help — prints program options
  • -log format — format of debugging information
  • -list type — prints a list of supported option arguments
  • -version — prints version information

okay so here's a thing you need to know bestie: you can use any setting or operator as an output-option. but only a limited number of settings are input-option. those special ones are: -antialias, -caption, -density, -define, -encoding, -font, -pointsize, -size, and -texture — plus any of the miscellaneous options. so yeah, not all of them get to be input-options, only those cuties 💜

and by default, the image format of file is determined by its magic number 🔮. wanna force a specific format? then either put an image format name and a colon in front of the filename (like ps:image) or just use the image type as the filename suffix (like image.ps). and if you want standard input or output, specify file as -. easy as that 🌈

🌟 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 a wrap, bestie!! 🫶 this whole page is from ImageMagick, version/date stamped Date: 2009/01/10 01:00:00, and it's the manual for convert-im7.q16hdri(1). go forth and convert, you absolute icon 👑✨
📦 where this page comes from