Description

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

Arguments

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

Return

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

Example

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