## GetPrimCamera

### Description

Creates a camera primitive object with an interest.
Note: This command uses output arguments. C# and some scripting languages (such as JScript, PerlScript and Python) don't support arguments passed by reference. Normally you can get the output arguments via either XSIApplication.ExecuteCommand method (C#) or the ISIVTCollection (scripting languages), but this command already returns a value.
The only available workaround in this case is to create a VBScript custom command which returns both the output arguments and the return value in one array. For details, see What Happens when the Function Already Returns a Value?.

### Scripting Syntax

    oReturn = GetPrimCamera( PresetObj, [Name], [Parent], [Primitive], [3DObjCamera], [3DObjCameraInterest] );

### Return Value

Returns the camera root (a CameraRig object).

### Parameters

Parameter | Type | Description
--- | --- | ---
PresetObj | String or a preset object (see SIGetPreset) | Any preset for Camera Primitives
Name | String | Name of the camera.
Parent | String | Parent object for the camera.
Primitive | Primitive | Returns the camera primitive.
3DObjCamera | Camera | Returns the camera object.
3DObjCameraInterest | Null | Returns the camera interest object.

### Examples

#### VBScript Example

    GetPrimCamera "Camera", "MyCameraName"
    dim root, prim, cam, interest
    set root = GetPrimCamera( "Camera", "Bob",, prim, cam, interest )
    logmessage "root = " & root
    logmessage "prim = " & prim
    logmessage "cam  = " & cam
    if Not TypeName (interest) = "Nothing" then
            logmessage "int  = " & interest
    end if

### See Also

SIGetPrimCamera