GetSubfixture(integer)

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

説明

GetSubfixture 関数は、パッチ・インデックス番号で指定されたフィクスチャのハンドルを返します。

引数

  • integer:
    フィクスチャのパッチ・インデックス番号です。「サブフィクスチャ・インデックス」とも呼ばれます。

戻り値

  • handle:
    指定したインデックス番号に一致するフィクスチャ・オブジェクトへのハンドルを返します。

例

フィクスチャ・セレクション内の最初のフィクスチャに関するすべての情報を、Dump() 関数を用いて Command Line History に出力します。

Copy Code
Lua
return function ()
    -- Check for a fixture selection, by returning an index for the first fixture
    if (SelectionFirst()) then
        -- There is a fixture selection, store the index for the first fixture 
        local fixtureIndex = SelectionFirst()
        -- Dump all information about the fixture
        Printf("=============== START OF DUMP ===============")
        GetSubfixture(fixtureIndex):Dump()
        Printf("================ END OF DUMP ================")
    else
        -- There needs to be a selection of at least one fixture
        Printf("Please select a fixture")
    end
end

関連する関数