GetDMXUniverse(integer[, boolean])

説明

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

引数

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

戻り値

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

― または ―

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

例

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

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 univers 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