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

概要

polySubdivideEdge([caching=boolean], [constructionHistory=boolean], [divisions=int], [name=string], [nodeState=int], [size=linear], [worldSpace=boolean])

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

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

複数のサブエッジにエッジを分割します。


既定:エッジを同じ長さの 2 つに分割します。

戻り値

stringノード名

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

関連

polyAppend, polyAppendVertex, polyBevel, polyChipOff, polyCreateFacet, polyExtrudeEdge, polyExtrudeFacet, polySmooth, polySplit, polySplitVertex, polySubdivideFacet, polyTriangulate

フラグ

caching, constructionHistory, divisions, name, nodeState, size, worldSpace
ロング ネーム(ショート ネーム) 引数タイプ プロパティ
divisions(dv) int createqueryedit
それぞれのエッジで挿入する頂点の最大数。指定した最低の長さよりエッジが短くなる場合、この数は少なくなることがあります。
C: 既定は 1 (エッジを半分に分割)です。
Q: 照会すると int を返します。
size(s) linear createqueryedit
作成するサブエッジの最短長。所定のサブディビジョンによってこの値よりも短いエッジが作成される場合は、最短長を維持するように分割数が変更されます。
C: 既定は 0.0 です。
Q: 照会すると float を返します。
worldSpace(ws) boolean createqueryedit
このフラグは、使用するリファレンスを指定します。オンの場合: すべてのジオメトリ値はワールド リファレンスで考慮されます。オフの場合:すべてのジオメトリ値はオブジェクト リファレンスで考慮されます。
C: 既定はオフです。
Q: 照会すると int を返します。
共通のフラグ
name(n) string create
作成されるノードに名前をつけます。
constructionHistory(ch) boolean createquery
コンストラクション ヒストリをオンまたはオフにします(適切な場合)。コンストラクション ヒストリがオンの場合、対応するノードがメッシュのヒストリ チェーンに挿入されます。コンストラクション ヒストリがオフの場合、操作オブジェクト上に直接行われます。
注: コンストラクション ヒストリがすでにオブジェクトにある場合は、このフラグは無視され、ノードは必ずヒストリ チェーンに挿入されます。
caching(cch) boolean createedit
すべてのアトリビュートのキャッシングを切り替えることで、再計算を不要にします。
nodeState(nds) int createqueryedit
ノードの評価方法を定義します。
  • 0: Normal
  • 1: PassThrough
  • 2: Blocking
  • 3: 内部的に無効。有効にすると、Normal 状態に戻ります。
  • 4: 内部的に無効。有効にすると、PassThrough 状態に戻ります。
  • 5: 内部的に無効。有効にすると、Blocking 状態に戻ります。

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

Python 例

import maya.cmds as cmds

cmds.polyCube( n='plg', w=5, h=5, d=5 )
cmds.scale( 2, 2, 2 )
cmds.select( 'plg' )
cmds.polyOptions( ao=True, dv='true' )
cmds.select( cl=True )

# Simple subdivision
cmds.select( 'plg.e[1]' )
cmds.polySubdivideEdge( dv=4 )
# The selected edges are subdivided by 4 vertices (5 subedges).

# Local bound
cmds.select( 'plg.e[7]' )
cmds.polySubdivideEdge( dv=4, s=1.5 )
# The length of each subedge must be greater or equal to 1.5
# in local space. Length of original edge is 5 in local space.
# Min size indicates that only 3 subedges can be created.

# World bound
cmds.select( 'plg.e[5]' )
cmds.polySubdivideEdge( dv=4, s=2, ws=True )
# The length of each subedge has to be greater or equal to 2
# in world space. Length of original edge is 10 in world space.
# All required subdivisions are done.