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 tweak/drag event is triggered for mouse/track-pad input (otherwise click events are detected)
- Type
int in [1, 255], default 3
-
drag_threshold_tablet
¶ Number of pixels to drag before a tweak/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
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
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.1
-
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 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
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
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’
-
use_auto_perspective
¶ Automatically switch between orthographic and perspective when changing from top/front/side views
- Type
boolean, default True
-
use_camera_lock_parent
¶ When the camera is locked to the view and in fly mode, transform the parent rather than the camera
- Type
boolean, default False
-
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
¶ Allow moving the mouse outside the view on some manipulations (transform, ui control drag)
- Type
boolean, default True
Use the depth under the mouse to improve view pan/rotate/zoom functionality
- Type
boolean, default False
Emulate Middle Mouse with Alt+Left Mouse
- Type
boolean, default False
-
use_ndof
¶ - Type
boolean, default True, (readonly)
-
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_trackpad_natural
¶ If your system uses ‘natural’ scrolling, this option keeps consistent trackpad usage throughout the UI
- 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’
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 3
-
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