Anima VRP Adv. Settings (Easy UI):
VRPAdvancedSettingsUI, displayed as “Anima VRP Adv. Settings (Easy UI)” in the LuCiD VRP category, prepares advanced configuration for Anima’s regional-routing system. Regional routing helps a compatible workflow apply different prompt descriptions to different parts of an image. This node gives you a consistent way to choose a project-recommended configuration, reproduce the supplied upstream defaults, or prepare a custom configuration for more controlled experimentation. It packages and validates the configuration rather than generating an image or drawing regions itself. Its main benefit is making expert routing controls reusable and easier to compare across generations. The Easy UI and Simple UI registrations use the same underlying node class, so their backend settings-building behavior is identical.
Anima VRP Adv. Settings (Easy UI) Input Parameters:
preset
Selects which configuration the node builds. The available options are VRP Recommended, Sen-sou Upstream Defaults, and Custom; the default is VRP Recommended. This selection has priority over all other controls: when you select either named preset, the backend uses that preset’s stored values and ignores the individual parameter values supplied to the node. VRP Recommended uses global base mode, base strength 0.20, an active interval of 0.0–1.0, cross-mask strength 1.0, self-mask strength 0.20, base ratio 0.31, and both injection intervals set to 1. Sen-sou Upstream Defaults uses disabled base mode, base strength 0.20, an active interval of 0.0–0.35, cross-mask strength 1.0, self-mask strength 0.20, base ratio 0.10, and both injection intervals set to 1. Select Custom when you want the individual controls below to determine the generated configuration.
base_mode
Chooses the base-routing mode when preset is Custom. The options are disabled, uncovered_only, and global; the default is global. These modes distinguish between disabling the base contribution, limiting it to areas not covered by regions, and using it globally. This gives you a way to choose whether the base contribution should support the whole composition or only fill areas outside your regions. The provided source defines these options but does not include the downstream routing implementation, so it does not establish the exact blending behavior at region boundaries. With a named preset selected, the preset’s base mode is used instead.
base_strength
Sets the strength value associated with the base contribution in a custom configuration. The minimum is 0.0, the maximum is 10.0, the default is 0.20, and the adjustment step is 0.01. This is a strength control rather than a percentage: its permitted range extends well above 1.0. Its practical effect depends on the selected base mode and how the receiving Anima routing patch applies the value; it should not be interpreted as a guaranteed percentage of visible image content. Both supplied presets store 0.20, although the upstream preset disables base mode. This node records and validates the value rather than applying the base contribution itself.
start_percent
Sets the normalized starting position of the regional-routing interval in a custom configuration. The minimum is 0.0, the maximum is 1.0, the default is 0.0, and the adjustment step is 0.001. On this scale, 0.0 represents the beginning of sampling progress and 1.0 represents the end. Together with end_percent, this value describes when the regional patch should be active in the receiving workflow; for example, 0.0–0.35 describes an interval covering the first 35% of progress. Both supplied presets start at 0.0. The provided code does not show the downstream scheduling calculation or the validator’s interval-ordering rules, so keep the start below the end for a meaningful interval.
end_percent
Sets the normalized ending position of the regional-routing interval in a custom configuration. The minimum is 0.0, the maximum is 1.0, the default is 1.0, and the adjustment step is 0.001. A value of 1.0 describes an interval extending to the end of sampling progress, while an earlier endpoint limits routing to an earlier portion of that progress. VRP Recommended uses 1.0, whereas Sen-sou Upstream Defaults uses 0.35. This is one of the important differences between the two presets, but the presets also differ in base mode and base ratio, so switching presets does not isolate timing alone. Keep this value above start_percent when preparing a custom interval.
cross_mask_strength
Sets the cross-attention mask-strength value in a custom configuration. The minimum is 0.0, the maximum is 1.0, the default is 1.0, and the adjustment step is 0.01. Cross-attention is the part of attention processing that relates image features to text conditioning, so this control concerns regional masking on that text-to-image interaction path. Both supplied presets use 1.0. The provided source does not show the mask-strength formula, so a value such as 0.5 should not be described as guaranteeing half the visible regional effect, nor should 0.0 be assumed to disable the entire regional-routing system. The node passes this setting to the compatible routing implementation.
self_mask_strength
Sets the self-attention mask-strength value in a custom configuration. The minimum is 0.0, the maximum is 1.0, the default is 0.20, and the adjustment step is 0.01. Self-attention concerns interactions among image features rather than the direct relationship between image features and prompt text. This control therefore configures a different masking path from cross_mask_strength. Both supplied presets use 0.20, providing a shared starting point for comparisons. The source does not show how this value changes attention internally, so precise claims about edge sharpness, subject separation, or visual quality cannot be made from this node alone.
base_ratio
Sets the routing configuration’s base-ratio value when using Custom. The minimum is 0.0, the maximum is 1.0, the default is 0.31, and the adjustment step is 0.01. The project-recommended preset uses 0.31, which the source comments identify as a deliberate change following comparisons, while the upstream comparison preset retains 0.10. This makes the parameter useful for controlled comparisons between those two configurations. However, the supplied code does not include the formula that consumes this ratio, so it should not be interpreted as a documented percentage of prompt influence, image area, or regional blending. It is a separate stored control from base_strength and should not be treated as interchangeable with it.
cross_inject_every
Sets the cross-attention injection interval in a custom configuration. The minimum is 1, the maximum is 100, the default is 1, and the adjustment step is 1. This integer describes how frequently cross-attention injection is requested: 1 represents every eligible injection opportunity, while larger values request a less frequent interval. Both supplied presets use 1. The provided source does not establish whether the receiving patch counts layers, attention calls, sampling steps, or another sequence, so this parameter should not be described as definitively meaning “every N sampling steps.” It also does not establish a guaranteed speed improvement from increasing the value.
self_inject_every
Sets the self-attention injection interval in a custom configuration. The minimum is 1, the maximum is 100, the default is 1, and the adjustment step is 1. It serves the same scheduling role as cross_inject_every but applies to the self-attention injection path, allowing the two paths to have different interval values. Both supplied presets use 1, requesting injection at every eligible opportunity. Larger values describe a less frequent interval, but the exact counting mechanism and resulting image or performance changes depend on the downstream patch, whose implementation is not included in the supplied context.
Anima VRP Adv. Settings (Easy UI) Output Parameters:
settings
The settings output has type VRP_ADVSETTINGS and contains the validated advanced-settings configuration for a compatible Anima regional-routing consumer. It is structured configuration data, not an image, mask, prompt, or model. The configuration contains a schema version of 1 and the nine routing controls described above; preset determines how those values are chosen but is not itself included in the dictionary constructed by the provided helper. Named presets produce their stored configurations, while Custom produces a configuration from the individual controls. Connecting this output to a compatible settings input allows the receiving node to use the chosen configuration. This node calls validation before returning the result, although the supplied context does not include the validator’s detailed checks.
Anima VRP Adv. Settings (Easy UI) Usage Tips:
-
Start with
VRP Recommendedto establish a reproducible baseline using the project’s selected defaults before experimenting with individual controls. -
Select
Custombefore testing manual adjustments. Named presets override the supplied individual values at execution time, even if those values appear different in the interface. -
To compare the complete project and upstream configurations, switch between
VRP RecommendedandSen-sou Upstream Defaultswhile keeping your seed, prompts, regions, model, and sampler settings unchanged. -
To isolate one difference between presets, use
Customand change only that control. For example, comparebase_ratiovalues of 0.31 and 0.10 without also changing the active interval or base mode. -
For a timing experiment, use
Customwithstart_percentat 0.0 and compareend_percentvalues of 1.0 and 0.35. Keep the remaining settings unchanged so that you can attribute differences more confidently to the routing interval. -
Keep
cross_inject_everyandself_inject_everyat 1 for your initial tests. Investigate larger intervals separately rather than assuming they correspond to sampling steps or guarantee faster execution. -
Connect
settingsto a compatible input acceptingVRP_ADVSETTINGS. Adding the node to the canvas without connecting its output does not apply its configuration to image generation. -
If debug logging is available in your workflow, inspect the “VRP effective regional settings” log entry in the receiving node. The supplied context shows logging for the effective values and their source, which can help confirm which configuration is actually being used.
Anima VRP Adv. Settings (Easy UI) Common Errors and Solutions:
Unknown VRP advanced-settings preset: …
- Explanation: This is an explicit error raised by the provided preset lookup function when it receives an unrecognized preset name. The normal dropdown supplies valid names, but edited workflow data or external calls may supply something else.
- Solution: Select exactly
VRP Recommended,Sen-sou Upstream Defaults, orCustom. If necessary, replace the node with a fresh instance and reconnect it.
Manual adjustments appear to have no effect
- Explanation: This is a configuration symptom rather than a documented exception. With either named preset selected, the backend ignores the individual controls and builds the stored preset configuration.
- Solution: Change
presettoCustom, confirm the individual values, and run the workflow again.
Settings validation fails
- Explanation: Every configuration passes through
validate_advanced_settingsbefore being returned. Its implementation is not included, so the exact error messages and complete validation rules cannot be listed reliably. - Solution: Return to
VRP Recommendedto test a known supplied configuration. For custom settings, use the documented options, keep numeric values within their interface ranges, and use whole numbers for the injection intervals. If the error persists, inspect the execution log for the specific validation message.
Custom routing interval produces unexpected results
- Explanation: This is a possible configuration issue, not an error string shown in the source. An equal or reversed start and end may not describe the active interval you intended; the supplied context does not show whether such a configuration is rejected or how it is handled.
- Solution: Begin with
start_percentset to 0.0 andend_percentset to 1.0. When narrowing the interval, keep the start below the end and adjust one endpoint at a time.
Cannot connect settings to the target socket
- Explanation: This is a connection-type issue rather than a documented node-specific exception. The output uses the custom type
VRP_ADVSETTINGS, which is not interchangeable with an image, mask, conditioning, or model connection. - Solution: Connect it to an input that explicitly accepts
VRP_ADVSETTINGS. Check that your receiving node belongs to a compatible version of the Anima VRP workflow.
The node runs, but generation does not use the expected settings
- Explanation: Successfully building the configuration does not prove that a downstream node is consuming it. A disconnected output or a receiving workflow using another configuration source can leave your intended settings unapplied.
- Solution: Check the connection from
settingsto the compatible consumer, confirm that the intended branch reaches your generation workflow, and inspect the effective-settings debug log when available.
