gui.utils.overlay_factory

File:

EuljiroBible/gui/utils/overlay_factory.py

Author:

Benjamin Jaedon Choi - https://github.com/saintbenjamin

Affiliated Church:

The Eulji-ro Presbyterian Church [대한예수교장로회(통합) 을지로교회]

Address:

The Eulji-ro Presbyterian Church, 24-10, Eulji-ro 20-gil, Jung-gu, Seoul 04549, South Korea

Telephone:

+82-2-2266-3070

E-mail:

euljirochurch [at] G.M.A.I.L. (replace [at] with @ and G.M.A.I.L as you understood.)

License:

MIT License with Attribution Requirement (see LICENSE file for details); Copyright (c) 2025 The Eulji-ro Presbyterian Church.

Provides a factory function to instantiate the WidgetOverlay using current settings and display geometry.

gui.utils.overlay_factory.create_overlay(settings, geometry, parent=None)[source]

Create and return a configured overlay widget instance.

This factory function constructs a WidgetOverlay using the current overlay-related settings and the target screen geometry. It centralizes overlay creation logic so that callers do not need to manually extract individual style parameters from the settings dictionary.

Parameters:

  • settings (dict) – Application settings dictionary containing overlay-related keys, such as font family, font size, colors, transparency, and display mode.

  • geometry (QRect) – Screen geometry defining the initial size and position of the overlay window.

  • parent (QWidget | None) – Optional parent widget for ownership and stacking context.

Returns:

A fully initialized overlay widget ready to be shown.

Return type:

WidgetOverlay