Set Object Field (Flowgraph Node)

Overview

• Node Name: Set Object Field
• Category: repeat_instant
• File: extensions/flowgraph/nodes/scene/setObjectField.lua

Sets a field on any scene object by ID. Supports both static fields and dynamic data fields.

Pin Schema

Input Pins

Output Pins

Behavior

• work() - Each frame:
  1. Finds the object via scenetree.findObjectById(objectId).
  2. If the value is a table, joins it with spaces (e.g., {1, 0, 0} → "1 0 0").
  3. Checks if the field exists in obj:getFields() - if so, uses setField().
  4. Otherwise falls back to setDynDataFieldbyName() for dynamic fields.
  5. Calls updateInstanceRenderData() if available to refresh visuals.

How It Works

1. Looks up the target object in the scene tree.
2. Automatically handles type conversion for vectors, quaternions, and colors passed as tables.
3. Distinguishes between built-in fields and dynamic data fields to use the correct setter.
4. Triggers a render data update so visual changes (like instance colors) take effect immediately.

Example Usage

-- Change the instance color of a TSStatic:
-- objectId = <some_id>
-- fieldName = "instanceColor"
-- value = {1, 0, 0, 1}  -- red

Key Dependencies

• scenetree.findObjectById() - scene object lookup
• obj:setField() / obj:setDynDataFieldbyName() - field setters
• obj:updateInstanceRenderData() - visual refresh

See Also

• Collection Marker (Flowgraph Node) - Related reference
• Custom Lua Command (Flowgraph Node) - Related reference
• Get Object Field (Flowgraph Node) - Related reference
• FlowGraph Guide - Guide