Merge pull request #133 from Runware/feature-settingsBackground

Added background to imageInference settings

clientlibs/utils.js

@@ -4823,6 +4823,8 @@ function settingsToggleHandler(settingsNode) {
     const trueCFGScaleWidget = settingsNode.widgets.find(w => w.name === "trueCFGScale");
     const useQualityWidget = settingsNode.widgets.find(w => w.name === "useQuality");
     const qualityWidget = settingsNode.widgets.find(w => w.name === "quality");
+    const useBackgroundWidget = settingsNode.widgets.find(w => w.name === "useBackground");
+    const backgroundWidget = settingsNode.widgets.find(w => w.name === "background");
     const usePromptExtendWidget = settingsNode.widgets.find(w => w.name === "usePromptExtend");
     const promptExtendWidget = settingsNode.widgets.find(w => w.name === "promptExtend");
     const useEditRegionsWidget = settingsNode.widgets.find(w => w.name === "useEditRegions");
@@ -4895,6 +4897,9 @@ function settingsToggleHandler(settingsNode) {
     if (useQualityWidget && qualityWidget) {
         toggleWidgetState(useQualityWidget, qualityWidget, "quality");
     }
+    if (useBackgroundWidget && backgroundWidget) {
+        toggleWidgetState(useBackgroundWidget, backgroundWidget, "background");
+    }
     if (usePromptExtendWidget && promptExtendWidget) {
         toggleWidgetState(usePromptExtendWidget, promptExtendWidget, "promptExtend");
     }

modules/settings.py

@@ -1,7 +1,9 @@
 """
 Runware Image Inference Settings (registered as Runware Settings for workflow compatibility).
-Provides settings for image generation including temperature, systemPrompt, topP,
-editRegions, thinking (boolean), thinkingLevel (high/medium/low), sequential, and colorPalette (from Runware Image Inference Settings Color Palette).
+Provides settings for image generation including temperature, systemPrompt, topP, layers,
+quality, background, promptExtend, editRegions, thinking (boolean),
+thinkingLevel (high/medium/low), sequential, and colorPalette
+(from Runware Image Inference Settings Color Palette).
 """
 
 import json
@@ -126,6 +128,14 @@ class RunwareSettings:
                     "default": "high",
                     "tooltip": "Reasoning level for visual understanding. Only used when 'Use Thinking Level' is enabled.",
                 }),
+                "useBackground": ("BOOLEAN", {
+                    "tooltip": "Enable to include background style in API request",
+                    "default": False,
+                }),
+                "background": (["auto", "transparent", "opaque"], {
+                    "default": "auto",
+                    "tooltip": "Background style for the generated image. Only used when 'Use Background' is enabled.",
+                }),
             }
         }
 
@@ -134,7 +144,7 @@ class RunwareSettings:
     FUNCTION = "createSettings"
     CATEGORY = "Runware"
     DESCRIPTION = (
-        "Configure general settings for image generation: temperature, system prompt, top-p, layers, quality, "
+        "Configure general settings for image generation: temperature, system prompt, top-p, layers, quality, background, "
         "promptExtend, editRegions (JSON), thinking (boolean), thinkingLevel (high/medium/low), sequential, and optional colorPalette from the Color Palette node."
     )
 
@@ -148,6 +158,7 @@ class RunwareSettings:
         useLayers = kwargs.get("useLayers", False)
         useTrueCFGScale = kwargs.get("useTrueCFGScale", False)
         useQuality = kwargs.get("useQuality", False)
+        useBackground = kwargs.get("useBackground", False)
         usePromptExtend = kwargs.get("usePromptExtend", False)
         promptExtend = kwargs.get("promptExtend", False)
         useEditRegions = kwargs.get("useEditRegions", False)
@@ -162,6 +173,7 @@ class RunwareSettings:
         layers = kwargs.get("layers")
         trueCFGScale = kwargs.get("trueCFGScale")
         quality = kwargs.get("quality", "medium")
+        background = kwargs.get("background", "auto")
 
         # Build settings dictionary - only include what is enabled
         settings: Dict[str, Any] = {}
@@ -179,6 +191,8 @@ class RunwareSettings:
             settings["true_cfg_scale"] = float(trueCFGScale)
         if useQuality:
             settings["quality"] = quality
+        if useBackground:
+            settings["background"] = background
         if usePromptExtend:
             settings["promptExtend"] = bool(promptExtend)