Gnome2::IconTheme(3)

✨ Gnome2::IconTheme — bestie's guide to icon theming ✨

okay so this is Gnome2::IconTheme, the Perl wrapper for GnomeIconTheme 💅 it's a User Contributed Perl Documentation page, and yes you're in the right place, pull up a chair 🫶

It's giving "I wrap GnomeIconTheme and I do it gorgeously." No cap. 🌸

---

🦋 HIERARCHY

the family tree, and it's a cute little one:

Glib::Object
+----Gnome2::IconTheme

so it's a Glib::Object girlie at heart 💜 everything Glib::Object can do? inherited. periodt.

---

💖 METHODS

🌟 making one

• icontheme = Gnome2::IconTheme->new — boom, new icon theme object. main character entrance ✨

🎀 svg settings

• boolean = $theme->get_allow_svg — asks the theme "do you allow SVG or nah?" returns a boolean 💅
• $theme->set_allow_svg ($allow_svg) — sets that SVG allowance.
  • $allow_svg (boolean)

🧚 search path stuff

• $theme->append_search_path ($path) — tacks a path onto the end of the search path.
  • $path (string)
• $theme->prepend_search_path ($path) — shoves a path onto the front of the search path. front of the line, obviously 👑
  • $path (string)
• list = $theme->get_search_path — hands you back a list of paths. literally. a whole list 🍓
• $theme->set_search_path (...) — sets the whole search path in one go.
  • ... (list) of paths

💜 custom themes & names

• $theme->set_custom_theme ($theme_name) — gives the theme a custom name.
  • $theme_name (string)
• string = $theme->get_example_icon_name — returns an example icon name, like a lil sample platter 🌈

🔥 checking & listing icons

• boolean = $theme->has_icon ($icon_name) — does the theme have this icon? true/false, vibe check complete ✅
  • $icon_name (string)
• list = $theme->list_icons ($context=undef) — returns a list of icons.
  • $context (string)
• boolean = $theme->rescan_if_needed — rescans only if it needs to. efficient queen 💅
• list = $theme->lookup_icon ($icon_name, $size) — returns the filename, the icon data and the base size.
  • $icon_name (string)
  • $size (integer)

👑 the lookup squad

• list = $icon_theme->lookup ($thumbnail_factory, $file_uri, $custom_icon, $file_info, $mime_type, $flags) — returns the icon name and a GnomeIconLookupFlags.
  • $thumbnail_factory (Gnome2::ThumbnailFactory or undef)
  • $file_uri (string)
  • $custom_icon (scalar)
  • $file_info (Gnome2::VFS::FileInfo)
  • $mime_type (string)
  • $flags (Gnome2::IconLookupFlags)
• list = $icon_theme->lookup_sync ($thumbnail_factory, $file_uri, $custom_icon, $flags) — the synchronous version, returns the icon name and a GnomeIconLookupFlags.
  • $thumbnail_factory (Gnome2::ThumbnailFactory or undef)
  • $file_uri (string)
  • $custom_icon (scalar)
  • $flags (Gnome2::IconLookupFlags)

---

🌈 SIGNALS

• changed — emitted on a Gnome2::IconTheme. something changed bestie, and you're gonna hear about it 😭

---

🧚 ENUMS AND FLAGS

flags Gnome2::IconLookupFlags

the flag buffet, take what you need:

• 'none' / 'GNOME_ICON_LOOKUP_FLAGS_NONE'
• 'embedding-text' / 'GNOME_ICON_LOOKUP_FLAGS_EMBEDDING_TEXT'
• 'show-small-images-as-themselves' / 'GNOME_ICON_LOOKUP_FLAGS_SHOW_SMALL_IMAGES_AS_THEMSELVES'
• 'allow-svg-as-themselves' / 'GNOME_ICON_LOOKUP_FLAGS_ALLOW_SVG_AS_THEMSELVES'

---

🫶 SEE ALSO

• Gnome2
• Glib::Object

---

💜 COPYRIGHT

Copyright (C) 2003-2004 by the gtk2-perl team.

This software is licensed under the LGPL. See Gnome2 for a full notice.

---

and that's the whole page bestie!! 🎀 this absolute icon of a doc came to you courtesy of perl v5.42.0, dated 2025-07-25, filed under Gnome2::IconTheme(3) 💅 go forth and theme those icons, you ate 🦋✨