SG-40371: Presentation Mode Enhancements (#850)

### Summarize your change.

This PR add some features to aid in automating Presentation mode

#### Add command to set the presentation device

Add new command `setPresentationDevice`. You can do this with the
writeSettings command but that requires a restart of RV or opening of
the preference window to trigger the the preference being applied.

#### Fix Video Format Overlay

View->Presentation Settings->Video Format overlay was disable because it
was causing a crash in `RV-4.0+`. I fixed the crash and it works again.
It is useful for debugging presentation devices.

<img width="1382" height="380" alt="image"
src="https://github.com/user-attachments/assets/75b53c6c-a934-4a74-8f06-1cd0d65cf1ab"
/>

<img width="1445" height="839" alt="image"
src="https://github.com/user-attachments/assets/4ec4410b-7fb4-4ed9-ac93-a49adc8c0af4"
/>

#### Presentation device additional options

This is pretty funny, **disable** the rich text option on this widget.
don't think this widget needs bold, underline text, colors etc. Can
happen if you are copy pasting text into widget

<img width="701" height="231" alt="image"
src="https://github.com/user-attachments/assets/4baca019-86f6-44c5-8f23-201c0a381236"
/>

#### Add command to apply preferences

`rv.commands.writeSetting` command does not immediately apply the
preferences you set. It only saves them to the configuration file. A
restart of RV or opening of the preference window is required to trigger
the changes to take effect. The `loadSettingsIntoOptions` command
addresses this issue by allowing preferences to be applied. I used the
same name as the c++ function for the command. This name might not be
ideal, I’m open to suggestions for a better name. This command has
proven to be very useful, for setting additional preferences like
modifying `Treat Stylus Events as Mouse Events` which currently not
possible.

### Describe what you have tested and on which operating system.

Linux, macOS

---------

Signed-off-by: Mark Reid <[email protected]>
Signed-off-by: Bernard Laberge <[email protected]>
Co-authored-by: pbergeron-adsk <[email protected]>
Co-authored-by: Bernard Laberge <[email protected]>

Author: 3 people

src/lib/app/RvCommon/MuUICommands.cpp

@@ -476,6 +476,13 @@ namespace Rv
             new Function(c, "presentationMode", presentationMode, None, Return,
                          "bool", End),
 
+            new Function(c, "setPresentationDevice", setPresentationDevice,
+                         None, Return, "void", Parameters,
+                         new Param(c, "name", "string"), End),
+
+            new Function(c, "loadSettingsIntoOptions", loadSettingsIntoOptions,
+                         None, Return, "void", End),
+
             new Function(c, "packageListFromSetting", packageListFromSetting,
                          None, Return, "string[]", Parameters,
                          new Param(c, "settingName", "string"), End),
@@ -2261,6 +2268,57 @@ namespace Rv
         NODE_RETURN(RvApp()->isInPresentationMode());
     }
 
+    NODE_IMPLEMENTATION(setPresentationDevice, void)
+    {
+        StringType::String* deviceName = NODE_ARG_OBJECT(0, StringType::String);
+        Rv::Options& opts = Rv::Options::sharedOptions();
+
+        if (!deviceName)
+            throwBadArgumentException(NODE_THIS, NODE_THREAD,
+                                      "Nil setting name.");
+
+        if (VideoDevice* d =
+                RvApp()->findPresentationDevice(deviceName->c_str()))
+        {
+            bool presenting = RvApp()->isInPresentationMode();
+            Session* s = Session::currentSession();
+            Session::CachingMode mode = s->cachingMode();
+
+            if (presenting)
+            {
+                s->setCaching(Session::NeverCache);
+                RvApp()->setPresentationMode(false);
+            }
+
+            RV_QSETTINGS;
+            settings.beginGroup("Video");
+            settings.setValue("presentationDevice",
+                              QString::fromUtf8(deviceName->c_str()));
+            settings.endGroup();
+
+            Rv::RvPreferences::loadSettingsIntoOptions(opts);
+
+            RvApp()->setVideoDeviceStateFromSettings(d);
+
+            if (presenting)
+            {
+                RvApp()->setPresentationMode(true);
+                s->setCaching(mode);
+            }
+        }
+        else
+        {
+            throwBadArgumentException(NODE_THIS, NODE_THREAD,
+                                      "device not found");
+        }
+    }
+
+    NODE_IMPLEMENTATION(loadSettingsIntoOptions, void)
+    {
+        Rv::Options& opts = Rv::Options::sharedOptions();
+        Rv::RvPreferences::loadSettingsIntoOptions(opts);
+    }
+
     NODE_IMPLEMENTATION(packageListFromSetting, Pointer)
     {
         StringType::String* setting = NODE_ARG_OBJECT(0, StringType::String);

src/lib/app/RvCommon/RvCommon/MuUICommands.h

@@ -78,6 +78,8 @@ namespace Rv
     NODE_DECLARATION(setDriverAttribute, void);
     NODE_DECLARATION(setPresentationMode, void);
     NODE_DECLARATION(presentationMode, bool);
+    NODE_DECLARATION(setPresentationDevice, void);
+    NODE_DECLARATION(loadSettingsIntoOptions, void);
     NODE_DECLARATION(packageListFromSetting, Mu::Pointer);
     NODE_DECLARATION(showTopViewToolbar, void);
     NODE_DECLARATION(showBottomViewToolbar, void);

src/lib/app/RvCommon/ui/RvPreferences/Qt5/RvPreferences.ui

@@ -1719,7 +1719,11 @@
           </widget>
          </item>
          <item row="19" column="1">
-          <widget class="QTextEdit" name="additionalOptionsEdit"/>
+          <widget class="QTextEdit" name="additionalOptionsEdit">
+           <property name="acceptRichText">
+            <bool>false</bool>
+           </property>
+          </widget>
          </item>
          <item row="3" column="0">
           <widget class="QLabel" name="label_22">

src/lib/app/mu_rvui/presentation_mode.mu

@@ -235,6 +235,79 @@ class: PresentationControlMinorMode : MinorMode
 	runtime.gc.pop_api();
     }
 
+    method: _drawFormat (void; Event event)
+    {
+        if (!_showFormat) return;
+        let vstate = videoState();
+        if (vstate eq nil) return;
+
+        let domain = event.domain(),
+            width  = domain.x,
+            height = domain.y,
+            h      = height / 4,
+            w      = width * 0.6,
+            m      = (width - w) / 2;
+
+        setupProjection(domain.x, domain.y, event.domainVerticalFlip());
+
+        \: init (void; FormatText t, string text, int w, int h)
+        {
+            if (text eq nil || text.size() == 0) text = " ";
+            t.text     = "%s" % text;
+            t.fontSize = fitTextInBox(text, w, h);
+
+            gltext.size(t.fontSize);
+
+            let b  = gltext.bounds(text);
+            t.width    = b[0] + b[2];
+            t.height   = -b[1] + b[3];
+            t.valid    = true;
+        }
+
+        if (!_deviceText.valid)
+        {
+            runtime.gc.push_api(0);
+            init(_deviceText, "%s/%s" % (vstate.module, vstate.device), w, h);
+            init(_formatText, vstate.videoFormat, w, h);
+            init(_dataFormatText, vstate.dataFormat, w, h);
+            init(_audioFormatText, vstate.audioFormat, w, h);
+
+            _totalHeight = _deviceText.height + _formatText.height +
+                _dataFormatText.height + _audioFormatText.height;
+
+            runtime.gc.pop_api();
+        }
+
+        glEnable(GL_BLEND);
+        glBlendFunc(GL_SRC_ALPHA, GL_ONE_MINUS_SRC_ALPHA);
+        let hm = (height - _totalHeight) / 2,
+            sep = (height / 4.0) * 0.1;
+
+        int y = height - hm;
+
+        drawRoundedBox(m, y - _totalHeight - sep * 4,
+                        width - m, y,
+                        20,
+                        Color(0,0,0,.75), Color(0,0,0,1));
+
+        for_each (t; [_deviceText, _formatText, _dataFormatText, _audioFormatText])
+        {
+            y -= t.height;
+
+            gltext.size(t.fontSize);
+
+            gltext.color(Color(0,0,0,.1)); gltext.writeAt(m - 2, y - 2, t.text);
+            gltext.color(Color(0,0,0,.1)); gltext.writeAt(m + 2, y + 2, t.text);
+            gltext.color(Color(0,0,0,.1)); gltext.writeAt(m - 2, y + 2, t.text);
+            gltext.color(Color(0,0,0,.25)); gltext.writeAt(m + 4, y - 4, t.text);
+            gltext.color(Color(.75,.75,.75,1)); gltext.writeAt(m, y, t.text);
+
+            y -= sep;
+        }
+
+        glDisable(GL_BLEND);
+    }
+
     method: render (void; Event event)
     {
         event.reject();
@@ -313,67 +386,7 @@ class: PresentationControlMinorMode : MinorMode
         setupProjection(domain.x, domain.y, event.domainVerticalFlip());
 
         _drawPointer (event, state);
-
-        if (_showFormat)
-        {
-            let vstate = videoState(),
-                h = vstate.height / 4,
-                w = vstate.width * 0.6,
-                m = (vstate.width - w) / 2;
-
-            \: init (void; FormatText t, string text, int w, int h)
-            {
-                t.text     = text;
-                t.fontSize = fitTextInBox(text, w, h);
-
-                gltext.size(t.fontSize);
-
-                let b  = gltext.bounds(text);
-                t.width    = b[0] + b[2];
-                t.height   = -b[1] + b[3];
-                t.valid    = true;
-            }
-
-            if (!_deviceText.valid)
-            {
-                init(_deviceText, "%s/%s" % (vstate.module, vstate.device), w, h);
-                init(_formatText, vstate.videoFormat, w, h);
-                init(_dataFormatText, vstate.dataFormat, w, h);
-                init(_audioFormatText, vstate.audioFormat, w, h);
-
-                _totalHeight = _deviceText.height + _formatText.height + 
-                    _dataFormatText.height + _audioFormatText.height;
-            }
-
-            glEnable(GL_BLEND);
-            glBlendFunc(GL_SRC_ALPHA, GL_ONE_MINUS_SRC_ALPHA);
-            let hm = (vstate.height - _totalHeight) / 2,
-                sep = (vstate.height / 4.0) * 0.1;
-
-            int y = vstate.height - hm;
-
-            drawRoundedBox(m, y - _totalHeight - sep * 4, 
-                           vstate.width - m, y,
-                           20,
-                           Color(0,0,0,.75), Color(0,0,0,1));
-
-            for_each (t; [_deviceText, _formatText, _dataFormatText, _audioFormatText])
-            {
-                y -= t.height;
-
-                gltext.size(t.fontSize);
-
-                gltext.color(Color(0,0,0,.1)); gltext.writeAt(m - 2, y - 2, t.text);
-                gltext.color(Color(0,0,0,.1)); gltext.writeAt(m + 2, y + 2, t.text);
-                gltext.color(Color(0,0,0,.1)); gltext.writeAt(m - 2, y + 2, t.text);
-                gltext.color(Color(0,0,0,.25)); gltext.writeAt(m + 4, y - 4, t.text);
-                gltext.color(Color(.75,.75,.75,1)); gltext.writeAt(m, y, t.text);
-
-                y -= sep;
-            }
-
-            glDisable(GL_BLEND);
-        }
+        _drawFormat (event);
 
 	}
 	catch (object obj)
@@ -510,8 +523,6 @@ class: PresentationControlMinorMode : MinorMode
                     subMenu("Presentation Settings", MenuItem[] {
                         menuText("Show"),
                         menuItem("   Pointer", "", "presentation_category", togglePointer, pointerState),
-			 //  XXX
-			 //  This errors in pres mode in rv4, crashes rvsdi, turn off for now
                         menuItem("   Video Format", "", "presentation_category", toggleFormat, formatState),
                         menuSeparator(),
                         menuText("Mirror"),

src/lib/app/py_rvui/rv_commands_setup.py

@@ -177,6 +177,8 @@
     "ioParameters",
     "propertyInfo",
     "setPresentationMode",
+    "setPresentationDevice",
+    "loadSettingsIntoOptions",
     "optionsPlay",
     "addSource",
     "addSourceBegin",