ascompose(1x)

💖 NAME 💖

ascompose — the tool that composes image(s) and then displays and/or saves them, all based on an XML input file you hand it. bestie it's literally a whole image pipeline in a trench coat 💅

---

🌸 SYNOPSIS 🌸

 ascompose -f file|-s string [-o file] [-t type] [-V]"
 ascompose -f file|-s string [-o file] [-t type] [-V]"
 ascompose -f file|-s string [-o file] [-t type] [-V] [-n]"
 ascompose -f file|-s string [-o file] [-t type] [-V] [-r]"
 ascompose [-h]
 ascompose [-v]

---

✨ DESCRIPTION ✨

okay so here's the tea ☕ ascompose reads the XML data you give it and then manipulates images accordingly. like, it can transform images from files of any supported file format, draw gradients, render antialiased texturized text, superimpose an arbitrary number of images on top of each other, and save images out into files of any of the supported output file formats. it's giving full-service image studio fr fr 🎀

at any point, the result of any operation could be assigned a name, and later on referenced under this name. yes bestie, variables but for pictures 👑

at any point during the script processing, the result of any operation could be saved into a file of any supported file types. iconic behaviour honestly.

internal image format is 32bit ARGB with 8bit per channel. no cap.

the last image referenced will be displayed in an X window, unless the -n option is specified. if the -r option is specified, then this image will be displayed in the root window of the X display, effectively setting a background for a desktop (main character energy, honestly). if the -o option is specified, this image will also be saved into the file or requested type.

ascompose can be compiled to not reference the X Window System, thus allowing it to be used on web servers and any other place. it does not even require X libraries in that case. server bestie representation!! 🫶

🦋 Supported file types for input 🦋

• XPM — via internal code, or libXpm library.
• JPEG — via libJpeg library.
• PNG — via libPNG library.
• XCF — via internal code. for now XCF support is not complete as it does not merge layers.
• PPM/PNM — via internal code.
• BMP, ICO, CUR — via internal code.
• GIF — via libungif library.
• TIFF — via libtiff library (including alpha channel support).
• see libAfterImage/ASImageFileTypes for more.

🧚 Supported file types for output 🧚

• XPM — via internal code, or libXpm library.
• JPEG — via libJpeg library.
• PNG — via libPNG library.
• GIF — via libungif library.
• TIFF — via libtiff library (including alpha channel support).

---

💅 OPTIONS 💅

• -h, --help — display help and exit. your lil cheat sheet 🎀
• -f, --file file — an XML file to use as input.
• -s, --string string — an XML string to use as input.
• -n, --no-display — don't display the last referenced image. shy girl behaviour.
• -r, --root-window — draw last referenced image image on root window. yes it says "image image", that's the original, we're keeping it exactly 💀
• -o, --output file — output last referenced image in to a file. you should use -t to specify what file type to use. Filenames are meaningless when it comes to determining what file type to use. like literally don't name your file .png and expect it to do anything, bestie, it's not gonna listen.
• -t, --type type — type of file to output to.
• -v, --version — display version and exit.
• -V, --verbose — increase verbosity. to increase verbosity level use several of these, like: ascompose -V -V -V. stack 'em like bracelets ✨
• -D, --debug — maximum verbosity - show everything and debug messages. the "tell me everything, don't leave out a single detail" option 🙈

---

🌈 PORTABILITY 🌈

ascompose could be used both with and without the X window system. it has been tested on most UNIX flavors on both 32 and 64 bit architecture. it has also been tested under CYGWIN environment on Windows 95/NT/2000. it gets around, okay?? 💫

---

💜 USES 💜

• libAfterImage — all the image manipulation routines.
• libAfterBase — optionally. misc data handling such as hash tables and console io. must be used when compiled without X Window support.
• libJPEG — JPEG image format support.
• libPNG — PNG image format support.
• libungif — GIF image format support.
• libTIFF — TIFF image format support.

---

👑 AUTHOR 👑

the legends who made this happen, show them some respect fr:

• Ethan Fisher <allanon at crystaltokyo dot com>
• Sasha Vasko <sasha at aftercode dot net>
• Eric Kowalski <eric at beancrock dot net>

---

🍓 EXAMPLE 🍓

here is the default script that gets executed by ascompose, if no parameters are given:

---

⭐ SOURCE ⭐

   static char* default_doc_str = "\
   <composite op=hue>\
     <composite op=add>\
       <scale width=512 height=384><img src=rose512.jpg/></scale>\
       <tile width=512 height=384><img src=back.xpm/></tile>\
     </composite>\
     <tile width=512 height=384><img src=fore.xpm/></tile>\
   </composite>\
   ";

---

and that's the whole page bestie 🫶 this was ascompose(1x), from the ascompose source, dated Mon Feb 18 2002 — vintage but she still serves. go compose something gorgeous, you got this 💖✨🎀