https://github.com/calebtt/xmaplib

A closer to the metal library for Xbox controller to keyboard and mouse input.
https://github.com/calebtt/xmaplib

controllers cpp gamepad input-simulation joystick mouse mouse-movement winapi xbox

Last synced: 10 months ago
JSON representation

A closer to the metal library for Xbox controller to keyboard and mouse input.

• Host: GitHub
• URL: https://github.com/calebtt/xmaplib
• Owner: calebtt
• License: mit
• Created: 2021-12-18T10:15:05.000Z (about 4 years ago)
• Default Branch: master
• Last Pushed: 2023-06-28T12:15:25.000Z (over 2 years ago)
• Last Synced: 2025-04-09T15:19:56.811Z (10 months ago)
• Topics: controllers, cpp, gamepad, input-simulation, joystick, mouse, mouse-movement, winapi, xbox
• Language: C++
• Homepage:
• Size: 791 KB
• Stars: 6
• Watchers: 1
• Forks: 2
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.txt

Awesome Lists containing this project

README

          
# XMapLib

[![MSBuild](https://github.com/calebtt/XMapLib/actions/workflows/msbuild.yml/badge.svg)](https://github.com/calebtt/XMapLib/actions/workflows/msbuild.yml)

A closer to the metal library for Xbox controller to keyboard and mouse input simulation on Windows

Current Features



  
Mapping of controller input to keyboard and mouse input on Windows.

  
GUI for changing key bindings

  
List of key binding presets to choose from

  
Editable list of key bindings

  
Adjustable mouse sensitivity

  
Toggleable key repeat behavior

 

 
Roadmap

 


  
Lower CPU usage

  
Portable input simulation thread priorities

  
Dep. injected timestamp retrieval, system calls for high res. clock are heavy

  
Make use of polar coordinates instead of scaling cartesian coordinates (PolarCode repo)

 

 
Possible Ideas

 


  
Integrate my PolarCode repo code

  
Portable everything

  
Run as a system service instead of on-demand app

  
Load/Save config files and share them

 

 

XMapLibSharp is a C# .NET GUI project using the C++ project code through a DLL. With this approach,

the project has access to the entire .NET framework for GUI work while keeping the native performance and power of the C++ XMapLib project code.

  
The project utilizes 



  
.NET multi-threading
 

  
events
 

  
programmatic UI element creation
 

  
a producer/consumer design pattern.

  
managed/native interop via custom C++ DLL







  

  
A high level code diagram of the XMapLib project code (native C++)

  

  
The project utilizes

  


    
C++ templates

    
Template SFINAE

    
constexpr

    
unit testing with Microsoft CppUnitTestingFramework



    
multi-threading, many threads running concurrently and interacting
 

    
concurrency synchronization objects, like mutexes and RAII scoped locks

    
C++ standard atomics

    
lambdas, and passing lambdas as arguments

    
usage of several Windows API functions including the XInput lib

    
operator overloads

    
input simulation

    
C++ pointer wrappers like unique_ptr

    
if-constexpr to do compile-time decisions instead of run-time

    
STL containers and algorithms

    
it is a real time system (or very close)

    
lots and lots of object oriented programming

    

    


  The main classes for use in the native C++ XMapLib project are :

 


MouseMapper

KeyboardMapper

MousePlayerInfo

KeyboardPlayerInfo

To set the mapping details KeyboardKeyMap encapsulates the information comprising a controller key to keyboard/mouse key mapping.

  

Also, please see the Example


The DLL API exposed from XMapLibDLL is described totally in apifuncs.h in the DLL project.