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
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
Lock Horizon forces the horizon to be kept leveled as it currently is
- Type
boolean, default True
3D Mouse Navigation Mode
OBJECT
Object – This mode is like reaching into the screen and holding the model in your hand. Push the 3D Mouse cap left, and the model moves left. Push right and the model moves right.FLY
Fly – Enables using the 3D Mouse as if it is a camera. Push into the scene and the camera moves forward into the scene. You are entering the scene as if flying around in it.
- Type
enum in [
'OBJECT'
,'FLY'
], default"'OBJECT'"
- ndof_orbit_center_auto
Auto sets the orbit center dynamically. When the complete model is in view, the center of volume of the whole model is used as the rotation point. When you move closer, the orbit center will be set on an object close to your center of the view.
- Type
boolean, default True
- ndof_orbit_center_selected
Selected Item forces the orbit center to only take the currently selected objects into account.
- 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_rotation_sensitivity
Overall sensitivity of the 3D Mouse for rotation
- Type
float in [0.01, 40], default 4.0
- 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_show_guide_orbit_axis
Display the center and axis during rotation
- Type
boolean, default False
- ndof_show_guide_orbit_center
Display the orbit center during rotation
- Type
boolean, default True
- ndof_translation_sensitivity
Overall sensitivity of the 3D Mouse for translation
- Type
float in [0.01, 40], default 4.0
- ndof_zoom_direction
Which axis of the 3D Mouse cap zooms the view
NDOF_ZOOM_FORWARD
Forward/Backward – Zoom by pulling the 3D Mouse cap upwards or pushing the cap downwards.NDOF_ZOOM_UP
Up/Down – Zoom by pulling the 3D Mouse cap upwards or pushing the cap downwards.
- Type
enum in [
'NDOF_ZOOM_FORWARD'
,'NDOF_ZOOM_UP'
], default"'NDOF_ZOOM_FORWARD'"
- 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 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 True
- 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'"
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