shadingNetworkCompare

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

概要

shadingNetworkCompare([byName=boolean], [byValue=boolean], [delete=boolean], [equivalent=boolean], [network1=boolean], [network2=boolean], [upstreamOnly=boolean])

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

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

戻り値

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

キーワード

フラグ

ロング ネーム(ショート ネーム)	引数タイプ	プロパティ
byName(nam)	boolean
比較する際に、ノード名を考慮するかどうかを指定します。true の場合、2 つのシェーディング ネットワークは、対応するノード名が同じである場合のみに(ネームスペースは無視します)、同等に扱われます。false の場合、2 つのシェーディング ネットワークは、対応するノード名が違っていても、同等に扱われます。既定は false です。
byValue(val)	boolean
比較する際に、接続されていないアトリビュートの値を考慮するかどうかを指定します。true の場合、2 つのシェーディング ネットワークは、対応する接続されていないアトリビュートが同じ型で同じ値を持つ場合のみに、同等に扱われます。int、bool、float、string 型のアトリビュートのみの値を比較します。false の場合、2 つのシェーディング ネットワークは、対応する接続されていないアトリビュートの型や値が違っていても、同等に扱われます。既定は true です。
upstreamOnly(up)	boolean
比較する際に、シェーディング ネットワーク ノードの下流に接続されたノードを考慮するかどうかを指定します。true の場合、シェーディング グループの上流にあるノードのみを考慮します。下流接続のみをたどり、ノードからシェーディング グループ上のシェーダ アトリビュートへの接続 パスが存在しない場合、ノードは考慮されません。false の場合、シェーディング グループのシェーダ アトリビュートへの入力接続が末端にある上流または下流接続をたどって、接続 パスが見つかるとノードを考慮します。これらの「ぶら下がった」ノードは、シェーディング グループのカラー、ディスプレイスメント、ボリュームなどの特性には直接寄与しません。既定は false です。
equivalent(eq)	boolean
int を返します。比較の結果、シェーディング ネットワークが同等の場合は 1 を返し、そうでない場合は 0 を返します。
network1(n1)	boolean
string[] を返します。比較の結果、シェーディング ネットワークが同等の場合は空の文字配列を返し、そうでない場合は 1 番目のシェーディング ネットワークのノードを返します。
network2(n2)	boolean
string[] を返します。比較の結果、シェーディング ネットワークが同等の場合は空の文字配列を返し、そうでない場合は 2 番目のシェーディング ネットワークのノードを返します。
delete(delete)	boolean
指定した比較をメモリから消去します。

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

Python 例

import maya.cmds as cmds

cmds.shadingNetworkCompare( 'blinn1SG', 'blinn2SG' )
# Result: shadingNetworkComparison1
cmds.shadingNetworkCompare( 'shadingNetworkComparison1', query=True, equivalent=True )
# Result: 1
cmds.shadingNetworkCompare( 'shadingNetworkComparison1', query=True, network1=True )
# Result: blinn1SG blinn1
cmds.shadingNetworkCompare( 'shadingNetworkComparison1', delete=True )