Tinca/Docs/Widgets/Gamepad Buttons

Gamepad Buttons

FREE
CONTROL · 6 FIELDS · 2×2 DEFAULT

Multi-button gamepad with custom actions

When to reach for it

Gamepad Buttons puts up to four fixed-payload actions on one thumb-reachable diamond: arm/disarm, gripper open/close, four mode switches. Set Buttons Shown to 1 and it renders a single round button, so for one action alone, Custom Button is simpler. For freeform JSON on any topic without the diamond layout, Topic Publisher (Pro) is the escape hatch.

Worked example: arm/disarm and gripper on the shipped topic

As shipped, all four buttons publish to /gamepad with Message Type std_msgs/msg/String, and Message is free-tier per button. Rewrite two payloads to {"data":"arm"} and {"data":"disarm"}, do the same for gripper open and close, and leave Hold Mode off (the default) so each tap fires once. Labels stay A/B/X/Y until Custom Button Labels (Pro) renames them to match.

Watch out for
  • Only the top button's Topic field is exposed in the editor. The other three slots carry their own topic in config; nothing syncs them when you edit Topic, so all four default to /gamepad with no way to point one elsewhere.
  • Buttons Shown is a target the grid can override: shrink the widget to a 1-cell-tall or wide strip and the count is capped by available cells. Reorder by Button Priority before resizing, so the buttons you actually use survive the cut.

Configuration fields

Topictopic

The topic this widget publishes to. While connected, tap to pick one the robot advertises.

Message Typestring

The ROS message type, like sensor_msgs/msg/Image. Fills in when you pick a topic.

Hold Modeboolean

Publish repeatedly while a button is held, instead of once per tap.

Publish Rate (Hz)PROnumber

Streaming rate while a button is held.

WITH PRODefault 10 Hz. Raise it for more responsive jogging, lower it on slow links.

Buttons Shownselect

Four form the diamond. With fewer, buttons line up and the lowest Button Priority drops first.

4321
Custom Button Labels

Replace A / B / X / Y with your own text on each button.

Custom Button Colors

Pick a color per button to encode meaning at a glance.

Buttonsgamepad-buttons

Set each button's published Message. Tap the reorder icon to set Button Priority.