decode Reference

Send 1 or 0 out a specific outlet

decode

Description

Provides hierarchical switching. The right inlet is the master disable switch, while the middle inlet is a submaster enable. The left inlet can turn on a single outlet provided neither the submaster switch nor the master switch is active.

Examples

decode is a hierarchical on/off switch

Arguments

outlets [int]

Optional

Sets the number of outlets. The default is one outlet.

outlets [float]

Optional

Converted to int.

Attributes

Common Box Attributes

Messages

bang

The message bang causes decode to output its current state.

int

Arguments

outlet [int]
In left inlet: The number specifies an outlet out to turn on, turning off all other outlets. (Whenever an outlet is turned on that was previously turned off, a 1 is sent out. Conversely, whenever an enabled outlet is disabled, a 0 is sent out.) The outlets are referred to by number, beginning with 0 on the left, and numbers received in the left inlet are automatically limited between 0 and the number of outlets minus 1.

  (inlet1)

Arguments

submaster [int]
In middle inlet: Any positive number other than 0 enables all disabled outlets (sends a 1 out them), unless all outlets are disabled. When 0 is received, decode turns off all outlets except the one that had previously been on.

  (inlet2)

Arguments

master [int]
In right inlet: Any positive number other than 0 disables all enabled outlets (sends a 0 out them). Once all outlets have been disabled in this manner, no outlet can be enabled until a 0 is received in the right inlet. When a 0 is received, decode re-enables all outlets that it had just disabled.

Output

int

When an outlet is enabled that was previously disabled, a 1 is sent out that outlet. When an outlet is disabled that was previously enabled, a 0 is sent out that outlet. The left outlet is initially enabled.

See Also

Name Description
bucket
gate
toggle