ToggleReferencedModel

Toggles a model between local and referenced.

If the model is a referenced model it is made local. If the model is a local model, it is converted to referenced.

Scripting Syntax

oReturn = ToggleReferencedModel( Model, [ShowWarnings] );

Return Value

Parameters

Parameter Type Description

Model String Which model to toggle

ShowWarnings Boolean Whether or not to show warnings
Default Value: True

Examples

Parameter	Type	Description
Model	String	Which model to toggle
ShowWarnings	Boolean	Whether or not to show warnings Default Value: True

JScript Example

/*

	This example demonstrates how to make structural changes to a referenced model using ToggleReferencedModel

*/

// Create a referenced model

NewScene( null, false );

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

var mdl = CreateModel()(0);

ConvertToRefModel( mdl, XSIUtils.BuildPath( ActiveProject.Path, "Models", "Model.emdl") );

// Make it local

ToggleReferencedModel(mdl);

// Make some changes

SetValue(mdl+".cube.name","newNameOfCube");

// toggle back to referenced.

ToggleReferencedModel(mdl);

ToggleReferencedModel

Introduced

Description

Scripting Syntax

Return Value

Parameters

Examples

JScript Example

See Also