PreferencesView(bpy_struct)

base class — bpy_struct

class bpy.types.PreferencesView(bpy_struct)

Preferences related to viewing data

border_width

Size of the padding around each editor. (in [1, 10], default 2)

Type:

int

color_picker_type

Different styles of displaying the color picker widget (default 'CIRCLE_HSV')

  • CIRCLE_HSV Circle (HSV) – A circular Hue/Saturation color wheel, with Value slider.

  • CIRCLE_HSL Circle (HSL) – A circular Hue/Saturation color wheel, with Lightness slider.

  • SQUARE_SV Square (SV + H) – A square showing Saturation/Value, with Hue slider.

  • SQUARE_HS Square (HS + V) – A square showing Hue/Saturation, with Value slider.

  • SQUARE_HV Square (HV + S) – A square showing Hue/Value, with Saturation slider.

Type:

Literal[‘CIRCLE_HSV’, ‘CIRCLE_HSL’, ‘SQUARE_SV’, ‘SQUARE_HS’, ‘SQUARE_HV’]

factor_display_type

How factor values are displayed (default 'FACTOR')

  • FACTOR Factor – Display factors as values between 0 and 1.

  • PERCENTAGE Percentage – Display factors as percentages.

Type:

Literal[‘FACTOR’, ‘PERCENTAGE’]

filebrowser_display_type

Default location where the File Editor will be displayed in (default 'WINDOW')

  • SCREEN Maximized Area – Open the temporary editor in a maximized screen.

  • WINDOW New Window – Open the temporary editor in a new window.

Type:

Literal[‘SCREEN’, ‘WINDOW’]

font_path_ui

Path to interface font (default “”, never None)

Type:

str

font_path_ui_mono

Path to interface monospaced Font (default “”, never None)

Type:

str

gizmo_size

Diameter of the gizmo (in [10, 200], default 75)

Type:

int

gizmo_size_navigate_v3d

The Navigate Gizmo size (in [30, 200], default 80)

Type:

int

header_align

Default header position for new space-types (default 'BOTTOM')

  • NONE Keep Existing – Keep existing header alignment.

  • TOP Top – Top aligned on load.

  • BOTTOM Bottom – Bottom align on load (except for property editors).

Type:

Literal[‘NONE’, ‘TOP’, ‘BOTTOM’]

language

Language used for translation (default 'DEFAULT')

  • DEFAULT Automatic – Automatically choose the system-defined language if available, or fall-back to English (US).

  • ab Abkhaz - Аԥсуа бызшәа – Locale code: ab. Translation progress: 0%.

  • ar_EG Arabic - ﺔﻴﺑﺮﻌﻟﺍ – Locale code: ar_EG. Translation progress: 23%.

  • eu_EU Basque - Euskara – Locale code: eu_EU. Translation progress: 1%.

  • be Belarusian - Беларуская – Locale code: be. Translation progress: 0%.

  • bg_BG Bulgarian - Български – Locale code: bg_BG. Translation progress: 1%.

  • ca_AD Catalan - Català – Locale code: ca_AD. Translation progress: 100%.

  • zh_HANS Chinese (Simplified) - 简体中文 – Locale code: zh_HANS. Translation progress: 100%.

  • zh_HANT Chinese (Traditional) - 繁體中文 – Locale code: zh_HANT. Translation progress: 62%.

  • cs_CZ Czech - Čeština – Locale code: cs_CZ. Translation progress: 27%.

  • da Danish - Dansk – Locale code: da. Translation progress: 3%.

  • nl_NL Dutch - Nederlands – Locale code: nl_NL. Translation progress: 8%.

  • en_GB English (UK) – Locale code: en_GB. Translation progress: 99%.

  • en_US English (US) – Locale code: en_US. Translation progress: 100%.

  • eo Esperanto - Esperanto – Locale code: eo. Translation progress: 0%.

  • fi_FI Finnish - Suomi – Locale code: fi_FI. Translation progress: 11%.

  • fr_FR French - Français – Locale code: fr_FR. Translation progress: 99%.

  • ka Georgian - ქართული – Locale code: ka. Translation progress: 100%.

  • de_DE German - Deutsch – Locale code: de_DE. Translation progress: 37%.

  • el_GR Greek - Ελληνικά – Locale code: el_GR. Translation progress: 1%.

  • he_IL Hebrew - תירִבְעִ – Locale code: he_IL. Translation progress: 2%.

  • hi_IN Hindi - हिन्दी – Locale code: hi_IN. Translation progress: 4%.

  • hu_HU Hungarian - Magyar – Locale code: hu_HU. Translation progress: 11%.

  • id_ID Indonesian - Bahasa indonesia – Locale code: id_ID. Translation progress: 21%.

  • it_IT Italian - Italiano – Locale code: it_IT. Translation progress: 44%.

  • ja_JP Japanese - 日本語 – Locale code: ja_JP. Translation progress: 99%.

  • ko_KR Korean - 한국어 – Locale code: ko_KR. Translation progress: 98%.

  • ky_KG Kyrgyz - Кыргыз тили – Locale code: ky_KG. Translation progress: 2%.

  • lt Lithuanian - Lietuviškai – Locale code: lt. Translation progress: 3%.

  • ml Malayalam - മലയാളം – Locale code: ml. Translation progress: 0%.

  • nb Norwegian (Bokmål) - Norsk bokmål – Locale code: nb. Translation progress: 4%.

  • fa_IR Persian - ﯽﺳﺭﺎﻓ – Locale code: fa_IR. Translation progress: 3%.

  • pl_PL Polish - Polski – Locale code: pl_PL. Translation progress: 100%.

  • pt_BR Portuguese (Brazil) - Português brasileiro – Locale code: pt_BR. Translation progress: 43%.

  • pt_PT Portuguese (Portugal) - Português europeu – Locale code: pt_PT. Translation progress: 77%.

  • ro_RO Romanian - Român – Locale code: ro_RO. Translation progress: 2%.

  • ru_RU Russian - Русский – Locale code: ru_RU. Translation progress: 100%.

  • sr_RS Serbian (Cyrillic) - Српски – Locale code: sr_RS. Translation progress: 16%.

  • sr_RS@latin Serbian (Latin) - Srpski latinica – Locale code: sr_RS@latin. Translation progress: 16%.

  • sk_SK Slovak - Slovenčina – Locale code: sk_SK. Translation progress: 100%.

  • sl Slovenian - Slovenščina – Locale code: sl. Translation progress: 51%.

  • es Spanish - Español – Locale code: es. Translation progress: 100%.

  • sw Swahili - Kiswahili – Locale code: sw. Translation progress: 72%.

  • sv_SE Swedish - Svenska – Locale code: sv_SE. Translation progress: 21%.

  • ta Tamil - தமிழ் – Locale code: ta. Translation progress: 93%.

  • th_TH Thai - ภาษาไทย – Locale code: th_TH. Translation progress: 5%.

  • tr_TR Turkish - Türkçe – Locale code: tr_TR. Translation progress: 78%.

  • uk_UA Ukrainian - Українська – Locale code: uk_UA. Translation progress: 57%.

  • ur Urdu - وُدرُا – Locale code: ur. Translation progress: 86%.

  • vi_VN Vietnamese - Tiếng Việt – Locale code: vi_VN. Translation progress: 93%.

Type:

Literal[‘DEFAULT’, ‘ab’, ‘ar_EG’, ‘eu_EU’, ‘be’, ‘bg_BG’, ‘ca_AD’, ‘zh_HANS’, ‘zh_HANT’, ‘cs_CZ’, ‘da’, ‘nl_NL’, ‘en_GB’, ‘en_US’, ‘eo’, ‘fi_FI’, ‘fr_FR’, ‘ka’, ‘de_DE’, ‘el_GR’, ‘he_IL’, ‘hi_IN’, ‘hu_HU’, ‘id_ID’, ‘it_IT’, ‘ja_JP’, ‘ko_KR’, ‘ky_KG’, ‘lt’, ‘ml’, ‘nb’, ‘fa_IR’, ‘pl_PL’, ‘pt_BR’, ‘pt_PT’, ‘ro_RO’, ‘ru_RU’, ‘sr_RS’, ‘sr_RS@latin’, ‘sk_SK’, ‘sl’, ‘es’, ‘sw’, ‘sv_SE’, ‘ta’, ‘th_TH’, ‘tr_TR’, ‘uk_UA’, ‘ur’, ‘vi_VN’]

lookdev_sphere_size

Diameter of the HDRI reference spheres (in [50, 400], default 150)

Type:

int

menu_close_leave

Close menus when the mouse is moved out of the region. (default False)

Type:

bool

mini_axis_brightness

Brightness of the icon (in [0, 10], default 8)

Type:

int

mini_axis_size

The axes icon’s size (in [10, 64], default 25)

Type:

int

mini_axis_type

Show small rotating 3D axes in the top right corner of the 3D viewport (default 'GIZMO')

Type:

Literal[‘NONE’, ‘MINIMAL’, ‘GIZMO’]

open_sublevel_delay

Time delay in 1/10 seconds before automatically opening sub level menus (in [1, 40], default 2)

Type:

int

open_toplevel_delay

Time delay in 1/10 seconds before automatically opening top level menus (in [1, 40], default 5)

Type:

int

pie_animation_timeout

Time needed to fully animate the pie to unfolded state (in 1/100ths of sec) (in [0, 1000], default 6)

Type:

int

pie_initial_timeout

Pie menus will use the initial mouse position as center for this amount of time (in 1/100ths of sec) (in [0, 1000], default 0)

Type:

int

pie_menu_confirm

Distance threshold after which selection is made (zero to disable) (in [0, 1000], default 0)

Type:

int

pie_menu_radius

Pie menu size in pixels (in [0, 1000], default 100)

Type:

int

pie_menu_threshold

Distance from center needed before a selection can be made (in [0, 1000], default 12)

Type:

int

pie_tap_timeout

Pie menu button held longer than this will dismiss menu on release (in 1/100ths of sec) (in [0, 1000], default 20)

Type:

int

playback_fps_samples

The number of frames to use for calculating FPS average. Zero to calculate this automatically, where the number of samples matches the target FPS. (in [0, 5000], default 8)

Type:

int

preferences_display_type

Default location where the Preferences will be displayed in (default 'WINDOW')

  • SCREEN Maximized Area – Open the temporary editor in a maximized screen.

  • WINDOW New Window – Open the temporary editor in a new window.

Type:

Literal[‘SCREEN’, ‘WINDOW’]

render_display_type

Default location where rendered images will be displayed in (default 'WINDOW')

  • NONE Keep User Interface – Images are rendered without changing the user interface.

  • SCREEN Maximized Area – Images are rendered in a maximized Image Editor.

  • AREA Image Editor – Images are rendered in an Image Editor.

  • WINDOW New Window – Images are rendered in a new window.

Type:

Literal[‘NONE’, ‘SCREEN’, ‘AREA’, ‘WINDOW’]

rotation_angle

Rotation step for numerical pad keys (2 4 6 8) (in [0, 90], default 15.0)

Type:

float

show_addons_enabled_only

Only show enabled add-ons. Un-check to see all installed add-ons. (default False)

Type:

bool

show_area_handle

Show visible area maintenance corner handles (default False)

Type:

bool

show_column_layout

Use a column layout for toolbox (default True)

Type:

bool

show_developer_ui

Display advanced settings and tools for developers (default False)

Type:

bool

show_extensions_updates

Show Extensions Update Count (default True)

Type:

bool

show_gizmo

Use transform gizmos by default (default True)

Type:

bool

show_navigate_ui

Show navigation controls in 2D and 3D views which do not have scroll bars (default True)

Type:

bool

show_number_arrows

Display arrows in numeric input fields for increasing or decreasing values (default False)

Type:

bool

show_object_info

Include the name of the active object and the current frame number in the text info overlay (default True)

Type:

bool

show_online_assets

When internet access is enabled, load and display online assets in asset shelves (default True)

Type:

bool

show_playback_fps

Include the number of frames displayed per second in the text info overlay while animation is played back (default True)

Type:

bool

show_splash

Display splash screen on startup (default True)

Type:

bool

show_statusbar_memory

Show Blender memory usage (default False)

Type:

bool

show_statusbar_scene_duration

Show scene duration (default False)

Type:

bool

show_statusbar_stats

Show scene statistics (default False)

Type:

bool

show_statusbar_version

Show Blender version string (default True)

Type:

bool

show_statusbar_vram

Show GPU video memory usage (default False)

Type:

bool

show_tooltips

Display tooltips (when disabled, hold Alt then hover to force display) (default True)

Type:

bool

show_tooltips_python

Show Python references in tooltips (default False)

Type:

bool

show_view_name

Include the name of the view orientation in the text info overlay (default True)

Type:

bool

smooth_view

Time to animate the view in milliseconds, zero to disable (in [0, 1000], default 200)

Type:

int

text_hinting

Method for making user interface text render sharp (default 'AUTO')

Type:

Literal[‘AUTO’, ‘NONE’, ‘SLIGHT’, ‘FULL’]

timecode_style

Format of timecode displayed when not displaying timing in terms of frames (default 'MINIMAL')

  • MINIMAL Minimal Info – Most compact representation, uses ‘+’ as separator for sub-second frame numbers, with left and right truncation of the timecode as necessary.

  • SMPTE SMPTE (Full) – Full SMPTE timecode (format is HH:MM:SS:FF).

  • SMPTE_COMPACT SMPTE (Compact) – SMPTE timecode showing minutes, seconds, and frames only - hours are also shown if necessary, but not by default.

  • MILLISECONDS Compact with Decimals – Similar to SMPTE (Compact), except that the decimal part of the second is shown instead of frames.

  • SECONDS_ONLY Only Seconds – Direct conversion of frame numbers to seconds.

Type:

Literal[‘MINIMAL’, ‘SMPTE’, ‘SMPTE_COMPACT’, ‘MILLISECONDS’, ‘SECONDS_ONLY’]

ui_line_width

Changes the thickness of widget outlines, lines and dots in the interface (default 'AUTO')

  • THIN Thin – Thinner lines than the default.

  • AUTO Default – Automatic line width based on UI scale.

  • THICK Thick – Thicker lines than the default.

Type:

Literal[‘THIN’, ‘AUTO’, ‘THICK’]

ui_scale

Changes the size of the fonts and widgets in the interface (in [0.5, 6], default 1.0)

Type:

float

use_filter_brushes_by_tool

Only show brushes applicable for the currently active tool in the asset shelf. Stored in the Preferences, which may have to be saved manually if Auto-Save Preferences is disabled (default False)

Type:

bool

use_fresnel_edit

Enable a fresnel effect on edit mesh overlays. It improves shape readability of very dense meshes, but increases eye fatigue when modeling lower poly

(default False)

Type:

bool

use_mouse_over_open

Open menu buttons and pull-downs automatically when the mouse is hovering (default False)

Type:

bool

use_reduce_motion

Avoid animations and other motion effects in the interface (default False)

Type:

bool

use_save_prompt

Ask for confirmation when quitting with unsaved changes (default True)

Type:

bool

use_text_antialiasing

Smooth jagged edges of user interface text (default True)

Type:

bool

use_text_render_subpixelaa

Render text for optimal horizontal placement (default False)

Type:

bool

use_translate_interface

Translate all labels in menus, buttons and panels (note that this might make it hard to follow tutorials or the manual) (default True)

Type:

bool

use_translate_new_dataname

Translate the names of new data-blocks (objects, materials…) (default True)

Type:

bool

use_translate_reports

Translate additional information, such as error messages (default True)

Type:

bool

use_translate_tooltips

Translate the descriptions when hovering UI elements (recommended) (default True)

Type:

bool

use_weight_color_range

Enable color range used for weight visualization in weight painting mode (default False)

Type:

bool

view2d_grid_spacing_min

Minimum number of pixels between each gridline in 2D Viewports (in [1, 500], default 45)

Type:

int

view_frame_keyframes

Keyframes around cursor that we zoom around (in [1, 500], default 0)

Type:

int

view_frame_seconds

Seconds around cursor that we zoom around (in [0, 10000], default 0.0)

Type:

float

view_frame_type

How zooming to frame focuses around current frame (default 'KEEP_RANGE')

Type:

Literal[‘KEEP_RANGE’, ‘SECONDS’, ‘KEYFRAMES’]

weight_color_range

Color range used for weight visualization in weight painting mode (readonly, never None)

Type:

ColorRamp

classmethod bl_rna_get_subclass(id, default=None, /)
Parameters:

  • id (str) – The RNA type identifier.

  • default (bpy.types.Struct | None) – The value to return when not found.

Returns:

The RNA type or default when not found.

Return type:

bpy.types.Struct

classmethod bl_rna_get_subclass_py(id, default=None, /)
Parameters:

  • id (str) – The RNA type identifier.

  • default (type | None) – The value to return when not found.

Returns:

The class or default when not found.

Return type:

type

Inherited Properties

Inherited Functions

References