OpalUIDriver Class

Detailed Description

OTs execute on background threads and must never touch QWidgets directly. OpalUIDriver provides a safe interface: OTs call request methods which emit signals marshalled to the main thread. The UI layer connects to these signals and performs the actual UI operations.

When headless (no display, trigger/LLM operator, offscreen platform), all requests are silently skipped.

Usage from an OT's execute() method:

if (driver && driver->hasDisplay()) {
        driver->requestPushActivity("WidgetCatalogActivity");
        driver->requestLogMessage("Capturing widget...");
}