## SetEnvelopeRefPoses

### Introduced

v1.0

### Description

Set new values for Envelope deformer objects' reference poses. After an envelope has been assigned, you can change the reference pose of the envelope.
The reference pose is the stance that the envelope and its deformers return to when you use the Reset Actor command. It is also the pose that determines the initial weighting of points to deformers based on proximity.

### Scripting Syntax

    oReturn = SetEnvelopeRefPoses( [InputObjs] );

### Return Value

Returns the new envelope deformer objects.

### Parameters

Parameter | Type | Description
--- | --- | ---
InputObjs | String | List of envelope deformer objects Default Value: Current selection

### Examples

#### VBScript Example

    '
    ' This example sets a new reference pose on a null object used
    ' as a deformer for a sphere.
    '
    NewScene , false
    ' Create the null to use as a deformer
    set oDeformer = GetPrim("Null")
    ' Create the sphere to deform
    set oEnvelope = CreatePrim( "Sphere", "NurbsSurface" )
    ' Assign the deformer to the envelope
    ApplyFlexEnv oEnvelope & ";" & oDeformer, False
    ' Change the position of the deformer so that we have a different
    ' position to use as the new reference pose
    Translate oDeformer, 3.21404651141284, 2.8656647389832, _
                    -0.28656647389832, siRelative, siView, siObj, siXYZ
    ' Set new values for the envelope's ref poses
    SetEnvelopeRefPoses oDeformer
    ' Move the deformer around. Once you use ResetActor, the sphere
    ' and null will snap back to the new reference pose
    'ResetActor

### See Also

SIApplyFlexEnv