PreferencesInput(bpy_struct)#

base class — bpy_struct

class bpy.types.PreferencesInput(bpy_struct)#

Settings for input devices

drag_threshold#

Number of pixels to drag before a drag event is triggered for keyboard and other non mouse/tablet input (otherwise click events are detected)

Type:

int in [1, 255], default 30

drag_threshold_mouse#

Number of pixels to drag before a drag event is triggered for mouse/trackpad input (otherwise click events are detected)

Type:

int in [1, 255], default 3

drag_threshold_tablet#

Number of pixels to drag before a drag event is triggered for tablet input (otherwise click events are detected)

Type:

int in [1, 255], default 10

invert_mouse_zoom#

Invert the axis of mouse movement for zooming

Type:

boolean, default False

invert_zoom_wheel#

Swap the Mouse Wheel zoom direction

Type:

boolean, default False

mouse_double_click_time#

Time/delay (in ms) for a double click

Type:

int in [1, 1000], default 350

mouse_emulate_3_button_modifier#

Hold this modifier to emulate the middle mouse button

Type:

enum in [‘ALT’, ‘OSKEY’], default ‘ALT’

move_threshold#

Number of pixels to before the cursor is considered to have moved (used for cycling selected items on successive clicks)

Type:

int in [0, 255], default 2

navigation_mode#

Which method to use for viewport navigation

Type:

enum in Navigation Mode Items, default ‘WALK’

ndof_deadzone#

Threshold of initial movement needed from the device’s rest position

Type:

float in [0, 1], default 0.0

ndof_fly_helicopter#

Device up/down directly controls the Z position of the 3D viewport

Type:

boolean, default False

ndof_lock_camera_pan_zoom#

Pan/zoom the camera view instead of leaving the camera view when orbiting

Type:

boolean, default True

ndof_lock_horizon#

Keep horizon level while flying with 3D Mouse

Type:

boolean, default True

ndof_orbit_sensitivity#

Overall sensitivity of the 3D Mouse for orbiting

Type:

float in [0.01, 40], default 4.0

ndof_pan_yz_swap_axis#

Pan using up/down on the device (otherwise forward/backward)

Type:

boolean, default False

ndof_panx_invert_axis#
Type:

boolean, default True

ndof_pany_invert_axis#
Type:

boolean, default True

ndof_panz_invert_axis#
Type:

boolean, default True

ndof_rotx_invert_axis#
Type:

boolean, default True

ndof_roty_invert_axis#
Type:

boolean, default True

ndof_rotz_invert_axis#
Type:

boolean, default True

ndof_sensitivity#

Overall sensitivity of the 3D Mouse for panning

Type:

float in [0.01, 40], default 4.0

ndof_show_guide#

Display the center and axis during rotation

Type:

boolean, default False

ndof_view_navigate_method#

Navigation style in the viewport

  • FREE Free – Use full 6 degrees of freedom by default.

  • ORBIT Orbit – Orbit about the view center by default.

Type:

enum in [‘FREE’, ‘ORBIT’], default ‘FREE’

ndof_view_rotate_method#

Rotation style in the viewport

  • TURNTABLE Turntable – Use turntable style rotation in the viewport.

  • TRACKBALL Trackball – Use trackball style rotation in the viewport.

Type:

enum in [‘TURNTABLE’, ‘TRACKBALL’], default ‘TRACKBALL’

ndof_zoom_invert#

Zoom using opposite direction

Type:

boolean, default True

pressure_softness#

Adjusts softness of the low pressure response onset using a gamma curve

Type:

float in [-inf, inf], default 0.0

pressure_threshold_max#

Raw input pressure value that is interpreted as 100% by Blender

Type:

float in [0, 1], default 1.0

tablet_api#

Select the tablet API to use for pressure sensitivity (may require restarting Blender for changes to take effect)

  • AUTOMATIC Automatic – Automatically choose Wintab or Windows Ink depending on the device.

  • WINDOWS_INK Windows Ink – Use native Windows Ink API, for modern tablet and pen devices. Requires Windows 8 or newer..

  • WINTAB Wintab – Use Wintab driver for older tablets and Windows versions.

Type:

enum in [‘AUTOMATIC’, ‘WINDOWS_INK’, ‘WINTAB’], default ‘AUTOMATIC’

touchpad_scroll_direction#

Scroll direction (Wayland only)

  • TRADITIONAL Traditional – Traditional scroll direction.

  • NATURAL Natural – Natural scroll direction.

Type:

enum in [‘TRADITIONAL’, ‘NATURAL’], default ‘TRADITIONAL’

use_auto_perspective#

Automatically switch between orthographic and perspective when changing from top/front/side views

Type:

boolean, default True

use_drag_immediately#

Moving things with a mouse drag confirms when releasing the button

Type:

boolean, default True

use_emulate_numpad#

Main 1 to 0 keys act as the numpad ones (useful for laptops)

Type:

boolean, default False

use_mouse_continuous#

Let the mouse wrap around the view boundaries so mouse movements are not limited by the screen size (used by transform, dragging of UI controls, etc.)

Type:

boolean, default True

use_mouse_depth_navigate#

Use the depth under the mouse to improve view pan/rotate/zoom functionality

Type:

boolean, default False

use_mouse_emulate_3_button#

Emulate Middle Mouse with Alt+Left Mouse

Type:

boolean, default False

use_multitouch_gestures#

Use multi-touch gestures for navigation with touchpad, instead of scroll wheel emulation

Type:

boolean, default False

use_numeric_input_advanced#

When entering numbers while transforming, default to advanced mode for full math expression evaluation

Type:

boolean, default False

use_rotate_around_active#

Use selection as the pivot point

Type:

boolean, default False

use_zoom_to_mouse#

Zoom in towards the mouse pointer’s position in the 3D view, rather than the 2D window center

Type:

boolean, default False

view_rotate_method#

Orbit method in the viewport

  • TURNTABLE Turntable – Turntable keeps the Z-axis upright while orbiting.

  • TRACKBALL Trackball – Trackball allows you to tumble your view at any angle.

Type:

enum in [‘TURNTABLE’, ‘TRACKBALL’], default ‘TURNTABLE’

view_rotate_sensitivity_trackball#

Scale trackball orbit sensitivity

Type:

float in [0.1, 10], default 1.0

view_rotate_sensitivity_turntable#

Rotation amount per pixel to control how fast the viewport orbits

Type:

float in [1.74533e-05, 0.261799], default 0.00698132

view_zoom_axis#

Axis of mouse movement to zoom in or out on

  • VERTICAL Vertical – Zoom in and out based on vertical mouse movement.

  • HORIZONTAL Horizontal – Zoom in and out based on horizontal mouse movement.

Type:

enum in [‘VERTICAL’, ‘HORIZONTAL’], default ‘VERTICAL’

view_zoom_method#

Which style to use for viewport scaling

  • CONTINUE Continue – Continuous zooming. The zoom direction and speed depends on how far along the set Zoom Axis the mouse has moved..

  • DOLLY Dolly – Zoom in and out based on mouse movement along the set Zoom Axis.

  • SCALE Scale – Zoom in and out as if you are scaling the view, mouse movements relative to center.

Type:

enum in [‘CONTINUE’, ‘DOLLY’, ‘SCALE’], default ‘DOLLY’

walk_navigation#

Settings for walk navigation mode

Type:

WalkNavigation, (readonly, never None)

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#