pymel.core.animation.timeEditor¶
- timeEditor(*args, **kwargs)¶
General Time Editor commands
Flags:
Long Name / Short Name Argument Types Properties allClips / alc unicode Return an exhaustive (recursive) list of all clip IDs from the active composition. Arguments may be used to filter the returning result. An empty string will return clip IDs for all clip types: roster container group clipId / id int ID of the clip to be edited. commonParentTrack / cpt bool Locate the common parent track node and track index of the given clip IDs. Requires a list of clip IDs to be specified using the clipId flag. The format of the returned string is track_node:track_index. If the clips specified are on the same track node but in different track indexes, only the track node will be returned. composition / cp unicode A flag to use in conjunction with -dca/drivingClipsForObjto indicate the name of composition to use. By default if this flag is not provided, current active composition will be used. drivingClipsForAttr / dca unicode Return a list of clips driving the specified attribute(s). If the composition is not specified, current active composition will be used. drivingClipsForObj / dco unicode, int Return a list of clips driving the specified object(s) with an integer value indicating the matching mode. If no object is specified explicitly, the selected object(s) will be used. Objects that cannot be driven by clips are ignored. If the composition is not specified, current active composition will be used. Default match mode is 0. 0: Include only the clip that has an exact match1: Include any clip that contains all of the specified objects2: Include any clip that contains any of the specified objects3: Include all clips that do not include any of the specified objects includeParent / ip bool A toggle flag to use in conjunction with -dca/drivingClipsForObj. When toggled, parent clip is included in selection (the entire hierarchy will be selected). mute / m bool Mute/unmute Time Editor. selectedClips / sc unicode Return a list of clip IDs of currently selected Time Editor clips. Arguments may be used to filter the returning result. An empty string will return clip IDs for all clip types: roster container group topLevelClips / tlc unicode Return a list of all top-level clip IDs from the active composition. Arguments may be used to filter the returning result. An empty string will return clip IDs for all clip types: roster container group Flag can have multiple arguments, passed either as a tuple or a list. Derived from mel command maya.cmds.timeEditor
Example:
- ::
import pymel.core as pm
pm.timeEditor(mute=True)
# Get clip IDs of current selected group clips pm.timeEditor(selectedClips=’group’)
# Get clip IDs of all selected clips pm.timeEditor(selectedClips=’‘)
# Get all top-level group clip IDs in the active composition pm.timeEditor(topLevelClips=’group’)
# Recursively get all container clip IDs in the active composition pm.timeEditor(allClips=’container’)
# Recursively get all clip IDs under the specified group clip (id=2) pm.timeEditor(allClips=’‘, clipId=2)
# Get all group clips directly under the specified group clip (id=21) pm.timeEditor(topLevelClips=’group’, clipId=21)
# Find the common parent track of the given clip IDs pm.timeEditor(commonParentTrack=True, clipId=[1,2,3])