qwerty_device.h

// Copyright 2021, Mateo de Mayo.
// SPDX-License-Identifier: BSL-1.0
/*!
 * @file
 * @brief Internal header for qwerty_device and its friends.
 * @author Mateo de Mayo <mateodemayo@gmail.com>
 * @ingroup drv_qwerty
 */
#pragma once

#include "util/u_logging.h"
#include "xrt/xrt_device.h"

#define QWERTY_HMD_STR "Qwerty HMD"
#define QWERTY_HMD_TRACKER_STR QWERTY_HMD_STR " Tracker"
#define QWERTY_LEFT_STR "Qwerty Left Controller"
#define QWERTY_LEFT_TRACKER_STR QWERTY_LEFT_STR " Tracker"
#define QWERTY_RIGHT_STR "Qwerty Right Controller"
#define QWERTY_RIGHT_TRACKER_STR QWERTY_RIGHT_STR " Tracker"

#ifdef __cplusplus
extern "C" {
#endif

/*!
 * @addtogroup drv_qwerty
 * @{
 */

//! Container of qwerty devices and driver properties.
struct qwerty_system
{
	struct qwerty_hmd *hmd;
	struct qwerty_controller *lctrl;
	struct qwerty_controller *rctrl;
	enum u_logging_level ll;
	bool process_keys;  //!< If false disable keyboard and mouse input
	bool hmd_focused;   //!< For gui var tracking only, true if hmd is the focused device
	bool lctrl_focused; //!< Same as `hmd_focused` but for the left controller
	bool rctrl_focused; //!< Same as `hmd_focused` but for the right controller
};

//! Fake device that modifies its tracked pose through its methods.
//! @implements xrt_device
struct qwerty_device
{
	struct xrt_device base;
	struct xrt_pose pose;      //!< Internal pose state
	struct qwerty_system *sys; //!< Reference to the system this device is in.

	float movement_speed; //!< In meters per frame
	bool left_pressed;
	bool right_pressed;
	bool forward_pressed;
	bool backward_pressed;
	bool up_pressed;
	bool down_pressed;

	float look_speed; //!< In radians per frame
	bool look_left_pressed;
	bool look_right_pressed;
	bool look_up_pressed;
	bool look_down_pressed;

	float yaw_delta;   //!< How much extra yaw to add for the next pose. Then reset to 0.
	float pitch_delta; //!< Similar to `yaw_delta`
};

//! @implements qwerty_device
struct qwerty_hmd
{
	struct qwerty_device base;
};

//! Supports input actions and can be attached to the HMD pose.
//! @implements qwerty_device
struct qwerty_controller
{
	struct qwerty_device base;

	bool select_clicked;
	bool menu_clicked;

	/*!
	 * Only used when a qwerty_hmd exists in the system.
	 * Do not modify directly; use qwerty_follow_hmd().
	 * If true, `pose` is relative to the qwerty_hmd.
	 */
	bool follow_hmd; // @todo: Make this work with non-qwerty HMDs.
};

/*!
 * @name Qwerty System
 * @memberof qwerty_system
 * qwerty_system public methods
 * @{
 */
//! @public @memberof qwerty_system <!-- Trick for doxygen -->

struct qwerty_system *
qwerty_system_create(struct qwerty_hmd *qhmd,
                     struct qwerty_controller *qleft,
                     struct qwerty_controller *qright,
                     enum u_logging_level log_level);

/*!
 * @}
 */

/*!
 * @name Qwerty Device
 * @memberof qwerty_device
 * qwerty_device public methods
 * @{
 */
//! @public @memberof qwerty_device <!-- Trick for doxygen -->

//! Cast to qwerty_device. Ensures returning a valid device or crashing.
struct qwerty_device *
qwerty_device(struct xrt_device *xd);

// clang-format off
void qwerty_press_left(struct qwerty_device *qd);
void qwerty_release_left(struct qwerty_device *qd);
void qwerty_press_right(struct qwerty_device *qd);
void qwerty_release_right(struct qwerty_device *qd);
void qwerty_press_forward(struct qwerty_device *qd);
void qwerty_release_forward(struct qwerty_device *qd);
void qwerty_press_backward(struct qwerty_device *qd);
void qwerty_release_backward(struct qwerty_device *qd);
void qwerty_press_up(struct qwerty_device *qd);
void qwerty_release_up(struct qwerty_device *qd);
void qwerty_press_down(struct qwerty_device *qd);
void qwerty_release_down(struct qwerty_device *qd);

void qwerty_press_look_left(struct qwerty_device *qd);
void qwerty_release_look_left(struct qwerty_device *qd);
void qwerty_press_look_right(struct qwerty_device *qd);
void qwerty_release_look_right(struct qwerty_device *qd);
void qwerty_press_look_up(struct qwerty_device *qd);
void qwerty_release_look_up(struct qwerty_device *qd);
void qwerty_press_look_down(struct qwerty_device *qd);
void qwerty_release_look_down(struct qwerty_device *qd);
// clang-format on

//! Add yaw and pitch movement for the next frame
void
qwerty_add_look_delta(struct qwerty_device *qd, float yaw, float pitch);

//! Change movement speed in exponential steps (usually integers, but any float allowed)
void
qwerty_change_movement_speed(struct qwerty_device *qd, float steps);

//! Release all movement input
void
qwerty_release_all(struct qwerty_device *qd);

/*!
 * @}
 */

/*!
 * @name Qwerty HMD
 * @memberof qwerty_hmd
 * qwerty_hmd public methods
 * @{
 */
//! @public @memberof qwerty_hmd <!-- Trick for doxygen -->

//! Create qwerty_hmd. Crash on failure.
struct qwerty_hmd *
qwerty_hmd_create(void);

//! Cast to qwerty_hmd. Ensures returning a valid HMD or crashing.
struct qwerty_hmd *
qwerty_hmd(struct xrt_device *xd);

/*!
 * @}
 */

/*!
 * @name Qwerty Controller
 * @memberof qwerty_controller
 * qwerty_controller public methods
 * @{
 */
//! @public @memberof qwerty_controller <!-- Trick for doxygen -->

//! Create qwerty_controller. Crash on failure.
struct qwerty_controller *
qwerty_controller_create(bool is_left, struct qwerty_hmd *qhmd);

//! Cast to qwerty_controller. Ensures returning a valid controller or crashing.
struct qwerty_controller *
qwerty_controller(struct xrt_device *xd);

//! Simulate input/select/click
void
qwerty_select_click(struct qwerty_controller *qc);

//! Simulate input/menu/click
void
qwerty_menu_click(struct qwerty_controller *qc);

//! Attach/detach the pose of `qc` to its HMD. Only works when a qwerty_hmd is present.
void
qwerty_follow_hmd(struct qwerty_controller *qc, bool follow);

//! Reset controller to initial pose and makes it follow the HMD
void
qwerty_reset_controller_pose(struct qwerty_controller *qc);

/*!
 * @}
 */

/*!
 * @}
 */

#ifdef __cplusplus
}
#endif