GetFaderText(handle, {[string], [integer]})

Description

The GetFaderText function returns a text string indicating a fader value for the object.

Arguments

• Handle:
  The function takes a handle of the type “light_userdata” as an argument. It can be omitted when using the colon notation on an object. See the examples below.

• Table:
  The table can contain two different elements: Token and Index. The important element is the token.

  • Token: This is used to specify which fader the value is requested for. These are the valid values:

    • FaderMaster
    • FaderX
    • FaderXA
    • FaderXB
    • FaderTemp
    • FaderRate
    • FaderSpeed
    • FaderHighlight
    • FaderLowlight
    • FaderSolo
    • FaderTime

Return

• String:
  The function returns a text string indicating the fader value.

Examples

This example prints the fader value text of the Master and Rate faders for the selected sequence.

Copy CodeLua
```
return function()

-- SelectedSequence() creates a handle to the selected sequence.
local selectedSequence = SelectedSequence()
-- Get the value for the Master fader. Since it is the default, no token needs to be defined.
local faderMasterText = selectedSequence:GetFaderText({})
-- Get the value for the Rate fader.
local faderRateText = selectedSequence:GetFaderText({token="FaderRate"})
-- Print feedback with the values.
Printf("The selected sequence Master fader value text is: ".. tostring(faderMasterText))
Printf("The selected sequence Rate fader value text is: ".. tostring(faderRateText))

end