Difference between revisions of "Key.axis"

From MiniScript Wiki
Jump to navigation Jump to search
(Created page with "<c>key.axis</c> returns the numeric value (from -1 to 1) of an input axis. See also: key.pressed === Arguments === {| class="wikitable" |- ! Parameter Name !! Type !! D...")
 
(7 intermediate revisions by the same user not shown)
Line 1: Line 1:
<c>key.axis</c> returns the numeric value (from -1 to 1) of an input axis.
+
<c>[[key]].axis</c> returns the numeric value (from -1 to 1) of an input axis (for example, a joystick horizontal or vertical axis).
  
See also: [[key.pressed]]
+
See also: [[key.pressed]]; [[How to move a sprite with directional inputs]]
  
 
=== Arguments ===
 
=== Arguments ===
Line 13: Line 13:
  
 
=== Usage Notes ===
 
=== Usage Notes ===
Available axis names are "Horizontal" and "Vertical", which can be activated
+
Available axis names are:
by both WASD and arrow keys as well as any joystick or gamepad;
+
* "Horizontal" and "Vertical", which can be activated by both WASD and arrow keys as well as any joystick or gamepad
"JoyAxis1" through "JoyAxis29" which detect axis inputs from any joystick or gamepad, and "Joy1Axis1" through "Joy8Axis29" which detect
+
* "Mouse X", "Mouse Y", and "Mouse ScrollWheel", which reflect movement/scrolling with the mouse
axis inputs from specific joystick/gamepad 1 through 8.
+
* "JoyAxis1" through "JoyAxis29" which detect axis inputs from any joystick or gamepad
 +
* "Joy1Axis1" through "Joy8Axis29" which detect axis inputs from specific joystick/gamepad 1 through 8.
  
 
== Example ==
 
== Example ==
  
 
<ms>print key.axis("Vertical")</ms>
 
<ms>print key.axis("Vertical")</ms>
 +
 +
A bigger example:
 +
 +
<ms>sp = new Sprite
 +
sp.image = file.loadImage("/sys/pics/Wumpus.png")
 +
display(4).sprites.push sp
 +
speed = 10  // pixels per frame
 +
while true
 +
sp.x = sp.x + key.axis("Horizontal") * speed
 +
sp.y = sp.y + key.axis("Vertical") * speed
 +
yield
 +
end while</ms>
  
 
[[Category:Mini Micro]]
 
[[Category:Mini Micro]]

Revision as of 14:13, 15 August 2023

key.axis returns the numeric value (from -1 to 1) of an input axis (for example, a joystick horizontal or vertical axis).

See also: key.pressed; How to move a sprite with directional inputs

Arguments

Parameter Name Type Default Value Meaning
axisName string Horizontal name of axis to get

Usage Notes

Available axis names are:

  • "Horizontal" and "Vertical", which can be activated by both WASD and arrow keys as well as any joystick or gamepad
  • "Mouse X", "Mouse Y", and "Mouse ScrollWheel", which reflect movement/scrolling with the mouse
  • "JoyAxis1" through "JoyAxis29" which detect axis inputs from any joystick or gamepad
  • "Joy1Axis1" through "Joy8Axis29" which detect axis inputs from specific joystick/gamepad 1 through 8.

Example

print key.axis("Vertical")

A bigger example:

sp = new Sprite
sp.image = file.loadImage("/sys/pics/Wumpus.png")
display(4).sprites.push sp
speed = 10  // pixels per frame
while true
	sp.x = sp.x + key.axis("Horizontal") * speed
	sp.y = sp.y + key.axis("Vertical") * speed
	yield
end while