bubbleUI 0.4.4a1__py3-none-any.whl

bubble/glasskit/settings.py

@@ -0,0 +1,82 @@
+"""Reusable runtime settings for desktop-glass surfaces.
+
+Material values live in :class:`glasskit.glass.FrostStyle` (including the
+vignette).  This module only holds the non-visual/runtime switches shared by
+desktop-glass windows:
+
+* background source: static system wallpaper or live screen tracking
+* screen-tracking frame rate
+* optional GPU composition
+* explicit energy saving
+* automatic energy saving when the window loses focus
+* transition duration between standard and energy configurations
+* capture compatibility for screen tracking
+
+``background_mode`` defaults to ``"wallpaper"``.  That is the Mica-like path:
+the wallpaper is sampled once, blurred by glasskit, and only reloaded when
+Windows reports a wallpaper change.  ``"screen"`` keeps the original live
+desktop tracking, which needs Windows' capture exclusion while it is active.
+
+``allow_capture`` only applies to ``"screen"`` mode.  It pauses live sampling
+and reuses the last frame so the window itself becomes visible to OBS and
+screenshot tools.
+"""
+
+from __future__ import annotations
+
+from dataclasses import dataclass, replace
+
+BACKGROUND_WALLPAPER = "wallpaper"
+BACKGROUND_SCREEN = "screen"
+
+
+@dataclass
+class GlassRuntimeSettings:
+    background_mode: str = BACKGROUND_WALLPAPER
+    fps: int = 15
+    gpu: bool = False
+    energy_saving: bool = False
+    auto_energy_on_focus_loss: bool = True
+    transition_ms: int = 250
+    allow_capture: bool = False
+
+    def __post_init__(self) -> None:
+        if self.background_mode not in (BACKGROUND_WALLPAPER, BACKGROUND_SCREEN):
+            self.background_mode = BACKGROUND_WALLPAPER
+        self.fps = max(1, min(30, int(self.fps)))
+        self.transition_ms = max(0, int(self.transition_ms))
+
+    @property
+    def wallpaper(self) -> bool:
+        return self.background_mode == BACKGROUND_WALLPAPER
+
+    @property
+    def screen_tracking(self) -> bool:
+        return self.background_mode == BACKGROUND_SCREEN
+
+    def copy(self) -> "GlassRuntimeSettings":
+        return replace(self)
+
+@dataclass
+class FrostStyle:
+    """All user-tunable properties of a frosted surface."""
+
+    tint: str = "#272727"
+    opacity: int = 74
+    blur: int = 32
+    frost: int = 16
+    noise: int = 9
+    sheen: int = 34
+    saturation: int = 102
+    brightness: int = 94
+    border: int = 24
+    radius: int = 18
+    vignette: int = 0
+
+    def copy(self) -> "FrostStyle":
+        return replace(self)
+
+    def snapshot(self) -> tuple:
+        return (self.tint, self.opacity, self.blur, self.frost, self.noise,
+                self.sheen, self.saturation, self.brightness, self.border,
+                self.radius, self.vignette)

bubble/i18n.py

@@ -0,0 +1,27 @@
+DEFAULT_SOURCE = None
+DEFAULT_LANG = None
+
+def get_lang(id, source=None, lang=None, default=''):
+    '''
+    Get the language text from the source list.
+    '''
+    source = source or DEFAULT_SOURCE # 获取默认语言包
+    lang = lang or DEFAULT_LANG # 获取默认语言
+
+    if not (source and lang):
+        print(f'Warning: Source or lang not set')
+        return default
+
+    for i in source:
+        if i['lang_id'] == 0: # 设置默认语言包
+            default_lang_text = i['lang_package']
+        if i['lang_id'] == lang: # 设置目前语言包
+            lang_text = i['lang_package']
+    try:
+        return lang_text[id]
+    except KeyError:
+        print(f'Warning: Language {id} not found')
+        return default
+    except UnboundLocalError:
+        lang_text = {}
+        return lang_text.get(id, default_lang_text[id])

bubble/icon.py

@@ -0,0 +1,261 @@
+from .QUI import *
+
+from typing import Optional
+from uiml import set_style
+
+_FONT_FAMILIES = ["Segoe Fluent Icons", "Segoe MDL2 Assets"]
+
+class FontIcon(QLabel):
+    """图标字体标签（Segoe Fluent Icons / Segoe MDL2 Assets），支持原地旋转。
+
+    angle 属性可直接交给 QPropertyAnimation 做旋转动画。
+    icon_color / icon_size 也可由 qss 用 qproperty-* 覆盖。
+
+    配色由 qss 决定：默认取 `.FontIcon`（或全局文字色）的 color；
+    需要单独配色的位置在 qss 里用自己的 class 声明 color（如 `.ExpanderArrow`），
+    代码只在显式传入 color 时才把颜色写进控件自身样式表。
+
+    字号通过「控件自身样式表」设置：全局样式表里的 `* { font-size: ... }`
+    会覆盖 setFont()，但覆盖不了控件自身样式表，因此图标字号不会被带跑。
+
+    示例：
+        icon = FontIcon("\uE799", size=24)                    # 颜色交给 qss 的 .FontIcon
+        icon = FontIcon("\uE70D", size=12, color="#F7F7F7")   # 单独配色
+        icon.set_angle(90)                                    # 原地旋转 90°
+        # angle 是 Qt Property，可直接交给 QPropertyAnimation 做动画
+    """
+
+    STYLE_CLASS = "FontIcon"
+
+    def __init__(self, icon="", size: int = 20, color: Optional[str] = None, parent=None):
+        super().__init__(icon, parent)
+
+        self._color = QColor(color) if color is not None else None
+        self._icon_size = int(size)
+        self._angle = 0.0
+        self._pixmap = None
+        self._pixmap_key = None
+
+        self.setAlignment(Qt.AlignCenter)
+        self.setMinimumWidth(0)
+        self.setSizePolicy(QSizePolicy.Maximum, QSizePolicy.Preferred)
+        self._apply_style()
+        set_style(self, self.STYLE_CLASS)
+
+    def _apply_style(self):
+        """把字号写进控件自身样式表（优先级高于全局 `*` 规则）。
+
+        只有显式指定颜色时才写入 color，否则交给 qss 的 `.FontIcon` 决定。
+        """
+        f = self.font()
+        f.setPixelSize(self._icon_size)
+        f.setFamilies(_FONT_FAMILIES)
+        self.setFont(f)
+        # 不在这里写 background：背景交给样式表按层级（level）决定
+        css = f"font-size: {self._icon_size}px;"
+        if self._color is not None:
+            css += f" color: {self._color.name()};"
+        self.setStyleSheet(css)
+        self.updateGeometry()
+
+    def _effective_color(self) -> QColor:
+        """当前生效的图标颜色：显式颜色优先，否则取 qss 设置的前景色。"""
+        if self._color is not None:
+            return self._color
+        return self.palette().color(self.foregroundRole())
+
+    # --------------------------- 原地旋转 ---------------------------
+    def get_angle(self) -> float:
+        return self._angle
+
+    def set_angle(self, angle: float):
+        angle = float(angle)
+        if angle != self._angle:
+            self._angle = angle
+            self.update()
+
+    angle = Property(float, get_angle, set_angle)
+
+    # --------------------------- 配色 / 字号 ---------------------------
+    def get_icon_color(self) -> QColor:
+        return self._effective_color()
+
+    def set_icon_color(self, color):
+        new_color = QColor(color) if color is not None else QColor()
+        if not new_color.isValid():
+            new_color = None
+        if new_color != self._color:
+            self._color = new_color
+            # 旋转时由 _effective_color() 自绘；未旋转时 QLabel 取样式表的颜色
+            self._apply_style()
+
+    def get_icon_size(self) -> int:
+        return self._icon_size
+
+    def set_icon_size(self, size: int):
+        size = int(size)
+        if size != self._icon_size:
+            self._icon_size = size
+            self._apply_style()
+
+    icon_color = Property(QColor, get_icon_color, set_icon_color)
+    icon_size = Property(int, get_icon_size, set_icon_size)
+
+    def _icon_pixmap(self) -> QPixmap:
+        """先把图标按 0° 渲染成 pixmap，再整体旋转绘制。
+
+        直接把文字交给旋转后的 painter 画，在部分平台上不会输出任何像素，
+        因此这里始终先渲染成位图再旋转。
+        """
+        color = self._effective_color()
+        dpr = self.devicePixelRatioF()
+        key = (self.size(), self.text(), self.font().key(), color.rgba(), dpr)
+        if self._pixmap is None or self._pixmap_key != key:
+            pm = QPixmap(int(self.width() * dpr), int(self.height() * dpr))
+            pm.setDevicePixelRatio(dpr)
+            pm.fill(Qt.transparent)
+
+            painter = QPainter(pm)
+            painter.setRenderHint(QPainter.Antialiasing, True)
+            painter.setRenderHint(QPainter.TextAntialiasing, True)
+            painter.setPen(color)
+            painter.setFont(self.font())
+            painter.drawText(QRect(QPoint(0, 0), self.size()), Qt.AlignCenter, self.text())
+            painter.end()
+
+            self._pixmap = pm
+            self._pixmap_key = key
+        return self._pixmap
+
+    def changeEvent(self, event):
+        # 主题 / 样式变化会改变 qss 决定的颜色，缓存的旋转位图必须失效
+        if event.type() in (QEvent.PaletteChange, QEvent.StyleChange, QEvent.FontChange):
+            self._pixmap = None
+            self._pixmap_key = None
+        super().changeEvent(event)
+
+    def paintEvent(self, event):
+        # 未旋转时走 QLabel 默认绘制，保证与普通图标标签完全一致
+        if self._angle % 360.0 == 0.0:
+            super().paintEvent(event)
+            return
+
+        painter = QPainter(self)
+        painter.setRenderHint(QPainter.Antialiasing, True)
+        painter.setRenderHint(QPainter.SmoothPixmapTransform, True)
+
+        rect = QRectF(self.rect())
+        painter.translate(rect.center())
+        painter.rotate(self._angle)
+        painter.translate(-rect.center())
+        painter.drawPixmap(0, 0, self._icon_pixmap())
+
+class IconImage(QLabel):
+    """内嵌图片图标（QLabel + QPixmap）。
+
+    与 FontIcon（图标字体）不同，它不依赖图标字体，图片直接内嵌在控件里，
+    因此完全不受全局 `* { font-size / font-family }` 之类规则影响。
+
+    参数：
+        image —— QPixmap / QIcon / 图片文件路径；None 表示暂无图片
+        size  —— 目标尺寸：int（正方形）或 QSize；None 表示按原图尺寸
+
+    示例：
+        logo = IconImage("logo.png", size=48)                  # 文件路径 + 48×48
+        logo = IconImage(QPixmap(48, 48), size=QSize(48, 48))  # QPixmap + 指定尺寸
+        logo.set_angle(90)                                     # 原地旋转（可做动画）
+    """
+
+    def __init__(self, image=None, size=None, parent=None):
+        super().__init__(parent)
+
+        self._source = QPixmap()      # 原图
+        self._icon_size = QSize()     # 空 QSize 表示按原图
+        self._angle = 0.0
+
+        self.setAlignment(Qt.AlignCenter)
+        self.setSizePolicy(QSizePolicy.Maximum, QSizePolicy.Preferred)
+        self.setMinimumWidth(0)
+
+        if size is not None:
+            self.set_icon_size(size)
+        if image is not None:
+            self.set_image(image)
+
+    # --------------------------- 图片 ---------------------------
+    def set_image(self, image):
+        """设置图片：QPixmap / QIcon / 文件路径。"""
+        if isinstance(image, QPixmap):
+            pixmap = image
+        elif isinstance(image, QIcon):
+            size = self._icon_size if not self._icon_size.isEmpty() else QSize(64, 64)
+            pixmap = image.pixmap(size)
+        elif isinstance(image, str):
+            pixmap = QPixmap(image)
+        elif image is None:
+            pixmap = QPixmap()
+        else:
+            raise TypeError("image 必须是 QPixmap / QIcon / 文件路径")
+
+        self._source = pixmap
+        self._refresh()
+
+    def image(self) -> QPixmap:
+        return self._source
+
+    def has_image(self) -> bool:
+        return not self._source.isNull()
+
+    def _refresh(self):
+        """按目标尺寸等比缩放后显示（保持宽高比）。"""
+        if self._source.isNull():
+            self.clear()
+        else:
+            if self._icon_size.isEmpty():
+                shown = self._source
+            else:
+                shown = self._source.scaled(self._icon_size, Qt.KeepAspectRatio,
+                                            Qt.SmoothTransformation)
+            super().setPixmap(shown)
+            self.setFixedSize(shown.size())
+        self.updateGeometry()
+
+    # --------------------------- 尺寸 ---------------------------
+    def get_icon_size(self) -> QSize:
+        return self._icon_size
+
+    def set_icon_size(self, size):
+        size = QSize(size, size) if isinstance(size, int) else QSize(size)
+        if size != self._icon_size:
+            self._icon_size = size
+            self._refresh()
+
+    icon_size = Property(QSize, get_icon_size, set_icon_size)
+
+    # --------------------------- 原地旋转（与 FontIcon 一致，可交给动画） ---------------------------
+    def get_angle(self) -> float:
+        return self._angle
+
+    def set_angle(self, angle: float):
+        angle = float(angle)
+        if angle != self._angle:
+            self._angle = angle
+            self.update()
+
+    angle = Property(float, get_angle, set_angle)
+
+    def paintEvent(self, event):
+        # 未旋转时走 QLabel 默认绘制
+        if self._angle % 360.0 == 0.0 or self.pixmap() is None:
+            super().paintEvent(event)
+            return
+
+        painter = QPainter(self)
+        painter.setRenderHint(QPainter.Antialiasing, True)
+        painter.setRenderHint(QPainter.SmoothPixmapTransform, True)
+
+        rect = QRectF(self.rect())
+        painter.translate(rect.center())
+        painter.rotate(self._angle)
+        painter.translate(-rect.center())
+        painter.drawPixmap(rect, self.pixmap(), QRectF(self.pixmap().rect()))

bubble/levels/__init__.py

@@ -0,0 +1,32 @@
+"""pyside6_levels —— 为 PySide6 提供“组件层级(level)”概念。
+
+一个控件（组件）可以声明自己为**子控件**增加多少层级（contribution），
+所有祖先贡献之和就是控件的基础层级；QSS 通过 ``level`` 动态属性按层级配色，
+未定义的中间层级自动就近向下填充。
+"""
+
+from .component import (
+    level_component,
+    level_of,
+    raw_level_of,
+    set_contribution,
+    set_level,
+)
+from .manager import (
+    LevelManager,
+    normalize_level_selectors,
+    parse_defined_levels,
+)
+
+__version__ = "0.1.0"
+
+__all__ = [
+    "LevelManager",
+    "level_component",
+    "set_contribution",
+    "set_level",
+    "raw_level_of",
+    "level_of",
+    "normalize_level_selectors",
+    "parse_defined_levels",
+]

bubble/levels/component.py

@@ -0,0 +1,106 @@
+"""pyside6_levels.component —— 声明式组件 API。
+
+用法一：类装饰器（推荐，自制组件“自己设置 +1”）
+
+    @level_component(contribution=1)
+    class Card(QFrame):
+        ...
+
+用法二：给任意内置控件/实例单独设置
+
+    btn = QPushButton("普通按钮")          # 默认贡献 0
+    manager.set_contribution(btn, 0)
+    manager.set_override(inner_btn, 0)     # 只改这一个子控件的层级
+
+用法三：不带参数时读取类属性 ``level_contribution``
+
+    @level_component
+    class Card(QFrame):
+        level_contribution = 1
+"""
+
+from __future__ import annotations
+
+import functools
+from typing import Callable, Optional, TypeVar
+
+from PySide6.QtWidgets import QWidget
+
+from .manager import LevelManager
+
+__all__ = [
+    "level_component",
+    "set_contribution",
+    "set_level",
+    "raw_level_of",
+    "level_of",
+]
+
+_T = TypeVar("_T", bound=type)
+
+
+def level_component(
+    cls: Optional[_T] = None,
+    *,
+    contribution: Optional[int] = None,
+    level: Optional[int] = None,
+):
+    """类装饰器：把这个组件类标记为“为子控件增加 ``contribution`` 层”。
+
+    :param contribution: 层级贡献（≥0）。省略时读取类属性 ``level_contribution``。
+    :param level: 需要强制指定该组件自身的基础层级时传入（等价于
+        :meth:`LevelManager.set_override`）。
+
+    装饰器在实例 ``__init__`` 之后生效，因此即使子控件在构造函数里创建、
+    或实例尚无 parent，后续事件循环也会自动补齐层级。
+    """
+
+    def decorate(component_cls: _T) -> _T:
+        # 类自己定义了 __init__ 就包装它；否则走父类（QWidget/QFrame）的初始化。
+        own_init = component_cls.__dict__.get("__init__")
+
+        def __init__(self, *args, **kwargs):
+            if own_init is not None:
+                own_init(self, *args, **kwargs)
+            else:
+                super(component_cls, self).__init__(*args, **kwargs)
+            manager = LevelManager.instance()
+            value = contribution
+            if value is None:
+                value = int(getattr(type(self), "level_contribution", 0))
+            manager.set_contribution(self, value)
+            if level is not None:
+                manager.set_override(self, level)
+
+        if own_init is not None:
+            __init__ = functools.wraps(own_init)(__init__)
+
+        component_cls.__init__ = __init__  # type: ignore[method-assign]
+        if contribution is not None:
+            component_cls.level_contribution = contribution  # type: ignore[attr-defined]
+        return component_cls
+
+    if cls is None:
+        return decorate
+    return decorate(cls)
+
+
+# --------------------------------------------------------------------- 便捷函数
+def set_contribution(widget: QWidget, contribution: int) -> None:
+    """设置控件的层级贡献（≥0）。"""
+    LevelManager.instance().set_contribution(widget, contribution)
+
+
+def set_level(widget: QWidget, level: Optional[int]) -> None:
+    """强制指定控件的基础层级（绝对覆盖父链），传 None 取消。"""
+    LevelManager.instance().set_override(widget, level)
+
+
+def raw_level_of(widget: QWidget) -> int:
+    """控件自身的基础层级（祖先贡献之和，不含自身贡献）。"""
+    return LevelManager.instance().raw_level(widget)
+
+
+def level_of(widget: QWidget) -> int:
+    """控件当前生效的样式层级（已按断点填充）。"""
+    return LevelManager.instance().level(widget)