## ToggleReferencedModel

### Introduced

v6.0

### Description

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

Nothing

### Parameters

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

### Examples

#### 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);

### See Also

ConvertToRefModel MakeModelLocal