compare-im7.q16hdri(1)

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

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

okay bestie, pull up a chair, we're talking about compare-im7.q16hdri from the ImageMagick family (yes, the ImageMagick-im7.q16hdri(1) squad). She's the friend in the group chat whose whole personality is spotting the difference between an image and its reconstruction — mathematically AND visually, no cap. ✨

🌸 SYNOPSIS 🌸

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

Two input files. Not one. Two. She's comparing, that's the whole point, okay? 🙈

🦋 OVERVIEW 🦋

compare-im7.q16hdri is a full member of the ImageMagick-im7.q16hdri(1) suite of tools — like, she has a membership card and everything 💅. Her job: mathematically and visually annotate the difference between an image and its reconstruction.

Want the full lore? Point your browser at:

✨ DESCRIPTION ✨

👑 Image Settings

These are the settings, bestie. The vibe-setters. The main character knobs.

  • -alpha option — on, activate, off, deactivate, set, opaque, copy transparent, extract, background, or shape
  • -authenticate value — decrypt image with this password
  • -background color — background color
  • -colorspace type — alternate image colorspace
  • -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
  • -density geometry — horizontal and vertical density of the image
  • -depth value — image depth
  • -dissimilarity-threshold value — maximum distortion for (sub)image match
  • -encipher filename — convert plain pixels to cipher pixels
  • -extract geometry — extract area from image
  • -format "string" — output formatted image characteristics
  • -fuzz distance — colors within this distance are considered equal
  • -gravity type — horizontal and vertical text placement
  • -identify — identify the format and characteristics of the image
  • -interlace type — type of image interlacing scheme
  • -highlight-color color — emphasize pixel differences with this color
  • -limit type value — pixel cache resource limit
  • -lowlight-color color — de-emphasize pixel differences with this color
  • -metric type — measure 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 — size and location of an image canvas
  • -respect-parentheses — settings remain in effect until parenthesis boundary
  • -sampling-factor geometry — 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 — minimum distortion for (sub)image match
  • -size geometry — width and height of image
  • -subimage-search — search for subimage
  • -synchronize — synchronize image to storage device
  • -taint — declare the image as modified
  • -transparent-color color — 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 — virtual pixel access method

🔥 Image Operators

The ones that actually do stuff to your pixels. Obsessed.

  • -auto-orient — automatically orient image
  • -brightness-contrast geometry — improve brightness / contrast of the image
  • -distort method args — distort images according to 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 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

The odds and ends. The little guys. We love them.

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

💅 The Fine Print (but make it cute)

By default, the image format of file is figured out from its magic number — like a vibe check, but for file types. Want to force a specific image format? Precede the filename with an image format name and a colon (i.e. ps:image), or just specify the image type as the filename suffix (i.e. image.ps). And you can specify file as - for standard input or output. 🫶

Two images are considered similar if their difference — according to the specified metric and fuzz value — is 0. There's one exception though, and it's the normalized cross correlation metric (NCC): with NCC, two images count as similar when their normalized cross correlation is 1. The default metric is NCC. 👑

Heads up bestie: the compare program returns 2 on error, 0 if the images are similar, or a value between 0 and 1 if they are not similar. Check that exit status, fr fr. 😭

🦋 SEE ALSO 🦋

Copyright (C) 1999 ImageMagick Studio LLC. Additional copyrights and licenses apply to this software — see:

and that's the whole page, bestie 💖 go forth and diff those images. this was ImageMagick, dated 2009/01/10 01:00:00 — yeah she's been iconic since forever, we stan an elder. periodt. 💅✨

📦 where this page comes from