DTICON(1)

💅 dticon — the Common Desktop Environment Icon Editor 💅

okay so this is the dticon page from the user cmd manual, and she's the Common Desktop Environment Icon Editor. Think group-chat bestie who can draw icons, grab stuff off your display, and absolutely slay a drag-and-drop. 💖

---

🌸 NAME 🌸

dticon — the Common Desktop Environment Icon Editor. That's it, that's the name, and she's iconic. 👑

🦋 SYNOPSIS 🦋

dticon [options]

✨ DESCRIPTION ✨

The Icon Editor gives you the facilities to create brand-new icons or modify existing ones. Basically: icon maker, icon fixer, icon main character. 💅

She uses lines and geometric shape drawing tools to create new icons or modify existing ones. She supports XPM and XBM formats. She can also grab images from the display and use them as bases for new icons. Snatching screenshots and turning them into icons? Obsessed. 🔥

She also supports drag and drop, which means you can drag an icon file from the file manager onto the Icon Editor window or icon. Yes bestie, just drag it over. 🫶

💖 Key Supported Tasks 💖

• Modify size of window.
• Modify location of window.
• Iconify window.
• Edit a new or existing icon.
• Save the current icon.
• Undo the last operation.
• Cut, copy, and paste areas within the Icon Editor drawing tablet.
• Grab images from the display.
• Rotate selected area.
• Scale selected area.
• Flip selected area right or left.
• Resize icon.
• Add a hot spot to the icon.
• Delete a hot spot from icon.
• Clear icon.
• Overlay the icon drawing area with a visible grid.
• Select icon format, XPM or XBM.
• Alter the magnification factor for the drawing tablet.

She accepts all of the standard X Toolkit/Widget command line options, too — no cap. The extra application-specific options are listed below. 👇

🎀 OPTIONS 🎀

The following options are available from the command line:

• -f file — This one takes a bitmap or pixmap file name. If the file ends in .pm or .xpm suffix, she'll try reading it as an XPM file first. If that fails, she'll try reading it as an XBM file. If the file ends in .bm or .xbm suffix, she'll try reading it as an XBM file first. If that fails, she'll try reading it as an XPM file. If the file doesn't match any of these suffixes, she'll try reading it as an XPM file first. If that fails, she'll try reading it as an XBM file. fr fr. 💅
• -x widthxheight — This sets an initial geometry for the icon image. If a file is specified using the -f option, the size of that icon supersedes the geometry specified. So the file wins, bestie. 👑
• -session file — This takes the name of a session file as an additional parameter. The Icon Editor is invoked with the specified session file name. That session file is one that was previously saved by the Icon Editor through a session shutdown. This option causes all other command line options to be ignored, because all settings are taken from the specified session file. So yeah, -session is the main character and everyone else sits down. 💅

💀 RETURN 💀

Exit values are:

• 0 — Successful completion.
• >0 — Error condition occurred.

🌈 EXAMPLES 🌈

dticon -x 24x32

Starts the Icon Editor with an icon template of width 24 and height 32. Cute template, bestie. 🎀

dticon

🧚 Tooltalk integration — using dticon in your apps

[Using Tooltalk to integrate dticon in your applications] Tooltalk makes it possible to use dticon from within your application. dticon supports the following Tooltalk messages: start, edit, quit. An application can construct a Tooltalk message, which will include a buffer containing the icon the application wishes to edit. The format of the message appears in dticon's ptype file (dticon.ptype). The buffer in the edit message is constructed to contain the icon contents of an XPM or an XBM icon file. In the case of an XBM icon containing transparent regions, dticon generates two icon files: an XBM file containing the base icon (the icon without the transparent regions) and a mask file that indicates the transparent regions in the icon. The buffer in this case must include both icon files double buffered — the base icon first and then the mask, both in the same buffer. 😭

NOTE: An application may pass a buffer to dticon containing an XPM icon and get back a double buffer containing an XBM icon and its mask, and vise versa. Yes, both directions, bestie. 🫶

📚 Suggested 📚

• The Common Desktop Environment: ToolTalk Messaging Overview - The Common Desktop Environment: Programmer's Guide

🧚 RESOURCES 🧚

• -useFileFilter — This resource instructs the Icon Editor to use the file filter feature in OPEN and SAVE dialogs.

🗂️ FILES 🗂️

Files used by this component.

• /.../dt/app-defaults/C/Dticon — App-defaults file.

---

okay bye bestie 💖 — that's dticon from the user cmd manual. This footer didn't give a separate date or version line beyond that, so here's the cute sign-off instead: stay iconic and hydrate. 🎀✨