移動先: 概要 戻り値 フラグ. Python 例.

概要

rebuildSurface( surface [surface] , [caching=boolean], [constructionHistory=boolean], [degreeU=int], [degreeV=int], [direction=int], [endKnots=int], [fitRebuild=int], [keepControlPoints=boolean], [keepCorners=boolean], [keepRange=int], [name=string], [nodeState=int], [object=boolean], [polygon=int], [rebuildType=int], [replaceOriginal=boolean], [spansU=int], [spansV=int], [tolerance=linear])

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

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

パラメータ配置を修正してサーフェスをリビルドします。 サーフェスのシェイプも変化することがあります。サーフェスの再構築方法は、 rebuildType (-rt) アトリビュートで決まります。

オプションの 2 番目のサーフェスは、リファレンス パラメータ配置の指定に使用できます。

戻り値

string[]オブジェクト名とノード名

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

フラグ

caching, constructionHistory, degreeU, degreeV, direction, endKnots, fitRebuild, keepControlPoints, keepCorners, keepRange, name, nodeState, object, polygon, rebuildType, replaceOriginal, spansU, spansV, tolerance
ロング ネーム(ショート ネーム) 引数型 プロパティ
rebuildType(rt) int createqueryedit
再構築のタイプ。 0 - 均一、 1 - スパンの削減、 2 - ノット マッチング、 3 - 多重ノットの削除、 4 - 非有理の強制、 5 - 終端のリビルド、 6 - トリムの変換(均一)、 7 - ベジェ メッシュへ。
デフォルト: 0
direction(dir) int createqueryedit
再構築する方向。 0 - U、 1 - V、 2 - U と V の両方。
デフォルト: 2
spansU(su) int createqueryedit
作成するサーフェスの、U 方向のスパン数。rebuildType が 0(均一)のときにのみ使用されます。0 の場合は、オリジナル サーフェスと同数のスパンを維持します。
デフォルト: 4
spansV(sv) int createqueryedit
作成するサーフェスの、V 方向のスパン数。rebuildType が 0(均一)のときにのみ使用されます。0 の場合は、オリジナル サーフェスと同数のスパンを維持します。
デフォルト: 4
degreeU(du) int createqueryedit
作成するサーフェスの U 方向の次数。 0 - カレントを維持、 1 - 一次、 2 - 二次、 3 - 三次、 5 - 五次、 7 - 七次。
デフォルト: 3
degreeV(dv) int createqueryedit
作成するサーフェスの V 方向の次数。 0 - カレントを維持、 1 - 一次、 2 - 二次、 3 - 三次、 5 - 五次、 7 - 七次。
デフォルト: 3
tolerance(tol) linear createqueryedit
リビルドする際の許容差。
デフォルト: 0.01
endKnots(end) int createqueryedit
サーフェスのエンド ノットの状態。 0 - 均一エンド ノット、 1 - 多重エンド ノット。
デフォルト: 0
keepCorners(kc) boolean createqueryedit
作成するサーフェスのコーナーを、入力サーフェスのコーナーから変更しません。
デフォルト: true
keepRange(kr) int createqueryedit
作成するサーフェスのパラメータ配置を決定します。 0 - 作成するサーフェスのパラメータを 0 から 1 で再配置、 1 - 元のサーフェスのパラメータ配置を維持、 2 - 結果のパラメータを 0 からスパン数に再設定。
デフォルト: 1
keepControlPoints(kcp) boolean createqueryedit
入力サーフェスの制御点を使用します。 rebuildType が 2(matchKnots)でない場合、強制的に均一なパラメータ配置になります。
デフォルト: false
fitRebuild(fr) int createqueryedit
使用するリビルド方法のタイプを指定します。0 - 従来の手法で変換(オリジナルの変換方法。デフォルトです)。1 - 最小二乗法を使用してフィット。2 - マッチを変換(マッチング変換方法の代替)。 3 - グリッドで変換(グリッドベースのフィット アルゴリズムを使用)。
デフォルト: 0
高度なフラグ
caching(cch) boolean createqueryedit
ノード キャッシング モードを修正します。詳細については、ノードの説明を参照してください。
: 上級ユーザ向けの機能です。
nodeState(nds) int createqueryedit
ノード状態を修正します。詳細については、ノードの説明を参照してください。
: 上級ユーザ向けの機能です。
一般的なフラグ
name(n) string create
作成されたオブジェクトに名前を付けます。
constructionHistory(ch) boolean create
コンストラクション ヒストリをオンまたはオフにします。
object(o) boolean create
結果のオブジェクト、またはディペンデンシー ノードのみを作成します。
replaceOriginal(rpo) boolean create
「同じ位置」に作成(つまり置き換え)します。
polygon(po) int create
この引数の値は、この操作で作成されるオブジェクトの タイプを制御します。
  • 0: NURBS サーフェス
  • 1: ポリゴン(nurbsToPolygonsPref を使用して変換用のパラメータを設定)
  • 2: サブディビジョン サーフェス(nurbsToSubdivPref を使用して変換用のパラメータを設定)
  • 3: ベジェ サーフェス
  • 4: サブディビジョン サーフェス ソリッド (変換のためのパラメータを設定するには、nurbsToSubdivPref を使用)

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

Python 例

import maya.cmds as cmds

# rebuild the surface using uniform parameterization
# The rebuilt surface will have 5 spans in u and
# 10 spans in v
cmds.rebuildSurface( rt=0, dir=2, su=5, sv=10 )

# rebuild the surface by removing its redundant spans
cmds.rebuildSurface( rt=1 )

# rebuild the surface by matching the u parameterization
# of another surface. surface1 is the surface to rebuild
# surface2 is the reference surface
cmds.rebuildSurface( 'surface1', 'surface2', rt=2, dir=0 )

# rebuild the surface by removing all multiple interior knots
cmds.rebuildSurface( rt=3 )

# rebuild the surface using uniform parameterization
cmds.rebuildSurface( rt=4 )