ジャンプ先: 概要. 戻り値. 関連. フラグ. Python 例.

概要

drag( [objects] , [attenuation=float], [directionX=float], [directionY=float], [directionZ=float], [magnitude=float], [maxDistance=linear], [name=string], [perVertex=boolean], [position=[linear, linear, linear]], [useDirection=boolean])

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

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

移動オブジェクトのスピードに比例して、ドラッグによって摩擦、つまりブレーキがかかります。方向を有効にしないと、ドラッグはオブジェクトの現行速度の反対に作用します。方向を有効にすると、指定した方向の速度コンポーネントと反対に作用します。フォースは、影響を受けるオブジェクトの位置には左右されません。

このトランスフォームは関連付けられたディペンデンシー ノードです。connectDynamic を使用して、フィールドがダイナミック オブジェクトに影響を及ぼすようにします。

フィールドを作成すると、このコマンドは各フィールドの名前を返します。フィールドを照会すると、その結果を返します。フィールドを編集すると、フィールド名を返します。

オブジェクト名が提供されるか、アクティブなセレクション リストが空でない場合、このコマンドはリスト内の全オブジェクトのフィールドを作成し、addDynamic をコールしてオブジェクトに追加します。リストが空の場合、コマンドの既定は -pos 0 0 0 です。

コマンド ラインにオブジェクトを指定して -pos フラグを設定すると、エラーになります。

戻り値

string

照会モードでは、戻り値のタイプは照会されたフラグに基づきます。

関連

addDynamic, connectDynamic, particle

フラグ

attenuation, directionX, directionY, directionZ, magnitude, maxDistance, name, perVertex, position, useDirection
ロング ネーム(ショート ネーム) 引数タイプ プロパティ
position(pos) [linear, linear, linear] queryeditmultiuse
フィールドを配置する空間内の位置です。これで、重力がオブジェクトからではなく空間のその位置から発生します。-pos を使用する(位置でフィールド作成時)ことも、オブジェクト名を示すこともできることに注意してください。
magnitude(m) float queryedit
フィールドの強さです。
attenuation(att) float queryedit
フィールドの減衰率です。
maxDistance(mxd) linear queryedit
フィールドが作用する最大距離です。-1 は、フィールドに最大距離がないことを示します。
name(n) string queryedit
フィールドの名前です。
perVertex(pv) boolean queryedit
頂点ごとに適用します。このフラグが true に設定されている場合、選択したオブジェクトのそれぞれのポイント(CV、パーティクル、頂点など)ごとに、フォース フィールドの同一コピーが発生します。このフラグを false に設定すると、フォースはポイントの集合の幾何学的中心からのみ発せられます。
directionX(dx) float queryedit
方向の X コンポーネントです。
directionY(dy) float queryedit
方向の Y コンポーネントです。
directionZ(dz) float queryedit
方向の Z コンポーネントです。
useDirection(ud) boolean queryedit
方向の有効化と無効化。このフラグを true に設定した場合、-dx 引数、-dy 引数、-dz 引数がドラッグで使用されます。
フラグはコマンドの作成モードで表示できます フラグはコマンドの編集モードで表示できます
フラグはコマンドの照会モードで表示できます フラグに複数の引数を指定し、タプルまたはリストとして渡すことができます。

Python 例

import maya.cmds as cmds

# Creates a drag field resisting in direction (0,1,0.5).
cmds.drag( name='myDrag', dx=0, dy=1.0, dz=0.5, useDirection=1 )

# Edits the acceleration value of the field myDrag
cmds.drag( 'myDrag', e=True, m=0.75 )

# Queries myDrag for its magnitude
cmds.drag( 'myDrag', q=True, m=True )