GetDMXUniverse(integer[, boolean])

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

Version 2.0

説明

GetDMXUniverse 関数は、DMXチャンネルとその現在値を含むテーブルを返します。

引数

integer:
ユニバース番号です。有効範囲は1～1024です。
boolean (オプション):
戻り値がパーセントまたはDMX値であるかを指定します。
- true:
  戻り値はパーセントです。範囲は0～100 です。
- false:
  戻り値はDMX値です。範囲は0～255です。

戻り値

table:
すべてのDMXアドレスと対応する値をテーブルとして返します。

― または ―

nil:
ユニバースが許可されていないか、入力値が範囲外の場合は、nil が返されます。

例

DMXユニバース1(許可されている場合)のテーブルを出力します。

Copy Code

Lua

return function()
    -- This gets a table for universe 1 with the returned value in percent.
    local tableDMXUniverse = GetDMXUniverse(1,true)
    -- Check the returned table and print information if nil.
    if tableDMXUniverse == nil then
        Printf("No value is returned. The univer is not granted or input is out of range")
        return
    end
    -- Prints the table if not nil.
    for addr, value in ipairs(tableDMXUniverse) do
        Printf("DMX Addr: %i - DMX value : %i", addr, value)
    end
end