PreferencesSystem(bpy_struct)#

base class — bpy_struct

class bpy.types.PreferencesSystem(bpy_struct)#

Graphics driver and operating system settings

anisotropic_filter#

Quality of anisotropic filtering

Type:

enum in [‘FILTER_0’, ‘FILTER_2’, ‘FILTER_4’, ‘FILTER_8’, ‘FILTER_16’], default ‘FILTER_0’

audio_channels#

Audio channel count

  • MONO Mono – Set audio channels to mono.

  • STEREO Stereo – Set audio channels to stereo.

  • SURROUND4 4 Channels – Set audio channels to 4 channels.

  • SURROUND51 5.1 Surround – Set audio channels to 5.1 surround sound.

  • SURROUND71 7.1 Surround – Set audio channels to 7.1 surround sound.

Type:

enum in [‘MONO’, ‘STEREO’, ‘SURROUND4’, ‘SURROUND51’, ‘SURROUND71’], default ‘STEREO’

audio_device#

Audio output device

  • None None – No device - there will be no audio output.

Type:

enum in [‘None’], default ‘None’

audio_mixing_buffer#

Number of samples used by the audio mixing buffer

  • SAMPLES_256 256 Samples – Set audio mixing buffer size to 256 samples.

  • SAMPLES_512 512 Samples – Set audio mixing buffer size to 512 samples.

  • SAMPLES_1024 1024 Samples – Set audio mixing buffer size to 1024 samples.

  • SAMPLES_2048 2048 Samples – Set audio mixing buffer size to 2048 samples.

  • SAMPLES_4096 4096 Samples – Set audio mixing buffer size to 4096 samples.

  • SAMPLES_8192 8192 Samples – Set audio mixing buffer size to 8192 samples.

  • SAMPLES_16384 16384 Samples – Set audio mixing buffer size to 16384 samples.

  • SAMPLES_32768 32768 Samples – Set audio mixing buffer size to 32768 samples.

Type:

enum in [‘SAMPLES_256’, ‘SAMPLES_512’, ‘SAMPLES_1024’, ‘SAMPLES_2048’, ‘SAMPLES_4096’, ‘SAMPLES_8192’, ‘SAMPLES_16384’, ‘SAMPLES_32768’], default ‘SAMPLES_2048’

audio_sample_format#

Audio sample format

  • U8 8-bit Unsigned – Set audio sample format to 8-bit unsigned integer.

  • S16 16-bit Signed – Set audio sample format to 16-bit signed integer.

  • S24 24-bit Signed – Set audio sample format to 24-bit signed integer.

  • S32 32-bit Signed – Set audio sample format to 32-bit signed integer.

  • FLOAT 32-bit Float – Set audio sample format to 32-bit float.

  • DOUBLE 64-bit Float – Set audio sample format to 64-bit float.

Type:

enum in [‘U8’, ‘S16’, ‘S24’, ‘S32’, ‘FLOAT’, ‘DOUBLE’], default ‘FLOAT’

audio_sample_rate#

Audio sample rate

  • RATE_44100 44.1 kHz – Set audio sampling rate to 44100 samples per second.

  • RATE_48000 48 kHz – Set audio sampling rate to 48000 samples per second.

  • RATE_96000 96 kHz – Set audio sampling rate to 96000 samples per second.

  • RATE_192000 192 kHz – Set audio sampling rate to 192000 samples per second.

Type:

enum in [‘RATE_44100’, ‘RATE_48000’, ‘RATE_96000’, ‘RATE_192000’], default ‘RATE_48000’

dpi#
Type:

int in [-inf, inf], default 0, (readonly)

gl_clip_alpha#

Clip alpha below this threshold in the 3D textured view

Type:

float in [0, 1], default 0.004

gl_texture_limit#

Limit the texture size to save graphics memory

Type:

enum in [‘CLAMP_OFF’, ‘CLAMP_8192’, ‘CLAMP_4096’, ‘CLAMP_2048’, ‘CLAMP_1024’, ‘CLAMP_512’, ‘CLAMP_256’, ‘CLAMP_128’], default ‘CLAMP_OFF’

gpu_backend#

GPU backend to use (requires restarting Blender for changes to take effect)

  • OPENGL OpenGL – Use OpenGL backend.

  • METAL Metal – Use Metal backend.

  • VULKAN Vulkan (experimental) – Use Vulkan backend.

Type:

enum in [‘OPENGL’, ‘METAL’, ‘VULKAN’], default ‘OPENGL’

gpu_preferred_device#

Preferred device to select during detection (requires restarting Blender for changes to take effect)

  • AUTO Auto – Auto detect best GPU for running Blender.

Type:

enum in [‘AUTO’], default ‘AUTO’

image_draw_method#

Method used for displaying images on the screen

  • AUTO Automatic – Automatically choose method based on GPU and image.

  • 2DTEXTURE 2D Texture – Use CPU for display transform and display image with 2D texture.

  • GLSL GLSL – Use GLSL shaders for display transform and display image with 2D texture.

Type:

enum in [‘AUTO’, ‘2DTEXTURE’, ‘GLSL’], default ‘AUTO’

is_microsoft_store_install#

Whether this blender installation is a sandboxed Microsoft Store version

Type:

boolean, default False, (readonly)

legacy_compute_device_type#

For backwards compatibility only

Type:

int in [-inf, inf], default 0, (readonly)

light_ambient#

Color of the ambient light that uniformly lit the scene

Type:

mathutils.Color of 3 items in [0, inf], default (0.0, 0.0, 0.0)

max_shader_compilation_subprocesses#

Max number of parallel shader compilation subprocesses, clamped at the max threads supported by the CPU (requires restarting Blender for changes to take effect). Setting it to 0 disables subprocess shader compilation.

Type:

int in [0, 32767], default 0

memory_cache_limit#

Memory cache limit (in megabytes)

Type:

int in [0, inf], default 4096

network_connection_limit#

Limit the number of simultaneous internet connections online operations may make at once. Zero disables the limit.

Type:

int in [0, 255], default 0

network_timeout#

The time in seconds to wait for online operations before a connection may fail with a time-out error. Zero uses the systems default.

Type:

int in [0, 255], default 0

pixel_size#
Type:

float in [-inf, inf], default 1.0, (readonly)

register_all_users#

Make this Blender version open blend files for all users. Requires elevated privileges.

Type:

boolean, default False

scrollback#

Maximum number of lines to store for the console buffer

Type:

int in [32, 32768], default 256

sequencer_disk_cache_compression#

Smaller compression will result in larger files, but less decoding overhead

  • NONE None – Requires fast storage, but uses minimum CPU resources.

  • LOW Low – Doesn’t require fast storage and uses less CPU resources.

  • HIGH High – Works on slower storage devices and uses most CPU resources.

Type:

enum in [‘NONE’, ‘LOW’, ‘HIGH’], default ‘NONE’

sequencer_disk_cache_dir#

Override default directory

Type:

string, default “”, (never None)

sequencer_disk_cache_size_limit#

Disk cache limit (in gigabytes)

Type:

int in [0, inf], default 100

sequencer_proxy_setup#

When and how proxies are created

  • MANUAL Manual – Set up proxies manually.

  • AUTOMATIC Automatic – Build proxies for added movie and image strips in each preview size.

Type:

enum in [‘MANUAL’, ‘AUTOMATIC’], default ‘AUTOMATIC’

solid_lights#

Lights used to display objects in solid shading mode

Type:

bpy_prop_collection of UserSolidLight, (readonly)

texture_collection_rate#

Number of seconds between each run of the GL texture garbage collector

Type:

int in [1, 3600], default 60

texture_time_out#

Time since last access of a GL texture in seconds after which it is freed (set to 0 to keep textures allocated)

Type:

int in [0, 3600], default 120

ui_line_width#

Suggested line thickness and point size in pixels, for add-ons displaying custom user interface elements, based on operating system settings and Blender UI scale

Type:

float in [-inf, inf], default 1.0, (readonly)

ui_scale#

Size multiplier to use when displaying custom user interface elements, so that they are scaled correctly on screens with different DPI. This value is based on operating system DPI settings and Blender display scale.

Type:

float in [-inf, inf], default 0.0, (readonly)

use_edit_mode_smooth_wire#

Enable edit mode edge smoothing, reducing aliasing (requires restart)

Type:

boolean, default False

use_gpu_subdivision#

Enable GPU acceleration for evaluating the last subdivision surface modifiers in the stack

Type:

boolean, default True

use_online_access#

Allow Blender to access the internet. Add-ons that follow this setting will only connect to the internet if enabled. However, Blender cannot prevent third-party add-ons from violating this rule.

Type:

boolean, default False

use_overlay_smooth_wire#

Enable overlay smooth wires, reducing aliasing

Type:

boolean, default True

use_region_overlap#

Display tool/property regions over the main region

Type:

boolean, default True

use_select_pick_depth#

When making a selection in 3D View, use the GPU depth buffer to ensure the frontmost object is selected first

Type:

boolean, default False

use_sequencer_disk_cache#

Store cached images to disk

Type:

boolean, default False

use_studio_light_edit#

View the result of the studio light editor in the viewport

Type:

boolean, default False

vbo_collection_rate#

Number of seconds between each run of the GL vertex buffer object garbage collector

Type:

int in [1, 3600], default 60

vbo_time_out#

Time since last access of a GL vertex buffer object in seconds after which it is freed (set to 0 to keep VBO allocated)

Type:

int in [0, 3600], default 120

viewport_aa#

Method of anti-aliasing in 3d viewport

  • OFF No Anti-Aliasing – Scene will be rendering without any anti-aliasing.

  • FXAA Single Pass Anti-Aliasing – Scene will be rendered using a single pass anti-aliasing method (FXAA).

  • 5 5 Samples – Scene will be rendered using 5 anti-aliasing samples.

  • 8 8 Samples – Scene will be rendered using 8 anti-aliasing samples.

  • 11 11 Samples – Scene will be rendered using 11 anti-aliasing samples.

  • 16 16 Samples – Scene will be rendered using 16 anti-aliasing samples.

  • 32 32 Samples – Scene will be rendered using 32 anti-aliasing samples.

Type:

enum in [‘OFF’, ‘FXAA’, ‘5’, ‘8’, ‘11’, ‘16’, ‘32’], default ‘8’

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

Inherited Properties#

Inherited Functions#

References#