Transform Operators

bpy.ops.transform.bend(value=(0.0), mirror=False, proportional='DISABLED', proportional_edit_falloff='SMOOTH', proportional_size=1.0, snap=False, snap_target='CLOSEST', snap_point=(0.0, 0.0, 0.0), snap_align=False, snap_normal=(0.0, 0.0, 0.0), gpencil_strokes=False, release_confirm=False)

Bend selected items between the 3D cursor and the mouse

Parameters:
  • value (float array of 1 items in [-inf, inf], (optional)) – Angle
  • mirror (boolean, (optional)) – Mirror Editing
  • proportional (enum in [‘DISABLED’, ‘ENABLED’, ‘PROJECTED’, ‘CONNECTED’], (optional)) –

    Proportional Editing

    • DISABLED Disable, Proportional Editing disabled.
    • ENABLED Enable, Proportional Editing enabled.
    • PROJECTED Projected (2D), Proportional Editing using screen space locations.
    • CONNECTED Connected, Proportional Editing using connected geometry only.
  • proportional_edit_falloff (enum in [‘SMOOTH’, ‘SPHERE’, ‘ROOT’, ‘INVERSE_SQUARE’, ‘SHARP’, ‘LINEAR’, ‘CONSTANT’, ‘RANDOM’], (optional)) –

    Proportional Editing Falloff, Falloff type for proportional editing mode

    • SMOOTH Smooth, Smooth falloff.
    • SPHERE Sphere, Spherical falloff.
    • ROOT Root, Root falloff.
    • INVERSE_SQUARE Inverse Square, Inverse Square falloff.
    • SHARP Sharp, Sharp falloff.
    • LINEAR Linear, Linear falloff.
    • CONSTANT Constant, Constant falloff.
    • RANDOM Random, Random falloff.
  • proportional_size (float in [1e-05, inf], (optional)) – Proportional Size
  • snap (boolean, (optional)) – Use Snapping Options
  • snap_target (enum in [‘CLOSEST’, ‘CENTER’, ‘MEDIAN’, ‘ACTIVE’], (optional)) –

    Target

    • CLOSEST Closest, Snap closest point onto target.
    • CENTER Center, Snap center onto target.
    • MEDIAN Median, Snap median onto target.
    • ACTIVE Active, Snap active onto target.
  • snap_point (float array of 3 items in [-inf, inf], (optional)) – Point
  • snap_align (boolean, (optional)) – Align with Point Normal
  • snap_normal (float array of 3 items in [-inf, inf], (optional)) – Normal
  • gpencil_strokes (boolean, (optional)) – Edit Grease Pencil, Edit selected Grease Pencil strokes
  • release_confirm (boolean, (optional)) – Confirm on Release, Always confirm operation when releasing button
bpy.ops.transform.create_orientation(name="", use_view=False, use=False, overwrite=False)

Create transformation orientation from selection

Parameters:
  • name (string, (optional, never None)) – Name, Name of the new custom orientation
  • use_view (boolean, (optional)) – Use View, Use the current view instead of the active object to create the new orientation
  • use (boolean, (optional)) – Use after creation, Select orientation after its creation
  • overwrite (boolean, (optional)) – Overwrite previous, Overwrite previously created orientation with same name
bpy.ops.transform.delete_orientation()

Delete transformation orientation

bpy.ops.transform.edge_bevelweight(value=0.0, snap=False, snap_target='CLOSEST', snap_point=(0.0, 0.0, 0.0), snap_align=False, snap_normal=(0.0, 0.0, 0.0), release_confirm=False)

Change the bevel weight of edges

Parameters:
  • value (float in [-1, 1], (optional)) – Factor
  • snap (boolean, (optional)) – Use Snapping Options
  • snap_target (enum in [‘CLOSEST’, ‘CENTER’, ‘MEDIAN’, ‘ACTIVE’], (optional)) –

    Target

    • CLOSEST Closest, Snap closest point onto target.
    • CENTER Center, Snap center onto target.
    • MEDIAN Median, Snap median onto target.
    • ACTIVE Active, Snap active onto target.
  • snap_point (float array of 3 items in [-inf, inf], (optional)) – Point
  • snap_align (boolean, (optional)) – Align with Point Normal
  • snap_normal (float array of 3 items in [-inf, inf], (optional)) – Normal
  • release_confirm (boolean, (optional)) – Confirm on Release, Always confirm operation when releasing button
bpy.ops.transform.edge_crease(value=0.0, snap=False, snap_target='CLOSEST', snap_point=(0.0, 0.0, 0.0), snap_align=False, snap_normal=(0.0, 0.0, 0.0), release_confirm=False)

Change the crease of edges

Parameters:
  • value (float in [-1, 1], (optional)) – Factor
  • snap (boolean, (optional)) – Use Snapping Options
  • snap_target (enum in [‘CLOSEST’, ‘CENTER’, ‘MEDIAN’, ‘ACTIVE’], (optional)) –

    Target

    • CLOSEST Closest, Snap closest point onto target.
    • CENTER Center, Snap center onto target.
    • MEDIAN Median, Snap median onto target.
    • ACTIVE Active, Snap active onto target.
  • snap_point (float array of 3 items in [-inf, inf], (optional)) – Point
  • snap_align (boolean, (optional)) – Align with Point Normal
  • snap_normal (float array of 3 items in [-inf, inf], (optional)) – Normal
  • release_confirm (boolean, (optional)) – Confirm on Release, Always confirm operation when releasing button
bpy.ops.transform.edge_slide(value=0.0, mirror=False, snap=False, snap_target='CLOSEST', snap_point=(0.0, 0.0, 0.0), snap_align=False, snap_normal=(0.0, 0.0, 0.0), correct_uv=False, release_confirm=False)

Slide an edge loop along a mesh

Parameters:
  • value (float in [-1, 1], (optional)) – Factor
  • mirror (boolean, (optional)) – Mirror Editing
  • snap (boolean, (optional)) – Use Snapping Options
  • snap_target (enum in [‘CLOSEST’, ‘CENTER’, ‘MEDIAN’, ‘ACTIVE’], (optional)) –

    Target

    • CLOSEST Closest, Snap closest point onto target.
    • CENTER Center, Snap center onto target.
    • MEDIAN Median, Snap median onto target.
    • ACTIVE Active, Snap active onto target.
  • snap_point (float array of 3 items in [-inf, inf], (optional)) – Point
  • snap_align (boolean, (optional)) – Align with Point Normal
  • snap_normal (float array of 3 items in [-inf, inf], (optional)) – Normal
  • correct_uv (boolean, (optional)) – Correct UVs, Correct UV coordinates when transforming
  • release_confirm (boolean, (optional)) – Confirm on Release, Always confirm operation when releasing button
bpy.ops.transform.mirror(constraint_axis=(False, False, False), constraint_orientation='GLOBAL', proportional='DISABLED', proportional_edit_falloff='SMOOTH', proportional_size=1.0, gpencil_strokes=False, release_confirm=False)

Mirror selected vertices around one or more axes

Parameters:
  • constraint_axis (boolean array of 3 items, (optional)) – Constraint Axis
  • constraint_orientation (enum in [], (optional)) – Orientation, Transformation orientation
  • proportional (enum in [‘DISABLED’, ‘ENABLED’, ‘PROJECTED’, ‘CONNECTED’], (optional)) –

    Proportional Editing

    • DISABLED Disable, Proportional Editing disabled.
    • ENABLED Enable, Proportional Editing enabled.
    • PROJECTED Projected (2D), Proportional Editing using screen space locations.
    • CONNECTED Connected, Proportional Editing using connected geometry only.
  • proportional_edit_falloff (enum in [‘SMOOTH’, ‘SPHERE’, ‘ROOT’, ‘INVERSE_SQUARE’, ‘SHARP’, ‘LINEAR’, ‘CONSTANT’, ‘RANDOM’], (optional)) –

    Proportional Editing Falloff, Falloff type for proportional editing mode

    • SMOOTH Smooth, Smooth falloff.
    • SPHERE Sphere, Spherical falloff.
    • ROOT Root, Root falloff.
    • INVERSE_SQUARE Inverse Square, Inverse Square falloff.
    • SHARP Sharp, Sharp falloff.
    • LINEAR Linear, Linear falloff.
    • CONSTANT Constant, Constant falloff.
    • RANDOM Random, Random falloff.
  • proportional_size (float in [1e-05, inf], (optional)) – Proportional Size
  • gpencil_strokes (boolean, (optional)) – Edit Grease Pencil, Edit selected Grease Pencil strokes
  • release_confirm (boolean, (optional)) – Confirm on Release, Always confirm operation when releasing button
bpy.ops.transform.push_pull(value=0.0, mirror=False, proportional='DISABLED', proportional_edit_falloff='SMOOTH', proportional_size=1.0, snap=False, snap_target='CLOSEST', snap_point=(0.0, 0.0, 0.0), snap_align=False, snap_normal=(0.0, 0.0, 0.0), release_confirm=False)

Push/Pull selected items

Parameters:
  • value (float in [-inf, inf], (optional)) – Distance
  • mirror (boolean, (optional)) – Mirror Editing
  • proportional (enum in [‘DISABLED’, ‘ENABLED’, ‘PROJECTED’, ‘CONNECTED’], (optional)) –

    Proportional Editing

    • DISABLED Disable, Proportional Editing disabled.
    • ENABLED Enable, Proportional Editing enabled.
    • PROJECTED Projected (2D), Proportional Editing using screen space locations.
    • CONNECTED Connected, Proportional Editing using connected geometry only.
  • proportional_edit_falloff (enum in [‘SMOOTH’, ‘SPHERE’, ‘ROOT’, ‘INVERSE_SQUARE’, ‘SHARP’, ‘LINEAR’, ‘CONSTANT’, ‘RANDOM’], (optional)) –

    Proportional Editing Falloff, Falloff type for proportional editing mode

    • SMOOTH Smooth, Smooth falloff.
    • SPHERE Sphere, Spherical falloff.
    • ROOT Root, Root falloff.
    • INVERSE_SQUARE Inverse Square, Inverse Square falloff.
    • SHARP Sharp, Sharp falloff.
    • LINEAR Linear, Linear falloff.
    • CONSTANT Constant, Constant falloff.
    • RANDOM Random, Random falloff.
  • proportional_size (float in [1e-05, inf], (optional)) – Proportional Size
  • snap (boolean, (optional)) – Use Snapping Options
  • snap_target (enum in [‘CLOSEST’, ‘CENTER’, ‘MEDIAN’, ‘ACTIVE’], (optional)) –

    Target

    • CLOSEST Closest, Snap closest point onto target.
    • CENTER Center, Snap center onto target.
    • MEDIAN Median, Snap median onto target.
    • ACTIVE Active, Snap active onto target.
  • snap_point (float array of 3 items in [-inf, inf], (optional)) – Point
  • snap_align (boolean, (optional)) – Align with Point Normal
  • snap_normal (float array of 3 items in [-inf, inf], (optional)) – Normal
  • release_confirm (boolean, (optional)) – Confirm on Release, Always confirm operation when releasing button
bpy.ops.transform.resize(value=(1.0, 1.0, 1.0), constraint_axis=(False, False, False), constraint_orientation='GLOBAL', mirror=False, proportional='DISABLED', proportional_edit_falloff='SMOOTH', proportional_size=1.0, snap=False, snap_target='CLOSEST', snap_point=(0.0, 0.0, 0.0), snap_align=False, snap_normal=(0.0, 0.0, 0.0), gpencil_strokes=False, texture_space=False, remove_on_cancel=False, release_confirm=False)

Scale (resize) selected items

Parameters:
  • value (float array of 3 items in [-inf, inf], (optional)) – Vector
  • constraint_axis (boolean array of 3 items, (optional)) – Constraint Axis
  • constraint_orientation (enum in [], (optional)) – Orientation, Transformation orientation
  • mirror (boolean, (optional)) – Mirror Editing
  • proportional (enum in [‘DISABLED’, ‘ENABLED’, ‘PROJECTED’, ‘CONNECTED’], (optional)) –

    Proportional Editing

    • DISABLED Disable, Proportional Editing disabled.
    • ENABLED Enable, Proportional Editing enabled.
    • PROJECTED Projected (2D), Proportional Editing using screen space locations.
    • CONNECTED Connected, Proportional Editing using connected geometry only.
  • proportional_edit_falloff (enum in [‘SMOOTH’, ‘SPHERE’, ‘ROOT’, ‘INVERSE_SQUARE’, ‘SHARP’, ‘LINEAR’, ‘CONSTANT’, ‘RANDOM’], (optional)) –

    Proportional Editing Falloff, Falloff type for proportional editing mode

    • SMOOTH Smooth, Smooth falloff.
    • SPHERE Sphere, Spherical falloff.
    • ROOT Root, Root falloff.
    • INVERSE_SQUARE Inverse Square, Inverse Square falloff.
    • SHARP Sharp, Sharp falloff.
    • LINEAR Linear, Linear falloff.
    • CONSTANT Constant, Constant falloff.
    • RANDOM Random, Random falloff.
  • proportional_size (float in [1e-05, inf], (optional)) – Proportional Size
  • snap (boolean, (optional)) – Use Snapping Options
  • snap_target (enum in [‘CLOSEST’, ‘CENTER’, ‘MEDIAN’, ‘ACTIVE’], (optional)) –

    Target

    • CLOSEST Closest, Snap closest point onto target.
    • CENTER Center, Snap center onto target.
    • MEDIAN Median, Snap median onto target.
    • ACTIVE Active, Snap active onto target.
  • snap_point (float array of 3 items in [-inf, inf], (optional)) – Point
  • snap_align (boolean, (optional)) – Align with Point Normal
  • snap_normal (float array of 3 items in [-inf, inf], (optional)) – Normal
  • gpencil_strokes (boolean, (optional)) – Edit Grease Pencil, Edit selected Grease Pencil strokes
  • texture_space (boolean, (optional)) – Edit Texture Space, Edit Object data texture space
  • remove_on_cancel (boolean, (optional)) – Remove on Cancel, Remove elements on cancel
  • release_confirm (boolean, (optional)) – Confirm on Release, Always confirm operation when releasing button
bpy.ops.transform.rotate(value=0.0, axis=(0.0, 0.0, 0.0), constraint_axis=(False, False, False), constraint_orientation='GLOBAL', mirror=False, proportional='DISABLED', proportional_edit_falloff='SMOOTH', proportional_size=1.0, snap=False, snap_target='CLOSEST', snap_point=(0.0, 0.0, 0.0), snap_align=False, snap_normal=(0.0, 0.0, 0.0), gpencil_strokes=False, release_confirm=False)

Rotate selected items

Parameters:
  • value (float in [-inf, inf], (optional)) – Angle
  • axis (float array of 3 items in [-inf, inf], (optional)) – Axis, The axis around which the transformation occurs
  • constraint_axis (boolean array of 3 items, (optional)) – Constraint Axis
  • constraint_orientation (enum in [], (optional)) – Orientation, Transformation orientation
  • mirror (boolean, (optional)) – Mirror Editing
  • proportional (enum in [‘DISABLED’, ‘ENABLED’, ‘PROJECTED’, ‘CONNECTED’], (optional)) –

    Proportional Editing

    • DISABLED Disable, Proportional Editing disabled.
    • ENABLED Enable, Proportional Editing enabled.
    • PROJECTED Projected (2D), Proportional Editing using screen space locations.
    • CONNECTED Connected, Proportional Editing using connected geometry only.
  • proportional_edit_falloff (enum in [‘SMOOTH’, ‘SPHERE’, ‘ROOT’, ‘INVERSE_SQUARE’, ‘SHARP’, ‘LINEAR’, ‘CONSTANT’, ‘RANDOM’], (optional)) –

    Proportional Editing Falloff, Falloff type for proportional editing mode

    • SMOOTH Smooth, Smooth falloff.
    • SPHERE Sphere, Spherical falloff.
    • ROOT Root, Root falloff.
    • INVERSE_SQUARE Inverse Square, Inverse Square falloff.
    • SHARP Sharp, Sharp falloff.
    • LINEAR Linear, Linear falloff.
    • CONSTANT Constant, Constant falloff.
    • RANDOM Random, Random falloff.
  • proportional_size (float in [1e-05, inf], (optional)) – Proportional Size
  • snap (boolean, (optional)) – Use Snapping Options
  • snap_target (enum in [‘CLOSEST’, ‘CENTER’, ‘MEDIAN’, ‘ACTIVE’], (optional)) –

    Target

    • CLOSEST Closest, Snap closest point onto target.
    • CENTER Center, Snap center onto target.
    • MEDIAN Median, Snap median onto target.
    • ACTIVE Active, Snap active onto target.
  • snap_point (float array of 3 items in [-inf, inf], (optional)) – Point
  • snap_align (boolean, (optional)) – Align with Point Normal
  • snap_normal (float array of 3 items in [-inf, inf], (optional)) – Normal
  • gpencil_strokes (boolean, (optional)) – Edit Grease Pencil, Edit selected Grease Pencil strokes
  • release_confirm (boolean, (optional)) – Confirm on Release, Always confirm operation when releasing button
bpy.ops.transform.select_orientation(orientation='GLOBAL')

Select transformation orientation

Parameters:orientation (enum in [], (optional)) – Orientation, Transformation orientation
bpy.ops.transform.seq_slide(value=(0.0, 0.0), snap=False, snap_target='CLOSEST', snap_point=(0.0, 0.0, 0.0), snap_align=False, snap_normal=(0.0, 0.0, 0.0), release_confirm=False)

Slide a sequence strip in time

Parameters:
  • value (float array of 2 items in [-inf, inf], (optional)) – Vector
  • snap (boolean, (optional)) – Use Snapping Options
  • snap_target (enum in [‘CLOSEST’, ‘CENTER’, ‘MEDIAN’, ‘ACTIVE’], (optional)) –

    Target

    • CLOSEST Closest, Snap closest point onto target.
    • CENTER Center, Snap center onto target.
    • MEDIAN Median, Snap median onto target.
    • ACTIVE Active, Snap active onto target.
  • snap_point (float array of 3 items in [-inf, inf], (optional)) – Point
  • snap_align (boolean, (optional)) – Align with Point Normal
  • snap_normal (float array of 3 items in [-inf, inf], (optional)) – Normal
  • release_confirm (boolean, (optional)) – Confirm on Release, Always confirm operation when releasing button
bpy.ops.transform.shear(value=0.0, mirror=False, proportional='DISABLED', proportional_edit_falloff='SMOOTH', proportional_size=1.0, snap=False, snap_target='CLOSEST', snap_point=(0.0, 0.0, 0.0), snap_align=False, snap_normal=(0.0, 0.0, 0.0), gpencil_strokes=False, release_confirm=False)

Shear selected items along the horizontal screen axis

Parameters:
  • value (float in [-inf, inf], (optional)) – Offset
  • mirror (boolean, (optional)) – Mirror Editing
  • proportional (enum in [‘DISABLED’, ‘ENABLED’, ‘PROJECTED’, ‘CONNECTED’], (optional)) –

    Proportional Editing

    • DISABLED Disable, Proportional Editing disabled.
    • ENABLED Enable, Proportional Editing enabled.
    • PROJECTED Projected (2D), Proportional Editing using screen space locations.
    • CONNECTED Connected, Proportional Editing using connected geometry only.
  • proportional_edit_falloff (enum in [‘SMOOTH’, ‘SPHERE’, ‘ROOT’, ‘INVERSE_SQUARE’, ‘SHARP’, ‘LINEAR’, ‘CONSTANT’, ‘RANDOM’], (optional)) –

    Proportional Editing Falloff, Falloff type for proportional editing mode

    • SMOOTH Smooth, Smooth falloff.
    • SPHERE Sphere, Spherical falloff.
    • ROOT Root, Root falloff.
    • INVERSE_SQUARE Inverse Square, Inverse Square falloff.
    • SHARP Sharp, Sharp falloff.
    • LINEAR Linear, Linear falloff.
    • CONSTANT Constant, Constant falloff.
    • RANDOM Random, Random falloff.
  • proportional_size (float in [1e-05, inf], (optional)) – Proportional Size
  • snap (boolean, (optional)) – Use Snapping Options
  • snap_target (enum in [‘CLOSEST’, ‘CENTER’, ‘MEDIAN’, ‘ACTIVE’], (optional)) –

    Target

    • CLOSEST Closest, Snap closest point onto target.
    • CENTER Center, Snap center onto target.
    • MEDIAN Median, Snap median onto target.
    • ACTIVE Active, Snap active onto target.
  • snap_point (float array of 3 items in [-inf, inf], (optional)) – Point
  • snap_align (boolean, (optional)) – Align with Point Normal
  • snap_normal (float array of 3 items in [-inf, inf], (optional)) – Normal
  • gpencil_strokes (boolean, (optional)) – Edit Grease Pencil, Edit selected Grease Pencil strokes
  • release_confirm (boolean, (optional)) – Confirm on Release, Always confirm operation when releasing button
bpy.ops.transform.shrink_fatten(value=0.0, mirror=False, proportional='DISABLED', proportional_edit_falloff='SMOOTH', proportional_size=1.0, snap=False, snap_target='CLOSEST', snap_point=(0.0, 0.0, 0.0), snap_align=False, snap_normal=(0.0, 0.0, 0.0), release_confirm=False)

Shrink/fatten selected vertices along normals

Parameters:
  • value (float in [-inf, inf], (optional)) – Offset
  • mirror (boolean, (optional)) – Mirror Editing
  • proportional (enum in [‘DISABLED’, ‘ENABLED’, ‘PROJECTED’, ‘CONNECTED’], (optional)) –

    Proportional Editing

    • DISABLED Disable, Proportional Editing disabled.
    • ENABLED Enable, Proportional Editing enabled.
    • PROJECTED Projected (2D), Proportional Editing using screen space locations.
    • CONNECTED Connected, Proportional Editing using connected geometry only.
  • proportional_edit_falloff (enum in [‘SMOOTH’, ‘SPHERE’, ‘ROOT’, ‘INVERSE_SQUARE’, ‘SHARP’, ‘LINEAR’, ‘CONSTANT’, ‘RANDOM’], (optional)) –

    Proportional Editing Falloff, Falloff type for proportional editing mode

    • SMOOTH Smooth, Smooth falloff.
    • SPHERE Sphere, Spherical falloff.
    • ROOT Root, Root falloff.
    • INVERSE_SQUARE Inverse Square, Inverse Square falloff.
    • SHARP Sharp, Sharp falloff.
    • LINEAR Linear, Linear falloff.
    • CONSTANT Constant, Constant falloff.
    • RANDOM Random, Random falloff.
  • proportional_size (float in [1e-05, inf], (optional)) – Proportional Size
  • snap (boolean, (optional)) – Use Snapping Options
  • snap_target (enum in [‘CLOSEST’, ‘CENTER’, ‘MEDIAN’, ‘ACTIVE’], (optional)) –

    Target

    • CLOSEST Closest, Snap closest point onto target.
    • CENTER Center, Snap center onto target.
    • MEDIAN Median, Snap median onto target.
    • ACTIVE Active, Snap active onto target.
  • snap_point (float array of 3 items in [-inf, inf], (optional)) – Point
  • snap_align (boolean, (optional)) – Align with Point Normal
  • snap_normal (float array of 3 items in [-inf, inf], (optional)) – Normal
  • release_confirm (boolean, (optional)) – Confirm on Release, Always confirm operation when releasing button
bpy.ops.transform.skin_resize(value=(1.0, 1.0, 1.0), constraint_axis=(False, False, False), constraint_orientation='GLOBAL', mirror=False, proportional='DISABLED', proportional_edit_falloff='SMOOTH', proportional_size=1.0, snap=False, snap_target='CLOSEST', snap_point=(0.0, 0.0, 0.0), snap_align=False, snap_normal=(0.0, 0.0, 0.0), release_confirm=False)

Scale selected vertices’ skin radii

Parameters:
  • value (float array of 3 items in [-inf, inf], (optional)) – Vector
  • constraint_axis (boolean array of 3 items, (optional)) – Constraint Axis
  • constraint_orientation (enum in [], (optional)) – Orientation, Transformation orientation
  • mirror (boolean, (optional)) – Mirror Editing
  • proportional (enum in [‘DISABLED’, ‘ENABLED’, ‘PROJECTED’, ‘CONNECTED’], (optional)) –

    Proportional Editing

    • DISABLED Disable, Proportional Editing disabled.
    • ENABLED Enable, Proportional Editing enabled.
    • PROJECTED Projected (2D), Proportional Editing using screen space locations.
    • CONNECTED Connected, Proportional Editing using connected geometry only.
  • proportional_edit_falloff (enum in [‘SMOOTH’, ‘SPHERE’, ‘ROOT’, ‘INVERSE_SQUARE’, ‘SHARP’, ‘LINEAR’, ‘CONSTANT’, ‘RANDOM’], (optional)) –

    Proportional Editing Falloff, Falloff type for proportional editing mode

    • SMOOTH Smooth, Smooth falloff.
    • SPHERE Sphere, Spherical falloff.
    • ROOT Root, Root falloff.
    • INVERSE_SQUARE Inverse Square, Inverse Square falloff.
    • SHARP Sharp, Sharp falloff.
    • LINEAR Linear, Linear falloff.
    • CONSTANT Constant, Constant falloff.
    • RANDOM Random, Random falloff.
  • proportional_size (float in [1e-05, inf], (optional)) – Proportional Size
  • snap (boolean, (optional)) – Use Snapping Options
  • snap_target (enum in [‘CLOSEST’, ‘CENTER’, ‘MEDIAN’, ‘ACTIVE’], (optional)) –

    Target

    • CLOSEST Closest, Snap closest point onto target.
    • CENTER Center, Snap center onto target.
    • MEDIAN Median, Snap median onto target.
    • ACTIVE Active, Snap active onto target.
  • snap_point (float array of 3 items in [-inf, inf], (optional)) – Point
  • snap_align (boolean, (optional)) – Align with Point Normal
  • snap_normal (float array of 3 items in [-inf, inf], (optional)) – Normal
  • release_confirm (boolean, (optional)) – Confirm on Release, Always confirm operation when releasing button
bpy.ops.transform.tilt(value=0.0, mirror=False, proportional='DISABLED', proportional_edit_falloff='SMOOTH', proportional_size=1.0, snap=False, snap_target='CLOSEST', snap_point=(0.0, 0.0, 0.0), snap_align=False, snap_normal=(0.0, 0.0, 0.0), release_confirm=False)

Tilt selected control vertices of 3D curve

Parameters:
  • value (float in [-inf, inf], (optional)) – Angle
  • mirror (boolean, (optional)) – Mirror Editing
  • proportional (enum in [‘DISABLED’, ‘ENABLED’, ‘PROJECTED’, ‘CONNECTED’], (optional)) –

    Proportional Editing

    • DISABLED Disable, Proportional Editing disabled.
    • ENABLED Enable, Proportional Editing enabled.
    • PROJECTED Projected (2D), Proportional Editing using screen space locations.
    • CONNECTED Connected, Proportional Editing using connected geometry only.
  • proportional_edit_falloff (enum in [‘SMOOTH’, ‘SPHERE’, ‘ROOT’, ‘INVERSE_SQUARE’, ‘SHARP’, ‘LINEAR’, ‘CONSTANT’, ‘RANDOM’], (optional)) –

    Proportional Editing Falloff, Falloff type for proportional editing mode

    • SMOOTH Smooth, Smooth falloff.
    • SPHERE Sphere, Spherical falloff.
    • ROOT Root, Root falloff.
    • INVERSE_SQUARE Inverse Square, Inverse Square falloff.
    • SHARP Sharp, Sharp falloff.
    • LINEAR Linear, Linear falloff.
    • CONSTANT Constant, Constant falloff.
    • RANDOM Random, Random falloff.
  • proportional_size (float in [1e-05, inf], (optional)) – Proportional Size
  • snap (boolean, (optional)) – Use Snapping Options
  • snap_target (enum in [‘CLOSEST’, ‘CENTER’, ‘MEDIAN’, ‘ACTIVE’], (optional)) –

    Target

    • CLOSEST Closest, Snap closest point onto target.
    • CENTER Center, Snap center onto target.
    • MEDIAN Median, Snap median onto target.
    • ACTIVE Active, Snap active onto target.
  • snap_point (float array of 3 items in [-inf, inf], (optional)) – Point
  • snap_align (boolean, (optional)) – Align with Point Normal
  • snap_normal (float array of 3 items in [-inf, inf], (optional)) – Normal
  • release_confirm (boolean, (optional)) – Confirm on Release, Always confirm operation when releasing button
bpy.ops.transform.tosphere(value=0.0, mirror=False, proportional='DISABLED', proportional_edit_falloff='SMOOTH', proportional_size=1.0, snap=False, snap_target='CLOSEST', snap_point=(0.0, 0.0, 0.0), snap_align=False, snap_normal=(0.0, 0.0, 0.0), gpencil_strokes=False, release_confirm=False)

Move selected vertices outward in a spherical shape around mesh center

Parameters:
  • value (float in [0, 1], (optional)) – Factor
  • mirror (boolean, (optional)) – Mirror Editing
  • proportional (enum in [‘DISABLED’, ‘ENABLED’, ‘PROJECTED’, ‘CONNECTED’], (optional)) –

    Proportional Editing

    • DISABLED Disable, Proportional Editing disabled.
    • ENABLED Enable, Proportional Editing enabled.
    • PROJECTED Projected (2D), Proportional Editing using screen space locations.
    • CONNECTED Connected, Proportional Editing using connected geometry only.
  • proportional_edit_falloff (enum in [‘SMOOTH’, ‘SPHERE’, ‘ROOT’, ‘INVERSE_SQUARE’, ‘SHARP’, ‘LINEAR’, ‘CONSTANT’, ‘RANDOM’], (optional)) –

    Proportional Editing Falloff, Falloff type for proportional editing mode

    • SMOOTH Smooth, Smooth falloff.
    • SPHERE Sphere, Spherical falloff.
    • ROOT Root, Root falloff.
    • INVERSE_SQUARE Inverse Square, Inverse Square falloff.
    • SHARP Sharp, Sharp falloff.
    • LINEAR Linear, Linear falloff.
    • CONSTANT Constant, Constant falloff.
    • RANDOM Random, Random falloff.
  • proportional_size (float in [1e-05, inf], (optional)) – Proportional Size
  • snap (boolean, (optional)) – Use Snapping Options
  • snap_target (enum in [‘CLOSEST’, ‘CENTER’, ‘MEDIAN’, ‘ACTIVE’], (optional)) –

    Target

    • CLOSEST Closest, Snap closest point onto target.
    • CENTER Center, Snap center onto target.
    • MEDIAN Median, Snap median onto target.
    • ACTIVE Active, Snap active onto target.
  • snap_point (float array of 3 items in [-inf, inf], (optional)) – Point
  • snap_align (boolean, (optional)) – Align with Point Normal
  • snap_normal (float array of 3 items in [-inf, inf], (optional)) – Normal
  • gpencil_strokes (boolean, (optional)) – Edit Grease Pencil, Edit selected Grease Pencil strokes
  • release_confirm (boolean, (optional)) – Confirm on Release, Always confirm operation when releasing button
bpy.ops.transform.trackball(value=(0.0, 0.0), mirror=False, proportional='DISABLED', proportional_edit_falloff='SMOOTH', proportional_size=1.0, snap=False, snap_target='CLOSEST', snap_point=(0.0, 0.0, 0.0), snap_align=False, snap_normal=(0.0, 0.0, 0.0), gpencil_strokes=False, release_confirm=False)

Trackball style rotation of selected items

Parameters:
  • value (float array of 2 items in [-inf, inf], (optional)) – Angle
  • mirror (boolean, (optional)) – Mirror Editing
  • proportional (enum in [‘DISABLED’, ‘ENABLED’, ‘PROJECTED’, ‘CONNECTED’], (optional)) –

    Proportional Editing

    • DISABLED Disable, Proportional Editing disabled.
    • ENABLED Enable, Proportional Editing enabled.
    • PROJECTED Projected (2D), Proportional Editing using screen space locations.
    • CONNECTED Connected, Proportional Editing using connected geometry only.
  • proportional_edit_falloff (enum in [‘SMOOTH’, ‘SPHERE’, ‘ROOT’, ‘INVERSE_SQUARE’, ‘SHARP’, ‘LINEAR’, ‘CONSTANT’, ‘RANDOM’], (optional)) –

    Proportional Editing Falloff, Falloff type for proportional editing mode

    • SMOOTH Smooth, Smooth falloff.
    • SPHERE Sphere, Spherical falloff.
    • ROOT Root, Root falloff.
    • INVERSE_SQUARE Inverse Square, Inverse Square falloff.
    • SHARP Sharp, Sharp falloff.
    • LINEAR Linear, Linear falloff.
    • CONSTANT Constant, Constant falloff.
    • RANDOM Random, Random falloff.
  • proportional_size (float in [1e-05, inf], (optional)) – Proportional Size
  • snap (boolean, (optional)) – Use Snapping Options
  • snap_target (enum in [‘CLOSEST’, ‘CENTER’, ‘MEDIAN’, ‘ACTIVE’], (optional)) –

    Target

    • CLOSEST Closest, Snap closest point onto target.
    • CENTER Center, Snap center onto target.
    • MEDIAN Median, Snap median onto target.
    • ACTIVE Active, Snap active onto target.
  • snap_point (float array of 3 items in [-inf, inf], (optional)) – Point
  • snap_align (boolean, (optional)) – Align with Point Normal
  • snap_normal (float array of 3 items in [-inf, inf], (optional)) – Normal
  • gpencil_strokes (boolean, (optional)) – Edit Grease Pencil, Edit selected Grease Pencil strokes
  • release_confirm (boolean, (optional)) – Confirm on Release, Always confirm operation when releasing button
bpy.ops.transform.transform(mode='TRANSLATION', value=(0.0, 0.0, 0.0, 0.0), axis=(0.0, 0.0, 0.0), constraint_axis=(False, False, False), constraint_orientation='GLOBAL', mirror=False, proportional='DISABLED', proportional_edit_falloff='SMOOTH', proportional_size=1.0, snap=False, snap_target='CLOSEST', snap_point=(0.0, 0.0, 0.0), snap_align=False, snap_normal=(0.0, 0.0, 0.0), gpencil_strokes=False, release_confirm=False)

Transform selected items by mode type

Parameters:
  • mode (enum in [‘INIT’, ‘DUMMY’, ‘TRANSLATION’, ‘ROTATION’, ‘RESIZE’, ‘SKIN_RESIZE’, ‘TOSPHERE’, ‘SHEAR’, ‘BEND’, ‘SHRINKFATTEN’, ‘TILT’, ‘TRACKBALL’, ‘PUSHPULL’, ‘CREASE’, ‘MIRROR’, ‘BONE_SIZE’, ‘BONE_ENVELOPE’, ‘CURVE_SHRINKFATTEN’, ‘MASK_SHRINKFATTEN’, ‘GPENCIL_SHRINKFATTEN’, ‘BONE_ROLL’, ‘TIME_TRANSLATE’, ‘TIME_SLIDE’, ‘TIME_SCALE’, ‘TIME_EXTEND’, ‘BAKE_TIME’, ‘BWEIGHT’, ‘ALIGN’, ‘EDGESLIDE’, ‘SEQSLIDE’], (optional)) – Mode
  • value (float array of 4 items in [-inf, inf], (optional)) – Values
  • axis (float array of 3 items in [-inf, inf], (optional)) – Axis, The axis around which the transformation occurs
  • constraint_axis (boolean array of 3 items, (optional)) – Constraint Axis
  • constraint_orientation (enum in [], (optional)) – Orientation, Transformation orientation
  • mirror (boolean, (optional)) – Mirror Editing
  • proportional (enum in [‘DISABLED’, ‘ENABLED’, ‘PROJECTED’, ‘CONNECTED’], (optional)) –

    Proportional Editing

    • DISABLED Disable, Proportional Editing disabled.
    • ENABLED Enable, Proportional Editing enabled.
    • PROJECTED Projected (2D), Proportional Editing using screen space locations.
    • CONNECTED Connected, Proportional Editing using connected geometry only.
  • proportional_edit_falloff (enum in [‘SMOOTH’, ‘SPHERE’, ‘ROOT’, ‘INVERSE_SQUARE’, ‘SHARP’, ‘LINEAR’, ‘CONSTANT’, ‘RANDOM’], (optional)) –

    Proportional Editing Falloff, Falloff type for proportional editing mode

    • SMOOTH Smooth, Smooth falloff.
    • SPHERE Sphere, Spherical falloff.
    • ROOT Root, Root falloff.
    • INVERSE_SQUARE Inverse Square, Inverse Square falloff.
    • SHARP Sharp, Sharp falloff.
    • LINEAR Linear, Linear falloff.
    • CONSTANT Constant, Constant falloff.
    • RANDOM Random, Random falloff.
  • proportional_size (float in [1e-05, inf], (optional)) – Proportional Size
  • snap (boolean, (optional)) – Use Snapping Options
  • snap_target (enum in [‘CLOSEST’, ‘CENTER’, ‘MEDIAN’, ‘ACTIVE’], (optional)) –

    Target

    • CLOSEST Closest, Snap closest point onto target.
    • CENTER Center, Snap center onto target.
    • MEDIAN Median, Snap median onto target.
    • ACTIVE Active, Snap active onto target.
  • snap_point (float array of 3 items in [-inf, inf], (optional)) – Point
  • snap_align (boolean, (optional)) – Align with Point Normal
  • snap_normal (float array of 3 items in [-inf, inf], (optional)) – Normal
  • gpencil_strokes (boolean, (optional)) – Edit Grease Pencil, Edit selected Grease Pencil strokes
  • release_confirm (boolean, (optional)) – Confirm on Release, Always confirm operation when releasing button
bpy.ops.transform.translate(value=(0.0, 0.0, 0.0), constraint_axis=(False, False, False), constraint_orientation='GLOBAL', mirror=False, proportional='DISABLED', proportional_edit_falloff='SMOOTH', proportional_size=1.0, snap=False, snap_target='CLOSEST', snap_point=(0.0, 0.0, 0.0), snap_align=False, snap_normal=(0.0, 0.0, 0.0), gpencil_strokes=False, texture_space=False, remove_on_cancel=False, release_confirm=False)

Translate (move) selected items

Parameters:
  • value (float array of 3 items in [-inf, inf], (optional)) – Vector
  • constraint_axis (boolean array of 3 items, (optional)) – Constraint Axis
  • constraint_orientation (enum in [], (optional)) – Orientation, Transformation orientation
  • mirror (boolean, (optional)) – Mirror Editing
  • proportional (enum in [‘DISABLED’, ‘ENABLED’, ‘PROJECTED’, ‘CONNECTED’], (optional)) –

    Proportional Editing

    • DISABLED Disable, Proportional Editing disabled.
    • ENABLED Enable, Proportional Editing enabled.
    • PROJECTED Projected (2D), Proportional Editing using screen space locations.
    • CONNECTED Connected, Proportional Editing using connected geometry only.
  • proportional_edit_falloff (enum in [‘SMOOTH’, ‘SPHERE’, ‘ROOT’, ‘INVERSE_SQUARE’, ‘SHARP’, ‘LINEAR’, ‘CONSTANT’, ‘RANDOM’], (optional)) –

    Proportional Editing Falloff, Falloff type for proportional editing mode

    • SMOOTH Smooth, Smooth falloff.
    • SPHERE Sphere, Spherical falloff.
    • ROOT Root, Root falloff.
    • INVERSE_SQUARE Inverse Square, Inverse Square falloff.
    • SHARP Sharp, Sharp falloff.
    • LINEAR Linear, Linear falloff.
    • CONSTANT Constant, Constant falloff.
    • RANDOM Random, Random falloff.
  • proportional_size (float in [1e-05, inf], (optional)) – Proportional Size
  • snap (boolean, (optional)) – Use Snapping Options
  • snap_target (enum in [‘CLOSEST’, ‘CENTER’, ‘MEDIAN’, ‘ACTIVE’], (optional)) –

    Target

    • CLOSEST Closest, Snap closest point onto target.
    • CENTER Center, Snap center onto target.
    • MEDIAN Median, Snap median onto target.
    • ACTIVE Active, Snap active onto target.
  • snap_point (float array of 3 items in [-inf, inf], (optional)) – Point
  • snap_align (boolean, (optional)) – Align with Point Normal
  • snap_normal (float array of 3 items in [-inf, inf], (optional)) – Normal
  • gpencil_strokes (boolean, (optional)) – Edit Grease Pencil, Edit selected Grease Pencil strokes
  • texture_space (boolean, (optional)) – Edit Texture Space, Edit Object data texture space
  • remove_on_cancel (boolean, (optional)) – Remove on Cancel, Remove elements on cancel
  • release_confirm (boolean, (optional)) – Confirm on Release, Always confirm operation when releasing button
bpy.ops.transform.vert_slide(value=0.0, mirror=False, snap=False, snap_target='CLOSEST', snap_point=(0.0, 0.0, 0.0), snap_align=False, snap_normal=(0.0, 0.0, 0.0), correct_uv=False, release_confirm=False)

Slide a vertex along a mesh

Parameters:
  • value (float in [-10, 10], (optional)) – Factor
  • mirror (boolean, (optional)) – Mirror Editing
  • snap (boolean, (optional)) – Use Snapping Options
  • snap_target (enum in [‘CLOSEST’, ‘CENTER’, ‘MEDIAN’, ‘ACTIVE’], (optional)) –

    Target

    • CLOSEST Closest, Snap closest point onto target.
    • CENTER Center, Snap center onto target.
    • MEDIAN Median, Snap median onto target.
    • ACTIVE Active, Snap active onto target.
  • snap_point (float array of 3 items in [-inf, inf], (optional)) – Point
  • snap_align (boolean, (optional)) – Align with Point Normal
  • snap_normal (float array of 3 items in [-inf, inf], (optional)) – Normal
  • correct_uv (boolean, (optional)) – Correct UVs, Correct UV coordinates when transforming
  • release_confirm (boolean, (optional)) – Confirm on Release, Always confirm operation when releasing button

Previous topic

Time Operators

Next topic

Ui Operators