Lua: Point Input and Output

Description

mlys.lua provides helper functions for Modalys point inputs and point outputs.

Point Input

modalys.create_point_input creates a point input. It is also available as create_point_input, make_point_input, and modalys.make_point_input.

local input = create_point_input{
    name = "Input1",
    channel = 1,
    gain = 0.9
}

Parameters:

• channel: one-based audio input channel. Internally, Modalys receives a zero-based channel index.
• gain: input gain. If omitted, the default is 1.
• name: optional name.

Point Output

modalys.create_point_output creates a point output. It is also available as create_point_output, make_point_output, and modalys.make_point_output.

local output = create_point_output{
    where = access,
    name = "Output1",
    channel = 1,
    gain = 1
}

Parameters:

• where: an access, object, or controller to output.
• channel: one-based audio output channel. Internally, Modalys receives a zero-based channel index.
• gain: output gain. If omitted, the default is 1.
• modes, index, or selector: optional mode or output selector.
• name: optional name.

Input Force Signal Access

modalys.create_input_force_signal_access creates a point input, a signal controller, an access, and a force connection in one call. It is also available as create_input_force_signal_access.

local force = create_input_force_signal_access{
    where = object,
    position = 0.77,
    kind = "normal",
    name = "SignalToForce",
    channel = 1,
    gain = 1
}

Required parameters are where, name, and either position or location.

★     ★
★