= Joystick
* ((<Joystickǽ>))
* ((<SDL::Joystick>))
* 祤ƥåϢ᥽å
TOC

== Joystickǽ
祤ƥåޤ˶ᤤ¾ΥǥХϡ
ץ쥤ˤ˶äƤꡢ
SDL ϤϰϤ˥ݡȤƤޤ
ܥPOV ϥåȥåƥȥåܡ
ƥݡȤƤޤ

祤ƥåΥݡȤ
@[init]  SDL::INIT_JOYSTICK ե饰ϤȤǽޤ
ä줿祤ƥå
@[Joystick.open] 
ץ󤵤ʤФޤ

˽񤫤Ƥ᥽åɤȤ
祤ƥåˤ餫饢ɤ߹Τ
ɤˡΤ褦˻פޤƤξ礽ǤϤޤ
Ūˤϡ祤ƥå@[٥|Event]
ƥȤäɤ߹٤Ǥ
ǽˤ뤿ˡ@[Joystick.poll=]
Ȥäƥ祤ƥåΥ٥Ƚ֤ꤷʤФʤޤ
󡢥祤ƥåȤ@[ץ|Joystick.open]
ʤФʤޤ

* NOTES

  ٥ȥ塼̤ƥ祤ƥå򰷤äƤΤ
  ((*ʤ*)) @[Joystick.update_all]
  Ƥǥ祤ƥåιŪ׵᤹ɬפޤ

  եեɥХåϤޤݡȤƤޤ

== SDL::Joystick
ġΥ祤ƥåϾ뤿Υ饹Ǥ

METHODS(Joystick)

== Methods
%%%
NAME num
MOD Joystick
TYPE .
PURPOSE Ѳǽʥ祤ƥåοޤ
RVAL Integer

PROTO
num

DESC
ƥ³줿祤ƥåοޤ

SEEALSO
Joystick.index_name
Joystick.open

%%
NAME index_name
MOD Joystick
TYPE .
PURPOSE 祤ƥå̾ޤ
RVAL String

PROTO
index_name(index)
indexName(index)

DESC
˰¸른祤ƥå̾ʸǼޤ
$[index] ѥ᡼ϥƥΥ祤ƥåֹؤޤ

EXAMPLE
# ³줿ƤΥ祤ƥå̾ɽ
num_joy = SDL::Joystick.num
printf("%d ܤΥ祤ƥåĤޤ\n", num_joy)
num_joy.times do |i|
  puts SDL::Joystick.index_name(i)
end

SEEALSO
Joystick.open

%%
NAME open
MOD Joystick
TYPE .
PURPOSE 祤ƥåȤᥪץ󤷤ޤ
RVAL SDL::Joystick

PROTO
open(index)

DESC
SDL ǥ祤ƥåȤᥪץ󤷤ޤ
$[index] ϥƥˤ른祤ƥåֹؤޤ
祤ƥåϥǻѤ˥ץ󤵤ɬפޤ

祤ƥåֹ 0  SDL::Joystick.num - 1 ޤǤͭǤ

RET
@[Joystick]Υ󥹥󥹤֤ޤ

EXCEPTION *

EXAMPLE
# 祤ƥå뤫å
if SDL::Joystick.num > 0
  # 祤ƥå򥪡ץ󤹤
  joy = SDL::Joystick.open(0)

  printf("0֤Υ祤ƥå򳫤ޤ\n");
  printf("̾: %s\n", SDL::Joystick.name(0))
  printf("ο: %d\n", joy.num_axes)
  printf("ܥο: %d\n", joy.num_buttons)
  printf("ܡο: %d\n", joy.num_balls)
end  

%%
NAME open?
MOD Joystick
TYPE .
PURPOSE 祤ƥåץ󤵤Ƥ뤫ɤĴ٤ޤ
RVAL true/false

PROTO
open?(index)

DESC
ץꥱǥ祤ƥåץ󤵤Ƥ뤫ɤĴ٤ޤ
$[index] ϥƥˤ른祤ƥåֹؤޤ

RET
祤ƥå˥ץ󤵤Ƥ true 
Ǥʤ false ֤ޤ

SEEALSO
Joystick.open

%%
NAME index
MOD Joystick
TYPE #
PURPOSE 祤ƥåΥǥåֹ֤ޤ
RVAL Integer

PROTO
index

DESC
$[self] Υǥåֹ֤ޤ

%%
NAME num_axes
MOD Joystick
TYPE #
PURPOSE 祤ƥåμοޤ
RVAL Integer

PROTO
num_axes
numAxes

DESC
Ѳǽʼο֤ޤ

NOTES
ļȲĤ褦(륢ʥƥå)ϼ
2Ĥȿޤ

SEEALSO
Joystick#axis

%%
NAME num_balls
MOD Joystick
TYPE #
PURPOSE 祤ƥåΥȥåܡοޤ
RVAL Integer

PROTO
num_balls
numBalls

DESC
Ѳǽʥȥåܡο֤ޤ

SEEALSO
Joystick#ball

%%
NAME num_hats
MOD Joystick
TYPE #
PURPOSE 祤ƥåΥϥåȥåοޤ
RVAL Integer

PROTO
num_hats
numHats

DESC
Ѳǽʥϥåȥåο֤ޤ

SEEALSO
Joystick#hat

%%
NAME num_buttons
MOD Joystick
TYPE #
PURPOSE 祤ƥåΥܥοޤ
RVAL Integer

PROTO
num_buttons
numButtons

DESC
Ѳǽʥܥο֤ޤ

SEEALSO
Joystick#button

%%
NAME poll=
MOD Joystick
TYPE .
PURPOSE 祤ƥå٥ȤΥݡ󥰤ͭ/̵ˤޤ

PROTO
poll=(enable)

DESC
祤ƥå٥Ȥνͭޤ̵ˤ뤿˻Ȥޤ
祤ƥå٥Ȥν̵ξ֤Ǥϡ@[Joystick.update_all]
Ȥäƥ祤ƥåξ֤򹹿
ưǥ祤ƥåξɤ߹ɬפޤ

ǥեȤǤͭˤʤäƤޤ

SEEALSO
Joystick.update_all
Joystick.poll
Event2::JoyAxis
Event2::JoyBall
Event2::JoyButtonDown
Event2::JoyButtonUp
Event2::JoyHat

%%
NAME poll
MOD Joystick
TYPE .
PURPOSE 祤ƥå٥ȤΥݡ󥰤ͭɤĴ٤ޤ
RVAL true/false

PROTO
poll

DESC
祤ƥå٥Ȥνͭʤ true ̵ʤ false ֤
ޤܤ @[Joystick.poll=] 򸫤Ƥ

%%
NAME update_all
MOD Joystick
TYPE .
PURPOSE ٤ƤΥ祤ƥåξ֤򹹿ޤ

PROTO
update_all
updateAll

DESC
ץ󤵤줿٤ƤΥ祤ƥåξ(֡ܥʤ)򹹿ޤ
@[Joystick.poll=]
ˤäƥ祤ƥå٥ȤͭˤʤäƤϡ
٥ȥ롼פǼưŪ˸ƤФޤ

%%
NAME axis
MOD Joystick
TYPE #
PURPOSE θߤξ֤ޤ
RVAL Integer

PROTO
axis(axis_index)

DESC
$[self] $[axis_index] ǻꤷθߤξ֤֤ޤ

ǶΤۤȤɤΥ祤ƥåǤϡ
X ̾ axis 0
Y  axis 1 ɽƤޤ
Υ᥽åɤˤä֤ͤϡθߤΰ֤ɽ魯
դ (-32768  32768 ޤ) Ǥꡢ
֤θ뤿ᤳͤŬͤꤷƤɬפǤ礦

EXAMPLE
joy = SDL::Joystick.open(0)
  .
  .
x_move = joy.axis(0)
y_move = joy.axis(1)

SEEALSO
Joystick#num_axes

%%
NAME hat
MOD Joystick
TYPE #
PURPOSE 祤ƥåΥϥåȥåθߤξ֤ޤ
RVAL UINT

PROTO
hat(hat_index)

DESC
$[hat_index] ǻꤷϥåȥåθߤξ֤ޤ

RET
ߤξ֤ϡ
ʲ˵󤲤ͤ 1 Ĥޤʣ OR ˤȤ߹碌Ȥ
̵ͤȤ֤ޤ

* SDL::Joystick::HAT_CENTERED
* SDL::Joystick::HAT_UP
* SDL::Joystick::HAT_RIGHT
* SDL::Joystick::HAT_DOWN
* SDL::Joystick::HAT_LEFT
* SDL::Joystick::HAT_RIGHTUP
* SDL::Joystick::HAT_RIGHTDOWN
* SDL::Joystick::HAT_LEFTUP
* SDL::Joystick::HAT_LEFTDOWN

SEEALSO
Joystick#num_hats

%%
NAME button
MOD Joystick
TYPE #
PURPOSE ꤵ줿ܥθߤξ֤ޤ
RVAL true/false

PROTO
button(button_index)

DESC
$[button_index] ǻꤵ줿ܥθߤξ֤ޤ
ܥ󤬲֤ˤ true ΥƤ false 
֤ޤ

SEEALSO
Joystick#num_buttons

%%
NAME ball
MOD Joystick
TYPE #
PURPOSE ȥåܡŪưޤ
RVAL [Integer, Integer]

PROTO
ball(ball_index)

DESC
$[ball_index] ǻꤷܡŪѲޤ

ȥåܡ
ΤΥ᥽åɤθƤӽФ
Ūư֤ȤǤưѲ
[dx, dy] Ȥ2Ĥޤ

EXCEPTION *

EXAMPLE
delta_x, delta_y = joy.ball(0)
printf("ȥåܡаư- X:%d, Y:%d\n", delta_x, delta_y)