Add TemporaryGraphics wrapper and developer example bundle

extensions/pyRevitDevTools.extension/pyRevitDev.tab/Developer Examples.panel/TemporaryGraphics.pushbutton/bundle.yaml

@@ -0,0 +1,3 @@
+title: "Temporary\nGraphics"
+engine:
+  persistent: true

extensions/pyRevitDevTools.extension/pyRevitDev.tab/Developer Examples.panel/TemporaryGraphics.pushbutton/config.py

@@ -0,0 +1,7 @@
+from pyrevit import revit
+from pyrevit.revit.tmpgfx import ControlManager
+
+cm = ControlManager(revit.doc)
+cm.sync()
+cm.clear_all()
+cm.unregister()

extensions/pyRevitDevTools.extension/pyRevitDev.tab/Developer Examples.panel/TemporaryGraphics.pushbutton/script.py

@@ -0,0 +1,116 @@
+# -*- coding: utf-8 -*-
+"""tmpgfx example — warning icon on a picked element."""
+
+import traceback
+
+from pyrevit import revit, UI, script
+from pyrevit.compat import get_elementid_value_func
+
+from pyrevit.revit.tmpgfx import ControlManager, Handler
+
+
+# Revit context
+
+
+uidoc = revit.uidoc
+doc = revit.doc
+
+get_elementid_value = get_elementid_value_func()
+
+# Bundle icon path — resolved once at module level
+
+
+ICON_PATH = script.get_bundle_file("warning.bmp")
+
+if not ICON_PATH:
+    raise IOError(
+        "warning.bmp not found in script bundle. "
+        "Place a 32x32 24-bit BMP named 'warning.bmp' next to script.py."
+    )
+
+
+# Custom handler
+class WarningHandler(Handler):
+    """Shows a TaskDialog with element info when a warning icon is clicked."""
+
+    def __init__(self):
+        Handler.__init__(
+            self,
+            name="pyRevit Warning Icon Handler",
+            description="Displays element info on warning icon click",
+            vendor_id="pyRevit",
+        )
+        # keep a doc reference for element lookup
+        self._doc = doc
+
+    def on_click(self, index, payload):
+        """Show element name and Id when the warning icon is clicked.
+
+        Args:
+            index (int): Control index that was clicked.
+            payload: The DB.Element stored when the control was created.
+        """
+        try:
+            if payload is None:
+                UI.TaskDialog.Show(
+                    "Warning Icon Clicked",
+                    "Control index: {}\n(no element linked)".format(index),
+                )
+                return
+
+            elem = payload
+            UI.TaskDialog.Show(
+                "Warning Icon Clicked",
+                "Element: {}\nId: {}".format(
+                    elem.Name,
+                    get_elementid_value(elem.Id),
+                ),
+            )
+        except Exception:
+            print(traceback.format_exc())
+
+
+# Pick an element
+
+
+elem = revit.pick_element()
+if not elem:
+    script.exit()
+
+bbox = elem.get_BoundingBox(None)
+
+if not bbox:
+    UI.TaskDialog.Show("Error", "Selected element has no bounding box.")
+    script.exit()
+
+center = (bbox.Min + bbox.Max) * 0.5
+
+
+# Create handler + manager, place the control
+
+
+handler = WarningHandler()
+mgr = ControlManager(doc, handler=handler)
+
+active_view = uidoc.ActiveView
+
+control_index = mgr.add_control(
+    icon_path=ICON_PATH,
+    position=center,
+    view=active_view,
+    payload=elem,
+)
+
+if control_index == -1:
+    print("Failed to create in-canvas control.")
+    script.exit()
+
+print(
+    "Warning icon placed (control index: {}, element: '{}', id: {}).".format(
+        control_index,
+        elem.Name,
+        get_elementid_value(elem.Id),
+    )
+)
+print("Click the icon in the canvas to see element info.")
+print("Controls in active view: {}".format(mgr.control_count(active_view)))