## Animation Editor Attributes

### Introduced

v5.0

View attributes for the Animation Editor (see View.GetAttributeValue and View.SetAttributeValue). Not all attributes support both setting and getting. Check the third column in the table.

Note | See ViewAttributes for a complete list of types of attributes that you can use when customizing your Relational Views.

Attribute Name | Description | Supports
--- | --- | ---
targetcontent | The name of the object for which to display the animated parameters. If the view is driven by a relationship, this content can be replaced dynamically. You can also control this attribute programmatically even if the view is not driven.
Possible Values: | Description:
<any eligible scene object> | The SIObject.Name of an object with animated parameters.
| View.GetAttributeValue and View.SetAttributeValue.
viewer | The viewer to display in the animation editor when it is opened. When you open the Animation Editor the list of parameters is scanned and the "default" editor for those parameters is opened. So if you have a single parameter with an expression then the Expression Editor is opened. However, if there is a mix of expressions and fcurves then the FCurve Editor is opened.
Possible Values: | Description:
FCurve Editor | Load the FCurve Editor in the editor.
DopeSheet | Load the DopeSheet in the editor.
Expression Editor | Load the Expression Editor in the editor.
Scripted Operator Editor | Load the Scripted Operator Editor in the editor.
| View.GetAttributeValue and View.SetAttributeValue.
drivingaction | Determines or not whether the animation editor will display only the parameters that are driven by an action clip at the current frame.
Possible Values: | Description:
'false' | (Default) Display parameters whether driven or not. Note: Use the string "false", not the boolean false.
'true' | Display only driven parameters. Note: Use the string "true", not the boolean true.
| View.GetAttributeValue and View.SetAttributeValue.
animatedparamsonly | Determines whether or not the animation editor will display only the element's animated parameters and their associated fcurves in the graph.
Possible Values: | Description:
'false' | No restrictions on displaying animated parameter. Note: Use the string "false", not the boolean false.
'true' | (Default) Display only the element's animated parameters and fcurves. Note: Use the string "true", not the boolean true.
| View.GetAttributeValue and View.SetAttributeValue.
keyableparamsonly | Determines whether or not the animation editor will display only the element's keyable parameters as defined in the keyable parameters editor.
Possible Values: | Description:
'false' | (Default) No restrictions on displaying keyable parameters. Note: Use the string "false", not the boolean false.
'true' | Display only the element's keyable parameters. Note: Use the string "true", not the boolean true.
| View.GetAttributeValue and View.SetAttributeValue.
filterpreset | Determines what kind of parameters will be displayed. See the siATFilterPreset enum for the list of valid values. | View.GetAttributeValue and View.SetAttributeValue.
taggedparameters | Determines which tagged parameters for the elements and their associated fcurves will be displayed. This is the scripting equivalent of changing the selection in the Explorer->Parameter Filters->Tagged Parameters menu. This is a kind of a string mask, so to set the value, you can pass a pipe-delimited ('|') list of options or specify a single value from the siATFilterTaggedParameters enum. For example:
    // Show only tagged 1 parameters
    myView.SetAttributeValue("TaggedParameters", siATFilterTagged1);

    // Show tagged 3, 4 and 5 parameters
    myView.SetAttributeValue("TaggedParameters", "Tag3|Tag4|Tag5");
If the siATFilterTaggedAll value is passed to the View.SetAttributeValue method, any other values will be ignored. | View.GetAttributeValue and View.SetAttributeValue.
activationparamsonly | Determines whether or not the animation editor will display only the element's active or mute parameters.
Possible Values: | Description:
'false' | (Default) No restrictions on displaying Active or Mute parameters. Note: Use the string "false", not the boolean false.
'true' | Display only the element's Active or Mute parameters. Note: Use the string "true", not the boolean true.
| View.GetAttributeValue and View.SetAttributeValue.
markedparamsonly | Determines whether or not the animation editor will display only the marked parameters for the elements and their associated function curves.
Possible Values: | Description:
'false' | (Default) No restrictions on displaying marked parameters. Note: Use the string "false", not the boolean false.
'true' | Display only the marked parameters. Note: Use the string "true", not the boolean true.
| View.GetAttributeValue and View.SetAttributeValue.
trackselection | Determines whether or not the animation explorer will automatically scroll to ensure that the node of the first selected elements is always visible.
Possible Values: | Description:
'false' | (Default) Disable automatic scrolling. Note: Use the string "false", not the boolean false.
'true' | Enable automatic scrolling. Note: Use the string "true", not the boolean true.
| View.GetAttributeValue and View.SetAttributeValue.
decomposebranchsel | Determines whether the animation explorer will display the children, grandchildren, and other descendents of a branch-selected object as top-level nodes or as a nested hierarchy.
Possible Values: | Description:
'false' | (Default) Display as nested hierarchy. Note: Use the string "false", not the boolean false.
'true' | Display hierarchy as top-level nodes. Note: Use the string "true", not the boolean true.
| View.GetAttributeValue and View.SetAttributeValue.
localpropsonly | Determines whether the animation explorer will display only the properties that have been applied directly to an object or all properties, no matter how they are propagated.
Possible Values: | Description:
'false' | (Default) Display all properties. Note: Use the string "false", not the boolean false.
'true' | Display the properties that have been applied directly to an object. Note: Use the string "true", not the boolean true.
| View.GetAttributeValue and View.SetAttributeValue.
lockedparams | Determines whether or not the animation explorer will display the locked parameters.
Possible Values: | Description:
'false' | Locked parameters will not be visible. Note: Use the string "false", not the boolean false.
'true' | (Default) Display the locked parameters. Note: Use the string "true", not the boolean true.
| View.GetAttributeValue and View.SetAttributeValue.
flattenstate | Controls how the hierarchy appears when the animation editor opens.
Possible Values: | Description:
'None' | Displays the entire hierarchy.
'Parameters' | Appears without intermediate nodes and with renamed nodes at the ends of branches. For example, Global Transform > Pos > X node appears as Global Transform > Pos.X.
'All' | (Default) Displays parameters in a flat list, hiding intermediate nodes (properties, primitives, materials, etc.). For example, Global Transform > Pos > X node is shortened to Global Transform.Pos.X.
| View.GetAttributeValue and View.SetAttributeValue.
colorcoding | Determines whether or not the animation explorer will display different types of nodes in different colors.
Possible Values: | Description:
'false' | No color coding for type. Note: Use the string "false", not the boolean false.
'true' | (Default) Indicates node type by color. Note: Use the string "true", not the boolean true.
| View.GetAttributeValue and View.SetAttributeValue.
scriptnames | Determines whether the animation explorer will use the script name instead of regular name for node labels. See the View.BeginEdit method for an example using this attribute.
Possible Values: | Description:
'false' | Use the regular name. Note: Use the string "false", not the boolean false.
'true' | (Default) Use the script name. Note: Use the string "true", not the boolean true.
| View.GetAttributeValue and View.SetAttributeValue.
parametervalues | Determines whether or not the animation explorer will display the values of any and all selected parameters.
Possible Values: | Description:
'false' | (Default) Do not display values. Note: Use the string "false", not the boolean false.
'true' | Parameter values will appear next to the parameter name. Note: Use the string "true", not the boolean true.
| View.GetAttributeValue and View.SetAttributeValue.
parametersort | Sorts parameters according to the specified criteria.
Possible Values: | Description:
'None' | Uses the order based on when an element was created or parented.
'Alphabetical' | (Default) Sorts the parameters alphabetically. Any numeric suffix is sorted in correct numerical order, so Param2 comes before Param10.
'Layout' | Uses the order in which the parameters appear in their property editor. If a parameter does not appear in the corresponding property editor, it is not listed.
| View.GetAttributeValue and View.SetAttributeValue.
lock | Controls the lock state of the animation explorer.
Possible Values: | Description:
'true' | Lock the animation explorer. Note: Use the string "true", not the boolean true.
'false' | Unlock the animation explorer. Note: Use the string "false", not the boolean false.
| View.GetAttributeValue and View.SetAttributeValue.
ripple | Determines whether or not existing keys are pushed ahead on the timeline when you parse keys on an fcurve or when you scale a region of keys. Note: This attribute is only effective if the view area (right panel) is the fcurve graph.
Possible Values: | Description:
false | (Default) Turns off ripple mode. Note: Use the boolean false.
true | Turns on ripple mode. Note: Use the boolean true.
| View.GetAttributeValue and View.SetAttributeValue.
snaptogrid | Determines whether or not the animation editor will use the snap-to-grid feature. Note: This attribute is only effective if the view area (right panel) is the fcurve graph.
Possible Values: | Description:
'false' | (Default) Do not use snap-to-grid feature. Note: Use the string "false", not the boolean false.
'true' | Use the snap-to-grid feature. Note: Use the string "true", not the boolean true.
| View.GetAttributeValue and View.SetAttributeValue.
snaptoframe | Determines whether or not the animation editor will use the snap-to-frame feature. Note: This attribute is only effective if the view area (right panel) is the fcurve graph.
Possible Values: | Description:
'false' | (Default) Do not use snap-to-frame feature. Note: Use the string "false", not the boolean false.
'true' | Use the snap-to-frame feature. Note: Use the string "true", not the boolean true.
| View.GetAttributeValue and View.SetAttributeValue.
snapslopes | Determines whether or not the slope handles on key points will snap when manipulated. Note: This attribute is only effective if the view area (right panel) is the fcurve graph.
Possible Values: | Description:
'false' | (Default) No snapping on slope handles. Note: Use the string "false", not the boolean false.
'true' | The slope handles on key points will snap when manipulated. Note: Use the string "true", not the boolean true.
| View.GetAttributeValue and View.SetAttributeValue.
selectedcurves | Returns or sets the selected FCurve objects as a comma-delimited string containing the full name of the FCurve's parent. If nothing is selected, it returns an empty string. Note: This attribute is only effective if the view area (right panel) is the fcurve graph.
Possible Values: | Description:
<string> | The parent(s) SIObject.FullName of FCurve Object(s).
| View.GetAttributeValue and View.SetAttributeValue.
frameall | Frames all displayed fcurves. Note: This attribute is only effective if the view area (right panel) is the fcurve graph.
Possible Values: | Description:
<any value> | This value is ignored.
| View.SetAttributeValue only.
frameselection | Frames selection. Note: This attribute is only effective if the view area (right panel) is the fcurve graph.
Possible Values: | Description:
<any value> | This value is ignored.
| View.SetAttributeValue only.
frameplaybackrange | Frames all the fcurves within the time span specified by the timeline. Note: This attribute is only effective if the view area (right panel) is the fcurve graph.
Possible Values: | Description:
<any value> | This value is ignored.
| View.SetAttributeValue only.
frameselectedkeys | Frames selected keys. Note: This attribute is only effective if the view area (right panel) is the fcurve graph.
Possible Values: | Description:
<any value> | This value is ignored.
| View.SetAttributeValue only.
frameselectedcurves | Frames selected fcurves. Note: This attribute is only effective if the view area (right panel) is the fcurve graph.
Possible Values: | Description:
<any value> | This value is ignored.
| View.SetAttributeValue only.
frameregion | Frames a region. Note: This attribute is only effective if the view area (right panel) is the fcurve graph.
Possible Values: | Description:
<any value> | This value is ignored.
| View.SetAttributeValue only.
centercurrenttime | Centers the fcurve graph around the timeline cursor's position, when the timeline cursor is visible. Note: This attribute is only effective if the view area (right panel) is the fcurve graph.
Possible Values: | Description:
<any value> | This value is ignored.
| View.SetAttributeValue only.
autoframe | Determines whether or not animation editor will frame all fcurves automatically. Note: This attribute is only effective if the view area (right panel) is the fcurve graph.
Possible Values: | Description:
false | (Default) Disables the automatic framing. Note: Use the boolean false.
true | Enables the automatic framing. Note: Use the boolean true.
| View.GetAttributeValue and View.SetAttributeValue.
interactiveupdate | Determines whether or not to see the effect of the changes in viewports as you edit the fcurves. Note: This attribute is only effective if the view area (right panel) is the fcurve graph.
Possible Values: | Description:
false | (Default) "Interactive update" option is off. Note: Use the boolean false.
true | "Interactive update" option is on. Note: Use the boolean true.
| View.GetAttributeValue and View.SetAttributeValue.
showbuffercurves | Determines whether or not to display a temporary copy of the original function curve that has been saved into a buffer. Note: This attribute is only effective if the view area (right panel) is the fcurve graph.
Possible Values: | Description:
false | (Default) Don't show the buffer curves. Note: Use the boolean false.
true | Shows the buffer curves. Note: Use the boolean true.
| View.GetAttributeValue and View.SetAttributeValue.
displaynormalized | Determines whether or not to display the normalized fcurves. Note: This attribute is only effective if the view area (right panel) is the fcurve graph.
Possible Values: | Description:
false | (Default) Displays non-normalized fcurves. Note: Use the boolean false.
true | Displays normalized fcurves. Note: Use the boolean true.
| View.GetAttributeValue and View.SetAttributeValue.
classicmode | Switches between Suite and Classic Mode. Note: This attribute is only effective if the view area (right panel) is the fcurve graph.
Possible Values: | Description:
false | Suite Mode is active which is designed to be used if you're running the Suite version of Softimage. Note: Use the boolean false.
true | (Default) Classic Mode is on to provide all tools that you are used to as a seasoned Softimage user. Note: Use the boolean true.
| View.GetAttributeValue and View.SetAttributeValue.
hle | Determines whether or not to enable the high-level editing (HLE) tool. Note: This attribute is only effective if the view area (right panel) is the fcurve graph.
Possible Values: | Description:
false | (Default) Disables the high-level editing (HLE) tool. Note: Use the binary false.
true | Enables the high-level editing (HLE) tool. Note: Use the binary true.
| View.GetAttributeValue and View.SetAttributeValue.
hlecompensation | Determines whether or not to enable the high-level editing (HLE) compensation mode, when the HLE tool is activated. Note: This attribute is only effective if the view area (right panel) is the fcurve graph.
Possible Values: | Description:
false | (Default) Disables the high-level editing (HLE) compensation mode. Note: Use the binary false.
true | Enables the high-level editing (HLE) compensation mode. Note: Use the binary true.
| View.GetAttributeValue and View.SetAttributeValue.
hleoperation | Determines which high-level editing (HLE) operation the HLE tool uses, when enabled. Note: This attribute is only effective if the view area (right panel) is the fcurve graph.
Possible Values: | Description:
siHLEOperationRelativeOffset | The HLE tool uses the Relative Offset operation.
siHLEOperationAbsoluteOffset | (Default) The HLE tool uses the Absolute Offset operation.
siHLEOperationAbsoluteScaling | The HLE tool uses the Absolute Scaling operation.
| View.GetAttributeValue and View.SetAttributeValue.
displayoptions | Determines which fcurves are displayed in the graph by default.
Possible Values: | Description:
siAllParam | Displays fcurves for all parameters of the selected object.
siMarkedParam | Displays fcurves only for the object's marked parameters.
siAnimatedParam | (Default) Displays fcurves only for the object's animated parameters.
siSelectedParam | Displays fcurves only for the object's selected parameters.
| View.GetAttributeValue and View.SetAttributeValue.
isolatecurve | Determines whether or not to isolate the selected fcurves so that only they appear in the graph. Note: This attribute is only effective if the view area (right panel) is the fcurve graph.
Possible Values: | Description:
false | (Default) Disables the isolating feature. Note: Use the boolean false.
true | Isolates the selected fcurves. Note: Use the boolean true.
| View.GetAttributeValue and View.SetAttributeValue.
clearallcurves | Hides all fcurves associated with the selected object without collapsing the animation explorer. Note: This attribute is only effective if the view area (right panel) is the fcurve graph.
Possible Values: | Description:
<any value> | This value is ignored.
| View.SetAttributeValue only.
hidecurve | Hides the selected fcurves. This also deselects the fcurves. Note: This attribute is only effective if the view area (right panel) is the fcurve graph.
Possible Values: | Description:
<any value> | This value is ignored.
| View.SetAttributeValue only.
unhideallcurves | Displays all hidden fcurves. Note: This attribute is only effective if the view area (right panel) is the fcurve graph.
Possible Values: | Description:
<any value> | This value is ignored.
| View.SetAttributeValue only.
keysonunselectedcurves | Determins whether or not to display keys on all unselected curves. Note: This attribute is only effective if the view area (right panel) is the fcurve graph.
Possible Values: | Description:
false | (Default) Hides keys on all unselected curves. Note: Use the boolean false.
true | Shows keys on all unselected curves. Note: Use the boolean true.
| View.GetAttributeValue and View.SetAttributeValue.
slopesonunselectedkeys | Determines whether or not to display the slope handles of all unselected keys on a selected curve. Note: This attribute is only effective if the view area (right panel) is the fcurve graph.
Possible Values: | Description:
false | (Default) Hides slope handles of all unselected keys. Note: Use the boolean false.
true | Shows slope handles of all unselected keys. Note: Use the boolean true.
| View.GetAttributeValue and View.SetAttributeValue.
showlabels | Determines whether or not to display labels on all selected curves. Note: This attribute is only effective if the view area (right panel) is the fcurve graph.
Possible Values: | Description:
false | (Default) Hides the curve and axis labels. Note: Use the boolean false.
true | Shows the curve and axis labels. Note: Use the boolean true.
| View.GetAttributeValue and View.SetAttributeValue.
keyscoordinates | Determines whether or not to display the X and Y coordinate values for each selected key. Note: This attribute is only effective if the view area (right panel) is the fcurve graph.
Possible Values: | Description:
false | Hides the coordinate values. Note: Use the boolean false.
true | (Default) Shows the coordinate values. Note: Use the boolean true.
| View.GetAttributeValue and View.SetAttributeValue.
grid | Determines whether or not to display the X and Y axis grid lines. Note: This attribute is only effective if the view area (right panel) is the fcurve graph.
Possible Values: | Description:
false | Hides the grid lines. Note: Use the boolean false.
true | (Default) Shows the grid lines. Note: Use the boolean true.
| View.GetAttributeValue and View.SetAttributeValue.
rulers | Determines whether or not to display the rulers on the horizontal X (time) and vertical Y (value) axes. Note: This attribute is only effective if the view area (right panel) is the fcurve graph.
Possible Values: | Description:
false | Hides both X and Y axes. Note: Use the boolean false.
true | (Default) Shows both X and Y axes. Note: Use the boolean true.
| View.GetAttributeValue and View.SetAttributeValue.
timecursorvisible | Determines whether or not to display the red playback cursor in the fcurve graph. Note: This attribute is only effective if the view area (right panel) is the fcurve graph.
Possible Values: | Description:
false | Hides the playback cursor. Note: Use the boolean false.
true | (Default) Shows the playback cursor. Note: Use the boolean true.
| View.GetAttributeValue and View.SetAttributeValue.
timecursorselectable | Determines whether or not the red playback cursor is selectable in the fcurve graph. Note: This attribute is only effective if the view area (right panel) is the fcurve graph.
Possible Values: | Description:
false | (Default) Only can drag the cursor in the timeline area. Note: Use the boolean false.
true | Makes the playback cursor available in the graph so that you can also select and drag it in graph area. Note: Use the boolean true.
| View.GetAttributeValue and View.SetAttributeValue.
metacurveregion | Determines whether or not to display a bar below the graph showing an overview representation of all the keys of the selected fcurves. Note: This attribute is only effective if the view area (right panel) is the fcurve graph.
Possible Values: | Description:
false | (Default) Hides the metacurve region. Note: Use the boolean false.
true | Shows the metacurve region. Note: Use the boolean true.
| View.GetAttributeValue and View.SetAttributeValue.
localtime | Determines whether or not to display the corresponding time of the animation between the action in the animation mixer and the fcurve editor. Note: This attribute is only effective if the view area (right panel) is the fcurve graph.
Possible Values: | Description:
false | (Default) Disables this feature. Note: Use the boolean false.
true | Shows the local time of where the original action source is being evaluated in fcurve editor, and shows whether this point is in relation to the global time of the scene in Mixer. Note: Use the boolean true.
| View.GetAttributeValue and View.SetAttributeValue.
framerange | Returns or sets the frame range in frame values. Note: This attribute is only effective if the view area (right panel) is the fcurve graph.
Possible Values: | Description:
<start>,<end> | Frame range, specified by a comma-delimited string containing the start and end frame values.
| View.GetAttributeValue and View.SetAttributeValue.
timerange | Returns or sets the frame range in time values. Note: This attribute is only effective if the view area (right panel) is the fcurve graph.
Possible Values: | Description:
<start>,<end> | Frame range, specified by a comma-delimited string containing the start and end time values.
| View.GetAttributeValue and View.SetAttributeValue.
valuerange | Returns or sets the minimum/maximum values (Y axis) range. Note: This attribute is only effective if the view area (right panel) is the fcurve graph.
Possible Values: | Description:
<minimum>,<maximum> | Value range, specified by a comma-delimited string containing the minimum and maximum values (Y axis).
| View.GetAttributeValue and View.SetAttributeValue.
displayedcurves | Returns or sets the displayed FCurve objects as a comma delimited string containing the full name of the FCurve's parent. If nothing is displayed, it returns an empty string. Note: This attribute is only effective if the view area (right panel) is the fcurve graph.
Possible Values: | Description:
<string> | The Parent's SIObject.FullName of FCurve Object(s).
| View.GetAttributeValue and View.SetAttributeValue.
selectedkeysatframes | Returns or sets the selected keys of FCurve objects as a string. The string format is the following: ",,;,,". Note: This attribute is only effective if the view area (right panel) is the fcurve graph. For example:
    // Selects keys at frame 1 and frame 25 of the local posx of the cone object and the frame 50 of the local sclx of the Model.sphere object.
    myView.SetAttributeValue( "selectedkeysatframes", "cone.kine.local.posx,1,25;Model.sphere.local.kine.sclx,50" );
Possible Values: | Description:
<string> | A string representing the selected keys in a context of frame values (X axis).
| View.GetAttributeValue and View.SetAttributeValue.
selectedkeysattimes | Returns or sets the selected keys of FCurve objects as a string. The string format is the following: ",,;,,". Note: This attribute is only effective if the view area (right panel) is the fcurve graph. For example:
    // Selects keys at time 0.5 and time 4 of the local posx of the cone object and the time 8 of the local sclx of the Model.sphere object.
    myView.SetAttributeValue( "selectedkeysattimes", "cone.kine.local.posx,0.5,4;Model.sphere.local.kine.sclx,8" );
Possible Values: | Description:
<string> | A string representing the selected keys in a context of time values (X axis).
| View.GetAttributeValue and View.SetAttributeValue.
savebuffer | Saves the buffer copy of the edited curve, when buffer curves option is active. Note: This attribute is only effective if the view area (right panel) is the fcurve graph.
Possible Values: | Description:
<any value> | This value is ignored.
| View.SetAttributeValue only.
swapbuffer | Swaps between the edited curve and its buffer copy, when buffer curves option is active. Note: This attribute is only effective if the view area (right panel) is the fcurve graph.
Possible Values: | Description:
<any value> | This value is ignored.
| View.SetAttributeValue only.
autosnaptoframes | Determines whether the keys will be kept on frames when scaling regions or not. Note: This attribute is only effective if the view area (right panel) is the fcurve graph or the dopesheet.
Possible Values: | Description:
'false' | (Default) Keys will not be snapped to frames. Note: Use the string "false", not the boolean false.
'true' | The keys will be kept on frames when scaling regions. Note: Use the string "true", not the boolean true.
| View.GetAttributeValue and View.SetAttributeValue.