## SavePivotKey

### Description

Key frames current values on pivot and pivot compensation parameters of the given S,R,T channels. The fcurves on pivot and pivot compensation have constant interpolation - pivot and pivot compensation require constant values to balance correctly.

### Scripting Syntax

    SavePivotKey( [InputObjs], [Type], [Time] );

### Parameters

Parameter | Type | Description
--- | --- | ---
InputObjs | String | List of objects to key Default Value: Current selection
Type | siTransformFilter | Specifies the type of transformation to reset Default Value: siSRT
Time | Number | Key frames are set at this frame. Default Value: Key frame

### Examples

#### VBScript Example

    '
    ' This example animates rotation and pivot point of a cube,
    ' creating a rolling cube animation.
    '
    CreatePrim "Cube", "MeshSurface"
    SetValue "cube.polymsh.geom.cube.length", 2
    Translate , -5, 1, 0, siAbsolute, siPivot, siObj, siXYZ, , , , , , , , , , 0
    SetValue "Camera.camvis.compobjselcenterpivot", True
    'save initial rotation key, move pivot and save pivot key
    SaveKey "cube.kine.local.rotx,cube.kine.local.roty,cube.kine.local.rotz", 1
    'move pivot and save pivot key at frame 1
    SetValue "cube.kine.local.pposx", 1
    SetValue "cube.kine.local.pposy", -1
    SavePivotKey "cube", siTrn, 1
    Rot90AndKey "cube", 10
    SetValue "cube.kine.local.pposy", 1
    SavePivotKey "cube", siTrn, 10
    Rot90AndKey "cube", 20
    SetValue "cube.kine.local.pposx", -1
    SavePivotKey "cube", siTrn, 20
    Rot90AndKey "cube", 30
    SetValue "cube.kine.local.pposy", -1
    SavePivotKey "cube", siTrn, 30
    Rot90AndKey "cube", 40
    SetValue "cube.kine.local.pposx", 1
    SavePivotKey "cube", siTrn, 40
    Rot90AndKey "cube", 50
    SetValue "cube.kine.local.pposy", 1
    SavePivotKey "cube", siTrn, 50
    Rot90AndKey "cube", 60
    sub Rot90AndKey( obj, in_frame )
            'rotate about pivot point and save rotation key
            SetValue "PlayControl.Key", in_frame
            SetValue "PlayControl.Current", in_frame
            Rotate obj, 0, 0, -90, siRelative, siAdd, siObj, siXYZ, , , , , , , , 0
            SaveKey obj&".kine.local.rotx,"&obj&".kine.local.roty,"&obj&".kine.local.rotz", in_frame
    end sub

### See Also

SaveKey