Skip to content

Customization and Image Processing

Jump to bottom
Regis "Casey" C edited this page Jul 5, 2023 · 5 revisions

Introduced in version 1 is a section that allows you to add some "image processing" to the image while or before it is drawn out. This section, dubbed CUSTOMIZATION AND IMAGE PROCESSING currently has two main settings to alter the appearance of the resulting image.

image

TintTone

The TintTone property is a tuple that makes up an RGB value. The RGB tuple is then added to the pixels while it is being drawn as a digital image, affecting the final image's color or brightness.

By default, this value is set to (0, 0, 0).

By changing the RGB values in the TintTone tuple, you can manipulate the color tint or color tone of the resulting image. Setting negative values tints the image, setting positive values tones the image.

Tinting (left) colors the white areas, toning (right) colors the dark areas.

0-Toned-image 0-Tinted-Image

By setting all three values in the TintTone tuple to the same value, you effectively control the image brightness. (An example being (32, 32, 32) or (-56, -56, -56).)

Here, we have two images; one with all values set to 128, and the other with all values set to -128.

0-plus128 0-minus128

Levels

The Levels properties allows the user to adjust the tonal range of the image, albeit not as well as say, with a dedicated photo editor.

To make use of this property, Levels must be set to True. This will then enable an operation in the script to modify each pixel value based on whatever adjustments you told the script to make. To get this to work, the program has to essentially 'rewrite' the entire pixel value list for the image, but with the modifications. This adds another layer of processing for the program to do, and may increase the total processing time converting the text/audio file into a .bmp image. If you are converting a long audio clip with many frames, or an image with many samples, it's recommended to leave this setting to False to avoid reducing processing speed.

Tone adjustment

There are three values that can be modified: Highlights, Midtones, and Shadows.

  • Highlights modify values above RGB 170
  • Midtones modify values between RGB 86 and RGB 169
  • Shadows modify values below RGB 85

Each value can be assigned a negative or positive number - Negative numbers suppress the tones in that range, positive numbers bring them out. To demonstrate this, the left image had a highlight boost of 50, the middle had a midtone boost of 50, and the right image had a shadow boost of 50.

1-high50 1-mid50 1-shad50

Be advised that there is no histogram, and clipping is very much possible. It's only advised to use this in case a correction must be made to the image due to a flaw in the original sample.

INTERNAL PICTURE CONTROL

It is not advised to modify these values. Do not report bugs if you modify these values.

image

In the script, you are going to look for def generateFramePalette(dump):. In the for val in dump: loop, you will find two lines that can be modified to adjust how the program processes images.

  • val = val * -255 - This converts the audio value to an RGB value, but "-255" can be modified to adjust the image contrast.
  • val = 255 - val - 164 - This inverts the image to a positive, but "164" can be modified to adjust the image brightness.

There should be no reason for these values to be changed. The script was calibrated to ensure the most accurate image reproduction based on my testing, I'm only mentioning this for debugging purposes. Please use TintTone or Levels as it is a safer option.

Clone this wiki locally