FromAddr(string[, handle])

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

Version 2.0

説明

FromAddr 関数は、番号付けまたは名前付けされたアドレスを、コマンドで使用できるハンドルに変換します。

引数

string:
オブジェクトを識別する文字列です。番号付けまたは名前付けされたアドレスを指定します。
handle (オプション):
デフォルトでは、ルート位置からのアドレスを記述しますが、このオプションのハンドルを用いると別のベース位置を指定できます。ルートからオブジェクトへのアドレスパスのベース位置である必要があります。

戻り値

handle:
アドレス指定したオブジェクトに対するハンドルを返します。

例

最初のシーケンスのアドレスを出力します。

Copy Code

Lua

return function()
    -- Converts the string to a handle and store in a variabel.
    local mySequenceHandle = FromAddr("13.13.1.5.1")
    -- Converts the handle back to a numbered string and prints it.
    Printf("The address is: " ..mySequenceHandle:Addr())
    -- Converts the handle to a named string and prints it.
    Printf("The address is: " ..mySequenceHandle:AddrNative())
    
    -- Store the handle of the selected datapool.
    local myDataPool = DataPool()
    -- Prints the address of the selected datapool.
    Printf(myDataPool:Addr())
    
    --- The follwoing example uses the name of a sequence in the sequence pool. 
    --- Please adjust the "Default" name in the next line to match an existing named sequence.
    -- Finds the address based on the base location and a text string with names.
    local alsoMySequenceHandle = FromAddr("Sequences.Default", myDataPool)
    -- Converts the handle back to a numbered string and prints it.
    Printf("The address is: " ..alsoMySequenceHandle:Addr())
    -- Converts the handle to a named string and prints it.
    Printf("The address is: " ..alsoMySequenceHandle:AddrNative())
end