Offset an animation fcurve in python?

Question

I want to offset an entire range of keyframes (all) in an individual animation fcurve using python. Is there an operator or function that will do this without needing to iterate through the keyframes individually - basically like performing a move command in the graph editor (G Y, 10)? More specifically, I would like to apply an object's Delta Transforms into its current animation in a python script.

Answer 1

Move All keyframe_points for a object

import bpy

def move_kp(obj, dx):
    anim_data           = obj.animation_data
    if not anim_data:   return

    action              = anim_data.action
    if not action:      return

    for fc in action.fcurves:
        for kp in fc.keyframe_points:
            kp.co[0]            += dx
            kp.handle_left[0]   += dx
            kp.handle_right[0]  += dx

move_kp(bpy.context.object, 10)

There have a api function to move keypoint

But only work on special cases

bpy.ops.transform.translate(value=(10, 0, 0), orient_type='GLOBAL', orient_matrix=((1, 0, 0), (0, 1, 0), (0, 0, 1)), orient_matrix_type='GLOBAL', constraint_axis=(True, True, True), mirror=True, use_proportional_edit=False, proportional_edit_falloff='SMOOTH', proportional_size=1, use_proportional_connected=False, use_proportional_projected=False)

Answer 2

In response to your comment to your question, here's an example, using an operator override, to move every fcurve 3 units on the X axis:

def get_override(area_type, region_type):
    for area in bpy.context.screen.areas: 
        if area.type == area_type:             
            for region in area.regions:                 
                if region.type == region_type:                    
                    override = {'area': area, 'region': region} 
                    return override
    raise RuntimeError("Wasn't able to find", region_type," in area ", area_type,
                        "\n Make sure it's open while executing script.")


override = get_override( 'GRAPH_EDITOR', 'WINDOW' )

bpy.ops.graph.select_all(override)
bpy.ops.transform.translate(override, value=(3, 0, 0))

What you need to do is replace the select_all call with code that selects only the F-Curve you want to modify, as the transform op operates on all selected curves.

This will only work if you do have a graph editor window open.

Here is the manual entry with details on overriding context if you need more information.

3.2 Update

Context overrides are deprecated in Blender 3.2 and are scheduled to be removed in Blender 3.3 The replacement is temp_override. The manual has examples of how to use the new function.