composite-im7.q16(1)

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

💖 composite-im7.q16 — bestie's guide to stacking pics on pics 💖

okay so real talk, this is the manual page for composite-im7.q16, and it's part of the General Commands Manual energy. If you're here it's because you wanna slap one image on top of another and you want it to look ✨ intentional ✨. Buckle up, we're doing this together. 🫶

🌸 NAME 🌸

composite — overlaps one image over another.

that's it. that's the whole job. it's giving collage. it's giving "put that png on that jpeg". iconic. 👑

✨ SYNOPSIS ✨

magick-im7.q16 composite [ options ... ] change-file base-file [ mask-file ] output-image

so the way this works is: you got your change-file (the one getting layered on top), your base-file (the one underneath, the main character), optionally a mask-file (the little shape-shifter that decides where the top one shows through, she's optional but she's powerful 💅), and then output-image where the magic lands. and yeah, options go anywhere up in there. no cap. 🦋

🎀 OVERVIEW 🎀

composite-im7.q16 is a whole member of the ImageMagick-ims7.q16(1) suite of tools — you know, the friend group. her whole thing? overlap one image over another. that's her lane and she stays in it. 💖

if you wanna know more about the composite command, point your browser at:

💅 DESCRIPTION 💅

okay here's the whole menu of settings, operators and misc goodies. every single one is listed, bestie, we are NOT skipping any. 😤

⭐ Image Settings ⭐

these are the vibe-setters — they configure how the image gets handled before/while stuff happens.

  • -affine matrix — the affine transform matrix, aka the mathy grid that says how things get skewed and squished.
  • -alpha option — set the alpha situation. your options are on, activate, off, deactivate, set, opaque, copy, transparent, extract, background, or shape. pick your fighter. 🎀
  • -authenticate value — decrypt the image using this password. yes queen, secrets. 🔐
  • -blue-primary point — the chromaticity blue primary point.
  • -colorspace type — use an alternate image colorspace.
  • -comment string — annotate the image with a comment. leave a little note, it's cute. 🍓
  • -compose operator — which composite operator to use. this is the big one, this decides how the overlap happens.
  • -compress type — what kind of pixel compression to use when writing the image.
  • -decipher filename — turn cipher pixels back into plain pixels.
  • -define format:option — define one or more image format options. you can stack these.
  • -depth value — image depth.
  • -density geometry — the horizontal and vertical density of the image.
  • -display server — grab the image or font from this X server.
  • -dispose method — layer disposal method.
  • -dither method — apply error diffusion to the image.
  • -encipher filename — turn plain pixels into cipher pixels. (the reverse glow-up of -decipher)
  • -encoding type — text encoding type.
  • -endian type — endianness of the image, so either MSB or LSB.
  • -filter type — which filter to use when resizing an image.
  • -font name — render text with this font.
  • -format "string" — output formatted image characteristics.
  • -gravity type — which direction to gravitate towards. literally gravitational pull for your content. 🌈
  • -green-primary point — the chromaticity green primary point.
  • -interlace type — type of image interlacing scheme.
  • -interpolate method — pixel color interpolation method.
  • -label string — assign a label to an image.
  • -limit type value — pixel cache resource limit.
  • -matte — store the matte channel if the image has one.
  • -monitor — monitor progress. she's watching. 👀
  • -page geometry — size and location of an image canvas. this one's a setting.
  • -pointsize value — font point size.
  • -quality value — compression level for JPEG/MIFF/PNG.
  • -quiet — suppress all warning messages. shhh. 🙈
  • -red-primary point — the chromaticity red primary point.
  • -regard-warnings — pay attention to warning messages. the opposite of -quiet, she listens.
  • -repage geometry — size and location of an image canvas. note: this one's an operator, unlike -page up there. don't get them mixed up bestie, they're siblings not twins. 😭
  • -respect-parentheses — settings remain in effect until the parenthesis boundary. parentheses are little bubbles and this keeps your settings trapped inside the right one. 🫧
  • -sampling-factor geometry — horizontal and vertical sampling factor.
  • -scene value — image scene number.
  • -seed value — seed a new sequence of pseudo-random numbers. deterministic chaos, love that.
  • -size geometry — width and height of the image.
  • -support factor — resize support: > 1.0 is blurry, < 1.0 is sharp. yes the math is doing that on purpose.
  • -synchronize — synchronize the image to the storage device.
  • -taint — declare the image as modified. she's marked now. 💀
  • -transparent-color color — the transparent color.
  • -treedepth value — color tree depth.
  • -tile — repeat the composite operation across and down the image. it's giving wallpaper. 🌸
  • -units type — the units of image resolution.
  • -verbose — print detailed information about the image.
  • -virtual-pixel method — virtual pixel access method.
  • -white-point point — chromaticity white point.

🔥 Image Operators 🔥

these actually do stuff to the image, as opposed to just setting the vibe.

  • -blend geometry — blend images.
  • -border geometry — surround the image with a border of color.
  • -bordercolor color — the border color. pairs with -border, obviously. 💅
  • -channel mask — set the image channel mask.
  • -colors value — the preferred number of colors in the image.
  • -displace geometry — shift image pixels as defined by a displacement map.
  • -dissolve value — dissolve the two images by a given percent.
  • -distort geometry — shift the lookup according to an absolute distortion map.
  • -extract geometry — extract an area from the image.
  • -geometry geometry — the location of the composite image. this is where you tell her to sit. 🪑
  • -identify — identify the format and characteristics of the image.
  • -monochrome — transform the image to black and white.
  • -negate — replace each pixel with its complementary color. the flip side of everything. 🌗
  • -profile filename — add an ICM or IPTC information profile to the image.
  • -quantize colorspace — reduce colors in this colorspace.
  • -rotate degrees — apply Paeth rotation to the image.
  • -resize geometry — resize the image.
  • -sharpen geometry — sharpen the image.
  • -shave geometry — shave pixels from the image edges.
  • -stegano offset — hide a watermark within an image. sneaky, we love her. 🕵️
  • -stereo — combine two images to create a stereo anaglyph. yes, the red-and-blue-glasses situation.
  • -strip — strip the image of all profiles and comments. she's bare-faced now.
  • -thumbnail geometry — create a thumbnail of the image.
  • -transform — affine transform the image.
  • -type type — image type.
  • -unsharp geometry — sharpen the image. (different flavor of sharpening than -sharpen, don't @ me)
  • -watermark geometry — percent brightness and saturation of a watermark.
  • -write filename — write the images to this file.

🦋 Image Stack Operators 🦋

  • -swap indexes — swap two images in the image sequence. a little switcheroo. 🔄

💜 Miscellaneous Options 💜

  • -debug events — display copious debugging information. copious. so much. 😭
  • -help — print program options.
  • -log format — format of the debugging information.
  • -list type — print a list of supported option arguments.
  • -version — print version information.

okay so also, super important, bestie: by default the image format of file gets figured out from its magic number ✨ (yes, actual name, actual concept, it's the bytes at the start of the file telling you what it is).

wanna force a specific format instead? two ways:

  1. put an image format name and a colon before the filename, like ps:image
  2. or just let the filename suffix say it, like image.ps

and if you want standard input or output, just specify 'file' as '-'. periodt. 💅

🌈 SEE ALSO 🌈

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

and that's the whole page bestie, you're officially certified in compositing 💖

ImageMagick · Date: 2009/01/10 01:00:00 · composite-im7.q16(1) — mwah, go overlap some images, you got this 🎀✨

📦 where this page comes from