/*

	This example shows how to traverse a shader tree and list the

	available shader inputs and their input types.

*/

NewScene(null,false);

// Create an object with a texture shader

var root = Application.ActiveProject.ActiveScene.Root;

var model = root.AddModel();

model.name = "MyModel";

var object = model.AddGeometry( "Sphere", "MeshSurface" );

BlendInPresets( "Image", object, 1, false );

CreateProjection( object, siTxtSpherical, siTxtDefaultSpherical, "TxtSupport", "TxtProjection" );

var filename = Application.InstallationPath( siFactoryPath ) + 

	"\\Data\\XSI_SAMPLES\\Pictures\\xsilogo.jpg";

var imageclip = CreateImageClip( filename, "XSILogo" );

// Set up the texture space on texture shader

var mat = object.Material;

var textureshader = object.Material.CurrentTexture;

// Set the texturespace parameter

SetInstanceDataValue(null, textureshader+".tspace_id", "TxtProjection");

textureshader.parameters("tex").Connect(imageclip);

// Select the texture shader

SelectObj("MyModel.sphere.Material.Image");

// Get an object from the selection list

var obj = selection(0);

// Object is a shader

if ( obj.isclassof( siShaderID ) )

{

	// Get the material from shader

	var mat = obj.Root;

	traverse_shadernode(mat);

}

// Expected results:

// INFO : Sources.Materials.DefaultLib.Material.ambient_blend.base_color is free to be connected to a shader that will match input type siColorParameterType

// INFO : Sources.Materials.DefaultLib.Material.Image.repeats is free to be connected to a shader that will match input type siVectorParameterType

// INFO : Sources.Materials.DefaultLib.Material.Image.alt_x is free to be connected to a shader that will match input type siBooleanParameterType

// INFO : Sources.Materials.DefaultLib.Material.Image.alt_y is free to be connected to a shader that will match input type siBooleanParameterType

// INFO : Sources.Materials.DefaultLib.Material.Image.alt_z is free to be connected to a shader that will match input type siBooleanParameterType

// INFO : Sources.Materials.DefaultLib.Material.Image.min is free to be connected to a shader that will match input type siVectorParameterType

// INFO : Sources.Materials.DefaultLib.Material.Image.max is free to be connected to a shader that will match input type siVectorParameterType

// etc.

// Helper functions

function traverse_shadernode( shadernode )

{

	if ( ! shadernode ) { return; }

	if (! ( shadernode.isclassof( siShaderID ) ||

		 shadernode.isclassof( siMaterialID ) || 

		 shadernode.isclassof( siLightID ) || 

		 shadernode.isclassof( siCameraID )) ) 

		{ return; }

	// Traverse the occupied shader inputs

	var eParam = new Enumerator(shadernode.parameters);

	for ( ;!eParam.atEnd(); eParam.moveNext() )

	{

		var param = eParam.item();

		if (param.capabilities & siTexturable)

		{	

			var nextnode = param.source;

			// parameter connected to shader node

			if ( nextnode != null )

				traverse_shadernode( nextnode );

			else // parameter free

			{

				var inputtype = shadernode.GetShaderInputType(param.scriptname);

				LogMessage( param.fullname + " is free to be connected to a shader that will match input type " 

					+ ShaderParameterTypeAsText(inputtype));

			}

		}		

	}

}

function ShaderParameterTypeAsText(type)

{

	switch (type)

	{

		case siUnknownParameterType : return "siUnknownParameterType";			

		case siBooleanParameterType : return "siBooleanParameterType";			

		case siColorParameterType : return "siColorParameterType";			

		case siDataParameterType : return "siDataParameterType";			

		case siIntegerParameterType : return "siIntegerParameterType";			

		case siLensParameterType : return "siLensParameterType";			

		case siLightParameterType : return "siLightParameterType";			

		case siMaterialParameterType : return "siMaterialParameterType";			

		case siMatrixParameterType : return "siMatrixParameterType";			

		case siModelParameterType : return "siModelParameterType";			

		case siRealTimeParameterType : return "siRealTimeParameterType";			

		case siReferenceParameterType : return "siReferenceParameterType";			

		case siScalarParameterType : return "siScalarParameterType";			

		case siShaderParameterType : return "siShaderParameterType";			

		case siStringParameterType : return "siStringParameterType";			

		case siStructParameterType : return "siStructParameterType";			

		case siTextureParameterType : return "siTextureParameterType";			

		case siTextureSpaceParameterType : return "siTextureSpaceParameterType";			

		case siVectorParameterType : return "siVectorParameterType";			

		default: return type;

	}

}