ApplyOp

Introduced

1.0

Description

Applies an operator to one or several objects, returns any objects created by the operator, and opens the newly applied operator's property page. This is a generic command that can apply any type of operator (hair, deform, generator, topology, custom, etc.).

You can also use commands that are specific to the type of operator you are applying. For example, the ApplyGenOp command can be used to apply generator operators (such as the Birail or Loft operators). Some operators have their own commands, such as the HairCombOp which can be applied with the ApplyHairCombOp.

This command supports group-level ConnectionSets only. To specify a port-level ConnectionSet, use the ApplyOperator command instead.

Tip: These type-specific commands often have features that are specialized for the type of operator you are applying. For example, the ApplyGenOp command gives the option of applying the operator in immediate or persistent mode and another option for what to do with the input (original) objects after the new geometry has been generated, whereas this command does not provide those options.

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

    ApplyOp( PresetObj, [ConnectionSet], [ConnectType], [ImmediateMode], [OutputObjs], [ConstructionMode] )

Parameters

Parameter | Type | Description
PresetObj | String or a preset object (for example, an object obtained from SIGetPreset) | An Operator Presets.
ConnectionSet [in/out] | ConnectionSet | Specifies the objects connected to an operator. See Operator Presets for details on the connection set required for this operator. Note: Because this is an in/out parameter, any string (variable or value) you pass into this parameter is automatically converted to a ConnectionSet object. Default Value: Currently selected objects are used as the main group. Warning: An error occurs if the connection set is invalid. Please verify the connection set required for this operator to avoid breaking your scripts.
ConnectType | siBranchFlag | Specifies the type of connection (node or branch). Default Value: siUnspecified
ImmediateMode [in/out] | siOperationMode | Specifies whether or not the operator should be immediately frozen. Default Value: siPersistentOperation
OutputObjs [out] | XSICollection | Returns the primitives created by the operator. For example, Loft creates a primitive surface.
ConstructionMode | siConstructionMode | Specifies in which construction mode the operator will be applied. Default Value: Use the current construction mode

Return Value

Returns an XSICollection that contains a list of the created operators.

Examples

1. VBScript Example

    '
    ' This example illustrates how to create
    ' loft operators
    '

    '
    ' Use Loft to create a surface from 2 curves
    '
    set curve1 = CreatePrim( "Arc", "NurbsCurve" )
    translate curve1, , , 2
    set curve2 = CreatePrim( "Arc", "NurbsCurve" )

    set oplist = ApplyOp( "Loft", curve1 & "," & curve2,,,createdobjects )
    set loftop = oplist(0)

    ' change the subdivision level in U
    setvalue loftop & ".subdivu", 19

    '
    ' Loft onto an existing surface
    '
    set surface = createdobjects(0)
    surface.name = "Surface_created_by_lofting_2_curves"

    set curve1 = CreatePrim( "Arc", "NurbsCurve" )
    translate curve1, , , 2
    set curve2 = CreatePrim( "Arc", "NurbsCurve" )
    set surface = CreatePrim( "Grid", "NurbsSurface", "Loft_into_existing_surface" )

    ' Freeze the surface so that the object can be used to contain a
    ' new lofted surface

    FreezeObj surface
    set oplist = ApplyOp( "Loft", curve1 & "," & curve2 & ";" & surface )
    set surface = oplist(0)
    surface.name = "Surface_created_by_lofting_2_curves"

2. JScript Example

    /*
       Example showing how to retrieve the newly created operator
       when ApplyOp is called on a single object
    */

    // Create primitive
    oCube = activesceneroot.addgeometry( "Cube", "MeshSurface" );

    // Call command to apply a Taper deformer and
    // retrieve the newly created operator
    oColl = ApplyOp( "Taper", oCube, 3, 0, null, 0 ) ;

    // Because there is only 1 input object (oCube)
    // we know there is only one operator created
    var oOp = oColl(0);

    // Modify the Amplitude Parameter
    oOp.ampl = 0.25 ;

3. JScript Example

    // Create empty collection to store objects that
    // we want to apply the operator to
    oInputCollection = XSIFactory.CreateObject( "XSI.Collection" );

    // Create primitive
    oInputCollection.add( activesceneroot.addgeometry( "Cube", "MeshSurface" ) );
    oInputCollection.add( activesceneroot.addgeometry( "Sphere", "MeshSurface" ) );

    // Call command to apply a Taper deformer and populate collection with its return value
    oOps = ApplyOp( "Taper", oInputCollection, 3, 0, null, 0 ) ;

    // Validate result
    for( var i=0; i < oOps.count; i++ )
    {
    // Get operator
    oOp = oOps(i);

    logmessage( oOp.fullname );
    }

    //Expected results:
    //INFO : cube.polymsh.taperop
    //INFO : sphere.polymsh.taperop

See Also

ApplyOperator | ApplyGenOp | ApplyTopoOp | ApplyHairOp
Operator | Generator and Converter Operators | Deform and Assignment Operators | Topology Operators
Simulation Operators | Hair Operators | Fx and Image Operators | Miscellaneous Operators
Alphabetical List of Operators |  |  |

Autodesk Softimage v7.5