ジャンプ先: 概要. 戻り値. キーワード. フラグ. Python 例.

概要

filterCurve([cutoffFrequency=float], [endTime=time], [filter=string], [keepKeysOnFrame=boolean], [kernel=string], [keySync=boolean], [maxTimeStep=float], [minTimeStep=float], [period=float], [precision=float], [precisionMode=int], [preserveKeyTangent=string], [sampleCount=int], [samplingRate=float], [selectedKeys=boolean], [startTime=time], [timeTolerance=float], [tolerance=float], [useQuaternion=boolean], [width=time])

注: オブジェクトの名前と引数を表す文字列は、カンマで区切る必要があります。これはシノプシスに示されていません。

filterCurve は、取り消し可能、照会不可能、および編集不可能です。

filterCurve コマンドはアニム カーブのリストを取得し、指定したフィルタを使用してこれらをフィルタします。次のフィルタがサポートされています。 butterworth euler gaussian keyReducer peakRemover keySync resample simplify

戻り値

intフィルタされたカーブの数

キーワード

filter

フラグ

cutoffFrequency, endTime, filter, keepKeysOnFrame, kernel, keySync, maxTimeStep, minTimeStep, period, precision, precisionMode, preserveKeyTangent, sampleCount, samplingRate, selectedKeys, startTime, timeTolerance, tolerance, useQuaternion, width
ロング ネーム(ショート ネーム) 引数タイプ プロパティ
cutoffFrequency(cof) float create
Butterworth フィルタのカットオフ周波数(Hz)を定義します。
endTime(e) time create
フィルタリングするセクションの終了時間を指定します。指定していない場合、アニメーション カーブの最後のキーを使用して終了時間を定義します。
filter(f) string create
使用するフィルタ タイプを指定します。使用可能なフィルタは butterworth、euler (既定)、gaussian、keyReducer 、peakRemover、keySync、resample、simplify です。
keepKeysOnFrame(kof) boolean create
指定した場合、フレーム全体にキーを配置するためのセカンダリ フィルタ パスが適用されます。このフラグがサポートされるのは、Butterworth フィルタのみです。
kernel(ker) string create
リサンプル カーネルは高密度データをリサンプリングする、デシメーション フィルタです。キーフレームに動作し、まばらなデータで使用すると、期待するような結果が出ない場合があります。

リサンプル フィルタは、均一性を問わず、時間ステップ入力データ サンプルを指定した均一 timeStep へと変換します。さまざまな時間領域フィルタが使用可能で、アニメーション カーブのキーフレームに適用されるリサンプリング カーネルを選択するカーネル フラグで指定できます。

カーネル値
closest 出力タイムスタンプに最も近いサンプル
lirp 最も近いサンプル間のリニア補間
box ボックス フィルタ:移動平均
triangle 三角フィルタ: (1 - |x|)ウェイト付けされた移動平均
gaussian2 Gaussian2 フィルタ: (2^(-2x*x)) ウェイト付けされた移動平均
gaussian4 Gaussian4 フィルタ: (2^(-4x*x)) ウェイト付けされた移動平均

このフィルタはデシメーションのリサンプリング のみ が対象で、補間のリサンプリングは基本的にサポートしていません。出力フレーム レートが入力フレーム レートよりも高い場合は(入力時間ステップは規則的と仮定されないので概算)通常、lirp と三角は補間され、残りは入力のフェーズと頻度によって平均化、または最も近いサンプルを使用します。ただし、この操作モードでは期待する結果が得られない場合があります。

keySync(ks) boolean create
指定した場合、セカンダリ フィルタ パスが適用され、検出されたキーごとに、兄弟カーブ(X,Y,Z)にキーが追加されます。このフラグがサポートされるのは、Key Reducer フィルタのみです。
maxTimeStep(mxs) float create
簡略化(Simplify)フィルタ。
minTimeStep(mns) float create
簡略化(Simplify)フィルタ。
period(per) float create
リサンプル(Resample)フィルタ。
precision(pre) float create
精度パラメータを定義します。Key Reducer フィルタの場合、このパラメータはソース カーブと出力カーブの間のエラー制限を指定します。この値を大きくすると、精度は低下します。この値を低くすると、精度は向上します。
precisionMode(pm) int create
精度値の処理方法を定義します(0: 絶対値。1: パーセンテージ)。
preserveKeyTangent(pkt) string createmultiuse
指定した場合、イン接線タイプまたはアウト接線タイプが指定したタイプと一致するキーが保持されます。サポート対象の接線タイプは、fixed、linear、flat、smooth、step、clamped、plateau、stepnext、auto です。このフラグがサポートされるのは、Key Reducer フィルタのみです。
sampleCount(sc) int create
ガウス フィルタ カーネルの寸法を定義します。
samplingRate(sr) float create
キーが Butterworth フィルタに追加されるレートをフレーム/秒(FPS)で定義します。
selectedKeys(sk) boolean create
指定した場合、フィルタは選択したキーにのみ適用されます。このフラグは、startTime/endTime の指定よりも優先します。
startTime(s) time create
フィルタリングの開始時間を指定します。指定していない場合、アニメーション カーブの最初のキーを使用して開始時間を取得します。
timeTolerance(tto) float create
簡略化(Simplify)フィルタ。
tolerance(tol) float create
簡略化(Simplify)フィルタ。
useQuaternion(uq) boolean create
オイラーでなく、クォータニオンを使用する場合に有効にします。
width(w) time create
ガウス フィルタの幅を定義します。
フラグはコマンドの作成モードで表示できます フラグはコマンドの編集モードで表示できます
フラグはコマンドの照会モードで表示できます フラグに複数の引数を指定し、タプルまたはリストとして渡すことができます。

Python 例

import maya.cmds as cmds


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