Gnome2:...s::Item(3)

📦
version 1.006 · 2 versions
, in fedora 43

✨ NAME ✨

okay so bestie, welcome to Gnome2::Canvas::Item — this whole page lives in the Gnome2:...s::Item manpage (User Contributed Perl Documentation, iykyk), and it's literally just the wrapper for GnomeCanvasItem. that's it. that's the job. 💅

🌸 HIERARCHY 🌸

the family tree, and yes it's giving royal lineage:

Glib::Object
+----Glib::InitiallyUnowned
     +----Gtk2::Object
          +----Gnome2::Canvas::Item

💖 METHODS 💖

🌟 item = Gnome2::Canvas::Item->new ($parent, $object_class, ...)

  • $parent (Gnome2::Canvas::Group)
  • $object_class (string)
  • ... (list) — property name => value pairs

this is the factory constructor for Gnome2::Canvas::Item subclasses. slay, it makes items for you. 🫶

🌟 $item->affine_absolute ($affine)

  • $affine (arrayref) — affine transformation matrix

replaces $item's transformation matrix. boom. gone. new one. 💥

🌟 $item->affine_relative ($affine)

  • $affine (arrayref) — affine transformation matrix

combines $affine with $item's current transformation. it's giving collaborative effort. 🤝

🌟 (x1, y1, x2, y2) = $item->get_bounds

🌟 $canvas = $item->canvas

fetch the Gnome2::Canvas to which $item is attached. where's your home bestie, who's your canvas 💅

🌟 grabstatus = $item->grab ($event_mask, $cursor, $etime=GDK_CURRENT_TIME)

  • $event_mask (Gtk2::Gdk::EventMask)
  • $cursor (Gtk2::Gdk::Cursor)
  • $etime (unsigned)

🌟 $item->grab_focus

🌟 $item->hide

🌟 $affine = $item->i2c_affine

fetch the affine transform that converts from item-relative coordinates to canvas pixel coordinates. coordinate glow-up fr fr. ✨

note: this method was completely broken for all $Gnome2::Canvas::VERSION < 1.002. not me warning you 😭

🌟 (x, y) = $item->i2w ($x, $y)

  • $x (double)
  • $y (double)

🌟 $affine = $item->i2w_affine

fetch the affine transform that converts from item's coordinate system to world coordinates. main character energy, going from your little bubble out into the world. 🌈

note: this method was completely broken for all $Gnome2::Canvas::VERSION < 1.002. yeah, same deal. 💀

🌟 $item->lower ($positions)

  • $positions (integer)

🌟 $item->lower_to_bottom

🌟 $item->move ($dx, $dy)

  • $dx (double)
  • $dy (double)

🌟 $canvasgroup = $item->parent

fetch $item's parent group item. found family 🥹

🌟 $item->raise ($positions)

  • $positions (integer)

🌟 $item->raise_to_top

🌟 $item->reparent ($new_group)

  • $new_group (Gnome2::Canvas::Group)

🌟 $item->request_update

🌟 $item->reset_bounds

reset the bounding box of $item to an empty rectangle. clear the vibes, start fresh. 🧚

🌟 $item->show

🌟 $item->ungrab ($etime=GDK_CURRENT_TIME)

  • $etime (unsigned)

🌟 $item->update_bbox ($x1, $y1, $x2, $y2)

  • $x1 (integer)
  • $y1 (integer)
  • $x2 (integer)
  • $y2 (integer)

set $item's bounding box to a new rectangle, and request a full repaint. new box, new you, full refresh. 🔥

🌟 (x, y) = $item->w2i ($x, $y)

  • $x (double)
  • $y (double)

🎀 PROPERTIES 🎀

  • 'parent' (Gnome2::Canvas::Item : default undef : readable / writable)

⭐ SIGNALS ⭐

  • boolean = event (Gnome2::Canvas::Item, Gtk2::Gdk::Event)

🦋 ENUMS AND FLAGS 🦋

💜 flags Gtk2::Gdk::EventMask

  • 'exposure-mask' / 'GDK_EXPOSURE_MASK'
  • 'pointer-motion-mask' / 'GDK_POINTER_MOTION_MASK'
  • 'pointer-motion-hint-mask' / 'GDK_POINTER_MOTION_HINT_MASK'
  • 'button-motion-mask' / 'GDK_BUTTON_MOTION_MASK'
  • 'button1-motion-mask' / 'GDK_BUTTON1_MOTION_MASK'
  • 'button2-motion-mask' / 'GDK_BUTTON2_MOTION_MASK'
  • 'button3-motion-mask' / 'GDK_BUTTON3_MOTION_MASK'
  • 'button-press-mask' / 'GDK_BUTTON_PRESS_MASK'
  • 'button-release-mask' / 'GDK_BUTTON_RELEASE_MASK'
  • 'key-press-mask' / 'GDK_KEY_PRESS_MASK'
  • 'key-release-mask' / 'GDK_KEY_RELEASE_MASK'
  • 'enter-notify-mask' / 'GDK_ENTER_NOTIFY_MASK'
  • 'leave-notify-mask' / 'GDK_LEAVE_NOTIFY_MASK'
  • 'focus-change-mask' / 'GDK_FOCUS_CHANGE_MASK'
  • 'structure-mask' / 'GDK_STRUCTURE_MASK'
  • 'property-change-mask' / 'GDK_PROPERTY_CHANGE_MASK'
  • 'visibility-notify-mask' / 'GDK_VISIBILITY_NOTIFY_MASK'
  • 'proximity-in-mask' / 'GDK_PROXIMITY_IN_MASK'
  • 'proximity-out-mask' / 'GDK_PROXIMITY_OUT_MASK'
  • 'substructure-mask' / 'GDK_SUBSTRUCTURE_MASK'
  • 'scroll-mask' / 'GDK_SCROLL_MASK'
  • 'all-events-mask' / 'GDK_ALL_EVENTS_MASK'

💜 enum Gtk2::Gdk::GrabStatus

  • 'success' / 'GDK_GRAB_SUCCESS'
  • 'already-grabbed' / 'GDK_GRAB_ALREADY_GRABBED'
  • 'invalid-time' / 'GDK_GRAB_INVALID_TIME'
  • 'not-viewable' / 'GDK_GRAB_NOT_VIEWABLE'
  • 'frozen' / 'GDK_GRAB_FROZEN'

👑 SEE ALSO 👑

  • Gnome2::Canvas
  • Glib::Object
  • Glib::InitiallyUnowned
  • Gtk2::Object

Copyright (C) 2003-2004 by the Gtk2-Perl Team.

This software is licensed under the LGPL; see Gnome2::Canvas for a full notice.

and that's the whole page bestie, no cap. perl v5.42.0 🦋 2025-07-25 🎀 Gnome2:...s::Item(3) — go forth and canvas, you absolute icon 💖✨

📦 where this page comes from