frontengine 1.0.39__tar.gz → 1.0.41__tar.gz

{frontengine-1.0.39 → frontengine-1.0.41}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: frontengine
-Version: 1.0.39
+Version: 1.0.41
 Summary: FrontEngine is use-define frontview or only use like screen saver
 Author-email: JE-Chen <jechenmailman@gmail.com>
 Project-URL: Homepage, https://github.com/Intergration-Automation-Testing/FrontEngine
@@ -177,6 +177,25 @@ that caps every overlay's refresh rate and drops its render resolution.
 
 ---
 
+## Stream and gaming
+
+Four things on the **Stream** tab, for playing and for going live:
+
+- **Crosshair** — a cross, dot, circle or T shape in the middle of the screen,
+  in your colour and size. It is **only drawn on top**: nothing is injected,
+  no memory is read, no game file is touched. An exclusive-fullscreen game will
+  cover it, which is how the OS stacks windows.
+- **Teleprompter** — scroll a script at an adjustable speed and size, with a
+  mirror option for prompter glass. It stops at the last line rather than
+  snapping back mid-read.
+- **Soundboard** — up to twelve slots, each with a sound and an optional
+  hotkey. A file that has gone missing is dropped rather than kept as a dead
+  button.
+- **OBS** — switch scenes and toggle recording or streaming through OBS's own
+  WebSocket (built in since OBS 28). The password stays in your local settings.
+
+---
+
 ## Screen time, clipboard and layouts
 
 Three things that remember, all of them **off until you switch them on** and

{frontengine-1.0.39 → frontengine-1.0.41}/README.md

@@ -153,6 +153,25 @@ that caps every overlay's refresh rate and drops its render resolution.
 
 ---
 
+## Stream and gaming
+
+Four things on the **Stream** tab, for playing and for going live:
+
+- **Crosshair** — a cross, dot, circle or T shape in the middle of the screen,
+  in your colour and size. It is **only drawn on top**: nothing is injected,
+  no memory is read, no game file is touched. An exclusive-fullscreen game will
+  cover it, which is how the OS stacks windows.
+- **Teleprompter** — scroll a script at an adjustable speed and size, with a
+  mirror option for prompter glass. It stops at the last line rather than
+  snapping back mid-read.
+- **Soundboard** — up to twelve slots, each with a sound and an optional
+  hotkey. A file that has gone missing is dropped rather than kept as a dead
+  button.
+- **OBS** — switch scenes and toggle recording or streaming through OBS's own
+  WebSocket (built in since OBS 28). The password stays in your local settings.
+
+---
+
 ## Screen time, clipboard and layouts
 
 Three things that remember, all of them **off until you switch them on** and

frontengine-1.0.41/frontengine/show/gaming/crosshair_widget.py

@@ -0,0 +1,160 @@
+"""
+準星覆蓋層：在畫面正中央畫一個自訂準星，點擊穿透，不動到任何遊戲檔案。
+
+這是純粹的疊圖——不注入遊戲、不讀取記憶體、不改動遊戲的任何東西。全螢幕
+獨佔模式的遊戲會蓋在它上面，那是作業系統的堆疊規則，不是這裡能繞過的。
+
+A crosshair overlay: draw a custom crosshair in the middle of the screen,
+click-through, touching no game files.
+
+It is only a layer on top - nothing is injected, no memory is read, no game is
+modified. An exclusive-fullscreen game will cover it, which is how the OS
+stacks windows and not something to work around.
+"""
+from __future__ import annotations
+
+from typing import Tuple
+
+from PySide6.QtCore import QPointF, Qt
+from PySide6.QtGui import QColor, QPainter, QPen
+
+from frontengine.show.base_widget import BaseWidget
+from frontengine.utils.logging.loggin_instance import front_engine_logger
+
+STYLE_CROSS = "cross"
+STYLE_DOT = "dot"
+STYLE_CIRCLE = "circle"
+STYLE_T_SHAPE = "t"
+STYLES = (STYLE_CROSS, STYLE_DOT, STYLE_CIRCLE, STYLE_T_SHAPE)
+
+DEFAULT_COLOR = "#00ff88"
+DEFAULT_SIZE = 24
+DEFAULT_THICKNESS = 2
+DEFAULT_GAP = 6
+MIN_SIZE = 4
+MAX_SIZE = 200
+
+
+def normalize_style(style) -> str:
+    """把準星樣式正規化；不認得的一律當十字。"""
+    name = str(style or "").strip().lower()
+    return name if name in STYLES else STYLE_CROSS
+
+
+def clamp_size(value, fallback: int = DEFAULT_SIZE) -> int:
+    """準星尺寸夾在看得見又不誇張的範圍。"""
+    try:
+        return max(MIN_SIZE, min(MAX_SIZE, int(value)))
+    except (TypeError, ValueError):
+        return fallback
+
+
+def clamp_thickness(value, fallback: int = DEFAULT_THICKNESS) -> int:
+    """線寬夾在 1~12。"""
+    try:
+        return max(1, min(12, int(value)))
+    except (TypeError, ValueError):
+        return fallback
+
+
+def clamp_gap(value, size: int = DEFAULT_SIZE, fallback: int = DEFAULT_GAP) -> int:
+    """
+    中央空隙不能大到把準星吃光，所以上限跟著尺寸走。
+    The centre gap cannot swallow the crosshair, so its ceiling follows the size.
+    """
+    try:
+        gap = int(value)
+    except (TypeError, ValueError):
+        gap = fallback
+    return max(0, min(clamp_size(size) - 1, gap))
+
+
+def arm_segments(size: int, gap: int) -> Tuple[Tuple[float, float], ...]:
+    """
+    十字手臂的 (起點, 終點) 距離中心多遠。因為 clamp_gap 保證空隙一定小於
+    尺寸，所以手臂至少會有一個像素長——準星不會被空隙吃到看不見。
+    How far each arm starts and ends from the centre. clamp_gap keeps the gap
+    strictly inside the size, so an arm is always at least a pixel long: the
+    crosshair can never be swallowed by its own gap.
+    """
+    length = clamp_size(size)
+    return ((clamp_gap(gap, length), length),)
+
+
+class CrosshairWidget(BaseWidget):
+    """
+    畫面中央的準星。位置固定在目標螢幕正中，不接受滑鼠（點擊會穿到遊戲）。
+    """
+
+    def __init__(self, style: str = STYLE_CROSS, color: str = DEFAULT_COLOR,
+                 size: int = DEFAULT_SIZE, thickness: int = DEFAULT_THICKNESS,
+                 gap: int = DEFAULT_GAP) -> None:
+        front_engine_logger.info(f"[CrosshairWidget] Init | style={style}")
+        super().__init__()
+        self.style = normalize_style(style)
+        candidate = QColor(color)
+        self.color = candidate if candidate.isValid() else QColor(DEFAULT_COLOR)
+        self.size = clamp_size(size)
+        self.thickness = clamp_thickness(thickness)
+        self.gap = clamp_gap(gap, self.size)
+        self.opacity = 1.0
+        self.resize(self.size * 2 + 8, self.size * 2 + 8)
+
+    def set_crosshair(self, style=None, color=None, size=None,
+                      thickness=None, gap=None) -> None:
+        """一次改好幾項設定，改完立刻重畫。"""
+        if style is not None:
+            self.style = normalize_style(style)
+        if color is not None:
+            candidate = QColor(color)
+            if candidate.isValid():
+                self.color = candidate
+        if size is not None:
+            self.size = clamp_size(size)
+        if thickness is not None:
+            self.thickness = clamp_thickness(thickness)
+        if gap is not None or size is not None:
+            self.gap = clamp_gap(self.gap if gap is None else gap, self.size)
+        self.resize(self.size * 2 + 8, self.size * 2 + 8)
+        self.centre_on_screen()
+        self.update()
+
+    def centre_on_screen(self, screen=None) -> None:
+        """擺到螢幕正中央（準星要對準的是畫面中心）。"""
+        from PySide6.QtGui import QGuiApplication
+
+        target = screen or self.screen() or QGuiApplication.primaryScreen()
+        if target is None:  # pragma: no cover - no screen at all
+            return
+        geometry = target.geometry()
+        self.move(geometry.x() + (geometry.width() - self.width()) // 2,
+                  geometry.y() + (geometry.height() - self.height()) // 2)
+
+    def draw_content(self, painter: QPainter) -> None:
+        painter.setRenderHint(QPainter.RenderHint.Antialiasing, True)
+        pen = QPen(self.color, self.thickness)
+        pen.setCapStyle(Qt.PenCapStyle.FlatCap)
+        painter.setPen(pen)
+        centre = QPointF(self.width() / 2.0, self.height() / 2.0)
+        if self.style == STYLE_DOT:
+            painter.setBrush(self.color)
+            painter.drawEllipse(centre, self.thickness, self.thickness)
+            return
+        if self.style == STYLE_CIRCLE:
+            painter.setBrush(Qt.BrushStyle.NoBrush)
+            painter.drawEllipse(centre, float(self.size), float(self.size))
+            return
+        self._draw_arms(painter, centre)
+
+    def _draw_arms(self, painter: QPainter, centre: QPointF) -> None:
+        """十字與 T 字共用的手臂繪製（T 字少了上面那一隻）。"""
+        for inner, outer in arm_segments(self.size, self.gap):
+            painter.drawLine(QPointF(centre.x() - outer, centre.y()),
+                             QPointF(centre.x() - inner, centre.y()))
+            painter.drawLine(QPointF(centre.x() + inner, centre.y()),
+                             QPointF(centre.x() + outer, centre.y()))
+            painter.drawLine(QPointF(centre.x(), centre.y() + inner),
+                             QPointF(centre.x(), centre.y() + outer))
+            if self.style != STYLE_T_SHAPE:
+                painter.drawLine(QPointF(centre.x(), centre.y() - outer),
+                                 QPointF(centre.x(), centre.y() - inner))

frontengine-1.0.41/frontengine/show/teleprompter/teleprompter_widget.py

@@ -0,0 +1,171 @@
+"""
+提詞機：把講稿以可調速度往上捲，字夠大、可以左右鏡像（配提詞玻璃用）。
+
+捲動用「每次前進幾個像素」而不是「每次一行」，這樣速度才會平順；到底之後
+會停在最後一行，不會自己跳回開頭把人嚇一跳。
+
+A teleprompter: scroll a script upward at an adjustable speed, in large type,
+optionally mirrored for prompter glass.
+
+Scrolling advances by pixels rather than by lines so the motion stays smooth,
+and it stops at the last line rather than snapping back to the top mid-read.
+"""
+from __future__ import annotations
+
+from typing import List, Optional
+
+from PySide6.QtCore import Qt, QTimer
+from PySide6.QtGui import QColor, QFont, QFontMetrics, QPainter, QTransform
+
+from frontengine.show.base_widget import BaseWidget
+from frontengine.utils.logging.loggin_instance import front_engine_logger
+from frontengine.utils.power_mode.power_mode import tier_interval
+
+DEFAULT_SPEED = 40          # 像素/秒 / pixels per second
+MIN_SPEED = 5
+MAX_SPEED = 400
+DEFAULT_FONT_SIZE = 32
+MIN_FONT_SIZE = 10
+MAX_FONT_SIZE = 120
+_TICK_MS = 33
+_SIDE_MARGIN = 40
+
+
+def clamp_speed(value, fallback: int = DEFAULT_SPEED) -> int:
+    """捲動速度夾在讀得完又跟得上的範圍。"""
+    try:
+        return max(MIN_SPEED, min(MAX_SPEED, int(value)))
+    except (TypeError, ValueError):
+        return fallback
+
+
+def clamp_font_size(value, fallback: int = DEFAULT_FONT_SIZE) -> int:
+    """字級夾在看得見的範圍。"""
+    try:
+        return max(MIN_FONT_SIZE, min(MAX_FONT_SIZE, int(value)))
+    except (TypeError, ValueError):
+        return fallback
+
+
+def wrap_lines(text: str, metrics: QFontMetrics, width: int) -> List[str]:
+    """
+    依實際字寬把講稿折行；空行會保留（那是段落之間的呼吸）。
+    Wrap the script to the actual text width, keeping blank lines - they are the
+    pauses between paragraphs.
+    """
+    usable = max(40, int(width))
+    lines: List[str] = []
+    for paragraph in str(text or "").splitlines():
+        if not paragraph.strip():
+            lines.append("")
+            continue
+        current = ""
+        for word in paragraph.split():
+            candidate = f"{current} {word}".strip()
+            if current and metrics.horizontalAdvance(candidate) > usable:
+                lines.append(current)
+                current = word
+            else:
+                current = candidate
+        if current:
+            lines.append(current)
+    return lines
+
+
+class TeleprompterWidget(BaseWidget):
+    """
+    提詞機覆蓋層。捲動位置以像素計，速度、字級與鏡像都可以邊跑邊調。
+    """
+
+    def __init__(self, text: str = "", speed: int = DEFAULT_SPEED,
+                 font_size: int = DEFAULT_FONT_SIZE, mirrored: bool = False) -> None:
+        front_engine_logger.info("[TeleprompterWidget] Init")
+        super().__init__()
+        self.script = str(text)
+        self.speed = clamp_speed(speed)
+        self.mirrored = bool(mirrored)
+        self.text_color = QColor("#ffffff")
+        self.opacity = 0.9
+        self.offset = 0.0
+        self._font = QFont()
+        self._font.setPointSize(clamp_font_size(font_size))
+        self._timer = QTimer(self)
+        self._timer.timeout.connect(self.advance)
+
+    @property
+    def font_size(self) -> int:
+        return self._font.pointSize()
+
+    def set_script(self, text: str) -> None:
+        """換一份講稿並回到開頭。"""
+        self.script = str(text)
+        self.offset = 0.0
+        self.update()
+
+    def set_speed(self, speed: int) -> None:
+        self.speed = clamp_speed(speed)
+
+    def set_font_size(self, size: int) -> None:
+        self._font.setPointSize(clamp_font_size(size))
+        self.update()
+
+    def set_mirrored(self, mirrored: bool) -> None:
+        """左右鏡像：透過提詞玻璃反射後才是正的。"""
+        self.mirrored = bool(mirrored)
+        self.update()
+
+    def lines(self) -> List[str]:
+        """目前折行後的講稿。"""
+        return wrap_lines(self.script, QFontMetrics(self._font),
+                          max(40, self.width() - _SIDE_MARGIN * 2))
+
+    def content_height(self) -> int:
+        """整份講稿捲完需要多高。"""
+        return len(self.lines()) * QFontMetrics(self._font).lineSpacing()
+
+    def max_offset(self) -> float:
+        """捲到底的位置（不會捲過頭）。"""
+        return float(max(0, self.content_height() - self.height() // 2))
+
+    def start(self) -> None:
+        self._timer.start(tier_interval(_TICK_MS, self.quality_tier))
+
+    def stop(self) -> None:
+        self._timer.stop()
+
+    def apply_quality_tier(self) -> None:
+        if self._timer.isActive():
+            self._timer.start(tier_interval(_TICK_MS, self.quality_tier))
+
+    def rewind(self) -> None:
+        """回到講稿開頭。"""
+        self.offset = 0.0
+        self.update()
+
+    def advance(self, seconds: Optional[float] = None) -> float:
+        """
+        前進一小段（預設一個 tick 的量），回傳新的捲動位置。捲到底就停住。
+        Advance one tick's worth and return the new offset, stopping at the end.
+        """
+        step = self.speed * (seconds if seconds is not None else _TICK_MS / 1000.0)
+        self.offset = min(self.max_offset(), self.offset + step)
+        self.update()
+        return self.offset
+
+    def draw_content(self, painter: QPainter) -> None:
+        painter.setFont(self._font)
+        painter.setPen(self.text_color)
+        if self.mirrored:
+            painter.setTransform(QTransform().translate(self.width(), 0).scale(-1, 1))
+        spacing = QFontMetrics(self._font).lineSpacing()
+        top = self.height() // 2 - int(self.offset)
+        for index, line in enumerate(self.lines()):
+            y = top + index * spacing
+            if y < -spacing or y > self.height():
+                continue
+            painter.drawText(_SIDE_MARGIN, y, self.width() - _SIDE_MARGIN * 2, spacing,
+                             Qt.AlignmentFlag.AlignLeft | Qt.AlignmentFlag.AlignVCenter, line)
+
+    def closeEvent(self, event) -> None:
+        self.stop()
+        super().closeEvent(event)

{frontengine-1.0.39 → frontengine-1.0.41}/frontengine/ui/main_ui.py

@@ -29,6 +29,7 @@ from frontengine.ui.page.scene_setting.scene_setting_ui import SceneSettingUI
 from frontengine.ui.page.presentation.presentation_setting_ui import PresentationSettingUI
 from frontengine.ui.page.screen_care.screen_care_setting_ui import ScreenCareSettingUI
 from frontengine.ui.page.sound_player.sound_player_setting_ui import SoundPlayerSettingUI
+from frontengine.ui.page.stream.stream_setting_ui import StreamSettingUI
 from frontengine.ui.page.text.text_setting_ui import TextSettingUI
 from frontengine.ui.page.tools.tools_setting_ui import ToolsSettingUI
 from frontengine.ui.page.video.video_setting_ui import VideoSettingUI
@@ -126,6 +127,7 @@ class FrontEngineMainUI(QMainWindow):
         self.focus_setting_ui = FocusSettingUI()
         self.widgets_setting_ui = WidgetsSettingUI()
         self.tools_setting_ui = ToolsSettingUI()
+        self.stream_setting_ui = StreamSettingUI()
 
         # 控制中心
         # Control Center
@@ -298,6 +300,9 @@ class FrontEngineMainUI(QMainWindow):
         for attribute in ("measure_widget_list", "capture_widget_list", "camera_widget_list"):
             self.control_center_ui.register_overlay_source(
                 lambda attribute=attribute: getattr(self.tools_setting_ui, attribute, []))
+        for attribute in ("crosshair_widget_list", "teleprompter_widget_list"):
+            self.control_center_ui.register_overlay_source(
+                lambda attribute=attribute: getattr(self.stream_setting_ui, attribute, []))
 
     def _add_tabs(self) -> None:
         """加入所有內建與擴充的 Tab / Add all built-in and extended tabs"""
@@ -317,6 +322,7 @@ class FrontEngineMainUI(QMainWindow):
             (self.focus_setting_ui, "tab_focus_text"),
             (self.widgets_setting_ui, "tab_widgets_text"),
             (self.tools_setting_ui, "tab_tools_text"),
+            (self.stream_setting_ui, "tab_stream_text"),
             (self.control_center_ui, "tab_control_center_text"),
         ]
 
@@ -518,6 +524,8 @@ class FrontEngineMainUI(QMainWindow):
         if getattr(self, "tools_setting_ui", None) is not None:
             self.tools_setting_ui.release_pinned_windows()
             self.tools_setting_ui.stop_camera()
+        if getattr(self, "stream_setting_ui", None) is not None:
+            self.stream_setting_ui.soundboard.stop_all()
         if getattr(self, "reminder_service", None) is not None:
             self.reminder_service.stop()
         if getattr(self, "app_profile_service", None) is not None:

{frontengine-1.0.39 → frontengine-1.0.41}/frontengine/ui/page/screen_care/screen_care_setting_ui.py

@@ -320,7 +320,7 @@ class ScreenCareSettingUI(QWidget):
             language_wrapper.language_word_dict.get("color_vision_start", "Simulate"))
 
     def _apply_color_vision_settings(self) -> None:
-        for widget in list(self.color_vision_widget_list):
+        for widget in self.color_vision_widget_list[:]:
             try:
                 widget.set_simulation(self.color_vision_combobox.currentData(),
                                       self.color_vision_slider.value() / 100.0)