This is the manual way of doing things
+This is the manual way of doing things
my $event = SDL::Event->new; # create a new event
SDL::Events::pump_events();
@@ -64,7 +70,7 @@
}
-An alternative to the manual Event processing is the SDLx::App::loop .
+An alternative to the manual Event processing is through the SDLx::Controller module. SDLx::App is a Controller so see the CALLBACKS section below.
SDLx::App::new initializes the SDL, creates a new screen,
and initializes some of the window manager properties.
SDLx::App::new takes a series of named parameters:
SDLx::App::title takes 0, 1, or 2 arguments. It returns the current
-application window title. If one parameter is passed, both the window
-title and icon title will be set to its value. If two parameters are
-passed the window title will be set to the first, and the icon title
-to the second.
SDLx::App::title takes 0, 1, or 2 arguments. If no parameter is given,
+it returns the current application window title. If one parameter is
+passed, both the window title and icon title will be set to its value.
+If two parameters are passed the window title will be set to the first,
+and the icon title to the second.
SDLx::App::delay takes 1 argument, and will sleep the application for
that many ms.
SDLx::App::error returns the last error message set by the SDL.
SDLx::App::resize takes a new height and width of the application
-if the application was originally created with the resizable option.
SDLx::App::resize takes a new width and height of the application. Only
+works if the application was originally created with the resizable option.
SDLx::App::iconify iconifies the applicaiton window.
SDLx::App::iconify iconifies the application window.
SDLx::App::grab_input can be used to change the input focus behavior of
-the application. It takes one argument, which should be one of the following:
SDLx::App::loop is a simple event loop method which takes a reference to a hash
-of event handler subroutines. The keys of the hash must be SDL event types such
-as SDL_QUIT(), SDL_KEYDOWN(), and the like. The event method recieves as its parameter
-the event object used in the loop.
Example:
- my $app = SDLx::App->new(
- title => "test.app",
- width => 800,
- height => 600,
- depth => 32
- );
-
- my %actions = (
- SDL_QUIT() => sub { exit(0); },
- SDL_KEYDOWN() => sub { print "Key Pressed" },
- );
-
- $app->loop( \%actions );
-
-
-
-SDLx::App::sync encapsulates the various methods of syncronizing the screen with the
-current video buffer. SDLx::App::sync will do a fullscreen update, using the double buffer
-or OpenGL buffer if applicable. This is prefered to calling flip on the application window.
SDLx::App::sync will do a fullscreen update, using the double buffer
+or OpenGL buffer if applicable. This is prefered to calling flip on the application window.
+
+SDLx::App::attribute allows one to set and get GL attributes. By passing a value
-in addition to the attribute selector, the value will be set. SDL:::App::attribute
-always returns the current value of the given attribute, or croaks on failure.
SDLx::App::attribute allows one to get and set GL attributes. By passing a value
+in addition to the attribute selector, the value will be set. SDL:::App::attribute
+always returns the current value of the given attribute, or Carp::confesss on failure.
SDLx::App is a SDLx::Controller. Use the event, show and handlers to run the app.
use SDL;
+ use SDLx::App;
+
+ use SDL::Event; #Where ever the event call back is processed
+
+ my $app = SDLx::App->new( width => 200, height => 200);
+
+ $app->add_event_handler( sub{ return 0 if $_[0]->type == SDL_QUIT; return 1});
+
+ $app->add_show_handler( sub{ $app->update() } );
+
+ $app->add_move_handler(
+ sub{
+ #calc your physics here
+ } );
+
+ $app->run();
+
+
+see SDLx::Controller for more details.