Transform Operators

bpy.ops.transform.create_orientation(name="", use=False, overwrite=False)

Create transformation orientation from selection

Parameters:
  • name (string, (optional)) – Name, Text to insert at the cursor position.
  • 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_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
  • 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), 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, never None)) – 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.mirror(constraint_axis=(False, False, False), constraint_orientation='', proportional='DISABLED', proportional_edit_falloff='SMOOTH', proportional_size=1.0, 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 [‘GLOBAL’, ‘NORMAL’, ‘GIMBAL’, ‘LOCAL’, ‘VIEW’], (optional, never None)) – Orientation, Transformation orientation
  • proportional (enum in [‘DISABLED’, ‘ENABLED’, ‘CONNECTED’], (optional, never None)) – Proportional Editing
  • proportional_edit_falloff (enum in [‘SMOOTH’, ‘SPHERE’, ‘ROOT’, ‘SHARP’, ‘LINEAR’, ‘CONSTANT’, ‘RANDOM’], (optional, never None)) – Proportional Editing Falloff, Falloff type for proportional editing mode.
  • proportional_size (float in [0, inf], (optional)) – Proportional Size
  • 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’, ‘CONNECTED’], (optional)) – Proportional Editing
  • proportional_edit_falloff (enum in [‘SMOOTH’, ‘SPHERE’, ‘ROOT’, ‘SHARP’, ‘LINEAR’, ‘CONSTANT’, ‘RANDOM’], (optional)) – Proportional Editing Falloff, Falloff type for proportional editing mode.
  • proportional_size (float in [0, inf], (optional)) – Proportional Size
  • snap (boolean, (optional)) – Use Snapping Options
  • snap_target (enum in [‘CLOSEST’, ‘CENTER’, ‘MEDIAN’, ‘ACTIVE’], (optional)) – 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='', 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)

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 [‘GLOBAL’, ‘NORMAL’, ‘GIMBAL’, ‘LOCAL’, ‘VIEW’], (optional, never None)) – Orientation, Transformation orientation
  • mirror (boolean, (optional)) – Mirror Editing
  • proportional (enum in [‘DISABLED’, ‘ENABLED’, ‘CONNECTED’], (optional, never None)) – Proportional Editing
  • proportional_edit_falloff (enum in [‘SMOOTH’, ‘SPHERE’, ‘ROOT’, ‘SHARP’, ‘LINEAR’, ‘CONSTANT’, ‘RANDOM’], (optional, never None)) – Proportional Editing Falloff, Falloff type for proportional editing mode.
  • proportional_size (float in [0, inf], (optional)) – Proportional Size
  • snap (boolean, (optional)) – Use Snapping Options
  • snap_target (enum in [‘CLOSEST’, ‘CENTER’, ‘MEDIAN’, ‘ACTIVE’], (optional, never None)) – 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.rotate(value=(0.0), axis=(0.0, 0.0, 0.0), constraint_axis=(False, False, False), constraint_orientation='', 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)

Rotate selected items

Parameters:
  • value (float array of 1 items 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 [‘GLOBAL’, ‘NORMAL’, ‘GIMBAL’, ‘LOCAL’, ‘VIEW’], (optional, never None)) – Orientation, Transformation orientation
  • mirror (boolean, (optional)) – Mirror Editing
  • proportional (enum in [‘DISABLED’, ‘ENABLED’, ‘CONNECTED’], (optional, never None)) – Proportional Editing
  • proportional_edit_falloff (enum in [‘SMOOTH’, ‘SPHERE’, ‘ROOT’, ‘SHARP’, ‘LINEAR’, ‘CONSTANT’, ‘RANDOM’], (optional, never None)) – Proportional Editing Falloff, Falloff type for proportional editing mode.
  • proportional_size (float in [0, inf], (optional)) – Proportional Size
  • snap (boolean, (optional)) – Use Snapping Options
  • snap_target (enum in [‘CLOSEST’, ‘CENTER’, ‘MEDIAN’, ‘ACTIVE’], (optional, never None)) – 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.select_orientation(orientation='')

Select transformation orientation

Parameters:
  • orientation (enum in [‘GLOBAL’, ‘NORMAL’, ‘GIMBAL’, ‘LOCAL’, ‘VIEW’], (optional, never None)) – Orientation, Transformation orientation
bpy.ops.transform.seq_slide(value=(1.0, 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)

Slide a sequence strip in time

Parameters:
  • value (float array of 2 items in [-inf, inf], (optional)) – angle
  • snap (boolean, (optional)) – Use Snapping Options
  • snap_target (enum in [‘CLOSEST’, ‘CENTER’, ‘MEDIAN’, ‘ACTIVE’], (optional, never None)) – 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), 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’, ‘CONNECTED’], (optional, never None)) – Proportional Editing
  • proportional_edit_falloff (enum in [‘SMOOTH’, ‘SPHERE’, ‘ROOT’, ‘SHARP’, ‘LINEAR’, ‘CONSTANT’, ‘RANDOM’], (optional, never None)) – Proportional Editing Falloff, Falloff type for proportional editing mode.
  • proportional_size (float in [0, inf], (optional)) – Proportional Size
  • snap (boolean, (optional)) – Use Snapping Options
  • snap_target (enum in [‘CLOSEST’, ‘CENTER’, ‘MEDIAN’, ‘ACTIVE’], (optional, never None)) – 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.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’, ‘CONNECTED’], (optional, never None)) – Proportional Editing
  • proportional_edit_falloff (enum in [‘SMOOTH’, ‘SPHERE’, ‘ROOT’, ‘SHARP’, ‘LINEAR’, ‘CONSTANT’, ‘RANDOM’], (optional, never None)) – Proportional Editing Falloff, Falloff type for proportional editing mode.
  • proportional_size (float in [0, inf], (optional)) – Proportional Size
  • snap (boolean, (optional)) – Use Snapping Options
  • snap_target (enum in [‘CLOSEST’, ‘CENTER’, ‘MEDIAN’, ‘ACTIVE’], (optional, never None)) – 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.snap_type(type='INCREMENT')

Set the snap element type

Parameters:
  • type (enum in [‘INCREMENT’, ‘VERTEX’, ‘EDGE’, ‘FACE’, ‘VOLUME’], (optional, never None)) – Type, Set the snap element type
bpy.ops.transform.tilt(value=(0.0), constraint_axis=(False, False, False), constraint_orientation='', 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 array of 1 items in [-inf, inf], (optional)) – Angle
  • constraint_axis (boolean array of 3 items, (optional)) – Constraint Axis
  • constraint_orientation (enum in [‘GLOBAL’, ‘NORMAL’, ‘GIMBAL’, ‘LOCAL’, ‘VIEW’], (optional, never None)) – Orientation, Transformation orientation
  • mirror (boolean, (optional)) – Mirror Editing
  • proportional (enum in [‘DISABLED’, ‘ENABLED’, ‘CONNECTED’], (optional, never None)) – Proportional Editing
  • proportional_edit_falloff (enum in [‘SMOOTH’, ‘SPHERE’, ‘ROOT’, ‘SHARP’, ‘LINEAR’, ‘CONSTANT’, ‘RANDOM’], (optional, never None)) – Proportional Editing Falloff, Falloff type for proportional editing mode.
  • proportional_size (float in [0, inf], (optional)) – Proportional Size
  • snap (boolean, (optional)) – Use Snapping Options
  • snap_target (enum in [‘CLOSEST’, ‘CENTER’, ‘MEDIAN’, ‘ACTIVE’], (optional, never None)) – 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), 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’, ‘CONNECTED’], (optional, never None)) – Proportional Editing
  • proportional_edit_falloff (enum in [‘SMOOTH’, ‘SPHERE’, ‘ROOT’, ‘SHARP’, ‘LINEAR’, ‘CONSTANT’, ‘RANDOM’], (optional, never None)) – Proportional Editing Falloff, Falloff type for proportional editing mode.
  • proportional_size (float in [0, inf], (optional)) – Proportional Size
  • snap (boolean, (optional)) – Use Snapping Options
  • snap_target (enum in [‘CLOSEST’, ‘CENTER’, ‘MEDIAN’, ‘ACTIVE’], (optional, never None)) – 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.trackball(value=(1.0, 1.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)

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’, ‘CONNECTED’], (optional)) – Proportional Editing
  • proportional_edit_falloff (enum in [‘SMOOTH’, ‘SPHERE’, ‘ROOT’, ‘SHARP’, ‘LINEAR’, ‘CONSTANT’, ‘RANDOM’], (optional)) – Proportional Editing Falloff, Falloff type for proportional editing mode.
  • proportional_size (float in [0, inf], (optional)) – Proportional Size
  • snap (boolean, (optional)) – Use Snapping Options
  • snap_target (enum in [‘CLOSEST’, ‘CENTER’, ‘MEDIAN’, ‘ACTIVE’], (optional)) – 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.transform(mode='DUMMY', value=(0.0, 0.0, 0.0, 0.0), axis=(0.0, 0.0, 0.0), constraint_axis=(False, False, False), constraint_orientation='', 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)

Transform selected items by mode type

Parameters:
  • mode (enum in [‘INIT’, ‘DUMMY’, ‘TRANSLATION’, ‘ROTATION’, ‘RESIZE’, ‘TOSPHERE’, ‘SHEAR’, ‘WARP’, ‘SHRINKFATTEN’, ‘TILT’, ‘TRACKBALL’, ‘PUSHPULL’, ‘CREASE’, ‘MIRROR’, ‘BONE_SIZE’, ‘BONE_ENVELOPE’, ‘CURVE_SHRINKFATTEN’, ‘BONE_ROLL’, ‘TIME_TRANSLATE’, ‘TIME_SLIDE’, ‘TIME_SCALE’, ‘TIME_EXTEND’, ‘BAKE_TIME’, ‘BEVEL’, ‘BWEIGHT’, ‘ALIGN’, ‘EDGESLIDE’, ‘SEQSLIDE’], (optional, never None)) – 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 [‘GLOBAL’, ‘NORMAL’, ‘GIMBAL’, ‘LOCAL’, ‘VIEW’], (optional, never None)) – Orientation, Transformation orientation
  • mirror (boolean, (optional)) – Mirror Editing
  • proportional (enum in [‘DISABLED’, ‘ENABLED’, ‘CONNECTED’], (optional, never None)) – Proportional Editing
  • proportional_edit_falloff (enum in [‘SMOOTH’, ‘SPHERE’, ‘ROOT’, ‘SHARP’, ‘LINEAR’, ‘CONSTANT’, ‘RANDOM’], (optional, never None)) – Proportional Editing Falloff, Falloff type for proportional editing mode.
  • proportional_size (float in [0, inf], (optional)) – Proportional Size
  • snap (boolean, (optional)) – Use Snapping Options
  • snap_target (enum in [‘CLOSEST’, ‘CENTER’, ‘MEDIAN’, ‘ACTIVE’], (optional, never None)) – 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.translate(value=(0.0, 0.0, 0.0), constraint_axis=(False, False, False), constraint_orientation='', 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)

Translate 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 [‘GLOBAL’, ‘NORMAL’, ‘GIMBAL’, ‘LOCAL’, ‘VIEW’], (optional, never None)) – Orientation, Transformation orientation
  • mirror (boolean, (optional)) – Mirror Editing
  • proportional (enum in [‘DISABLED’, ‘ENABLED’, ‘CONNECTED’], (optional, never None)) – Proportional Editing
  • proportional_edit_falloff (enum in [‘SMOOTH’, ‘SPHERE’, ‘ROOT’, ‘SHARP’, ‘LINEAR’, ‘CONSTANT’, ‘RANDOM’], (optional, never None)) – Proportional Editing Falloff, Falloff type for proportional editing mode.
  • proportional_size (float in [0, inf], (optional)) – Proportional Size
  • snap (boolean, (optional)) – Use Snapping Options
  • snap_target (enum in [‘CLOSEST’, ‘CENTER’, ‘MEDIAN’, ‘ACTIVE’], (optional, never None)) – 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.warp(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)

Warp selected items around the cursor

Parameters:
  • value (float array of 1 items in [-inf, inf], (optional)) – Angle
  • mirror (boolean, (optional)) – Mirror Editing
  • proportional (enum in [‘DISABLED’, ‘ENABLED’, ‘CONNECTED’], (optional, never None)) – Proportional Editing
  • proportional_edit_falloff (enum in [‘SMOOTH’, ‘SPHERE’, ‘ROOT’, ‘SHARP’, ‘LINEAR’, ‘CONSTANT’, ‘RANDOM’], (optional, never None)) – Proportional Editing Falloff, Falloff type for proportional editing mode.
  • proportional_size (float in [0, inf], (optional)) – Proportional Size
  • snap (boolean, (optional)) – Use Snapping Options
  • snap_target (enum in [‘CLOSEST’, ‘CENTER’, ‘MEDIAN’, ‘ACTIVE’], (optional, never None)) – 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

Previous topic

Time Operators

Next topic

Ui Operators