FirstDmxModeFixture(handle)

grandMA3 ユーザマニュアル » プラグイン » Lua 関数 - Object-Free API » FirstDmxModeFixture(handle)

Version 2.2

説明

FirstDmxModeFixture 関数は、指定されたDMXモードに一致する最初のフィクスチャへのハンドルを返します。

引数

handle:
DMXモードへのハンドルです。

戻り値

handle:
DMXモードに一致する最初のフィクスチャへのハンドルを返します。

例

ショーに Dimmer フィクスチャタイプが存在する場合、それに接続された最初のデータデータを、"Mode 0" を用いて、Dump() 関数で出力します。

Copy Code

Lua

return function ()
    -- Get the handle for the Dimmer fixture.
    local fixtureTypeHandle = Patch().FixtureTypes['Dimmer']

    -- Check if fixture type returned something and provide feedback.
    if fixtureTypeHandle == nil then
        ErrPrintf("The fixture type does not exist in this show. Try adding it or edit this plugin.")
    else
        -- Get the handle for the DMX mode of a Dimmer fixture.
        local fixtureDMXMode = fixtureTypeHandle.DMXModes["Mode 0"]

        -- Check if fixtureDMXMode returned something and provide feedback.
        if fixtureDMXMode == nil then
            ErrPrintf("The fixture type does not contain a 'Mode 0' DMX mode. Try adding it or edit this plugin.")
        else
            -- Dumps information about the first fixture matching the DMX mode.
            Printf("=============== START OF DUMP ===============")
            FirstDmxModeFixture(fixtureDMXMode):Dump()
            Printf("================ END OF DUMP ================")
        end
    end
end