summaryrefslogblamecommitdiffstats
path: root/src/hid_core/frontend/input_converter.h
blob: c51c03e57e43ea639594813748d929a94a1693e9 (plain) (tree)
1
2
3
4
5
6
7

                                                               


            
                         
                      








                                   





                                                       
                                                                 

                                        
                                                                                               



                                                                                               
                                                                

                                      
                                                                                             



                                                      
                                               

                                      
                                                                                             




                                                                                                
                                              

                                      
                                                                                           



                                                     
                                              

                                      
                                                                                           




                                                                                           
                                                                

                                        
                                                                                               

   


                                                                                          
                                               




                                                                                             







                                                                                             


                                                   
                                   



                                                                                       







                                                                                               
                                                     

                                                                                         
   
                                                                           


                                                   


                                                                                                 
   

                                                                                                

                        
// SPDX-FileCopyrightText: Copyright 2021 yuzu Emulator Project
// SPDX-License-Identifier: GPL-2.0-or-later

#pragma once

namespace Common::Input {
struct CallbackStatus;
enum class BatteryLevel : u32;
using BatteryStatus = BatteryLevel;
struct AnalogStatus;
struct ButtonStatus;
struct MotionStatus;
struct StickStatus;
struct TouchStatus;
struct TriggerStatus;
}; // namespace Common::Input

namespace Core::HID {

/**
 * Converts raw input data into a valid battery status.
 *
 * @param callback Supported callbacks: Analog, Battery, Trigger.
 * @return A valid BatteryStatus object.
 */
Common::Input::BatteryStatus TransformToBattery(const Common::Input::CallbackStatus& callback);

/**
 * Converts raw input data into a valid button status. Applies invert properties to the output.
 *
 * @param callback Supported callbacks: Analog, Button, Trigger.
 * @return A valid TouchStatus object.
 */
Common::Input::ButtonStatus TransformToButton(const Common::Input::CallbackStatus& callback);

/**
 * Converts raw input data into a valid motion status.
 *
 * @param callback Supported callbacks: Motion.
 * @return A valid TouchStatus object.
 */
Common::Input::MotionStatus TransformToMotion(const Common::Input::CallbackStatus& callback);

/**
 * Converts raw input data into a valid stick status. Applies offset, deadzone, range and invert
 * properties to the output.
 *
 * @param callback Supported callbacks: Stick.
 * @return A valid StickStatus object.
 */
Common::Input::StickStatus TransformToStick(const Common::Input::CallbackStatus& callback);

/**
 * Converts raw input data into a valid touch status.
 *
 * @param callback Supported callbacks: Touch.
 * @return A valid TouchStatus object.
 */
Common::Input::TouchStatus TransformToTouch(const Common::Input::CallbackStatus& callback);

/**
 * Converts raw input data into a valid trigger status. Applies offset, deadzone, range and
 * invert properties to the output. Button status uses the threshold property if necessary.
 *
 * @param callback Supported callbacks: Analog, Button, Trigger.
 * @return A valid TriggerStatus object.
 */
Common::Input::TriggerStatus TransformToTrigger(const Common::Input::CallbackStatus& callback);

/**
 * Converts raw input data into a valid analog status. Applies offset, deadzone, range and
 * invert properties to the output.
 *
 * @param callback Supported callbacks: Analog.
 * @return A valid AnalogStatus object.
 */
Common::Input::AnalogStatus TransformToAnalog(const Common::Input::CallbackStatus& callback);

/**
 * Converts raw input data into a valid camera status.
 *
 * @param callback Supported callbacks: Camera.
 * @return A valid CameraObject object.
 */
Common::Input::CameraStatus TransformToCamera(const Common::Input::CallbackStatus& callback);

/**
 * Converts raw input data into a valid nfc status.
 *
 * @param callback Supported callbacks: Nfc.
 * @return A valid data tag vector.
 */
Common::Input::NfcStatus TransformToNfc(const Common::Input::CallbackStatus& callback);

/**
 * Converts raw input data into a valid color status.
 *
 * @param callback Supported callbacks: Color.
 * @return A valid Color object.
 */
Common::Input::BodyColorStatus TransformToColor(const Common::Input::CallbackStatus& callback);

/**
 * Converts raw analog data into a valid analog value
 * @param analog An analog object containing raw data and properties
 * @param clamp_value determines if the value needs to be clamped between -1.0f and 1.0f.
 */
void SanitizeAnalog(Common::Input::AnalogStatus& analog, bool clamp_value);

/**
 * Converts raw stick data into a valid stick value
 * @param analog_x raw analog data and properties for the x-axis
 * @param analog_y raw analog data and properties for the y-axis
 * @param clamp_value bool that determines if the value needs to be clamped into the unit circle.
 */
void SanitizeStick(Common::Input::AnalogStatus& analog_x, Common::Input::AnalogStatus& analog_y,
                   bool clamp_value);

} // namespace Core::HID