feat: Implement upscale functionality with ONNX models

- Added upscale operator to handle image upscaling by 4x using AI models.
- Introduced new jobs for upscale processing in the server, including debug and standard upscale jobs.
- Created a new ONNX model handler for upscale operations, supporting tiled inference and resource management.
- Updated tests to cover new upscale functionality, including input validation and output verification.
- Added documentation for the upscale feature, detailing usage and model options.

src/anyimage/operators/debug.py

@@ -1,10 +1,7 @@
 import bpy
 
 from ..runtime import JobOperatorBase
-from ..properties import (
-    BEN2_MODEL_KEY,
-    REALESRGAN_MODEL_KEY,
-)
+from ..properties import BEN2_MODEL_KEY, REALESRGAN_GENERAL_WDN_MODEL_KEY
 from .common import (
     background_input_path,
     da3_parameters,
@@ -94,19 +91,24 @@ class DebugBen2(JobOperatorBase, bpy.types.Operator):
         return f"Removed background to {result.directory}"
 
 
-class DebugRealesrganGeneralX4v3(JobOperatorBase, bpy.types.Operator):
-    bl_idname = "anyimage.debug_realesrgan_general_x4v3"
-    bl_label = "Debug Real-ESRGAN General x4v3"
-    job_type = "debug-realesrgan-general-x4v3"
-    starting_message = "Starting Real-ESRGAN General x4v3 inference"
+class DebugUpscale(JobOperatorBase, bpy.types.Operator):
+    bl_idname = "anyimage.debug_upscale"
+    bl_label = "Debug Upscale"
+    job_type = "debug-upscale"
+    starting_message = "Starting Upscale inference"
+
+    model: bpy.props.StringProperty(
+        default=REALESRGAN_GENERAL_WDN_MODEL_KEY,
+        options={"HIDDEN", "SKIP_SAVE"},
+    )
 
     def request(self, context):
         require_environment()
         settings = context.scene.anyimage_settings
-        require_model(REALESRGAN_MODEL_KEY)
+        require_model(self.model)
         return {
             "input": str(input_path(settings.input_path)),
-            "model": REALESRGAN_MODEL_KEY,
+            "model": self.model,
             "device": settings.device.lower(),
             "video_frames": settings.video_frames,
             "start_frame": 1,
@@ -114,5 +116,4 @@ class DebugRealesrganGeneralX4v3(JobOperatorBase, bpy.types.Operator):
 
     def response(self, _context, result):
         open_job_directory(result.directory)
-        return f"Saved Real-ESRGAN API prediction to {result.directory}"
-
+        return f"Saved upscale API prediction to {result.directory}"