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’
-
collection_instance_empty_size
¶ Display size of the empty when new collection instances are created
- Type
float in [0.001, inf], default 1.0
-
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
¶ The opacity of unselected F-Curves against the background of the 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_anim_channel_group_colors
¶ Use animation channel group colors; generally this is used to show bone group colors
- Type
boolean, default False
-
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 data-blocks
- 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_hair
¶ Causes hair data to be duplicated with the object
- Type
boolean, default False
-
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_pointcloud
¶ Causes point cloud data 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
Inherited Functions
References