Upscale4KAgentOptions

Options & Configuration · AiDotNet.Video.Options

Configuration options for Upscale4KAgent, 4KAgent (Zuo et al. 2025) over AiDotNet’s native super-resolution experts.

Inheritance: ModelOptions → NeuralNetworkOptions → Upscale4KAgentOptions

For Beginners

the agent does not have one network of its own. It runs several existing upscaling networks on the clip, scores each result with a no-reference image-quality measure, keeps the best, and repeats until the clip reaches the target size.

How It Works

The profile fields follow the release’s profiles (pipeline/profiles/*.yaml): Upscale4K, ScaleFactor and RestorePreference. The defaults are Gen4K-P, the profile the model is named after: upscale to 4K with the perception-oriented experts.

The toolbox experts are AiDotNet’s own paper networks, each configured by its options object, so every expert’s architecture and training hyperparameters are those of its own paper unless changed here.

Constructors

Constructor Summary
Upscale4KAgentOptions() Initializes a new instance with default values.
Upscale4KAgentOptions(Upscale4KAgentOptions other) Initializes a new instance by copying from another instance.

Properties

Property Summary
BasicVSROptions BasicVsr { get; set; } Gets or sets the BasicVSR expert (fidelity).
FourKAgentRestorePreference RestorePreference { get; set; } Gets or sets which experts compete for each super-resolution step (Perception, Gen4K-P’s).
IconVSROptions IconVsr { get; set; } Gets or sets the IconVSR expert (fidelity).
OnnxModelOptions OnnxOptions { get; set; } Gets or sets ONNX runtime options.
RealBasicVSROptions RealBasicVsr { get; set; } Gets or sets the RealBasicVSR expert (perception).
RealViformerOptions RealViformer { get; set; } Gets or sets the RealViformer expert (perception).
bool Upscale4K { get; set; } Gets or sets whether the agent upscales to 4K (true, Gen4K) or by ScaleFactor (false, ExpSR).
double RollbackThreshold { get; set; } Gets or sets the quality score below which a step’s best result counts as a failure (0.5, the release’s threshold for its metric score).
int ColorFixMinSide { get; set; } Gets or sets the longer output side from which a super-resolution result is AdaIN color-corrected to its input (1024).
int ScaleFactor { get; set; } Gets or sets the upscaling factor when Upscale4K is false: 2, 4, 8 or 16 (4).
string ModelPath { get; set; } Gets or sets the path to an ONNX model file for inference mode.