[cuegui] Expand job user colors and add a custom RGB option (#1859)

Expand job user colors (right click job > Set user color) and add a
custom RGB option popup.

- Increased predefined color options from 4 to 15 with descriptive names
- Added custom color picker dialog with RGB input (0-255 range)
- Included live preview in custom color dialog
- Updated menu items to show color names (e.g., "Set Color 1 - Dark
Blue")
- New colors include: Purple, Teal, Orange, Maroon, Forest Green,
Lavender, Crimson, Navy, Olive, Plum, and Slate
- Custom colors persist across sessions using existing storage mechanism

This enhancement provides better visual organization for complex
rendering workflows with many concurrent jobs

**Link the Issue(s) this Pull Request is related to.**
- #1858 
- #1800

Author: ramonfigueiredo

cuegui/cuegui/Constants.py

@@ -185,6 +185,17 @@ def __get_version_from_cmd(command):
 COLOR_USER_2 = QtGui.QColor(*__bg_colors[1])
 COLOR_USER_3 = QtGui.QColor(*__bg_colors[2])
 COLOR_USER_4 = QtGui.QColor(*__bg_colors[3])
+COLOR_USER_5 = QtGui.QColor(*__bg_colors[4])
+COLOR_USER_6 = QtGui.QColor(*__bg_colors[5])
+COLOR_USER_7 = QtGui.QColor(*__bg_colors[6])
+COLOR_USER_8 = QtGui.QColor(*__bg_colors[7])
+COLOR_USER_9 = QtGui.QColor(*__bg_colors[8])
+COLOR_USER_10 = QtGui.QColor(*__bg_colors[9])
+COLOR_USER_11 = QtGui.QColor(*__bg_colors[10])
+COLOR_USER_12 = QtGui.QColor(*__bg_colors[11])
+COLOR_USER_13 = QtGui.QColor(*__bg_colors[12])
+COLOR_USER_14 = QtGui.QColor(*__bg_colors[13])
+COLOR_USER_15 = QtGui.QColor(*__bg_colors[14])
 
 __frame_colors = __config.get('style.colors.frame_state')
 RGB_FRAME_STATE = {

cuegui/cuegui/JobMonitorTree.py

@@ -513,6 +513,20 @@ def contextMenuEvent(self, e):
         self.__menuActions.jobs().addAction(color_menu, "setUserColor2")
         self.__menuActions.jobs().addAction(color_menu, "setUserColor3")
         self.__menuActions.jobs().addAction(color_menu, "setUserColor4")
+        self.__menuActions.jobs().addAction(color_menu, "setUserColor5")
+        self.__menuActions.jobs().addAction(color_menu, "setUserColor6")
+        self.__menuActions.jobs().addAction(color_menu, "setUserColor7")
+        self.__menuActions.jobs().addAction(color_menu, "setUserColor8")
+        self.__menuActions.jobs().addAction(color_menu, "setUserColor9")
+        self.__menuActions.jobs().addAction(color_menu, "setUserColor10")
+        self.__menuActions.jobs().addAction(color_menu, "setUserColor11")
+        self.__menuActions.jobs().addAction(color_menu, "setUserColor12")
+        self.__menuActions.jobs().addAction(color_menu, "setUserColor13")
+        self.__menuActions.jobs().addAction(color_menu, "setUserColor14")
+        self.__menuActions.jobs().addAction(color_menu, "setUserColor15")
+        color_menu.addSeparator()
+        self.__menuActions.jobs().addAction(color_menu, "setUserCustomColor")
+        color_menu.addSeparator()
         self.__menuActions.jobs().addAction(color_menu, "clearUserColor")
         menu.addMenu(color_menu)
 
@@ -586,6 +600,62 @@ def actionSetUserColor(self, color):
                 self.__userColors[objectKey] = color
             item.setUserColor(color)
 
+    def actionSetUserCustomColor(self):
+        """Opens a dialog to set a custom RGB color for selected items"""
+        dialog = QtWidgets.QDialog(self)
+        dialog.setWindowTitle("Set Custom Color (RGB)")
+        dialog.setModal(True)
+
+        layout = QtWidgets.QFormLayout()
+
+        # Create spinboxes for RGB values
+        r_spinbox = QtWidgets.QSpinBox()
+        r_spinbox.setRange(0, 255)
+        r_spinbox.setValue(100)
+
+        g_spinbox = QtWidgets.QSpinBox()
+        g_spinbox.setRange(0, 255)
+        g_spinbox.setValue(100)
+
+        b_spinbox = QtWidgets.QSpinBox()
+        b_spinbox.setRange(0, 255)
+        b_spinbox.setValue(100)
+
+        # Color preview label
+        preview_label = QtWidgets.QLabel()
+        preview_label.setMinimumSize(200, 50)
+        preview_label.setFrameStyle(QtWidgets.QFrame.Box)
+        preview_label.setStyleSheet("background-color: rgb(100, 100, 100);")
+
+        def update_preview():
+            r = r_spinbox.value()
+            g = g_spinbox.value()
+            b = b_spinbox.value()
+            preview_label.setStyleSheet(f"background-color: rgb({r}, {g}, {b});")
+
+        r_spinbox.valueChanged.connect(update_preview)
+        g_spinbox.valueChanged.connect(update_preview)
+        b_spinbox.valueChanged.connect(update_preview)
+
+        layout.addRow("Red (0-255):", r_spinbox)
+        layout.addRow("Green (0-255):", g_spinbox)
+        layout.addRow("Blue (0-255):", b_spinbox)
+        layout.addRow("Preview:", preview_label)
+
+        # Buttons
+        button_box = QtWidgets.QDialogButtonBox(
+            QtWidgets.QDialogButtonBox.Ok | QtWidgets.QDialogButtonBox.Cancel)
+        button_box.accepted.connect(dialog.accept)
+        button_box.rejected.connect(dialog.reject)
+        layout.addRow(button_box)
+
+        dialog.setLayout(layout)
+
+        if dialog.exec_() == QtWidgets.QDialog.Accepted:
+            # Create custom color from RGB values
+            custom_color = QtGui.QColor(r_spinbox.value(), g_spinbox.value(), b_spinbox.value())
+            self.actionSetUserColor(custom_color)
+
     def actionEatSelectedItems(self):
         """Eats all dead frames for selected jobs"""
         self.__menuActions.jobs().eatDead()

cuegui/cuegui/MenuActions.py

@@ -762,29 +762,108 @@ def copyJobName(self, rpcObjects=None):
                 " ".join(names), QtGui.QClipboard.Clipboard)
 
     setUserColor1_info = [
-        "Set Color 1", "Set user defined background color", cuegui.Constants.COLOR_USER_1]
+        "Set Color 1 - Dark Blue", "Set user defined background color",
+        cuegui.Constants.COLOR_USER_1]
 
     def setUserColor1(self, rpcObjects=None):
         self._caller.actionSetUserColor(cuegui.Constants.COLOR_USER_1)
 
     setUserColor2_info = [
-        "Set Color 2", "Set user defined background color", cuegui.Constants.COLOR_USER_2]
+        "Set Color 2 - Dark Yellow", "Set user defined background color",
+        cuegui.Constants.COLOR_USER_2]
 
     def setUserColor2(self, rpcObjects=None):
         self._caller.actionSetUserColor(cuegui.Constants.COLOR_USER_2)
 
     setUserColor3_info = [
-        "Set Color 3", "Set user defined background color", cuegui.Constants.COLOR_USER_3]
+        "Set Color 3 - Dark Green", "Set user defined background color",
+        cuegui.Constants.COLOR_USER_3]
 
     def setUserColor3(self, rpcObjects=None):
         self._caller.actionSetUserColor(cuegui.Constants.COLOR_USER_3)
 
     setUserColor4_info = [
-        "Set Color 4", "Set user defined background color", cuegui.Constants.COLOR_USER_4]
+        "Set Color 4 - Dark Brown", "Set user defined background color",
+        cuegui.Constants.COLOR_USER_4]
 
     def setUserColor4(self, rpcObjects=None):
         self._caller.actionSetUserColor(cuegui.Constants.COLOR_USER_4)
 
+    setUserColor5_info = [
+        "Set Color 5 - Purple", "Set user defined background color", cuegui.Constants.COLOR_USER_5]
+
+    def setUserColor5(self, rpcObjects=None):
+        self._caller.actionSetUserColor(cuegui.Constants.COLOR_USER_5)
+
+    setUserColor6_info = [
+        "Set Color 6 - Teal", "Set user defined background color", cuegui.Constants.COLOR_USER_6]
+
+    def setUserColor6(self, rpcObjects=None):
+        self._caller.actionSetUserColor(cuegui.Constants.COLOR_USER_6)
+
+    setUserColor7_info = [
+        "Set Color 7 - Orange", "Set user defined background color", cuegui.Constants.COLOR_USER_7]
+
+    def setUserColor7(self, rpcObjects=None):
+        self._caller.actionSetUserColor(cuegui.Constants.COLOR_USER_7)
+
+    setUserColor8_info = [
+        "Set Color 8 - Maroon", "Set user defined background color", cuegui.Constants.COLOR_USER_8]
+
+    def setUserColor8(self, rpcObjects=None):
+        self._caller.actionSetUserColor(cuegui.Constants.COLOR_USER_8)
+
+    setUserColor9_info = [
+        "Set Color 9 - Forest Green", "Set user defined background color",
+        cuegui.Constants.COLOR_USER_9]
+
+    def setUserColor9(self, rpcObjects=None):
+        self._caller.actionSetUserColor(cuegui.Constants.COLOR_USER_9)
+
+    setUserColor10_info = [
+        "Set Color 10 - Lavender", "Set user defined background color",
+        cuegui.Constants.COLOR_USER_10]
+
+    def setUserColor10(self, rpcObjects=None):
+        self._caller.actionSetUserColor(cuegui.Constants.COLOR_USER_10)
+
+    setUserColor11_info = [
+        "Set Color 11 - Crimson", "Set user defined background color",
+        cuegui.Constants.COLOR_USER_11]
+
+    def setUserColor11(self, rpcObjects=None):
+        self._caller.actionSetUserColor(cuegui.Constants.COLOR_USER_11)
+
+    setUserColor12_info = [
+        "Set Color 12 - Navy", "Set user defined background color", cuegui.Constants.COLOR_USER_12]
+
+    def setUserColor12(self, rpcObjects=None):
+        self._caller.actionSetUserColor(cuegui.Constants.COLOR_USER_12)
+
+    setUserColor13_info = [
+        "Set Color 13 - Olive", "Set user defined background color", cuegui.Constants.COLOR_USER_13]
+
+    def setUserColor13(self, rpcObjects=None):
+        self._caller.actionSetUserColor(cuegui.Constants.COLOR_USER_13)
+
+    setUserColor14_info = [
+        "Set Color 14 - Plum", "Set user defined background color", cuegui.Constants.COLOR_USER_14]
+
+    def setUserColor14(self, rpcObjects=None):
+        self._caller.actionSetUserColor(cuegui.Constants.COLOR_USER_14)
+
+    setUserColor15_info = [
+        "Set Color 15 - Slate", "Set user defined background color", cuegui.Constants.COLOR_USER_15]
+
+    def setUserColor15(self, rpcObjects=None):
+        self._caller.actionSetUserColor(cuegui.Constants.COLOR_USER_15)
+
+    setUserCustomColor_info = [
+        "Set Custom Color (RGB)...", "Set custom background color using RGB values", None]
+
+    def setUserCustomColor(self, rpcObjects=None):
+        self._caller.actionSetUserCustomColor()
+
     clearUserColor_info = ["Clear", "Clear user defined background color", None]
 
     def clearUserColor(self, rpcObjects=None):

cuegui/cuegui/config/cuegui.yaml

@@ -56,10 +56,21 @@ style.font.size: 10
 style.color_theme: 'plastique'
 # RGB values.
 style.colors.background: [
-  [50, 50, 100],
-  [100, 100, 50],
-  [0, 50, 0],
-  [50, 30, 0],
+  [50, 50, 100],    # Dark blue
+  [100, 100, 50],   # Dark yellow
+  [0, 50, 0],       # Dark green
+  [50, 30, 0],      # Dark brown
+  [80, 0, 80],      # Purple
+  [0, 80, 80],      # Teal
+  [100, 50, 0],     # Orange
+  [70, 0, 35],      # Maroon
+  [0, 60, 30],      # Forest green
+  [90, 60, 90],     # Lavender
+  [100, 0, 50],     # Crimson
+  [0, 50, 100],     # Navy
+  [80, 80, 0],      # Olive
+  [60, 20, 60],     # Plum
+  [30, 70, 70],     # Slate
 ]
 style.colors.frame_state:
   DEAD: [255, 0, 0]

docs/_docs/user-guides/cuetopia-monitoring-guide.md

@@ -20,6 +20,7 @@ This guide provides comprehensive documentation for Cuetopia, which includes the
 
 ## Table of Contents
 1. [Monitor Jobs Plugin](#monitor-jobs-plugin)
+   - [Job Color Organization](#job-color-organization)
 2. [Monitor Job Details Plugin](#monitor-job-details-plugin)
 3. [Job Graph Plugin](#job-graph-plugin)
 4. [Filters and Search Capabilities](#filters-and-search-capabilities)
@@ -132,6 +133,67 @@ Right-clicking on a job provides these actions:
 - Eat/retry frames
 - Add comments
 - Use local cores
+- Set user color (see [Job Color Organization](#job-color-organization))
+
+### Job Color Organization
+
+The Monitor Jobs view allows you to organize jobs visually by applying background colors. This feature is particularly useful when working with many concurrent renders, allowing you to group jobs by project, priority, department, or any other categorization scheme.
+
+#### Setting Job Colors
+
+To apply a color to one or more jobs:
+
+1. **Select Jobs**: Click on a job or use Ctrl+click to select multiple jobs
+2. **Right-Click**: Open the context menu
+3. **Choose Color**: Navigate to "Set user color" submenu
+
+![Set User Color Menu with 15 Options](/assets/images/cuegui/cuetopia/job_user_colors_set_user_color_with_15_color_options.png)
+
+#### Available Color Options
+
+The system provides **15 predefined colors** with descriptive names:
+
+- **Set Color 1 - Dark Blue**
+- **Set Color 2 - Dark Yellow**  
+- **Set Color 3 - Dark Green**
+- **Set Color 4 - Dark Brown**
+- **Set Color 5 - Purple**
+- **Set Color 6 - Teal**
+- **Set Color 7 - Orange**
+- **Set Color 8 - Maroon**
+- **Set Color 9 - Forest Green**
+- **Set Color 10 - Lavender**
+- **Set Color 11 - Crimson**
+- **Set Color 12 - Navy**
+- **Set Color 13 - Olive**
+- **Set Color 14 - Plum**
+- **Set Color 15 - Slate**
+
+#### Custom Color Option
+
+For complete flexibility, use the **"Set Custom Color (RGB)..."** option to create any color:
+
+1. Select jobs and choose "Set Custom Color (RGB)..." from the menu
+2. Enter RGB values (0-255 range) using the spinboxes
+3. Preview the color in real-time as you adjust values
+4. Click OK to apply the custom color
+
+![Custom Color Dialog](/assets/images/cuegui/cuetopia/job_user_colors_set_user_color_with_set_custom_color.png)
+
+#### Color Management
+
+- **Clear Colors**: Use "Clear" option to remove color assignments
+- **Persistent Colors**: Color assignments are saved and restored across CueGUI sessions
+- **Multiple Selection**: Apply colors to multiple jobs simultaneously
+- **Visual Organization**: Colors appear as background highlighting in the job list
+
+#### Best Practices for Color Organization
+
+- **Consistent Scheme**: Develop a facility-wide color coding standard
+- **Project-Based**: Use different colors for different shows or projects
+- **Priority-Based**: Use warmer colors (red, orange) for urgent jobs, cooler colors (blue, green) for routine work
+- **Department-Based**: Assign colors by department (lighting, compositing, effects)
+- **Status-Based**: Use colors to indicate job status or approval stages
 
 ---