pymel.core.animation.filterCurve

filterCurve(*args, **kwargs)

The filterCurve command takes a list of anim curve and filters them. Currently only a Euler filter is supported. The Euler filter demangles discontinous rotation anim curves into smooth curves.

Flags:
Long name (short name) Argument Types Properties
endTime (e) time ../../../_images/create.gif
 

Specify the end time of the section to filter. If not specified, the last key of the animation curve is used to define the end time.Flag can appear in Create mode of commandFlag can have multiple arguments, passed either as a tuple or a list.

filter (f) unicode ../../../_images/create.gif
 
Specifies the filter type to use. The avalible filters are euler, simplify, and resample. By default euler is used.
kernel (ker) unicode ../../../_images/create.gif
 

The resample kernel is a decimation resampling filter used to resample dense data. It works on the keyframes and may not produce the desired results when used with sparse data. The resample filter converts from either uniform or non-uniform timestep input data samples to the specified uniform timeStep. Various time domain filters are available and are specified with the kernel flag which selects the resampling kernel applied to the keyframes on the animation curves. Kernel ValuesclosestClosest sample to output timestamplirpLinear interpolation between closest samplesboxBox filter: moving averagetriangleTriangle filter: (1 - |x|) weighted moving averagegaussian2Gaussian2 Filter: (2^(-2x*x)) weighted moving averagegaussian4Gaussian4 Filter: (2^(-4x*x)) weighted moving averageThis filter is onlytargeted at decimation resampling – interpolation resampling is basically unsupported. If your output framerate is much higher than your input frame rate (approximate, as the input timestep is not assumed to be regular) the lirp and triangle will interpolate (usually) and the rest will either average, or use the closest sample (depending on the phase and frequency of the input). However this mode of operation may not give the expected result.

maxTimeStep (mxs) float ../../../_images/create.gif
 
Simplify filter.
minTimeStep (mns) float ../../../_images/create.gif
 
Simplify filter.
period (per) float ../../../_images/create.gif
 
Resample filter
startTime (s) time ../../../_images/create.gif
 
Specify the start time to filter. If not specified, then the first key in the animation curve is used to get the start time.
timeTolerance (tto) float ../../../_images/create.gif
 
Simplify filter.
tolerance (tol) float ../../../_images/create.gif
 
Simplify filter.

Derived from mel command maya.cmds.filterCurve

Example:

import pymel.core as pm

import maya.cmds as cmds

pm.filterCurve( 'nurbsCone1_rotateX', 'nurbsCone1_rotateY', 'nurbsCone1_rotateZ' )

Previous topic

pymel.core.animation.enableDevice

Next topic

pymel.core.animation.findKeyframe

Core

Core Modules

Other Modules

This Page