## SIConvert

### Description

Converts an implicit primitive to a geometry type.
Warning: The implicit primitives must be compatible with the geometry types.
Note: This command uses output arguments. C# and some scripting languages (such as JScript, PerlScript and Python) don't support arguments passed by reference. However, this command also returns an XSICollection containing the output arguments.

### Scripting Syntax

    oReturn = SIConvert( Target, Source, CreatedObj, OutputObj );

### Return Value

Returns an XSICollection that contains the created converter Operator and the newly created geometric Primitive object wrapped in an XSICollection.

### Parameters

Parameter | Type | Description
--- | --- | ---
Target | String | name of the output geometry
Possible Values: | Description:
MeshSurface | Mesh surface geometry
NurbsSurface | Nurbs curve geometry
NurbsCurve | Nurbs curve geometry
Glyphs | Output geometry type for use with implicit text
Source | String | Object to convert
CreatedObj | Operator | Returns the converter operator
OutputObj | XSICollection containing the Primitive | Returns the primitive.

### Examples

#### VBScript Example

    ' This example shows how to convert an implicit sphere to a mesh sphere

    NewScene , false

    dim lCreated, oImplicitSphere

    ' Create implicit sphere

    set oImplicitSphere = GetPrim("Sphere")

    ' Implicit sphere becomes a mesh.

    ' SIConvert returns more information than Convert.

    ' The return collection is consulted instead of the return parameters

    ' because it is more scripting language neutral.

    set lCreated = SIConvert( "MeshSurface", oImplicitSphere )

    'Log the following information:

    'INFO : "2 elements in collection."

    'INFO : "First object is an Operator"

    'INFO : "Second object is an Object"

    LogMessage lCreated.Count & " elements in collection."

    LogMessage "First object is an " & typename( lCreated(0))

    LogMessage "Second object is an " & typename( lCreated(1))

### See Also

Convert