Module: Rubygame::Events

Defined in:

lib/rubygame/events.rb,
lib/rubygame/events/misc_events.rb,
lib/rubygame/events/clock_events.rb,
lib/rubygame/events/mouse_events.rb,
lib/rubygame/events/joystick_events.rb,
lib/rubygame/events/keyboard_events.rb

Overview

The Events module contains classes representing various hardware events (e.g. keyboard presses, mouse clicks) and software events (e.g. clock tick, window becomes active)

This event classes are meant as a full replacement for the older event classes defined in the Rubygame module (e.g. KeyDownEvent, QuitEvent). The old classes are deprecated and should not be used anymore.

Defined Under Namespace

Modules: JoystickButtonEvent, KeyboardEvent, MouseButtonEvent Classes: ClockTicked, InputFocusGained, InputFocusLost, JoystickAxisMoved, JoystickBallMoved, JoystickButtonPressed, JoystickButtonReleased, JoystickHatMoved, KeyPressed, KeyReleased, MouseFocusGained, MouseFocusLost, MouseMoved, MousePressed, MouseReleased, QuitRequested, WindowExposed, WindowMinimized, WindowResized, WindowUnminimized

Class Method Summary

• .fetch_sdl_events ⇒ Object

  NOTE: This method converts the SDL events into the new-style event classes, located in the Rubygame::Events module.

Class Method Details

.fetch_sdl_events ⇒ Object

NOTE: This method converts the SDL events into the new-style event classes, located in the Rubygame::Events module. For converting to the older (deprecated) events, see Rubygame.fetch_sdl_events.

Retrieves all pending events from SDL’s event stack and converts them into Rubygame event objects. Returns an Array of all the events, in the order they were read.

This method is used by the EventQueue class (among others), so don’t call it if you are using any of Rubygame’s event management classes (e.g. EventQueue)! If you do, they will not receive all the events, because some events will have been removed from SDL’s event stack by this method.

However, if you aren’t using EventQueue, you can safely use this method to make your own event management system.

# File 'lib/rubygame/events.rb', line 117

def self.fetch_sdl_events
  events = []
  until( ( event = SDL::PollEvent() ).nil? )
    case ( event = _convert_sdlevent(event) )
    when Array;   events += event
    else;         events << event
    end
  end
  return events
end