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

概要

untangleUV([mapBorder=string], [maxRelaxIterations=int], [pinBorder=boolean], [pinSelected=boolean], [pinUnselected=boolean], [relax=string], [relaxTolerance=float], [shapeDetail=float])

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

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

このコマンドは、テクスチャ UV をほどくことで、テクスチャ空間に非オーバーラップ領域(すなわちポリゴン)を作成できるようにします。これは次の 2 段階で行われます。
1. このコマンドを使用して、現在の選択項目に定義された UV 境界または渡されたコンポーネントを、次のリラックス処理により適したシェイプにマッピングします。
2. テクスチャ空間にあるすべてのエッジに対して長さの最小化アルゴリズムを実行し、内部のすべてのテクスチャ UV をリラックスさせます。

戻り値

int実行するリラックス反復の回数

キーワード

poly, uv, map, border, relax, untangle

関連

polyClipboard, polyCylindricalProjection, polyEditUV, polyForceUV, polyMapCut, polyMapDel, polyMapSew, polyMoveFacetUV, polyMoveUV, polyPlanarProjection, polyProjection, polySphericalProjection, polyUVSet

フラグ

mapBorder, maxRelaxIterations, pinBorder, pinSelected, pinUnselected, relax, relaxTolerance, shapeDetail
ロング ネーム(ショート ネーム) 引数タイプ プロパティ
mapBorder(mb) string create
選択した UV を含む境界を、UV のリラックス操作により適したシェイプへとマッピングします。数多くのタイプのマッピングが使用可能です。すべてのマッピング結果は単位正方形内に収められます。

有効な文字列:
circular: (0,0)に最近接の選択済み UV による円形マッピング
square: 選択済み UV を(0,0)に配置した、単位正方形へのマッピング
shape: 選択済み UV が(0,0)から(0.5,0.5)の直線状に配置されたオブジェクトの、実際のシェイプを反映することを試みるマッピング
shape_circular: マッピングされた境界の自己交差を回避できる程度に、円形マッピングへと補間されるシェイプ マッピング
shape_square: マップピングされた境界の自己交差を回避できる程度に、正方形マッピングへと補間されるシェイプ マッピング
shapeDetail(sd) float create
mapBorder フラグを circular または square に設定した場合、このフラグは、境界の他王するサーフェス シェイプが、最終的にマッピングされた境界で保持される度合いを制御します。
relax(r) string create
選択した UV のシェルにあるすべての UV をリラックスします。リラックスは、UV の各エッジをスプリングとして扱う、スプリング システムをシミュレートします。リラックスには、スプリング システムにおける UV エッジをウェイト付けする方法により、さまざまな方法があります。ウェイト付けは文字列で指定します。有効な文字列:
uniform: すべてのエッジを同じようにウェイト付けします。これが最速の方法です。
inverse_length: すべてのエッジ ウェイトは、ワールド空間上の長さに反比例します。
inverse_sqrt_length: すべてのエッジ ウェイトは、ワールド空間上の長さの平方根に反比例します。
harmonic: このウェイト付けは、UV とジオメトリとの一致ングについてほぼ最適の結果を生成できますが、処理に時間がかかる場合があります。
relaxTolerance(rt) float create
リラックス プロセスを中止するタイミングを定義する許容量を設定します。許容量を小さくすると優れた結果が得られますが、処理に時間がかかります。
maxRelaxIterations(mri) int create
リラックス プロセスは反復アルゴリズムです。このフラグを使用して、実行する反復数の上限を設定します。
pinBorder(pb) boolean create
true の場合、すべてのリラックス操作において、関連するテクスチャ境界を同じ位置に固定します。
pinSelected(ps) boolean create
true の場合、すべてのリラックス操作において、選択した UV を同じ位置に固定します。
pinUnselected(pu) boolean create
true の場合、すべてのリラックス操作において、各メッシュにあるすべての非選択 UV を同じ位置に固定します。
フラグはコマンドの作成モードで表示できます フラグはコマンドの編集モードで表示できます
フラグはコマンドの照会モードで表示できます フラグに複数の引数を指定し、タプルまたはリストとして渡すことができます。

Python 例

import maya.cmds as cmds

cmds.untangleUV( mb='shape_square' )
# map the border associated with the selected UV trying to retain the
# shape of the object and use a square mapping to iron out crossings
cmds.untangleUV( r='one_over_length', pb=True, ps=False, pu=False, rt=0.1 )
# relax the shell associated with the selected UV using edge weights
# that are inversely proportional to length of world space lengths
# pin the UV on borders and use a tolerance of 0.1