Documentation

Toggle Menu

Joystick

This tile is great for use when controlling something that moves. It can be configured to send data in the form of radians or degrees.

Settings

Tag

This is a unique String ID assigned to this tile and is used (by you) to identify what tile sent what data by your script.
Note that this is case sensitive, and cannot contain any white space.

Size

This modifies the size of the button as it appears on your screen. Its units of measurement is tiles. Since each tile that can have its size modified is aware of its surroundings, the numeric steppers used to adjust the tile size will stop you from overlapping with other tiles or going over the edge of the screen.

Return Value

Here you can set the tile to send values in the form of either Radians or Degrees.

Output

The following is what data is sent from this tile to the server/your script. It is in the format:
Action → Data TypeValue

  • Joystick Moved → FloatAngle value from top

  • Joystick Released → Integer-999

Note that a tile's tag is always sent to the server for identification purposes.

Usage Demo

Calls a function which will handle the data sent in from the joystick tile. If the data is -999, then the joystick has been released, so the program will call another function to handle this.

                            def forceServerDidReceiveData(self, deviceName, senderTag, data):
                                if senderTag == "Joystick":
                                    if data != -999:
                                        self.handleJoystick(data)
                                    else:
                                        self.joystickReleased()