glmChannelTool
As of August 5th, 2025, Golaem will no longer provide direct support.
All support for Autodesk Golaem will now be handled exclusively through Autodesk support channels and this website will be deactivated.
Please bookmark the Autodesk Golaem Support section for any future support needs related to Autodesk Golaem packages.
The glmChannelTool command returns the value of a Channel for a specific Entity when a simulation is running:
bool glmChannelTool [-isFloat] [-entityIds int] [-behaviorName string] [-channelName string] [-componentName string]
float glmChannelTool [-entityIds int] [-behaviorName string] [-channelName string] [-componentName string]
float[3] glmGetChannelValue [-entityIds int] [-behaviorName string] [-channelName string] [-componentName string]
Flags
Long name (short name) | Argument types | Properties | Description |
-entityId (-eid) | int | ID of the queried Entity (can be found in the Crowd Visual Feedback). Only required if getAttr is "channelValue" | |
-behaviorName (-bn) | string | Name of the behavior relative to the queried Channel (only if the queried Channel is a Behavior Channel) | |
-channelName (-cn) | string | Name of the queried Channel. Only required if getAttr is different from "channelInfo" | |
-componentName (-con) | string | Name of the component of the Channel to query (only if the queried Channel requires a Component) | |
-getAttr (-gat) | string | mandatory | Attribute to get. Available attributes are: channelInfo, channelValue, isChannelFloat. |
Return Value
This command returns either:
- a boolean if the flag -getAttr is set to isChannelFloat
- a float value if the flag -getAttr is set to channelValue and if the return type of the queried Channel is a float (can be checked with the -getAttr flag)
- a float[3] value if the flag -getAttr is set to channelValue and if the return type of the queried Channel is a vector3 (can be checked with the -isFloat flag)
- a string array if the flag -getAttr -getAttr is set to channelInfo is set to. Each string array item will have the following pattern [behaviorType];[channelName];[componentType] (thus none;entityId;none; means that the Channel entityId does not require any behavior name or component name to be fetched and none;bonePosition;boneName; means that the Channel bonePosition requires a bone name as component)
MEL Examples
glmChannelTool -getAttr "channelInfo";
// Result: none;entityId;none; none;particleId;none; none;entityTypeId;none;... //
glmChannelTool -getAttr "isChannelFloat" -channelName "entityId";
// Result: 1 //
glmChannelTool -getAttr "channelValue" -entityId 1001 -channelName "entityId";
// Result: 1001 //
glmChannelTool -getAttr "channelValue" -entityId 1001 -channelName "bonePosition" -con "LeftArm";
// Result: 1.57347 1.256903 -1.553255 //
glmChannelTool -getAttr "channelValue" -entityId 1001 -behaviorName "beMotionShape1" -channelName "motionId";
// Result: 3 //
Python Examples
import maya.cmds as cmds
cmds.glmChannelTool(getAttr="channelInfo")
// Result: [u'none;currentFrame;none;', u'none;currentTime;none;',... //
cmds.glmChannelTool(getAttr="isChannelFloat", channelName="entityId")
// Result: True //
cmds.glmChannelTool(getAttr="channelValue", entityId=1001, channelName="entityId")
// Result: 1001 //