X11::A...stants(3pm)

🌸 X11::AtomConstants — NAME 💖

okay so bestie, this page is X11::A...stants(3pm) (yes the header truncates it, it's giving ✨mysterious✨) and the whole vibe is: X11::AtomConstants — predefined X11 atoms. that's it, that's the name, she's simple and she serves 💅

---

✨ SYNOPSIS ✨

you drop her in and go:

use X11::AtomConstants;
$X->ChangeProperty($window,
                   X11::AtomConstants::WM_NAME,  # property
                   X11::AtomConstants::PIXMAP,   # type
                   8,                            # format
                   'Replace',
                   'My Window Title');

look at that. WM_NAME as the property, PIXMAP as the type, format 8, mode 'Replace', and the title 'My Window Title'. chef's kiss 🫶

---

🦋 DESCRIPTION 🦋

so these are the X11 pre-defined atoms, packaged up as Perl constants. that's the whole thing. for example PIXMAP is 20, because the PIXMAP atom is number 20, no cap:

my $atom_id = X11::AtomConstants::PIXMAP;  # $atom_id is 20
my $name = $X->GetAtomName($atom_id);      # $name is "PIXMAP"

see how she round-trips? you give the number, you get the name back. iconic behavior, honestly 😭

now — LAST_PREDEFINED is not an atom, bestie, don't let the name fool you. she's just the last of the predefined values, and that value happens to be WM_TRANSIENT_FOR. periodt.

here's the full roster, every single one, no skips, i would never 🙈

• PRIMARY — 1
• SECONDARY — 2
• ARC — 3
• ATOM — 4
• BITMAP — 5
• CARDINAL — 6
• COLORMAP — 7
• CURSOR — 8
• CUT_BUFFER0 — 9
• CUT_BUFFER1 — 10
• CUT_BUFFER2 — 11
• CUT_BUFFER3 — 12
• CUT_BUFFER4 — 13
• CUT_BUFFER5 — 14
• CUT_BUFFER6 — 15
• CUT_BUFFER7 — 16
• DRAWABLE — 17
• FONT — 18
• INTEGER — 19
• PIXMAP — 20
• POINT — 21
• RECTANGLE — 22
• RESOURCE_MANAGER — 23
• RGB_COLOR_MAP — 24
• RGB_BEST_MAP — 25
• RGB_BLUE_MAP — 26
• RGB_DEFAULT_MAP — 27
• RGB_GRAY_MAP — 28
• RGB_GREEN_MAP — 29
• RGB_RED_MAP — 30
• STRING — 31
• VISUALID — 32
• WINDOW — 33
• WM_COMMAND — 34
• WM_HINTS — 35
• WM_CLIENT_MACHINE — 36
• WM_ICON_NAME — 37
• WM_ICON_SIZE — 38
• WM_NAME — 39
• WM_NORMAL_HINTS — 40
• WM_SIZE_HINTS — 41
• WM_ZOOM_HINTS — 42
• MIN_SPACE — 43
• NORM_SPACE — 44
• MAX_SPACE — 45
• END_SPACE — 46
• SUPERSCRIPT_X — 47
• SUPERSCRIPT_Y — 48
• SUBSCRIPT_X — 49
• SUBSCRIPT_Y — 50
• UNDERLINE_POSITION — 51
• UNDERLINE_THICKNESS — 52
• STRIKEOUT_ASCENT — 53
• STRIKEOUT_DESCENT — 54
• ITALIC_ANGLE — 55
• X_HEIGHT — 56
• QUAD_WIDTH — 57
• WEIGHT — 58
• POINT_SIZE — 59
• RESOLUTION — 60
• COPYRIGHT — 61
• NOTICE — 62
• FONT_NAME — 63
• FAMILY_NAME — 64
• FULL_NAME — 65
• CAP_HEIGHT — 66
• WM_CLASS — 67
• WM_TRANSIENT_FOR — 68
• LAST_PREDEFINED — 68

sixty-eight of them and then LAST_PREDEFINED also sitting at 68 like 👑 because she is the last one. the math is mathing.

---

🎀 EXPORTS 🎀

nothing is exported by default, bestie — she's not gonna dump 68 constants in your namespace uninvited, she has boundaries. but you can ask for them the usual Exporter way:

use X11::AtomConstants 'PIXMAP';
blah (atom => PIXMAP);

and if you want everything, the :all tag imports the whole squad:

use X11::AtomConstants ':all';
blah (atom1 => POINT,
      atom2 => RECTANGLE);

lowkey heads up though: a lot of these atoms have super generic names — STRING, WEIGHT, like girl, those could mean anything 😭 — so importing them might not be the move. and that's fine!! you can always just use the full package name and nobody gets hurt:

use X11::AtomConstants;
blah (atom => X11::AtomConstants::PIXMAP);

fully-qualified and unbothered. that's the safe route, fr fr.

---

💜 SEE ALSO 💜

go read these too, they're all part of the same little universe:

• X11::CursorFont
• X11::Keysyms
• X11::Protocol
• X11::Protocol::Other
• X11::Protocol::WM

and for the real source-of-truth tea:

• the X Window System Protocol specification (the values live in Appendix B), at /usr/share/X11/doc/hardcopy/XProtocol/proto.PS.gz
• /usr/include/X11/Xatom.h

---

🌈 HOME PAGE 🌈

<http://user42.tuxfamily.org/x11-protocol-other/index.html>

---

💖 LICENSE 💖

Copyright 2011, 2012, 2013, 2014, 2017 Kevin Ryde.

X11-Protocol-Other is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3, or (at your option) any later version.

X11-Protocol-Other is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with X11-Protocol-Other. If not, see <http://www.gnu.org/licenses/>.

---

and that's the whole page, bestie!! 🎀 this was X11::A...stants(3pm) from the User Contributed Perl Documentation, perl v5.28.1, dated 2019-08-26 — go forth and name your atoms, you absolute main character 🦋✨👑