GamepadSettingsWidget Class

A configuration widget for adjusting gamepad input settings. More...

Declaration

class helios::ext::imgui::widgets::GamepadSettingsWidget { ... }

Base class

class	ImGuiWidget
	Abstract base class for ImGui widgets rendered in debug overlays. More...

Public Constructors Index

	GamepadSettingsWidget (helios::input::InputAdapter *inputAdapter)
	Constructs the GamepadSettingsWidget. More...

Public Member Functions Index

void	draw () override
	Renders the gamepad settings configuration interface. More...

Private Member Attributes Index

helios::input::InputAdapter *	inputAdapter_ = nullptr
	Pointer to the InputAdapter used to access gamepad settings. Non-owning pointer; must be valid for the lifetime of this widget. More...
int	selectedGamepadIndex_ = 0
	The currently selected gamepad index in the UI combo box (0-3). More...

Private Static Functions Index

static helios::input::types::Gamepad	indexToId (int index) noexcept
	Helper to map an integer index (0-3) to a Gamepad enum ID. More...

Description

A configuration widget for adjusting gamepad input settings.

This widget provides interactive controls for configuring per-gamepad settings including deadzone thresholds and axis inversion options. Changes are applied in real-time to the underlying InputAdapter's GamepadSettings.

**Features:**

• **Gamepad Selection:** Switch between controllers (1-4) via dropdown.
• **Deadzone Sliders:** Adjust left/right stick deadzone thresholds (0.0 to 0.9).
• **Axis Inversion:** Toggle X/Y axis inversion for both sticks.
• **Visual Feedback:** Deadzone values displayed as percentage.

info

Changes are applied immediately to the InputAdapter. No explicit save required.

info

This widget is not thread-safe. Use from the main/render thread only.

See Also

GamepadSettings for the underlying configuration data.

See Also

GamepadWidget for real-time input visualization.

Definition at line 39 of file GamepadSettingsWidget.ixx.

Public Constructors

GamepadSettingsWidget()

helios::ext::imgui::widgets::GamepadSettingsWidget::GamepadSettingsWidget (helios::input::InputAdapter * inputAdapter)

inline explicit

Constructs the GamepadSettingsWidget.

Parameters

inputAdapter

Pointer to the InputAdapter to configure. Pass nullptr to render a disabled widget.

Definition at line 78 of file GamepadSettingsWidget.ixx.

78 explicit GamepadSettingsWidget(helios::input::InputAdapter* inputAdapter)

79 : inputAdapter_(inputAdapter) {}

Public Member Functions

draw()

void helios::ext::imgui::widgets::GamepadSettingsWidget::draw ()

inline virtual

Renders the gamepad settings configuration interface.

Definition at line 84 of file GamepadSettingsWidget.ixx.

84 void draw() override {

85 if (!inputAdapter_) return;

86

87 ImGui::SetNextWindowSize(ImVec2(350, 320), ImGuiCond_FirstUseEver);

88

89 if (ImGui::Begin("Gamepad Settings", nullptr, ImGuiWindowFlags_NoCollapse)) {

90

91 // --- Gamepad Selection ---

92 const char* items[] = { "Gamepad 1", "Gamepad 2", "Gamepad 3", "Gamepad 4" };

93 ImGui::Combo("Controller", &selectedGamepadIndex_, items, IM_ARRAYSIZE(items));

94

95 auto gamepadId = indexToId(selectedGamepadIndex_);

96 auto& settings = inputAdapter_->gamepadSettings(gamepadId);

97

98 ImGui::Separator();

99

100 // --- Deadzone Configuration ---

101 ImGui::Text("Deadzone Settings");

102 ImGui::Spacing();

103

104 // Left Stick Deadzone

105 float leftDeadzone = settings.leftStickDeadzone();

106 ImGui::Text("Left Stick");

107 if (ImGui::SliderFloat("##LeftDeadzone", &leftDeadzone, 0.0f, 0.9f, "%.2f")) {

108 settings.setLeftStickDeadzone(leftDeadzone);

109 }

110 ImGui::SameLine();

111 ImGui::TextDisabled("(%.0f%%)", leftDeadzone * 100.0f);

112

113 // Right Stick Deadzone

114 float rightDeadzone = settings.rightStickDeadzone();

115 ImGui::Text("Right Stick");

116 if (ImGui::SliderFloat("##RightDeadzone", &rightDeadzone, 0.0f, 0.9f, "%.2f")) {

117 settings.setRightStickDeadzone(rightDeadzone);

118 }

119 ImGui::SameLine();

120 ImGui::TextDisabled("(%.0f%%)", rightDeadzone * 100.0f);

121

122 ImGui::Separator();

123

124 // --- Axis Inversion ---

125 ImGui::Text("Axis Inversion");

126 ImGui::Spacing();

127

128 // Left Stick Inversion

129 ImGui::Text("Left Stick:");

130 ImGui::SameLine();

131

132 bool invertLeftX = settings.invertLeftX();

133 if (ImGui::Checkbox("Invert X##Left", &invertLeftX)) {

134 settings.setInvertLeftX(invertLeftX);

135 }

136 ImGui::SameLine();

137

138 bool invertLeftY = settings.invertLeftY();

139 if (ImGui::Checkbox("Invert Y##Left", &invertLeftY)) {

140 settings.setInvertLeftY(invertLeftY);

141 }

142

143 // Right Stick Inversion

144 ImGui::Text("Right Stick:");

145 ImGui::SameLine();

146

147 bool invertRightX = settings.invertRightX();

148 if (ImGui::Checkbox("Invert X##Right", &invertRightX)) {

149 settings.setInvertRightX(invertRightX);

150 }

151 ImGui::SameLine();

152

153 bool invertRightY = settings.invertRightY();

154 if (ImGui::Checkbox("Invert Y##Right", &invertRightY)) {

155 settings.setInvertRightY(invertRightY);

156 }

157

158 ImGui::Separator();

159

160 // --- Reset Button ---

161 if (ImGui::Button("Reset to Defaults")) {

162 settings.setLeftStickDeadzone(0.0f);

163 settings.setRightStickDeadzone(0.0f);

164 settings.setInvertLeftX(false);

165 settings.setInvertLeftY(false);

166 settings.setInvertRightX(false);

167 settings.setInvertRightY(false);

168 }

169

170 ImGui::SameLine();

171 ImGui::TextDisabled("(?)");

172 if (ImGui::IsItemHovered()) {

173 ImGui::SetTooltip(

174 "Deadzone: Input below this threshold is ignored.\n"

175 "Helps filter out stick drift when idle.\n\n"

176 "Invert: Reverses the axis direction.\n"

177 "Useful for flight-style controls."

178 );

179 }

180 }

181 ImGui::End();

182 }

Private Member Attributes

inputAdapter_

helios::input::InputAdapter* helios::ext::imgui::widgets::GamepadSettingsWidget::inputAdapter_ = nullptr

Pointer to the InputAdapter used to access gamepad settings. Non-owning pointer; must be valid for the lifetime of this widget.

Definition at line 46 of file GamepadSettingsWidget.ixx.

46 helios::input::InputAdapter* inputAdapter_ = nullptr;

selectedGamepadIndex_

int helios::ext::imgui::widgets::GamepadSettingsWidget::selectedGamepadIndex_ = 0

The currently selected gamepad index in the UI combo box (0-3).

Definition at line 51 of file GamepadSettingsWidget.ixx.

51 int selectedGamepadIndex_ = 0;

Private Static Functions

indexToId()

helios::input::types::Gamepad helios::ext::imgui::widgets::GamepadSettingsWidget::indexToId (int index)

inline nodiscard noexcept static

Helper to map an integer index (0-3) to a Gamepad enum ID.

Parameters

index

The index selected in the UI.

Returns

The corresponding Gamepad enum value.

Definition at line 60 of file GamepadSettingsWidget.ixx.

60 [[nodiscard]] static helios::input::types::Gamepad indexToId(int index) noexcept {

61 switch (index) {

62 case 0: return helios::input::types::Gamepad::ONE;

63 case 1: return helios::input::types::Gamepad::TWO;

64 case 2: return helios::input::types::Gamepad::THREE;

65 case 3: return helios::input::types::Gamepad::FOUR;

66 default: return helios::input::types::Gamepad::ONE;

67 }

68 }

---

The documentation for this class was generated from the following file:

• GamepadSettingsWidget.ixx

---

Generated via doxygen2docusaurus 2.0.0 by Doxygen 1.15.0.