PreferencesEdit(bpy_struct)

base class — bpy_struct

class bpy.types.PreferencesEdit(bpy_struct)

Settings for interacting with Blender data

auto_keying_mode

Mode of automatic keyframe insertion for Objects and Bones (default setting used for new Scenes)

Type

enum in [‘ADD_REPLACE_KEYS’, ‘REPLACE_KEYS’], default ‘ADD_REPLACE_KEYS’

fcurve_new_auto_smoothing

Auto Handle Smoothing mode used for newly added F-Curves

• NONE None, Automatic handles only take immediately adjacent keys into account.

• CONT_ACCEL Continuous Acceleration, Automatic handles are adjusted to avoid jumps in acceleration, resulting in smoother curves. However, key changes may affect interpolation over a larger stretch of the curve.

Type

enum in [‘NONE’, ‘CONT_ACCEL’], default ‘CONT_ACCEL’

fcurve_unselected_alpha

Amount that unselected F-Curves stand out from the background (Graph Editor)

Type

float in [0.001, 1], default 0.25

grease_pencil_default_color

Color of new annotation layers

Type

float array of 4 items in [0, inf], default (0.38, 0.61, 0.78, 0.9)

grease_pencil_eraser_radius

Radius of eraser ‘brush’

Type

int in [1, 500], default 25

grease_pencil_euclidean_distance

Distance moved by mouse when drawing stroke to include

Type

int in [0, 100], default 2

grease_pencil_manhattan_distance

Pixels moved by mouse per axis when drawing stroke

Type

int in [0, 100], default 1

keyframe_new_handle_type

Handle type for handles of new keyframes

• FREE Free, Completely independent manually set handle.

• ALIGNED Aligned, Manually set handle with rotation locked together with its pair.

• VECTOR Vector, Automatic handles that create straight lines.

• AUTO Automatic, Automatic handles that create smooth curves.

• AUTO_CLAMPED Auto Clamped, Automatic handles that create smooth curves which only change direction at keyframes.

Type

enum in [‘FREE’, ‘ALIGNED’, ‘VECTOR’, ‘AUTO’, ‘AUTO_CLAMPED’], default ‘AUTO_CLAMPED’

keyframe_new_interpolation_type

Interpolation mode used for first keyframe on newly added F-Curves (subsequent keyframes take interpolation from preceding keyframe)

• CONSTANT Constant, No interpolation, value of A gets held until B is encountered.

• LINEAR Linear, Straight-line interpolation between A and B (i.e. no ease in/out).

• BEZIER Bezier, Smooth interpolation between A and B, with some control over curve shape.

• SINE Sinusoidal, Sinusoidal easing (weakest, almost linear but with a slight curvature).

• QUAD Quadratic, Quadratic easing.

• CUBIC Cubic, Cubic easing.

• QUART Quartic, Quartic easing.

• QUINT Quintic, Quintic easing.

• EXPO Exponential, Exponential easing (dramatic).

• CIRC Circular, Circular easing (strongest and most dynamic).

• BACK Back, Cubic easing with overshoot and settle.

• BOUNCE Bounce, Exponentially decaying parabolic bounce, like when objects collide.

• ELASTIC Elastic, Exponentially decaying sine wave, like an elastic band.

Type

enum in [‘CONSTANT’, ‘LINEAR’, ‘BEZIER’, ‘SINE’, ‘QUAD’, ‘CUBIC’, ‘QUART’, ‘QUINT’, ‘EXPO’, ‘CIRC’, ‘BACK’, ‘BOUNCE’, ‘ELASTIC’], default ‘BEZIER’

material_link

Toggle whether the material is linked to object data or the object block

• OBDATA Object Data, Toggle whether the material is linked to object data or the object block.

• OBJECT Object, Toggle whether the material is linked to object data or the object block.

Type

enum in [‘OBDATA’, ‘OBJECT’], default ‘OBDATA’

node_margin

Minimum distance between nodes for Auto-offsetting nodes

Type

int in [0, 255], default 80

object_align

When adding objects from a 3D View menu, either align them with that view or with the world

• WORLD World, Align newly added objects to the world coordinate system.

• VIEW View, Align newly added objects to the active 3D View direction.

• CURSOR 3D Cursor, Align newly added objects to the 3D Cursor’s rotation.

Type

enum in [‘WORLD’, ‘VIEW’, ‘CURSOR’], default ‘WORLD’

sculpt_paint_overlay_color

Color of texture overlay

Type

float array of 3 items in [0, inf], default (0.0, 0.0, 0.0)

undo_memory_limit

Maximum memory usage in megabytes (0 means unlimited)

Type

int in [0, inf], default 0

undo_steps

Number of undo steps available (smaller values conserve memory)

Type

int in [0, 256], default 32

use_auto_keying

Automatic keyframe insertion for Objects and Bones (default setting used for new Scenes)

Type

boolean, default False

use_auto_keying_warning

Show warning indicators when transforming objects and bones if auto keying is enabled

Type

boolean, default False

use_cursor_lock_adjust

Place the cursor without ‘jumping’ to the new location (when lock-to-cursor is used)

Type

boolean, default True

use_duplicate_action

Causes actions to be duplicated with the object

Type

boolean, default True

use_duplicate_armature

Causes armature data to be duplicated with the object

Type

boolean, default True

use_duplicate_curve

Causes curve data to be duplicated with the object

Type

boolean, default True

use_duplicate_grease_pencil

Causes grease pencil data to be duplicated with the object

Type

boolean, default True

use_duplicate_light

Causes light data to be duplicated with the object

Type

boolean, default True

use_duplicate_lightprobe

Causes light probe data to be duplicated with the object

Type

boolean, default True

use_duplicate_material

Causes material data to be duplicated with the object

Type

boolean, default False

use_duplicate_mesh

Causes mesh data to be duplicated with the object

Type

boolean, default True

use_duplicate_metaball

Causes metaball data to be duplicated with the object

Type

boolean, default True

use_duplicate_particle

Causes particle systems to be duplicated with the object

Type

boolean, default False

use_duplicate_surface

Causes surface data to be duplicated with the object

Type

boolean, default True

use_duplicate_text

Causes text data to be duplicated with the object

Type

boolean, default True

use_duplicate_volume

Causes volume data to be duplicated with the object

Type

boolean, default False

use_enter_edit_mode

Enter Edit Mode automatically after adding a new object

Type

boolean, default False

use_global_undo

Global undo works by keeping a full copy of the file itself in memory, so takes extra memory

Type

boolean, default True

use_insertkey_xyz_to_rgb

Color for newly added transformation F-Curves (Location, Rotation, Scale) and also Color is based on the transform axis

Type

boolean, default True

use_keyframe_insert_available

Automatic keyframe insertion in available F-Curves

Type

boolean, default False

use_keyframe_insert_needed

Keyframe insertion only when keyframe needed

Type

boolean, default False

use_mouse_depth_cursor

Use the surface depth for cursor placement

Type

boolean, default True

use_negative_frames

Current frame number can be manually set to a negative value

Type

boolean, default True

use_visual_keying

Use Visual keying automatically for constrained objects

Type

boolean, default False

classmethod bl_rna_get_subclass(id, default=None)

Parameters

id (string) – The RNA type identifier.

Returns

The RNA type or default when not found.

Return type

bpy.types.Struct subclass

classmethod bl_rna_get_subclass_py(id, default=None)

Parameters

id (string) – The RNA type identifier.

Returns

The class or default when not found.

Return type

type

Inherited Properties

bpy_struct.id_data

Inherited Functions

bpy_struct.as_pointer bpy_struct.driver_add bpy_struct.driver_remove bpy_struct.get bpy_struct.is_property_hidden bpy_struct.is_property_overridable_library bpy_struct.is_property_readonly bpy_struct.is_property_set bpy_struct.items bpy_struct.keyframe_delete

bpy_struct.keyframe_insert bpy_struct.keys bpy_struct.path_from_id bpy_struct.path_resolve bpy_struct.pop bpy_struct.property_overridable_library_set bpy_struct.property_unset bpy_struct.type_recast bpy_struct.values

References

Preferences.edit