simplify command

概要

simplify( animatedObject , [animation=string], [attribute=string], [controlPoints=boolean], [float=floatrange], [floatTolerance=float], [hierarchy=string], [includeUpperBound=boolean], [index=uint], [shape=boolean], [time=timerange], [timeTolerance=time], [valueTolerance=float])

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

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

このコマンドは、キーセット上に作用します。キーセットは、1 つまたは複数のアニメーションカーブ上の指定したタイムレンジ内のキーグループとして定義されます。

キーセットを構成するアニメーションカーブは、「-animation」フラグの値に依存します。

keysOrObjects:
1. コマンドラインにターゲットオブジェクトまたは -attribute フラグが表示されていない場合は任意のアクティブキー
2. アクティブキーが存在しない場合は、コマンドラインの targetList として指定されているオブジェクトのキーフレーム可能なすべてのアトリビュートに接続されたすべてのアニメーションカーブ

keys: アクティブなキーまたは接線のみに作用します。アクティブなキーまたは接線がない場合は、何も行いません。

objects: 指定したオブジェクトのみに作用します。オブジェクトが指定されていない場合は、何も行いません。

-animation フラグを使用して、「translateX」など attributeName という形式の引数を取る、多目的な -attribute フラグによって固有に識別されるカーブをオーバーライドすることができます。

アニメーションカーブ上の各キーは、カーブの時間値またはインデックスによって識別されます。時間とインデックスは、単独にあるいはリストの一部または範囲として指定することができます。

-time 10pal は、フレーム 10 のキーを意味します(PAL 形式)。
-time 1.0sec -time 15ntsc -time 20 は、時間 1.0 秒、フレーム 15 (NTSC 形式)、時間 20 (現在定義されているグローバル時間単位)のキーを意味します。
-time "10:20" は、10～20 の範囲(現在の時間単位、両方の値を含む)のすべてのキーを意味します。

範囲の一方の値を省略した場合は、次の例のように、範囲が「無限であること」を意味します。

-time "10:" は、時間 10 (現在の時間単位)より後にあるすべてのキーを意味します。
-time ":10" は、時間 10 (現在の時間単位)以前のすべてのキーを意味します。
-time ":" は、すべてのキーを指定するための短い形式です。

-index 0 は、各アニメーションカーブの最初のキーを意味します(インデックスは 0 ベースです)。
-index 2 -index 5 -index 7 は、3 番目、6 番目、8 番目のキーを意味します。
-index "1:5" は、各アニメーションカーブの 2 番目、3 番目、4 番目、5 番目、6 番目のキーを意味します。

このコマンドは、アニメーションカーブを簡略化(キーフレーム数を削減)します。

戻り値

int

簡略化されたアニメーションカーブの数

フラグ

animation, attribute, controlPoints, float, floatTolerance, hierarchy, includeUpperBound, index, shape, time, timeTolerance, valueTolerance

ロングネーム(ショートネーム) 引数タイプ プロパティ

attribute(at) string

選択するアトリビュートのリストです。

照会モードでは、このフラグに値が必要になります。

hierarchy(hi) string

階層展開オプションです。有効な値は、「above」、「below」、「both」、「none」です。(「pasteKey」コマンドでは無効)。

照会モードでは、このフラグに値が必要になります。

shape(s) boolean

トランスフォームの下にあるシェイプのアトリビュート(「controlPoints」以外)も考慮します。既定: true(「pasteKey」コマンドでは無効)。

照会モードでは、このフラグに値が必要になります。

controlPoints(cp) boolean

このフラグは、アトリビュートのリストにシェイプのコントロールポイントを含めるかどうかを明示的に指定します(「-s」フラグを参照)。既定: false(「pasteKey」コマンドでは無効)。

照会モードでは、このフラグに値が必要になります。

index(index) uint

アニメーションカーブ上のキーのインデックス

照会モードでは、このフラグに値が必要になります。

time(t) timerange

時間ベースのアニメーションカーブ上のキー(またはキーレンジ)を固有に表す時間です。有効な timeRange は、単一の値(-t 10)、または上下限をコロンで区切った文字列(-t "10:20")です。

照会モードでは、このフラグに値が必要になります。

float(f) floatrange

時間ベースの animCurve上の時間ベースでないキー(またはキーレンジ)を固有に表す値です。有効な floatRange は、単一の値(-f 10)、または上下限をコロンで区切った文字列(-f "10:20")です。

照会モードでは、このフラグに値が必要になります。

includeUpperBound(iub) boolean

-t/time または -f/float フラグがキーの範囲を表す場合に、範囲の上限のキーをキーセットに含めるかどうかを定義します。既定値: true。このフラグは、-t/time フラグの引数が上下限が指定したタイムレンジである場合に限り有効です（「pasteKey」コマンドでこのフラグを使用するときに「replace」、「fitReplace」、「scaleReplace」などのオプションを指定すると、このフラグは、置き換えられるターゲットカーブの時間範囲のみを参照します。このフラグは、クリップボードからペーストされたカーブには影響しません）。

animation(an) string

このコマンドが、自身が影響を与えるアニメーションを取得する場所です。有効な値は「objects」、「keys」、「keysOrObjects」で、既定は「keysOrObjects」です (詳細については、説明を参照してください)。

timeTolerance(tt) time

時間で入力する animCurve の X 軸の許容値(既定は 0.05 秒)を指定します。float でドライブされる animCurve では、このフラグは無視されます。時間の許容値を大きくするとキーがまばらになり、最初のカーブを表現する精度が低くなります。

floatTolerance(ft) float

ドリブンキーフレームの設定(Set Driven Keyframe)で作成するような、float で入力する animCurve の X 軸の許容値(既定は 0.05 秒)を指定します。時間でドライブされる animCurve では、このフラグは無視されます。floatTolerance の値を大きくするとキーがまばらになり、最初のカーブを表現する精度が低くなります。

valueTolerance(vt) float

値の許容値(既定は 0.01)を指定します。

フラグはコマンドの作成モードで表示できます	フラグはコマンドの編集モードで表示できます
フラグはコマンドの照会モードで表示できます	フラグに複数の引数を指定し、タプルまたはリストとして渡すことができます。

Python 例

import maya.cmds as cmds

cmds.polySphere()
cmds.setKeyframe( '.tx' )
cmds.simplify( time=(1,10) )

コマンド (Python)	MEL バージョン
simplify	カテゴリ内: アニメーション