Softimage SDK プログラミング ガイド > プラグイン開発 > 選択 > 

階層の操作

 
 
 

選択では、オブジェクトの階層の 4 つの異なるレベル(選択モード)を認識します。 特定の操作(オペレータの適用など)では、これらの操作の範囲が変更されるため、選択モードが重要になります。

注:

Softimage における階層の選択についての一般情報は、『Softimage ユーザ ガイド』の「階層でオブジェクトを選択する」を参照してください。

選択の際に階層を指定する

SelectObj コマンドまたは Selection.Add/Selection::Add メソッドのパラメータを使用して、階層モードの 1 つを指定することができます。

注:

AddToSelection、ToggleSelection、SelectNeighborObj の各コマンドでも、階層キーワードがサポートされています。

また、SelectBranch、SelectTree、SelectModel は、階層選択を指定するのに使用できる便利なコマンドです。

ヒント:

さらに、項目をブランチ選択するか、選択から独立させるかを指定する別の方法もあります。

階層を使用したオブジェクトを削除する

ほとんどの場合、オブジェクトの削除はオブジェクト名を DeleteObj コマンドに渡すだけで簡単に行うことができます。ただし、オブジェクトに他の 3D オブジェクトが含まれている場合は、以下の特別な手順に従う必要があります。

  • 削除するオブジェクトがモデルまたはヌルの場合は、ブランチ削除によってそのオブジェクトとその子を削除する必要があります。 モデルまたはヌルは、ブランチ削除以外の方法では削除されません。

  • ブランチ削除によって他の 3D オブジェクト(球、円錐など)を削除すると、そのオブジェクトと、含まれるノードがすべて削除されます。ノード削除によって削除すると、そのオブジェクトが削除され、同名のヌルに置き換わります。これは、含まれているノードの階層を維持するためです。

オブジェクトをブランチ削除するには、オブジェクトをブランチで選択して引数なしで DeleteObj コマンドを実行するか、削除するオブジェクトの名前の前に "B:" ブランチ プリフィックスを指定します。たとえば以下のようになります。

JScript の例: モデルの削除(ノードとブランチ) 

// Create a simple model containing a sphere
NewScene(null, false);
var sph = CreatePrim("Sphere", "MeshSurface");
var mdl = CreateModel(sph, "LocalModel")(0);
Application.LogMessage(Application.ActiveSceneRoot.Models.GetAsText());
// INFO : LocalModel

// First node-delete it (nothing happens)
DeleteObj(mdl);
Application.LogMessage(Application.ActiveSceneRoot.Models.GetAsText());
// INFO : LocalModel

// Then try branch-deleting it (it is removed)
SelectObj(mdl, "BRANCH")// models must be branch-selected when deleting
DeleteObj();
Application.LogMessage(Application.ActiveSceneRoot.Models.GetAsText());
// INFO :
注:

"B:" プリフィックスを DeleteObj コマンドで使用する例については、「VBScript の例: ブランチでヌルを削除する」を参照してください。

階層の選択のテスト

すべての 3D オブジェクトには、オブジェクトがノード選択されているかどうかを定義した独自の ProjectItem.BranchFlag または ProjectItem::GetBranchFlag が格納されています。つまり、オブジェクトがブランチ、ツリー、またはモデルで選択されている場合、ブランチ フラグは 1 になります。 オブジェクトがノード選択のみされている場合は、ブランチ フラグは 0 に設定されます。

重要:

パラメータおよびコンパウンド プロパティは選択できないので注意してください。これらの 3dobject が選択されますが、マークとして認識されます。 SDK では、パラメータは SIObject または SIObject クラスから派生しますが、これは ProjectItem.BranchFlag または ProjectItem::GetBranchFlag プロパティを実装する ProjectItem または ProjectItem クラスです。

Python での階層選択のテスト例は、「Python の例: 階層の選択項目をテストする」を参照してください。

階層およびサブコンポーネント

ポイント、エッジ、ポリゴンなどは、個別のサブコンポーネントであるため、どの階層モードもサポートしません。階層が重要となるのは、シーン アイテムに対して操作を行う場合(ブランチ内でのオペレータの適用など)だけです。

例

以下の例を参考にしてください。

JScript の例: SelectObj コマンドを使用した階層選択

この例では、SelectObj コマンドを使用して、さまざまな階層モードでオブジェクトを選択する方法を示します。 

// Set up a scene with lots of hierarchy 
SetUpScene();

// Try the different modes with the SelectObj command

SelectObj("Herman.Larm", "NODE");
Application.LogMessage(Selection.GetAsText());
// INFO : Herman.LArm

SelectObj("Herman.Larm", "BRANCH");
Application.LogMessage(Selection.GetAsText());
// INFO : Herman.LArm

SelectObj("Herman.Larm", "TREE");
Application.LogMessage(Selection.GetAsText());
// INFO : Herman.Arms

SelectObj("Herman.Larm", "MODEL");
Application.LogMessage(Selection.GetAsText());
// INFO : Herman


// --------------------------
//	Convenience function
//
function SetUpScene()
{
	NewScene(null, false);

	// Topmost level
	CreateModel("", "Herman");

	// General body parts
	GetPrim("Null", "Head", "Herman");
	GetPrim("Null", "Chest", "Herman");
	GetPrim("Null", "Arms", "Herman");
	GetPrim("Null", "Torso", "Herman");
	GetPrim("Null", "Legs", "Herman");

	// Individual body parts
	GetPrim("Null", "LArm", "Herman.Arms");
	GetPrim("Null", "RArm", "Herman.Arms");

	// Specific body parts
	CreatePrim("Sphere", "MeshSurface", "Bicep", "Herman.Larm");
	Scale("Herman.Bicep", 0.35, 1, 0.35, siAbsolute, siPivot, siObj, siXZ);
}

Python の例: Selection.Add メソッドを使用した階層選択

siSelectMode 値は、SelectObj コマンドの代わりに、Selection.Add または Selection::Add と使用することもできます。 

from win32com.client import constants as xsi
app = Application

# --------------------------
#	Convenience function
#
def SetUpScene() :
	Application.NewScene("", 0)

	# Topmost level
	Application.CreateModel("", "Herman")

	# General body parts
	Application.GetPrim("Null", "Head", "Herman")
	Application.GetPrim("Null", "Chest", "Herman")
	Application.GetPrim("Null", "Arms", "Herman")
	Application.GetPrim("Null", "Torso", "Herman")
	Application.GetPrim("Null", "Legs", "Herman")

	# Individual body parts
	oRefObj = app.GetPrim("Null", "LArm", "Herman.Arms")
	Application.GetPrim("Null", "RArm", "Herman.Arms")

	# Specific body parts
	Application.CreatePrim("Sphere", "MeshSurface", "Bicep", "Herman.Larm")
	Application.Scale("Herman.Bicep", 0.35, 1, 0.35, "siAbsolute", "siPivot", "siObj", "siXZ")
	
	return oRefObj


# --------------------------
#	Hierarchical selection
#
# Set up a scene with lots of hierarchy 
o3DSceneItem = SetUpScene()

# Try the different modes with the Selection.Add method
oSel = app.Selection

oSel.Clear()
oSel.Add(o3DSceneItem, xsi.siSelectNode)
app.LogMessage(oSel.GetAsText())
# INFO : Herman.LArm

oSel.Clear()
oSel.Add(o3DSceneItem, xsi.siSelectBranch)
app.LogMessage(oSel.GetAsText())
# INFO : Herman.LArm

oSel.Clear()
oSel.Add(o3DSceneItem, xsi.siSelectTree)
app.LogMessage(oSel.GetAsText())
# INFO : Herman.Arms

oSel.Clear()
oSel.Add(o3DSceneItem, xsi.siSelectModel)
app.LogMessage(oSel.GetAsText())
# INFO : Herman

VBScript の例: ブランチでヌルを削除する

この例では、オブジェクトの文字列式に"B:"ブランチ プリフィックスを指定して、オブジェクトとその子を削除する方法を示します。 

set app = Application
NewScene , false

GetPrim "Null", "top"
GetPrim "Null", "middle_1", "top"
GetPrim "Null", "middle_2", "top"
GetPrim "Null", "middle_3", "top"
GetPrim "Null", "mid_2_bottom_1", "middle_2"
GetPrim "Null", "way_low", "mid_2_bottom_1"
GetPrim "Null", "mid_2_bottom_2", "middle_2"
GetPrim "Null", "mid_3_bottom", "middle_3"

SelectAll
app.LogMessage "There are currently " & app.Selection.Count & " item(s) selected."
for each sel_item in app.Selection
	app.LogMessage sel_item.Name
next
' INFO : There are currently 12 item(s) selected.
' INFO : Camera_Root
' INFO : Camera
' INFO : Camera_Interest
' INFO : light
' INFO : top
' INFO : middle_1
' INFO : middle_2
' INFO : mid_2_bottom_1
' INFO : way_low
' INFO : mid_2_bottom_2
' INFO : middle_3
' INFO : mid_3_bottom


' Now delete the entire middle_2 branch
DeleteObj "B:middle_2"
app.LogMessage "There are currently " & app.Selection.Count & " item(s) selected."
for each sel_item in app.Selection
	app.LogMessage sel_item.Name
next
' INFO : There are currently 8 item(s) selected.
' INFO : Camera_Root
' INFO : Camera
' INFO : Camera_Interest
' INFO : light
' INFO : top
' INFO : middle_1
' INFO : middle_3
' INFO : mid_3_bottom

Python の例: 階層の選択項目をテストする

この例では、選択したアイテムを繰り返し処理し、各アイテムがノード選択されているかどうかをテストする方法を示します。 

app = Application

# --------------------------
#	Convenience function
#
def SetUpMultiLevelNulls() :
	app.NewScene("", 0)
	app.CreateModel("", "TopDog")
	
	# Create a hierarchy to test
	app.CreateModel("", "NextLevel")
	app.GetPrim("Null", "HigherLevel", "NextLevel")
	targetObj = app.GetPrim("Null", "MidLevel", "NextLevel.HigherLevel")
	app.GetPrim("Null", "LowerLevel", "NextLevel.MidLevel")
	app.GetPrim("Null", "BottomFeeder", "NextLevel.LowerLevel")
	app.CreateModel(app.ActiveSceneRoot.Models(0), "TopDog")

	
	return targetObj


# --------------------------
#	Hierarchical selection
#
def TestSelection() :
	for thing in app.Selection :
		if ( thing.BranchFlag ) :
			app.LogMessage( thing.Name + " is selection in BRANCH" )
		else :
			app.LogMessage( thing.Name + " is selection in NODE" )


# --------------------------
#	Logging results
#
# NODE-selected
refObj = SetUpMultiLevelNulls()
app.SelectObj( refObj.FullName )
TestSelection()	# INFO : MidLevel is selection in NODE

# BRANCH-selected
refObj = SetUpMultiLevelNulls()
app.SelectObj( "B:" + refObj.FullName )
TestSelection()	# INFO : MidLevel is selection in BRANCH

# TREE-selected
refObj = SetUpMultiLevelNulls()
app.SelectObj( "B:" + refObj.FullName, "TREE" )
TestSelection()	# INFO : HigherLevel is selection in BRANCH

# MODEL-selected
refObj = SetUpMultiLevelNulls()
app.SelectObj( "B:" + refObj.FullName, "MODEL" )
TestSelection()	# INFO : NextLevel is selection in BRANCH
このトピックについてのコメントをお送りください