Joystick Node - Revision history

Blayze at 16:08, 21 August 2024

2024-08-21T16:08:30Z

← Older revision		Revision as of 16:08, 21 August 2024
Line 7:		Line 7:
	\|output-list=<li>x</li><li>y</li>		\|output-list=<li>x</li><li>y</li>
	}}		}}
	The Joystick Node is a UI Node that places a simulated dual-axis joystick on the [[The Controller\|controller]]. A joystick is a simple element that can can be dragged in two directions - up and down (the ''x axis'') and left and right (the ''y axis''). These values are reported out of Joystick node's ''x'' and ''y'' output ports.		The Joystick Node is a UI Node that places a simulated dual-axis joystick on the [[The Controller\|controller]]. A joystick is a simple element that can can be dragged in two directions - up and down (the ''x axis'') and left and right (the ''y axis''). These values are reported out of Joystick node's ''x'' and ''y'' output ports as an ''x'' value, the position of the joystick from the left to the right, expressed as a number between 0 and 1, and the ''y'' value, the position of the joystick from the bottom to the top, again expressed as a number between 0 and 1.

	Joystick Nodes were introduced in [[Firmware Releases\|firmware version]] 2.1 along with all basic nodes.		Joystick Nodes were introduced in [[Firmware Releases\|firmware version]] 2.1 along with all basic nodes.

Blayze at 02:46, 21 August 2024

2024-08-21T02:46:11Z

← Older revision		Revision as of 02:46, 21 August 2024
Line 10:		Line 10:

	Joystick Nodes were introduced in [[Firmware Releases\|firmware version]] 2.1 along with all basic nodes.		Joystick Nodes were introduced in [[Firmware Releases\|firmware version]] 2.1 along with all basic nodes.

			The [[Example: Simple Joystick-Drive Robot\|Joystick drive example robot]] uses a joystick as it's central input method - check that out for an example nodegraph!

	== Outputs ==		== Outputs ==

Blayze: Removes references to slider and just generally improves the first paragraph, also fixes the outputs list in the Node Data section.

2023-03-04T00:48:29Z

Removes references to slider and just generally improves the first paragraph, also fixes the outputs list in the Node Data section.

← Older revision		Revision as of 00:48, 4 March 2023
Line 5:		Line 5:
	File:Joystick-settings.png		File:Joystick-settings.png
	</gallery>		</gallery>
	\|output-list=<li>~~signal~~</li>		\|output-list=<li>x</li><li>y</li>
	}}		}}
	The ~~Slider~~ Node is a UI Node that places a ~~slider~~ on the [[The Controller\|controller]]. A ~~slider~~ is a simple element that can can be dragged in ~~one direction~~ - ~~either~~ up and down or left and right.		The Joystick Node is a UI Node that places a simulated dual-axis joystick on the [[The Controller\|controller]]. A joystick is a simple element that can can be dragged in two directions - up and down (the ''x axis'') and left and right (the ''y axis''). These values are reported out of Joystick node's ''x'' and ''y'' output ports.

	Joystick Nodes were introduced in [[Firmware Releases\|firmware version]] 2.1 along with all basic nodes.		Joystick Nodes were introduced in [[Firmware Releases\|firmware version]] 2.1 along with all basic nodes.

Blayze: Adds return to nodes

2023-03-01T03:02:40Z

Adds return to nodes

← Older revision		Revision as of 03:02, 1 March 2023
Line 1:		Line 1:
	{{Node Data		{{Return to nodes}}{{Node Data
	\|title=Joystick Node		\|title=Joystick Node
	\|gallery=<gallery mode="slideshow">		\|gallery=<gallery mode="slideshow">

Blayze: Adds gallery.

2023-03-01T02:58:55Z

Adds gallery.

← Older revision		Revision as of 02:58, 1 March 2023
Line 28:		Line 28:

	== Gallery ==		== Gallery ==
			<gallery mode="slideshow">
			File:Joystick-return-behaviour-examples.png\|Three joystick node elements drawn to the controller, one with both x and y behaviours set to reset (bottom left), one with both set to hold (middle) and one with only x-axis set to hold (right), all in their starting position.
			File:Joystick-return-behaviour-examples-2.png\|Three joystick node elements drawn to the controller, one with both x and y behaviours set to reset (bottom left), one with both set to hold (middle) and one with only x-axis set to hold (right). After movement, only the top can be completely off-center in both axes.
			</gallery>

Blayze: Created page with "{{Node Data |title=Joystick Node |gallery= File:Joystick-node.png File:Joystick-settings.png |output-list=
signal
}} The Slider Node is a UI Node that places a slider on the controller. A slider is a simple element that can can be dragged in one direction - either up and down or left and right. Joystick Nodes were introduced in firmware version 2.1 along with all basic nodes. == Outpu..."

2023-03-01T02:57:53Z

Created page with "{{Node Data |title=Joystick Node |gallery=<gallery mode="slideshow"> File:Joystick-node.png File:Joystick-settings.png </gallery> |output-list=<li>signal</li> }} The Slider Node is a UI Node that places a slider on the controller. A slider is a simple element that can can be dragged in one direction - either up and down or left and right. Joystick Nodes were introduced in firmware version 2.1 along with all basic nodes. == Outpu..."

New page

{{Node Data
|title=Joystick Node
|gallery=<gallery mode="slideshow">
File:Joystick-node.png
File:Joystick-settings.png
</gallery>
|output-list=<li>signal</li>
}}
The Slider Node is a UI Node that places a slider on the [[The Controller|controller]]. A slider is a simple element that can can be dragged in one direction - either up and down or left and right.

Joystick Nodes were introduced in [[Firmware Releases|firmware version]] 2.1 along with all basic nodes.

== Outputs ==
Joystick Nodes are very similar to [[Slider Node|Slider Nodes]], but have an additional degree of freedom, meaning they can move in 2 axes. They are designed to mimic traditional dual-axis joystick found on a physical controller. Joystick Nodes have two output ports - ''x'' and ''y'', reflective of the stick's position in the x axis and y axis of it's region of movement. Both outputs are emitted from 0 to 1 (clipped), every time the slider is moved when in the [[The Controller|controller]].

== Settings ==
The Joystick Node's settings can be configured to alter it's visual presentation, mode of operation and output value mapping.

{{UI_Node_Settings|node=Joystick}}

* '''Stick Colour''': Configures the colour of the stick of this joystick as it's seen in the [[The Controller|controller]].
* '''X-Axis Release Behaviour''': Configures what should happen to the stick when a held click or touch is released, but only along the ''x-axis'' - ''reset'' will result in the stick returning to it's x-axis (horizontal) ''Start Position'' when released - much like a spring-loaded self-centering joystick on a traditional physical controller, while ''hold'' will leave the stick in it's current position along the x-axis, similar to non-self-centering joysticks. Joysticks set to ''hold'' in the x-axis will render with three little vertical bars in the center of the stick.
* '''Y-Axis Release Behaviour''': This behaves identically to the ''X-Axis Release Behaviour'', but along the y-axis (vertically).
* '''X-Axis Start Position''': This configures both the position the slider starts in along the x-axis (horizontally) and the position that it returns to if it's ''X-Axis Release Behaviour'' is set to ''reset''.
* '''Y-Axis Start Position''': This behaves identically to the ''X-Axis Start Position'', but along the y-axis (vertically).
* '''Invert X Axis''': This option inverts the output along the x-axis (horizontally). By default a fully leftwards stick position makes the output ''x'' port emit '''0''', and a fully right stick emits '''1''', however enabling this inverts that, with a stick position fully to the left emitting '''1''' and a fully right position emitting '''0'''. Note that similar achievement could be achieved by using an [[Inverter Node]] on the ''x'' output port.
* '''Invert Y Axis''': This behaves identically to the ''Invert X Axis'' option, but inverts along the y-axis (vertically).

== Gallery ==