GetDMXValue(integer[, integer, boolean])

grandMA3 ユーザマニュアル » プラグイン » Lua 関数 - Object-Free API » GetDMXValue(integer[, integer, boolean]) Version 2.2

説明

GetDMXValue 関数は、指定されたDMXアドレスのDMX値を返します。

引数

  • integer:
    DMXアドレスです。ユニバースが指定されている場合、この値は 1 〜 512 である必要があります。ユニバースが指定されていない場合は、1 〜 524,288 の範囲の絶対DMXアドレスでなければなりません。
  • integer (オプション):
    ユニバース番号です。
  • boolean (オプション):
    戻り値がパーセントまたはDMX値であるかを指定します。
    • true:
      戻り値はパーセントです。範囲は0〜100 です。
    • false:
      戻り値はDMX値です。範囲は0〜255です。

戻り値

  • integer またはr nil:
    指定したDMXアドレスの値に対応する整数値を返します。DMXアドレスが許可されていない場合は nil になります。

例

ユニバース1のDMXアドレス2の値を出力します(許可されている場合)。

Copy Code
Lua
return function()
    -- This prints the value of DMX address 2 in universe 1 in a range of 0 to 255
    local address = 2       -- The DMX address
    local universe = 1      -- The DMX universe
    local percent = false   -- Readout in percent or DMX value
    local value = GetDMXValue(address, universe, percent)
    if value == nil then
        Printf("The DMX address did not return a valid value")
    else
        Printf("DMX address %i.%03d has a value of %03d", universe, address, value)
    end
end