mirror of
https://github.com/qelectrotech/qelectrotech-source-mirror.git
synced 2026-10-13 16:34:14 +02:00
ispyisail
aaeaff55cc
The 3D mouse only worked on Linux, through spacenavd. This adds a second backend that reads the device directly over USB through hidapi, with no 3Dconnexion driver or SDK: the route to Windows and macOS (discussion #599), and usable on Linux without spacenavd. SpaceMouseHid decodes the raw reports from the device's own report descriptor -- where each axis and button sits, its range, absolute or relative -- so no per-model table is needed, with the classic report 1/2/3 layout as a fallback when the descriptor cannot be read and the 0x1c button list newer devices send. Absolute axes are rescaled to +-500 exactly as spacenavd does, so both backends give QET the same values. HidBackend polls from the main thread (fast while moving, slow when still), emits one sample per poll, and looks for a device every 3 s so plugging one in or back in needs no restart. QET_SPACEMOUSE_BACKEND (auto, spnav, hid) picks the backend; auto keeps libspnav on Linux when it is found and uses hidapi otherwise. hidapi is found through pkg-config as hidapi-hidraw (Linux) or hidapi (MSYS2, Homebrew). A sample arriving in the same millisecond as the previous one now counts for no time instead of a full period, so a burst of queued samples no longer moves the view further than the time it covers. Tested without a device: tst_spacemousehid (descriptor parsing, broken and hostile descriptors, every report form, recordings from real devices once they are added to fixtures/spacemouse), and end to end on Linux through a virtual USB device created with /dev/uhid: the same moves give byte-identical screenshots through the hidapi and libspnav backends, an absolute axis is rescaled as spacenavd does, buttons trigger their bound action, and unplugging and replugging while QET runs (including with a dialog open that a device button opened) reconnects cleanly. Not tested on Windows, macOS or real hardware. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
84 lines
3.6 KiB
CMake
84 lines
3.6 KiB
CMake
# Copyright 2006 The QElectroTech Team
|
|
# This file is part of QElectroTech.
|
|
#
|
|
# QElectroTech is free software: you can redistribute it and/or modify
|
|
# it under the terms of the GNU General Public License as published by
|
|
# the Free Software Foundation, either version 2 of the License, or
|
|
# (at your option) any later version.
|
|
#
|
|
# QElectroTech is distributed in the hope that it will be useful,
|
|
# but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
# GNU General Public License for more details.
|
|
#
|
|
# You should have received a copy of the GNU General Public License
|
|
# along with QElectroTech. If not, see <http://www.gnu.org/licenses/>.
|
|
|
|
message(" - find_spacemouse")
|
|
|
|
# QET_ENABLE_SPACEMOUSE (cmake/developer_options.cmake) is off by default,
|
|
# so none of this runs, and the default build is entirely unaffected: no new
|
|
# dependency, no new source files, no new symbols.
|
|
#
|
|
# When it is on, QET_SPACEMOUSE_BACKEND picks how the device is read -- see
|
|
# sources/spacemouse/spacemousebackend.h for what a backend is:
|
|
# spnav Linux, through the spacenavd daemon (libspnav)
|
|
# hid any platform, directly over USB (hidapi), no 3Dconnexion driver
|
|
# auto spnav on Linux when libspnav is found, hid otherwise
|
|
# A backend whose library is not found downgrades the option to off with a
|
|
# warning, rather than failing configure for an opt-in feature.
|
|
set(QET_SPACEMOUSE_BACKEND "auto" CACHE STRING "3D mouse backend: auto, spnav or hid")
|
|
set_property(CACHE QET_SPACEMOUSE_BACKEND PROPERTY STRINGS auto spnav hid)
|
|
|
|
set(QET_SPACEMOUSE_ENABLED FALSE)
|
|
set(QET_SPACEMOUSE_BACKEND_SPNAV_ENABLED FALSE)
|
|
set(QET_SPACEMOUSE_BACKEND_HID_ENABLED FALSE)
|
|
|
|
if(QET_ENABLE_SPACEMOUSE)
|
|
find_package(PkgConfig)
|
|
|
|
set(_qet_spacemouse_try_spnav FALSE)
|
|
set(_qet_spacemouse_try_hid FALSE)
|
|
if(QET_SPACEMOUSE_BACKEND STREQUAL "spnav")
|
|
set(_qet_spacemouse_try_spnav TRUE)
|
|
elseif(QET_SPACEMOUSE_BACKEND STREQUAL "hid")
|
|
set(_qet_spacemouse_try_hid TRUE)
|
|
else()
|
|
if(UNIX AND NOT APPLE)
|
|
set(_qet_spacemouse_try_spnav TRUE)
|
|
endif()
|
|
set(_qet_spacemouse_try_hid TRUE)
|
|
endif()
|
|
|
|
# libspnav: Debian/Ubuntu's libspnav-dev ships spnav.pc.
|
|
if(_qet_spacemouse_try_spnav AND PkgConfig_FOUND)
|
|
pkg_check_modules(SPNAV IMPORTED_TARGET spnav)
|
|
if(SPNAV_FOUND)
|
|
set(QET_SPACEMOUSE_ENABLED TRUE)
|
|
set(QET_SPACEMOUSE_BACKEND_SPNAV_ENABLED TRUE)
|
|
add_definitions(-DQET_SPACEMOUSE_BACKEND_SPNAV)
|
|
message("QET_ENABLE_SPACEMOUSE ON (backend: libspnav ${SPNAV_VERSION})")
|
|
endif()
|
|
endif()
|
|
|
|
# hidapi: hidapi-hidraw.pc on Linux (libhidapi-dev), hidapi.pc from
|
|
# MSYS2 (mingw-w64-ucrt-x86_64-hidapi) and Homebrew (hidapi).
|
|
if(NOT QET_SPACEMOUSE_ENABLED AND _qet_spacemouse_try_hid AND PkgConfig_FOUND)
|
|
pkg_search_module(HIDAPI IMPORTED_TARGET hidapi-hidraw hidapi)
|
|
if(HIDAPI_FOUND)
|
|
set(QET_SPACEMOUSE_ENABLED TRUE)
|
|
set(QET_SPACEMOUSE_BACKEND_HID_ENABLED TRUE)
|
|
add_definitions(-DQET_SPACEMOUSE_BACKEND_HID)
|
|
message("QET_ENABLE_SPACEMOUSE ON (backend: hidapi ${HIDAPI_VERSION})")
|
|
endif()
|
|
endif()
|
|
|
|
if(QET_SPACEMOUSE_ENABLED)
|
|
add_definitions(-DQET_SPACEMOUSE_SUPPORT)
|
|
else()
|
|
message(WARNING "QET_ENABLE_SPACEMOUSE is ON but no library was found for the "
|
|
"'${QET_SPACEMOUSE_BACKEND}' backend (libspnav-dev for spnav, "
|
|
"hidapi for hid, via pkg-config) -- building WITHOUT 3D mouse support.")
|
|
endif()
|
|
endif()
|