Documentation by TAPgiles

Signal Manipulator

Manipulates input signals in various ways, and outputs them again.

Shown on the face of the gadget are two bar graphs representing the original input value and the manipulated output value, scaled according to their ranges. (Jj) (Jj) (Tg)

The input value, or components of the input fat wire value, will be manipulated in some way. The output will be of the same wire type as the input. This principle holds apart from certain settings.

Simplified Settings: The settings listed below as (simplified) use the Default value of the input as a Number value, instead of the individual components.

Memory: Costs 0.0061% of the things limit per gadget.

Tweak Menu

# Input/Output

The input to be manipulated, and the manipulated output. (Tg)

# Remapper Mode

Dictates the high-level way input signals are manipulated.

# Remap Thresholds

This is a line graph representation of the input signal on the left and output signal on the right. The input signal will be squashed or stretched to fit into the output range. (Tg)

On both sides there are “maximum” and “minimum” horizontal lines. (Tg)

By default, the input value will be converted to a percentage through the input range, and the percentage is then mapped to the output range. (Jj) This means values outside than the input range will be mapped to outside the output range.

For example, for the thresholds Input 5 - 10, Output: 15 - 20 and other settings at their defaults, values will be mapped like so:
Input Percentage Output
6 20% 16
10 100% 20
2 -60% 12

"Maximums" can be set to lower or the same as their "Minimum" counterpart.

For example, for the thresholds Input 5 - 10, Output: -5 - -10 and other settings at their defaults, values will be mapped like so:
Input Percentage Output
6 20% -6
10 100% -10
2 -60% -2

Adjustment using the increment controls works on these values.

# Buttons

There are two buttons on the graph:

# Remap Curve

Shapes the percentage before mapping onto the output range. (Tg)

# Output Smoothing

Smoothly changes the output to the target value at a rate of change ÷ output range size. (Tg) (Jj) (Jj)

When the target is greater than the current output, the output “eases out” to that value over smooth rise × rate seconds.

When the target is less than the current output, output “eases out” to that value over smooth fall × rate seconds.

# Output Pulse Shape: When in a “Pulse” or “Toggle” mode, this setting group is renamed to “Output Pulse Shape.”

When using a toggle mode, the behaviour of this setting does not change.

When in a pulse mode, the output will rise over smooth rise seconds, and then fall over smooth fall seconds.

Any new pulses that would be triggered will be ignored until the output has returned to 0% of output after the pulse has ended.

This means with a rise of 3s and fall of 1s, if a pulse begins to animate up and down, no other pulses can begin until 4s after the first triggered.

When these settings are at 0s and 0s (the default), The pulse will immediately be 100% of output, and 1 frame later return to 0% of output.

# Freeze Output

While on, the output will be locked in and will continue to be sent. (Tg) (Tg) (Jj) (Jj)

This means if “freeze” is on at the start of the scene, its output is currently 0, and so 0 will be locked in.
Using this feature, a live signal can be frozen each time some logic is triggered. (Tg) This can control a timeline to create a stuttering or stop-motion effect to an existing animation. (Tg)

The fact that you can freeze many values at the same time means you can store many values in a single signal manipulator, which if used correctly can save you a lot of thermo. You can even use a destroyer to destroy other gadgets that generated these signals once they’ve served their purpose. (Jj)

# Edge Mode

Special ways of reacting to “edges.” An “on edge” occurs when the percentage becomes 100% or higher. An “off edge” occurs when the percentage becomes 0% or lower. (Tg)

The pulsing modes can be used to find out if a value is going from below a value to above a value or vice versa. (Tg)

# Toggle State: The toggle state will start at “off.”

If the edge mode is changed, the toggle state will be preserved and used when changed to a toggle mode. If changed to a pulse mode, the toggle state is reset to “off.”

# Bypass

When active, input values will be passed directly to the output without manipulation. (Tg) (Jj)

A number of switches, one for each component of the input value. So if the input is a fat wire with multiple values, there will be one switch for each value carried by that fat wire. Also shows “nested” values such as a Transform’s > position > X value. (Jj)