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
- connect_strips_by_default
Connect newly added movie strips by default if they have multiple channels
- Type
boolean, default True
- fcurve_new_auto_smoothing
Auto Handle Smoothing mode used for newly added F-Curves
- Type
enum in Fcurve Auto Smoothing Items, 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
- key_insert_channels
Which channels to insert keys at when no keying set is active
- Type
enum set in {
'LOCATION'
,'ROTATION'
,'SCALE'
,'ROTATE_MODE'
,'CUSTOM_PROPS'
}, default"{'CUSTOM_PROPS', 'LOCATION', 'ROTATION', 'SCALE'}"
- keyframe_new_handle_type
Handle type for handles of new keyframes
- Type
enum in Keyframe Handle Type Items, 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)
- Type
enum in Beztriple Interpolation Mode Items, 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 40
- node_preview_resolution
Resolution used for Shader node previews (should be changed for performance convenience)
- Type
int in [50, 250], default 120
- node_use_insert_offset
Automatically offset the following or previous nodes in a chain when inserting a new node
- Type
boolean, default True
- object_align
The default alignment for objects added from a 3D viewport menu
WORLD
World – Align newly added objects to the world coordinate system.VIEW
View – Align newly added objects to the active 3D view orientation.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
mathutils.Color
of 3 items in [0, inf], default (0.0, 0.0, 0.0)
- show_only_selected_curve_keyframes
Only keyframes of selected F-Curves are visible and editable
- Type
boolean, default False
- 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_keyframe_insert_needed
Auto-Keying will skip inserting keys that don’t affect the animation
- Type
boolean, default True
- 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 True
- 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_camera
Causes camera 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_curves
Causes curves 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_lattice
Causes lattice 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_node_tree
Make copies of node groups when duplicating nodes in the node editor
- Type
boolean, default False
- 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 True
- use_duplicate_speaker
Causes speaker data to be duplicated with the object
- Type
boolean, default True
- 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_fcurve_high_quality_drawing
Draw F-Curves using Anti-Aliasing (disable for better performance)
- Type
boolean, default True
- 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
Insert Keyframes only for properties that are already animated
- Type
boolean, default False
- use_keyframe_insert_needed
When keying manually, skip inserting keys that don’t affect the animation
- 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_text_edit_auto_close
Automatically close relevant character pairs when typing in the text editor
- Type
boolean, default False
- use_visual_keying
Use Visual keying automatically for constrained objects
- Type
boolean, default False
- classmethod bl_rna_get_subclass(id, default=None, /)
- Parameters
id (str) – 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 (str) – The RNA type identifier.
- Returns
The class or default when not found.
- Return type
type