compare-im7.q16(1)

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

💖 compare-im7.q16 — bestie edition 💖

okay so this is compare-im7.q16, and it lives in the General Commands Manual section, so you already know it's a real one. it's part of the ImageMagick-im7.q16(1) squad of tools, and its whole personality is: take an image and its reconstruction and mathematically + visually annotate the difference between them. like a glow-up before/after but for pixels. 💅

✨ NAME ✨

compare — mathematically and visually annotate the difference between an image and its reconstruction.

🌸 SYNOPSIS 🌸

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

two input files. options in the middle. output at the end. that's the whole recipe bestie, no cap. 🫶

🦋 OVERVIEW 🦋

so compare-im7.q16 is one of the little icons in the ImageMagick-ims7.q16(1) suite of tools. its job? mathematically AND visually annotate the difference between an image and its reconstruction. yes, both. she does both. 💅

want the full lore? point your browser at:

👑 DESCRIPTION 👑

here's the whole menu of settings and operators, and I'm listing every single one because we do not gatekeep on this account. 🌈

💜 Image Settings

  • -alpha option — set the alpha. the vibes include on, activate, off, deactivate, set, opaque, copy, transparent, extract, background, or shape.
  • -authenticate value — decrypt the image with this password. 🔐
  • -background color — the background color.
  • -colorspace type — use an alternate image colorspace.
  • -compose operator — set the image composite operator.
  • -compress type — the type of pixel compression used when writing the image.
  • -decipher filename — convert cipher pixels to plain pixels.
  • -define format:option — define one or more image format options.
  • -density geometry — the horizontal and vertical density of the image.
  • -depth value — image depth.
  • -dissimilarity-threshold value — the maximum distortion allowed for a (sub)image match.
  • -encipher filename — convert plain pixels to cipher pixels.
  • -extract geometry — extract an area from the image.
  • -format "string" — output formatted image characteristics.
  • -fuzz distance — colors within this distance count as equal.
  • -gravity type — horizontal and vertical text placement.
  • -identify — identify the format and characteristics of the image.
  • -interlace type — the type of image interlacing scheme.
  • -highlight-color color — emphasize pixel differences with this color.
  • -limit type value — set a pixel cache resource limit.
  • -lowlight-color color — de-emphasize pixel differences with this color.
  • -metric type — measure the differences between images with this metric.
  • -monitor — monitor progress. 👀
  • -negate — replace each pixel with its complementary color.
  • -profile filename — add, delete, or apply an image profile.
  • -quality value — JPEG/MIFF/PNG compression level.
  • -quiet — suppress all warning messages. 🤫
  • -quantize colorspace — reduce colors in this colorspace.
  • -read-mask filename — associate a read mask with the image.
  • -regard-warnings — pay attention to warning messages.
  • -repage geometry — the size and location of an image canvas.
  • -respect-parentheses — settings stay in effect until a parenthesis boundary.
  • -sampling-factor geometry — the horizontal and vertical sampling factor.
  • -seed value — seed a new sequence of pseudo-random numbers.
  • -set attribute value — set an image attribute.
  • -similarity-threshold value — the minimum distortion for a (sub)image match.
  • -size geometry — the width and height of the image.
  • -subimage-search — search for a subimage.
  • -synchronize — synchronize the image to the storage device.
  • -taint — declare the image as modified.
  • -transparent-color color — the transparent color.
  • -type type — image type.
  • -write-mask filename — associate a write mask with the image.
  • -verbose — print detailed information about the image.
  • -virtual-pixel method — the virtual pixel access method.

💅 Image Operators

  • -auto-orient — automatically orient the image.
  • -brightness-contrast geometry — improve the brightness / contrast of the image.
  • -distort method args — distort images according to the given method and args.
  • -level value — adjust the level of image contrast.
  • -resize geometry — resize the image.
  • -rotate degrees — apply Paeth rotation to the image.
  • -sigmoidal-contrast geometry — lightness rescaling using sigmoidal contrast enhancement.
  • -trim — trim the image edges.

🎀 Image Channel Operators

  • -separate — separate an image channel into a grayscale image.

🌟 Image Sequence Operators

  • -crop geometry — cut out a rectangular region of the image.
  • -write filename — write images to this file.

🧚 Image Stack Operators

  • -delete indexes — delete the image from the image sequence.

⭐ Miscellaneous Options

  • -channel mask — set the image channel mask.
  • -debug events — display copious debugging information.
  • -help — print program options.
  • -log format — the format of debugging information.
  • -list type — print a list of supported option arguments.
  • -version — print version information.

🍓 how the file format gets figured out

by default, the image format of file is determined by its magic number. so she just knows. 🔮

want to force a specific format? 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 file to be standard input or standard output, just write -. iconic behavior honestly.

🌈 the similarity rules

two images count as similar if their difference according to the specified metric and fuzz value is 0.

⚠️ EXCEPT for the normalized cross correlation metric (NCC) — with NCC, two images count as similar when their normalized cross correlation is 1.

and the default metric? NCC. yes, that's the default, remember it. 📌

💀 exit status (aka the vibe check results)

  • 2 on error — it's giving disaster
  • 0 if the images are similar
  • a value between 0 and 1 if they are not similar

🔥 SEE ALSO 🔥

ImageMagick-im7.q16(1)

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 or https://imagemagick.org/license/

okay that's the whole page, you ate it, you're literally a compare expert now. 🫶✨

this one came from ImageMagick, dated Date: 2009/01/10 01:00:00, and yes, compare-im7.q16(1) is the moment. mwah. 💅💖🌸

📦 where this page comes from