Material.CreateTextureLayer

コンテナ（マテリアル）に属する新しいテクスチャレイヤを作成します。

テクスチャレイヤは、シェーダおよびマテリアルの上のテクスチャエフェクトのレイヤリングを簡略化するためのオブジェクトです。各レイヤごとに、その特性（カラー、ミキシングモード、ウェイトなど）を説明するプロパティのセットがあり、制御するシェーダポートに対する影響の度合いを指定できます。コンテナの下にレイヤが表示される順序はレイヤ化が適用された順序であり、「N 色をミックス」したシェーダノードが動作する場合と似ています。テクスチャレイヤポートのオブジェクト（TextureLayer.AddTextureLayerPort コマンドを参照）はレイヤに所有され、レイヤが影響するシェーダポートを指定するために使用されます。

Shaderのテクスチャレイヤコンテナもあり、この場合も同じ関連メソッドのセットを持ちます。

C#構文

スクリプト構文

戻り値

パラメータ

パラメータタイプ説明

Name String 新しいの名前 TextureLayer
デフォルト値："Layer"

After Boolean True の場合は、新しいテクスチャレイヤはリファレンスレイヤの後に挿入されます。 False の場合は、リファレンスレイヤの前に挿入されます。リファレンスレイヤがないときは、True の場合はコンテナのリストの最後に、False の場合はリストの最初に追加されます。
デフォルト値: True

Reference TextureLayerまたはString 新しく追加されたレイヤが配置されるスタック内の位置を示す、リファレンステクスチャレイヤ。レイヤはリファレンスレイヤの前後に挿入されます。指定しない場合には、新しいレイヤはこの後に続く引数に応じて先頭または末尾に追加されます。

例

パラメータ	タイプ	説明
Name	String	新しいの名前 TextureLayer デフォルト値："Layer"
After	Boolean	True の場合は、新しいテクスチャレイヤはリファレンスレイヤの後に挿入されます。 False の場合は、リファレンスレイヤの前に挿入されます。リファレンスレイヤがないときは、True の場合はコンテナのリストの最後に、False の場合はリストの最初に追加されます。デフォルト値: True
Reference	TextureLayerまたはString	新しく追加されたレイヤが配置されるスタック内の位置を示す、リファレンステクスチャレイヤ。レイヤはリファレンスレイヤの前後に挿入されます。指定しない場合には、新しいレイヤはこの後に続く引数に応じて先頭または末尾に追加されます。

1. JScript の例

/*

	This example shows how to create texture layers on

	a material, plus enumerating and removing them.

*/

oRoot = ActiveProject.ActiveScene.Root;

oSph = oRoot.AddGeometry( "Sphere", "MeshSurface" );

oMat = oSph.AddMaterial( "Phong" );

// Add a layer at the end (since there are no others the "After"

// flag is irrelevant).

oLayers = new Array(3);

oLayers[0] = oMat.CreateTextureLayer( "B", true );

// Add another layer before the other one.

oLayers[1] = oMat.CreateTextureLayer( "A", false, oLayers[0] );

// Create a third layer at the very start.

oLayers[2] = oMat.CreateTextureLayer( "base", false );

Application.LogMessage( "Created " + oMat.TextureLayers.Count + " layers." );

for ( i = 0; i < oMat.TextureLayers.Count; i++ )

{

	oLayer = oMat.TextureLayers(i);

	Application.LogMessage( (i+1) + ": " + oLayer );

}

oMat.RemoveTextureLayer( oLayers[1] );

oMat.RemoveTextureLayer( oMat.FullName + "." + oLayers[2].Name );

count = oMat.TextureLayers.Count;

Application.LogMessage( "Only " + count + " remains after removal." );

for ( i = 0; i < count; i++ )

{

	Application.LogMessage( (i+1) + ": " + oMat.TextureLayers.Item(i) );

}

// This example should log something like:

//INFO : "Created 3 layers."

//INFO : "1: sphere.Material.base"

//INFO : "2: sphere.Material.A"

//INFO : "3: sphere.Material.B"

//INFO : "Only 1 remains after removal."

//INFO : "1: sphere.Material.B"

2. VBScript の例

'

' This example shows how to create texture layers on

' a material, plus enumerating and removing them.

'

set oRoot = ActiveProject.ActiveScene.Root

set oSph = oRoot.AddGeometry( "Sphere", "MeshSurface" )

set oMat = oSph.AddMaterial( "Phong" )

' Add a layer at the end (since there are no others the "After"

' flag is irrelevant).

dim oLayers(2)

set oLayers(0) = oMat.CreateTextureLayer( "B", True )

' Add another layer before the other one.

set oLayers(1) = oMat.CreateTextureLayer( "A", False, oLayers(0) )

' Create a third layer at the very start.

set oLayers(2) = oMat.CreateTextureLayer( "base", False )

Application.LogMessage "Created " & oMat.TextureLayers.Count & " layers."

i = 1

for each oLayer in oMat.TextureLayers

	Application.LogMessage i & ": " & oLayer

	i = i + 1

next

oMat.RemoveTextureLayer oLayers(1)

oMat.RemoveTextureLayer oMat.FullName & "." & oLayers(2).Name

count = oMat.TextureLayers.Count

Application.LogMessage "Only " & count & " remains after removal."

for i = 0 to count - 1

	Application.LogMessage i + 1 & ": " & oMat.TextureLayers.Item(i)

next

' This example should log something like:

'INFO : "Created 3 layers."

'INFO : "1: sphere.Material.base"

'INFO : "2: sphere.Material.A"

'INFO : "3: sphere.Material.B"

'INFO : "Only 1 remains after removal."

'INFO : "1: sphere.Material.B"