Documentation by TAPgiles

Signal Manipulator

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

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

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)

# Smooth Rise, Smooth Fall

Smoothly changes the output to the target value over time. (Tg) (Jj) (Jj)

The rate of change of the output is change ÷ output range size.

When the change is positive (becoming a larger number), the output “eases out” to that value over smooth fall × rate seconds.

When the change is negative (becoming a smaller number), output “eases out” to that value over smooth fall × rate seconds.

When in “Pulse” mode, the output will rise over smooth rise seconds, and then fall over smooth fall seconds.

# 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 value of the input wire. 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)