get_effective_output_bus
Resolves the inherited output bus for an Actor-Mixer object by tracing ancestor overrides, returning the effective bus path and HDR window status.
Instructions
Resolve the effective (inherited) output bus for an Actor-Mixer hierarchy object.
WAAPI's @OutputBus returns the LOCAL value, which defaults to "Master Audio Bus" when an object has not set Override Output. This tool walks the ancestor chain to find the first non-default @OutputBus assignment and returns its full bus path.
Args: object_path: Project path. e.g. "\Actor-Mixer Hierarchy\Default Work Unit\SFX\Barrage" object_guid: GUID. e.g. "{aabbcc00-1122-3344-5566-77889900aabb}" object_name_with_type: type:name. e.g. "Sound:Barrage"
Provide exactly one of object_path, object_guid, or object_name_with_type.
Returns: object: {name, path, type} of the queried object effective_bus: {id, name} of the resolved output bus bus_path: full project path of the bus (e.g. "\Master-Mixer Hierarchy\Default Work Unit\Master Audio Bus\SFX") is_hdr: whether the object is inside an HDR window (true if the resolved bus or any of its bus ancestors has HdrEnable=true) hdr_bus: {id, name, path} of the bus that establishes the HDR window, or null if not in one set_by: "self", the ancestor path that sets the override, or "default (no ancestor overrides)"
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| object_path | No | ||
| object_guid | No | ||
| object_name_with_type | No |