grandMA3 User Manual Publication
Set(handle, string, string[, integer])

grandMA3 User Manual » Plugins » Lua Functions - Object API » Set(handle, string, string[, integer])
Version 2.0

Description

The Set function sets a value to a specified property of the object, for instance, the object's name.

Arguments

  • Handle:
    The function takes a handle of the type "light_userdata" as an argument.
    It can be omitted when using the colon notation on an object.

    The Colon Notation is a way to omit the handle as the first argument when using the Object functions.

    This is the general syntax with the colon notation: object:function()

    This is the general syntax with standard handle notation: object.function(object)

    Learn more in the Lua Functions - Object API topic.

  • String:
    The string must be the name of a valid property for the object.
  • String:
    This string must be the desired value for the property.
  • Integer  (optional):
    ?

Return

This function does not return anything. 

Examples

This example changes the "Tracking" property of the selected sequence to "No".

Lua
return function()
    -- SelectedSequence() creates a handle to the selected sequence.
    local selectedSequence = SelectedSequence()
    -- Set a variable with the property name.
    local propertyName = "Tracking"
    -- Set the property.
    selectedSequence:Set(propertyName, "No")
end