# SD Webui Vectorscope CC This is an Extension for the Automatic1111 Webui, which performs a kind of Offset Noise natively during inference, allowing you to adjust the brightness, contrast, and color of the generations.

Also supports both old & new Forge

Example Images

Base Image w/o Extension

Vibrant	Cold	"Movie when Mexico"
Alt: True Saturation: 1.75 Noise: Ones Scaling: 1 - Cos	Brightness: -5.0 Contrast: 2.5 Saturation: 0.75 R: -3.0 B: 3.0 Noise: Ones Scaling: 1 - Sin	Brightness: 2.5 Contrast: -2.5 Saturation: 1.25 R: 1.5 G: 3.0 B: -4.0 Noise: Ones Scaling: 1 - Sin

How to Use

Note: Since this Extension modifies the underlying latent tensor, the composition may change drastically depending on the parameters

Basic Parameters

• Enable: Enable the Extension 💀

• Alt: Cause the Extension effects to be stronger

  Technical Detail

  - This parameter makes the Extension modify the `denoised` Tensor instead of the `x` Tensor

• Brightness, Contrast, Saturation: Adjust the overall brightness / contrast / saturation of the image

Color Channels

• The Extension also comes with a Color Wheel for visualization, which you can also click on to pick a color directly

The color picker isn't 100% accurate due to multiple layers of conversions...

Style Presets

• To apply a Style, select from the Dropdown then click Apply Style
• To save a Style, enter a name in the Textbox then click Save Style
• To delete a Style, enter the name in the Textbox then click Delete Style
  • Style that was deleted is still in the styles.json in case you wish to retrieve it
• Click Refresh Style to update the Dropdown if you edited the styles.json manually

You can also find pre-made Styles by the community available online

• eg. The Photomatix Styles (right click on the link, click Save link as, then save the .json file into the sd-webui-vectorscope-cc extension folder)

Advanced Parameters

• Process Hires. fix: Enable this option to process during the Hires. fix phase too
  • By default, this Extension only functions during the regular phase of the txt2img mode
• Process ADetailer: Enable this option to process during the ADetailer phase too
  • Will usually cause a square of inconsistent colors
• Randomize using Seed: Enable this option to use the current generation seed to randomize the basic parameters
  • Randomized results will be printed in the console

Noise Settings

let x denote the latent Tensor ; let y denote the operations

• Straight: All operations are calculated on the same Tensor
  • x += x * y
• Cross: All operations are calculated on the Tensor opposite of the Alt. setting
  • x += x' * y
• Ones: All operations are calculated on a Tensor filled with ones
  • x += 1 * y
• N.Random: All operations are calculated on a Tensor filled with random values in normal distribution
  • x += randn() * y
• U.Random: All operations are calculated on a Tensor filled with random values in uniform distribution
  • x += rand() * y
• Multi-Res: All operations are calculated on a Tensor generated with multi-res noise algorithm
  • x += multires() * y
• Abs: Calculate using the absolute values of the chosen Tensors instead
  • x += abs(F) * y

Scaling Settings

By default, this Extension offsets the noise by the same amount every step. But depending on the Sampler and Scheduler used, and whether Alt. was enabled or not, the effects might be too strong during the early or the later phase of the process, which in turn causes artifacts.

• Flat: Default behavior
• Cos: Cosine scaling (High -> Low)
• Sin: Sine scaling (Low -> High)
• 1 - Cos: (Low -> High)
• 1 - Sin: (High -> Low)

Buttons

• Reset: Reset all Basic and Advanced parameters to the default values
• Randomize: Randomize the Brightness, Contrast, Saturation, R, G, B parameters

Roadmap

• [X] Extension Released!
• [X] Add Support for X/Y/Z Plot
• [X] Implement different Noise functions
• [X] Implement Randomize button
• [X] Implement Style Presets
• [X] Implement Color Wheel & Color Picker
• [X] Implement better scaling algorithms
• [X] Add API Docs
• [X] Append Parameters to Infotext
• [X] Improved Infotext Support (by. catboxanon)
• [X] Add HDR Script
• [X] Add Support for SDXL
• [ ] Implement Gradient features

API

You can use this Extension via API by adding an entry to the alwayson_scripts of your payload. An example is provided. The args are sent in the following order in an array:

Known Issues

• In rare occasions, this Extension has little effects when used with certain LoRAs
• Works better / worse with certain Samplers

HDR

Discussion Thread

In the Script Dropdown at the bottom, there is now a new High Dynamic Range option:

• This script will generate multiple images ("Brackets") of varying brightness, then merge them into 1 HDR image
• (Recommended) Use a deterministic sampler and high enough steps. Euler (not Euler a) works well in my experience

Settings

• Brackets: The numer of images to generate
• Gaps: The brightness difference between each image
• Automatically Merge: When enabled, this will merge the images using an OpenCV algorithm and save to the HDR folder in the outputs folder
  • Disable this if you want to merge them yourself using better external program

Vectorscope?

The Extension is named this way because the color interactions remind me of the Vectorscope found in Premiere Pro's Lumetri Color. Those who are experienced in Color Correction should be rather familiar with this Extension.

^{Yes. I'm aware that it's just how digital colors work in general.}

^{We've come full circle (*ba dum tss) now that a Color Wheel is actually added.}