polyChipOff コマンド

概要

polyChipOff([attraction=float], [caching=boolean], [constructionHistory=boolean], [duplicate=boolean], [gravity=[linear, linear, linear]], [gravityX=linear], [gravityY=linear], [gravityZ=linear], [keepFacesTogether=boolean], [localDirection=[linear, linear, linear]], [localDirectionX=linear], [localDirectionY=linear], [localDirectionZ=linear], [localRotate=[angle, angle, angle]], [localRotateX=angle], [localRotateY=angle], [localRotateZ=angle], [localScale=[float, float, float]], [localScaleX=float], [localScaleY=float], [localScaleZ=float], [localTranslate=[linear, linear, linear]], [localTranslateX=linear], [localTranslateY=linear], [localTranslateZ=linear], [magnX=linear], [magnY=linear], [magnZ=linear], [magnet=[linear, linear, linear]], [name=string], [nodeState=int], [offset=float], [pivot=[linear, linear, linear]], [pivotX=linear], [pivotY=linear], [pivotZ=linear], [random=float], [rotate=[angle, angle, angle]], [rotateX=angle], [rotateY=angle], [rotateZ=angle], [scale=[float, float, float]], [scaleX=float], [scaleY=float], [scaleZ=float], [translate=[linear, linear, linear]], [translateX=linear], [translateY=linear], [translateZ=linear], [weight=float], [worldSpace=boolean])

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

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

ファセットを抽出します。フェースは個別に抽出、またはまとめて抽出でき、ワールド空間かオブジェクト空間で操作できます。

戻り値

string

ノード名

戻り値の型は照会モードでは照会フラグが基になります。

フラグ

attraction, caching, constructionHistory, duplicate, gravity, gravityX, gravityY, gravityZ, keepFacesTogether, localDirection, localDirectionX, localDirectionY, localDirectionZ, localRotate, localRotateX, localRotateY, localRotateZ, localScale, localScaleX, localScaleY, localScaleZ, localTranslate, localTranslateX, localTranslateY, localTranslateZ, magnX, magnY, magnZ, magnet, name, nodeState, offset, pivot, pivotX, pivotY, pivotZ, random, rotate, rotateX, rotateY, rotateZ, scale, scaleX, scaleY, scaleZ, translate, translateX, translateY, translateZ, weight, worldSpace

ロングネーム（ショートネーム） 引数型 プロパティ

keepFacesTogether(kft) boolean

ファセットの切り取り方法を指定します。オンにすると、ファセットはまとめて引き出されます（コネクト状態は維持されます）。オフにすると、個別に引き出されます。
C: デフォルトはオンです。
Q: 照会すると int を返します。

duplicate(dup) boolean

オンにすると、ファセットを複製します。オフにすると、オリジナルのファセットが削除されます。
C: デフォルトはオンです。
Q: 照会すると int を返します。

worldSpace(ws) boolean

このフラグは、使用するリファレンスを指定します。オンの場合: すべてのジオメトリ値はワールドリファレンスで考慮されます。オフの場合: すべてのジオメトリ値はオブジェクトリファレンスで考慮されます。
C: デフォルトはオフです。
Q: 照会すると int を返します。

random(ran) float

すべてのパラメータにランダム値を指定します。
C: デフォルトは 0.0 です。範囲は [-10.0, 10.0] です。
Q: 照会すると float を返します。

グローバル値

translate(t) [linear, linear, linear]

このフラグは移動ベクトルを指定します。
C: デフォルトは 0.0 0.0 0.0 です。
Q: 照会すると float[3] を返します。

translateX(tx) linear

X 移動ベクトルを指定します。
C: デフォルトは 0.0 です。
Q: 照会すると float を返します。

translateY(ty) linear

Y 移動ベクトルを指定します。
C: デフォルトは 0.0 です。
Q: 照会すると float を返します。

translateZ(tz) linear

Z 移動ベクトルを指定します。
C: デフォルトは 0.0 です。
Q: 照会すると float を返します。

rotate(ro) [angle, angle, angle]

X、Y、Z の回転角度を指定します。
C: デフォルトは 0.0 0.0 0.0 です。
Q: 照会すると float[3] を返します。

rotateX(rx) angle

X の回転角度を指定します。
C: デフォルトは 0.0 です。
Q: 照会すると float を返します。

rotateY(ry) angle

Y の回転角度を指定します。
C: デフォルトは 0.0 です。
Q: 照会すると float を返します。

rotateZ(rz) angle

Z の回転角度を指定します。
C: デフォルトは 0.0 です。
Q: 照会すると float を返します。

scale(s) [float, float, float]

スケーリングベクトルを指定します。
C: デフォルトは 1.0 1.0 1.0 です。
Q: 照会すると float[3] を返します。

scaleX(sx) float

スケーリングベクトルの X を指定します。
C: デフォルトは 1.0 です。
Q: 照会すると float を返します。

scaleY(sy) float

スケーリングベクトルの Y を指定します。
C: デフォルトは 1.0 です。
Q: 照会すると float を返します。

scaleZ(sz) float

スケーリングベクトルの Z を指定します。
C: デフォルトは 1.0 です。
Q: 照会すると float を返します。

pivot(pvt) [linear, linear, linear]

スケーリングと回転のピボットを指定します。
C: デフォルトは 0.0 0.0 0.0 です。
Q: 照会すると float[3] を返します。

pivotX(pvx) linear

スケーリングと回転の X ピボットを指定します。
C: デフォルトは 0.0 です。
Q: 照会すると float を返します。

pivotY(pvy) linear

スケーリングと回転の Y ピボットを指定します。
C: デフォルトは 0.0 です。
Q: 照会すると float を返します。

pivotZ(pvz) linear

スケーリングと回転の Z ピボットを指定します。
C: デフォルトは 0.0 です。
Q: 照会すると float を返します。

ローカル値

offset(off) float

ローカルオフセットを指定します。
C: デフォルトは 0.0 です。
Q: 照会すると float を返します。

localTranslate(lt) [linear, linear, linear]

ローカルの移動ベクトルを指定します。
C: デフォルトは 0.0 0.0 0.0 です。
Q: 照会すると float[3] を返します。

localTranslateX(ltx) linear

X のローカル移動ベクトルを指定します。
C: デフォルトは 0.0 です。
Q: 照会すると float を返します。

localTranslateY(lty) linear

Y のローカル移動ベクトルを指定します。
C: デフォルトは 0.0 です。
Q: 照会すると float を返します。

localTranslateZ(ltz) linear

Z のローカル移動ベクトルを指定します。
C: デフォルトは 0.0 です。
Q: 照会すると float を返します。

localRotate(lr) [angle, angle, angle]

次のローカル回転を指定します（slantRot、slantRoll、twistRot）。
C: デフォルトは 0.0 0.0 0.0 です。
Q: 照会すると float[3] を返します。ローカル回転（slantRot、slantRoll、twistRot）。

localRotateX(lrx) angle

ローカル回転の X 角度（slantAxis を中心とする傾斜ロール）を指定します。
C: デフォルトは 0.0 です。範囲は [0,360] です。
Q: 照会すると float を返します。

localRotateY(lry) angle

ローカル回転の Y 角度（slantAxis の傾斜ロール）を指定します。
C: デフォルトは 0.0 です。範囲は [0, 180] です。
Q: 照会すると float を返します。

localRotateZ(lrz) angle

ローカル回転の Z 角度（法線を中心とするツイスト）を指定します。
C: デフォルトは 0.0 です。範囲は [0,360] です。
Q: 照会すると float を返します。

localDirection(ld) [linear, linear, linear]

ローカルの傾斜軸を指定します（ローカル回転を参照してください）。
C: デフォルトは 0.0 0.0 1.0 です。
Q: 照会すると float[3] を返します。

localDirectionX(ldx) linear

ローカルの傾斜軸の X を指定します。
C: デフォルトは 0.0 です。
Q: 照会すると float を返します。

localDirectionY(ldy) linear

ローカルの傾斜軸の Y を指定します。
C: デフォルトは 0.0 です。
Q: 照会すると float を返します。

localDirectionZ(ldz) linear

ローカルの傾斜軸の Y を指定します。
C: デフォルトは 1.0 です。
Q: 照会すると float を返します。

localScale(ls) [float, float, float]

ローカルのスケーリングベクトルを指定します。
C: デフォルトは 1.0 1.0 1.0 です。
Q: 照会すると float[3] を返します。

localScaleX(lsx) float

ローカルのスケーリングベクトルの X を指定します。
C: デフォルトは 1.0 です。
Q: 照会すると float を返します。

localScaleY(lsy) float

ローカルのスケーリングベクトルの Y を指定します。
C: デフォルトは 1.0 です。
Q: 照会すると float を返します。

localScaleZ(lsz) float

ローカルのスケーリングベクトルの Z を指定します。平らになります。
C: デフォルトは 1.0 です。範囲は [0.0, 1.0] です。
Q: 照会すると float を返します。

ダイナミック値

weight(w) float

重力に関連したウェイトを指定します。
C: デフォルトは 0.0 です。
Q: 照会すると float を返します。

gravity(g) [linear, linear, linear]

重力ベクトルを指定します。
C: デフォルトは、0.0 -1.0 0.0 です。
Q: 照会すると float[3] を返します。

gravityX(gx) linear

重力ベクトルの X を指定します。
C: デフォルトは 0.0 です。
Q: 照会すると float を返します。

gravityY(gy) linear

重力ベクトルの Y を指定します。
C: デフォルトは -1.0 です。
Q: 照会すると float を返します。

gravityZ(gz) linear

重力ベクトルの Z を指定します。
C: デフォルトは 0.0 です。
Q: 照会すると float を返します。

attraction(att) float

磁石に関連する引き付けを指定します。
C: デフォルトは 0.0 です。範囲は [-2.0, 2.0] です。
Q: 照会すると float を返します。

magnet(m) [linear, linear, linear]

磁石ベクトルを指定します。
C: デフォルトは 0.0 0.0 0.0 です。
Q: 照会すると float[3] を返します。

magnX(mx) linear

磁石ベクトルの X を指定します。
C: デフォルトは 0.0 です。
Q: 照会すると float を返します。

magnY(my) linear

磁石ベクトルの Y を指定します。
C: デフォルトは 0.0 です。
Q: 照会すると float を返します。

magnZ(mz) linear

磁石ベクトルの Z を指定します。
C: デフォルトは 0.0 です。
Q: 照会すると float を返します。

一般的なフラグ

name(n) string

作成されるノードに名前をつけます。

constructionHistory(ch) boolean

コンストラクションヒストリをオンまたはオフにします（適切な場合）。コンストラクションヒストリがオンの場合、対応するノードがメッシュのヒストリチェーンに挿入されます。コンストラクションヒストリがオフの場合、操作オブジェクト上に直接行われます。
注: コンストラクションヒストリがすでにオブジェクトにある場合は、このフラグは無視され、ノードは必ずヒストリチェーンに挿入されます。

caching(cch) boolean

すべてのアトリビュートのキャッシングを切り替えることで、再計算を不要にします。

nodeState(nds) int

ノードの評価方法を定義します。

0: Normal
1: PassThrough
2: Blocking
3: 内部的に無効。有効にすると、Normal の状態に戻ります。
4: 内部的に無効。有効にすると、PassThrough 状態に戻ります。
5: 内部的に無効。有効にすると、Blocking 状態に戻ります。

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

Python 例

import maya.cmds as cmds

# Duplicate
cmds.polyPlane( n='plg', w=10, h=10 )
cmds.polyChipOff( 'plg.f[71:72]', 'plg.f[81:82]', dup=True, ltz=1 )
#facets are duplicated and translated in local space

# Extract
cmds.polyChipOff( 'plg.f[11:12]', 'plg.f[21:22]', dup=False, ty=1 )
#facets are extracted and translated in world space

# Separate
cmds.polyChipOff( 'plg.f[15:16]', 'plg.f[23:24]', dup=False, kft=False, ls=(.5, .5, 0) )
#facets are extracted then scaled separately

# Together
cmds.polyChipOff( 'plg.f[73:74]', 'plg.f[83:84]', dup=False, kft=True, ls=(.5, .5, 0) )
#facets are extracted then scaled together

コマンド (Python)	MEL バージョン
polyChipOff	カテゴリ: モデリング, ポリゴン

polyChipOff

概要

戻り値

関連項目

フラグ

Python 例