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