移動先: 概要 戻り値 関連項目. フラグ. Python 例.

概要

applyTake([channel=string], [device=string], [filter=string], [preview=boolean], [recurseChannel=boolean], [reset=boolean], [specifyChannel=boolean], [startTime=time])

注意: オブジェクト名や引数を表す文字列はカンマで区切ります。これは概要には示されていません。

applyTake は 「元に戻す」が可能、「照会」が不可能「編集」が不可能 です。

このコマンドは、デバイスのデータ(テイクと呼ばれる)を取得し、これを再生してレビューできる形式に変換します。テイクは readTake アクションでインポートしたり、recordDevice アクションで記録したりすることができます。テイクはアニメーション カーブに変換されるか、または -preview フラグを使用した場合は blendDevice ノードに変換されます。

このコマンドは、デバイス アタッチメントのターゲット アトリビュートにアタッチされているアニメーション カーブを探します。アニメーション カーブが存在する場合、テイクは既存のカーブにペーストされます。カーブが存在しない場合は、新規のアニメーション カーブが作成されます。

デバイスが指定されない場合、テイク データのあるデバイスと applyTake 用に有効になっているすべてのデバイスにデータが適用されます。

関連項目: recordDevice、enableDevice、readTake、writeTake

戻り値

なし

関連項目

defineDataServer, defineVirtualDevice, enableDevice, filter, movIn, movOut, readTake, recordDevice, writeTake

フラグ

channel, device, filter, preview, recurseChannel, reset, specifyChannel, startTime
ロング ネーム(ショート ネーム) 引数型 プロパティ
device(d) string createmultiuse
どのデバイスにテイクを含めるかを指定します。
C: デフォルトは、applyTake が有効になっているすべてのデバイスです。
startTime(st) time create
テイク用のデフォルト開始時間は記録時に決定されます。 startTime オプションは、現在のアニメーション単位でテイクの開始時間を設定します。
C: デフォルトは、テイクの最初のタイム スタンプです。テイクのタイム スタンプが存在しない場合は、0 が使用されます。
channel(c) string createmultiuse
このフラグは、セット チャンネルの有効値をオーバーライドします。 チャンネルが指定されると、チャンネルは有効になります。
C: デフォルトは、デバイス用に applyTake が有効になっているチャンネルすべてです。
specifyChannel(sc) boolean create
このフラグは、-c/channel フラグと共に使用されます。使用される場合、applyTake は、-c/channel フラグでリストされるチャンネルでだけ動作します。
C: デフォルトは有効になったすべてのチャンネルです。
recurseChannel(rc) boolean create
このフラグを使用すると、-c/channel で指定されるチャンネルの子にも適用されます。 C: デフォルトは有効になったすべてのチャンネルです。
filter(f) string createmultiuse
このフラグは、applyTake 使用時に使うフィルタを指定します。このフラグが複数回使用される場合、フィルタの順序は左から右になります。
C: デフォルトは、フィルタなしです。
preview(p) boolean create
デバイス アタッチメントにコネクトされたターゲット アトリビュートにアタッチされている blendDevice ノードにテイクを適用します。アトリビュートにアタッチされているアニメーション カーブは、プレビュー データが定義される場合以外は変更されません。プレビュー データは再生時に使用されるデータです。
C: デフォルトは、プレビューしないです。
reset(r) boolean create
-preview によって影響を受ける blendDevice ノードをリセットします。プレビュー データが削除され、アニメーション カーブが存在する場合は、それらのカーブが再生時に使用されます。

: コマンドの作成モードで使用可能なフラグ : コマンドの編集モードで使用可能なフラグ
: コマンドの照会モードで使用可能なフラグ : タプルまたはリストとして渡された複数の引数を持てるフラグ

Python 例

import maya.cmds as cmds

#    Apply all of the recorded data to param curves.
cmds.applyTake()

#    Applies the takes from clock and ultra devices and starts the
#    data at anim time 100.
cmds.applyTake( d=('clock', 'ultra'), st=100 )

#    Applies the take from the ultra device and uses the euler and
#    simplify filters.
cmds.applyTake( d='ultra', f=('euler', 'simplify') )

#    Applies only the shoulder channel and all of its children.
cmds.applyTake( d='ultra', c='shoulder', sc=True, rc=True )