/*

	This example demonstrates how to create a completely bogus shader 

	definition on the fly (ie., not to be persisted), instantiate it 

	on a scene object, and then remove it.

*/

NewScene("", false);

// First check to make sure the parser name isn't already registered

// Create the shader definition on the fly and get its ProgID

var sProgID = CreateDefOnTheFly();

// Now create a cube and instantiate this shader on it

var oCube = CreatePrim("Cube", "MeshSurface");

CreateShaderFromProgID(sProgID, "Sources.Materials.DefaultLib.Scene_Material");

SIConnectShaderToCnxPoint("Sources.Materials.DefaultLib.Scene_Material.Chauncey.splish", 

	"Sources.Materials.DefaultLib.Scene_Material.Phong.ambient", false);

// List all the on-the-fly shader definitions found

FindOnTheFlyDefs();

// Now remove it

var oRemoveMe = Application.ShaderDefinitions(sProgID);

if (oRemoveMe) {

	XSIFactory.RemoveShaderDef(oRemoveMe);

	// List any remaining on-the-fly shader definitions 

	FindOnTheFlyDefs();

} else {

	Application.LogMessage("Couldn't find "+sProgID+" shader definition");

}

// Expected output:

// INFO : Found 2 on-the-fly definition(s): RendererUserPorts.mental ray.1.0, Gardiner.Chauncey.1.0

// INFO : Found 1 on-the-fly definition(s): RendererUserPorts.mental ray.1.0

// This function demonstrates how to find a a list of on-the-fly shader definitions 

function FindOnTheFlyDefs ()

{

	var aOTFDefs = new Array();

	var e = new Enumerator(Application.ShaderDefinitions);

	for (; !e.atEnd(); e.moveNext()) {

		var oMaybe = e.item();

		if (oMaybe.ParserBased && !oMaybe.DefinitionPath) {

			aOTFDefs.push(oMaybe);

		}

	}

	// Write out results

	if (aOTFDefs.length) {

		Application.LogMessage("Found "+aOTFDefs.length+" on-the-fly definition(s): "+aOTFDefs.join(", "));

	} else {

		Application.LogMessage("No on-the-fly definitions found");

	}

}

// This function creates a bogus shader definition on the fly and returns its ProgID

function CreateDefOnTheFly () 

{

	var otmpShaderDef = XSIFactory.CreateShaderDef("Gardiner", "Chauncey", 1, 0);

	otmpShaderDef.Category = "Test Shaders";

	// family

	otmpShaderDef.AddShaderFamily("mrTexture");

	// paramdef options (in)

	var otmpShadPDefOpts = XSIFactory.CreateShaderParamDefOptions();

	otmpShadPDefOpts.SetTexturable(true);

	otmpShadPDefOpts.SetShortName("squelch");

	// paramdef (in)

	var otmpInParams = otmpShaderDef.InputParamDefs;

	otmpInParams.AddParamDef("squerch", siColorParameterType, otmpShadPDefOpts);

	// paramdef options (out)

	otmpShadPDefOpts = XSIFactory.CreateShaderParamDefOptions();

	otmpShadPDefOpts.SetTexturable(true);

	otmpShadPDefOpts.SetShortName("splosh");

	// paramdef (out)

	var otmpOutParams = otmpShaderDef.OutputParamDefs;

	otmpOutParams.AddParamDef("splish", siColorParameterType, otmpShadPDefOpts);

	// renderer

	var otmpRendDef = otmpShaderDef.AddRendererDef("whoops");

	otmpRendOpts = otmpRendDef.RendererOptions;

	otmpRendOpts.Set("plain", false);

	// attributes

	var otmpAttrs = otmpShaderDef.Attributes;

	otmpAttrs.Set("chuckle", "on");

	otmpAttrs.Set("nbr", 456123);

	// return the ProgID of the new shader

	return otmpShaderDef.ProgID;

}