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¶
Keep horizon level while flying with 3D Mouse
- Type:
boolean, default True
- 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¶
Use selected item forces the orbit center to only take the currently selected objects into account.
- Type:
boolean, default False
- 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_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
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 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