PreferencesSystem(bpy_struct)

base class — bpy_struct

class bpy.types.PreferencesSystem(bpy_struct)

Graphics driver and operating system settings

anisotropic_filter

Quality of the anisotropic filtering (values greater than 1.0 enable 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 ‘MONO’
audio_device

Audio output device

  • Null None, Null device - there will be no audio output.
Type:enum in [‘Null’], default ‘Null’
audio_mixing_buffer

Number of samples used by the audio mixing buffer

  • SAMPLES_256 256, Set audio mixing buffer size to 256 samples.
  • SAMPLES_512 512, Set audio mixing buffer size to 512 samples.
  • SAMPLES_1024 1024, Set audio mixing buffer size to 1024 samples.
  • SAMPLES_2048 2048, Set audio mixing buffer size to 2048 samples.
  • SAMPLES_4096 4096, Set audio mixing buffer size to 4096 samples.
  • SAMPLES_8192 8192, Set audio mixing buffer size to 8192 samples.
  • SAMPLES_16384 16384, Set audio mixing buffer size to 16384 samples.
  • SAMPLES_32768 32768, 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_256’
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 ‘U8’
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_44100’
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.0
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’
gpencil_multi_sample

Enable Grease Pencil OpenGL multi-sampling, only for systems that support it

  • NONE No MultiSample, Do not use OpenGL MultiSample.
  • 2 MultiSample: 2, Use 2x OpenGL MultiSample.
  • 4 MultiSample: 4, Use 4x OpenGL MultiSample.
  • 8 MultiSample: 8, Use 8x OpenGL MultiSample.
  • 16 MultiSample: 16, Use 16x OpenGL MultiSample.
Type:enum in [‘NONE’, ‘2’, ‘4’, ‘8’, ‘16’], default ‘NONE’
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 draw image with 2D texture.
  • GLSL GLSL, Use GLSL shaders for display transform and draw image with 2D texture.
Type:enum in [‘AUTO’, ‘2DTEXTURE’, ‘GLSL’], default ‘AUTO’
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:float array of 3 items in [0, inf], default (0.0, 0.0, 0.0)
memory_cache_limit

Memory cache limit (in megabytes)

Type:int in [0, inf], default 0
multi_sample

Enable OpenGL multi-sampling, only for systems that support it

  • NONE No MultiSample, Do not use OpenGL MultiSample.
  • 2 MultiSample: 2, Use 2x OpenGL MultiSample.
  • 4 MultiSample: 4, Use 4x OpenGL MultiSample.
  • 8 MultiSample: 8, Use 8x OpenGL MultiSample.
  • 16 MultiSample: 16, Use 16x OpenGL MultiSample.
Type:enum in [‘NONE’, ‘2’, ‘4’, ‘8’, ‘16’], default ‘NONE’
opensubdiv_compute_type

Type of computer back-end used with OpenSubdiv

Type:enum in [‘NONE’, ‘CPU’, ‘OPENMP’], default ‘NONE’
pixel_size
Type:float in [-inf, inf], default 0.0, (readonly)
prefetch_frames

Number of frames to render ahead during playback (sequencer only)

Type:int in [0, inf], default 0
scrollback

Maximum number of lines to store for the console buffer

Type:int in [32, 32768], default 0
solid_lights

Lights user to display objects in solid draw 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 0
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 0
ui_line_width

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

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

Size multiplier to use when drawing 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_region_overlap

Draw tool/property regions over the main region

Type:boolean, default False
use_select_pick_depth

Use the depth buffer for picking 3D View selection (without this the front most object may not be selected first)

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 0
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 0
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 ‘OFF’
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