Softimage SDK Programmer's Guide > C++ API Development > Programming with the C++ API > Calling Commands from C++ >

# Accessing Return Values

To get at the value returned from a command, you convert it from the returned . Ror example, the AddImageSource command returns a Source object representing the new image source:

    Application app;
    CValue retVal;CValueArray inArgs(2);
    inArgs[0]= CValue();// default: prompts user for location
    inArgs[1]= L"MyNewImgSrc";
    app.ExecuteCommand( L"AddImageSource", inArgs, retVal );

    // The new image source can be extracted from the returned CValue
    Source sph( retVal );

    app.LogMessage( sph.GetFullName() );

    /* The following is logged to history:
    //INFO : Sources.MyNewImgSrc
    */

Getting Multiple Return Values from a Command

If the command returns a collection you can convert it to a CValueArray and then cast each member to its proper class. This example demonstrates how to apply an orientation constraint to two objects using the SIApplyCns command which then returns a constraint collection containing the two new constraints:

    Application app;
    Model root = app.GetActiveSceneRoot();

    // Create a cone and 2 cubes
    X3DObject cone; root.AddGeometry( L"Cone", L"MeshSurface", L"MyCone", cone );
    X3DObject cube1; root.AddGeometry( L"Cube", L"MeshSurface", L"MyCube1", cube1 );
    X3DObject cube2; root.AddGeometry( L"Cube", L"MeshSurface", L"MyCube2", cube2 );

    CValue retVal;
    CValueArray inArgs(4);
    inArgs[0] = L"Orientation";
    inArgs[1] = cube1.GetFullName() + L"," + cube2.GetFullName();
    inArgs[2] = cone.GetFullName();
    inArgs[3] = CValue(); // default: false
    app.ExecuteCommand( L"SIApplyCns", inArgs, retVal );

    // The new constraints can be extracted from the returned CValue
    CValueArray cnslist( retVal );
    for ( LONG i=0; i<cnslist.GetCount(); ++i ) {
    	Constraint cns( cnslist[i] );
    	app.LogMessage( cns.GetFullName() );
    }

    /* The following is logged to history:
    //INFO : MyCube1.kine.oricns
    //INFO : MyCube2.kine.oricns
    */