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

grandMA3 ユーザマニュアル » プラグイン » Lua 関数 - Object-Free API » GetFader(handle, {[string],[integer]})
Version 2.1

説明

The GetFader function returns a float number indicating a fader position for the object.

引数

  • 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

戻り値

  • number:
    The function returns a float number indicating the fader position.

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

Lua
return function()
-- SelectedSequence() creates a handle to the selected sequence.
local selectedSequence = SelectedSequence()
-- Get the value for the Master fader.
local faderMasterValue = selectedSequence:GetFader({})
-- Get the value for the Rate fader.
local faderRateValue = selectedSequence:GetFader({token="FaderRate"})
-- Print feedback with the values.
Printf("The selected sequence Master fader value is: ".. tostring(faderMasterValue))
Printf("The selected sequence Rate fader value is: ".. tostring(faderRateValue))
end