226 lines
8.8 KiB
Python
226 lines
8.8 KiB
Python
"""A single holographic notification card.
|
|
|
|
Layout: [app icon] [ summary (emitted-magenta, letter-spaced) / radio-squiggle
|
|
divider / body ] with an optional row of action-pill buttons, all under a
|
|
scanline/sweep/noise HologramOverlay (lib/hologram.py) clipped to the card's
|
|
rounded rectangle. The card materialises out of static (holo intro) when it
|
|
appears and dissolves back into static when dismissed.
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
import math
|
|
from typing import Callable, Optional
|
|
|
|
import cairo
|
|
import gi
|
|
|
|
gi.require_version("Gtk", "4.0")
|
|
gi.require_version("Gdk", "4.0")
|
|
gi.require_version("GdkPixbuf", "2.0")
|
|
from gi.repository import Gdk, GdkPixbuf, GLib, Gtk # noqa: E402
|
|
|
|
from lib.hologram import HologramOverlay
|
|
|
|
_CARD_RADIUS = 16.0
|
|
|
|
# Divider "radio wave" colour (Cairo, not CSS): a magenta wave line on a
|
|
# transparent background. Critical keeps an accent wave to match its frame.
|
|
_MAGENTA = (0xEB / 255, 0x00 / 255, 0xA6 / 255) # foreground wave (normal)
|
|
_ACCENT = (0xE4 / 255, 0x00 / 255, 0x46 / 255) # foreground wave (critical)
|
|
_SQUIGGLE_H = 14 # divider row height
|
|
_SQUIGGLE_AMP = 3.0 # wave amplitude (px)
|
|
_SQUIGGLE_CYCLES = 0.045 # cycles per px of width
|
|
_SQUIGGLE_SPEED = 2.4 # phase advance (rad/s) — a slowly travelling signal
|
|
|
|
|
|
def _rounded_path(cr, w: float, h: float, r: float = _CARD_RADIUS) -> None:
|
|
r = min(r, w / 2, h / 2)
|
|
cr.new_sub_path()
|
|
cr.arc(w - r, r, r, -math.pi / 2, 0)
|
|
cr.arc(w - r, h - r, r, 0, math.pi / 2)
|
|
cr.arc(r, h - r, r, math.pi / 2, math.pi)
|
|
cr.arc(r, r, r, math.pi, 3 * math.pi / 2)
|
|
cr.close_path()
|
|
|
|
|
|
class NotificationCard:
|
|
def __init__(self, nid: int, summary: str, body: str, urgency: int,
|
|
icon: str, image_data, actions: list[str],
|
|
on_action: Callable[[int, str], None],
|
|
on_dismiss: Callable[[int], None]) -> None:
|
|
self.nid = nid
|
|
self._on_action = on_action
|
|
self._on_dismiss = on_dismiss
|
|
self._dismissing = False
|
|
critical = urgency >= 2
|
|
|
|
# -- content -----------------------------------------------------------
|
|
content = Gtk.Box(orientation=Gtk.Orientation.HORIZONTAL, spacing=12)
|
|
content.add_css_class("beacon-content")
|
|
|
|
img = self._build_icon(icon, image_data)
|
|
if img is not None:
|
|
content.append(img)
|
|
|
|
textcol = Gtk.Box(orientation=Gtk.Orientation.VERTICAL, spacing=2)
|
|
textcol.set_hexpand(True)
|
|
textcol.set_valign(Gtk.Align.CENTER)
|
|
|
|
if summary:
|
|
lbl = Gtk.Label(label=summary, xalign=0.0)
|
|
lbl.add_css_class("beacon-summary")
|
|
lbl.set_wrap(True)
|
|
lbl.set_wrap_mode(2) # WORD_CHAR
|
|
lbl.set_max_width_chars(30)
|
|
textcol.append(lbl)
|
|
|
|
self._squiggle_color = _ACCENT if critical else _MAGENTA
|
|
self._squiggle_phase = 0.0
|
|
self._squiggle = Gtk.DrawingArea()
|
|
self._squiggle.add_css_class("beacon-squiggle")
|
|
self._squiggle.set_content_height(_SQUIGGLE_H)
|
|
self._squiggle.set_hexpand(True)
|
|
self._squiggle.set_draw_func(self._draw_squiggle)
|
|
textcol.append(self._squiggle)
|
|
|
|
if body:
|
|
blbl = Gtk.Label(xalign=0.0)
|
|
blbl.add_css_class("beacon-body")
|
|
blbl.set_wrap(True)
|
|
blbl.set_wrap_mode(2)
|
|
blbl.set_max_width_chars(34)
|
|
# bodies may carry a small Pango-markup subset (<b>/<i>/<u>/<a>…);
|
|
# fall back to plain text if the sender's markup won't parse.
|
|
try:
|
|
blbl.set_markup(body)
|
|
except GLib.GError:
|
|
blbl.set_text(body)
|
|
textcol.append(blbl)
|
|
|
|
content.append(textcol)
|
|
|
|
if actions:
|
|
row = self._build_actions(actions)
|
|
if row is not None:
|
|
textcol.append(row)
|
|
|
|
card = Gtk.Box(orientation=Gtk.Orientation.VERTICAL)
|
|
card.add_css_class("beacon-card")
|
|
if critical:
|
|
card.add_css_class("critical")
|
|
card.append(content)
|
|
card.set_size_request(340, -1)
|
|
|
|
# -- hologram overlay --------------------------------------------------
|
|
self._holo = HologramOverlay(enabled=True, clip_func=_rounded_path,
|
|
fade_widget=content)
|
|
|
|
overlay = Gtk.Overlay()
|
|
overlay.set_child(card)
|
|
overlay.add_overlay(self._holo.widget)
|
|
overlay.set_measure_overlay(self._holo.widget, False)
|
|
|
|
# left-click anywhere on the card = invoke default action if present, else
|
|
# dismiss; right-click always dismisses.
|
|
self._default_action = "default" if "default" in actions else None
|
|
left = Gtk.GestureClick(button=1)
|
|
left.connect("released", self._on_left_click)
|
|
overlay.add_controller(left)
|
|
right = Gtk.GestureClick(button=3)
|
|
right.connect("released", lambda *_a: self.dismiss())
|
|
overlay.add_controller(right)
|
|
|
|
self.widget = overlay
|
|
self._holo.start_intro()
|
|
|
|
# -- public ---------------------------------------------------------------
|
|
def tick(self, dt: float) -> None:
|
|
self._holo.tick(dt)
|
|
self._squiggle_phase += dt * _SQUIGGLE_SPEED
|
|
self._squiggle.queue_draw() # travel the wave along like a live signal
|
|
|
|
def _draw_squiggle(self, _area, cr, width: int, height: int) -> None:
|
|
if width <= 0:
|
|
return
|
|
# transparent background — just the magenta (accent for critical) radio wave
|
|
mid = height / 2.0
|
|
amp = min(_SQUIGGLE_AMP, mid - 2.0)
|
|
k = _SQUIGGLE_CYCLES * 2.0 * math.pi # angular freq per px
|
|
steps = max(2, int(width))
|
|
cr.set_line_cap(cairo.LINE_CAP_ROUND)
|
|
cr.set_line_join(cairo.LINE_JOIN_ROUND)
|
|
# two passes: a soft wide glow, then a bright thin core — reads as emitted
|
|
# light over the purple bar, matching the card's holographic frame.
|
|
for line_w, alpha in ((3.0, 0.30), (1.4, 1.0)):
|
|
cr.set_line_width(line_w)
|
|
cr.set_source_rgba(*self._squiggle_color, alpha)
|
|
for i in range(steps + 1):
|
|
x = width * i / steps
|
|
y = mid + amp * math.sin(x * k + self._squiggle_phase)
|
|
cr.line_to(x, y) if i else cr.move_to(x, y)
|
|
cr.stroke()
|
|
|
|
def dismiss(self) -> None:
|
|
"""Play the dissolve, then hand the id back to the window for removal."""
|
|
if self._dismissing:
|
|
return
|
|
self._dismissing = True
|
|
self._holo.start_outro(lambda: self._on_dismiss(self.nid))
|
|
|
|
# -- internals ------------------------------------------------------------
|
|
def _on_left_click(self, *_a) -> None:
|
|
if self._default_action is not None:
|
|
self._on_action(self.nid, self._default_action)
|
|
else:
|
|
self.dismiss()
|
|
|
|
def _build_actions(self, actions: list[str]) -> Optional[Gtk.Box]:
|
|
# actions is a flat [key, label, key, label, …] list; "default" is the
|
|
# implicit click action and isn't shown as a button.
|
|
row = Gtk.Box(orientation=Gtk.Orientation.HORIZONTAL, spacing=6)
|
|
row.add_css_class("beacon-actions")
|
|
row.set_margin_top(6)
|
|
shown = 0
|
|
for i in range(0, len(actions) - 1, 2):
|
|
key, label = actions[i], actions[i + 1]
|
|
if key == "default":
|
|
continue
|
|
btn = Gtk.Button(label=label or key)
|
|
btn.add_css_class("beacon-action")
|
|
btn.connect("clicked", lambda _b, k=key: self._on_action(self.nid, k))
|
|
row.append(btn)
|
|
shown += 1
|
|
return row if shown else None
|
|
|
|
def _build_icon(self, icon: str, image_data) -> Optional[Gtk.Image]:
|
|
img: Optional[Gtk.Image] = None
|
|
if image_data is not None:
|
|
pb = self._pixbuf_from_hint(image_data)
|
|
if pb is not None:
|
|
img = Gtk.Image.new_from_paintable(Gdk.Texture.new_for_pixbuf(pb))
|
|
if img is None and icon:
|
|
if icon.startswith("file://"):
|
|
icon = icon[len("file://"):]
|
|
if icon.startswith("/"):
|
|
img = Gtk.Image.new_from_file(icon)
|
|
else:
|
|
img = Gtk.Image.new_from_icon_name(icon)
|
|
if img is None:
|
|
return None
|
|
img.add_css_class("beacon-icon")
|
|
img.set_pixel_size(44)
|
|
img.set_valign(Gtk.Align.START)
|
|
return img
|
|
|
|
@staticmethod
|
|
def _pixbuf_from_hint(data) -> Optional[GdkPixbuf.Pixbuf]:
|
|
# Spec "image-data": (width, height, rowstride, has_alpha, bits, channels, bytes)
|
|
try:
|
|
w, h, rowstride, has_alpha, bits, channels, raw = data
|
|
return GdkPixbuf.Pixbuf.new_from_bytes(
|
|
GLib.Bytes.new(bytes(raw)), GdkPixbuf.Colorspace.RGB,
|
|
has_alpha, bits, w, h, rowstride)
|
|
except (ValueError, TypeError):
|
|
return None
|