FindTexture(string)

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

Version 2.0

説明

The FindTixture Lua function returns a handle to the texture matching the input text string - if the texture exists.

引数

string:
The text string must be the name of the texture without the file type. See the example below.

戻り値

handle | nil:
The function returns the texture handle or nil if it does not exist.

例

This example prints the information about the "button" texture. The example uses the Dump() function.

Dump()

The Dump() function returns a string with information about the object, for instance, the name, class, path of the object, its properties, and children.

Learn more in the Dump() topic.

Copy Code

Lua

return function ()
    -- Set a texture name.
    local textureName = "button"
    -- Get the handle of the texture.
    local textureHandle = FindTexture(textureName)
    -- Check if textureHandle returned something and provide feedback.
    if textureHandle == nil then
        ErrPrintf("Texture does not exist.")
    else
        Printf("=============== START OF DUMP ===============")
        FindTexture(textureName):Dump()
        Printf("================ END OF DUMP ================")
    end
end