UserPreferencesInput(bpy_struct)

base class — bpy_struct

class bpy.types.UserPreferencesInput(bpy_struct)

Settings for input devices

active_keyconfig

The name of the active key configuration

Type:string, default “”, (never None)
drag_threshold

Amount of pixels you have to drag before dragging UI items happens

Type:int in [3, 40], default 0
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 0
navigation_mode

Which method to use for viewport navigation

  • WALK Walk, Interactively walk or free navigate around the scene.
  • FLY Fly, Use fly dynamics to navigate the scene.
Type:enum in [‘WALK’, ‘FLY’], 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 your Z position

Type:boolean, default False
ndof_lock_horizon

Keep horizon level while flying with 3D Mouse

Type:boolean, default False
ndof_orbit_sensitivity

Overall sensitivity of the 3D Mouse for orbiting

Type:float in [0.01, 40], default 0.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 False
ndof_pany_invert_axis
Type:boolean, default False
ndof_panz_invert_axis
Type:boolean, default False
ndof_rotx_invert_axis
Type:boolean, default False
ndof_roty_invert_axis
Type:boolean, default False
ndof_rotz_invert_axis
Type:boolean, default False
ndof_sensitivity

Overall sensitivity of the 3D Mouse for panning

Type:float in [0.01, 40], default 0.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 False
select_mouse

Mouse button used for selection

  • LEFT Left, Use left Mouse Button for selection.
  • RIGHT Right, Use Right Mouse Button for selection.
Type:enum in [‘LEFT’, ‘RIGHT’], default ‘RIGHT’
tweak_threshold

Number of pixels you have to drag before tweak event is triggered

Type:int in [3, 1024], default 0
use_emulate_numpad

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

Type:boolean, default False
use_mouse_continuous

Allow moving the mouse outside the view on some manipulations (transform, ui control drag)

Type:boolean, default False
use_mouse_emulate_3_button

Emulate Middle Mouse with Alt+Left Mouse (doesn’t work with Left Mouse Select option)

Type:boolean, default False
use_mouse_mmb_paste

In text window, paste with middle mouse button instead of panning

Type:boolean, default False
use_ndof
Type:boolean, default True, (readonly)
use_trackpad_natural

If your system uses ‘natural’ scrolling, this option keeps consistent trackpad usage throughout the UI

Type:boolean, default False
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 ‘TURNTABLE’
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, Old style zoom, continues while moving mouse up or down.
  • DOLLY Dolly, Zoom in and out based on vertical mouse movement.
  • SCALE Scale, Zoom in and out like scaling the view, mouse movements relative to center.
Type:enum in [‘CONTINUE’, ‘DOLLY’, ‘SCALE’], default ‘CONTINUE’
walk_navigation

Settings for walk navigation mode

Type:WalkNavigation, (readonly, never None)
wheel_scroll_lines

Number of lines scrolled at a time with the mouse wheel

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

Inherited Properties

Inherited Functions

References