pods::SDLx::App(3pm)

💖 NAME 💖

SDLx::App — a SDL perl extension 💅

(also hiii, you're reading pods::SDLx::App(3pm) from the pods manual — welcome, bestie 🫶)

---

🎀 CATEGORY 🎀

Extension ✨

---

🦋 SYNOPSIS 🦋

use SDL;
use SDLx::App;
use SDL::Event;
use SDL::Events;

my $app = SDLx::App->new(
    title  => 'Application Title',
    width  => 640,
    height => 480,
    depth  => 32
);

That's the manual way of doing things, okay 😌

my $event = SDL::Event->new; # create a new event

SDL::Events::pump_events();

while ( SDL::Events::poll_event($event) ) {
    my $type = $event->type(); # get event type
    print $type;
    exit if $type == SDL_QUIT;
}

But like… there's an alternative to manually wrangling all those Events: the SDLx::Controller module 🎮. SDLx::App is a Controller, so peep the CALLBACKS section down below, iykyk 👑

---

🌸 DESCRIPTION 🌸

SDLx::App controls the root window of your SDL-based application — main character energy fr fr 👑. It extends the SDL::Surface class and hands you an interface to all the window-manager-oriented functions. Literally so convenient 💅

---

✨ METHODS ✨

🍓 new

SDLx::App::new initializes the SDL, creates a new screen, and sets up some of the window manager properties. SDLx::App::new takes a whole lineup of named parameters, bestie:

• title — the window title. Defaults to the file name. Shorter alias: 't' 🏷️
• icon_title — the icon title. Defaults to file name. Shortcut: 'it'
• icon — the icon itself. Defaults to none. Shortcut: 'i' 🖼️
• width — Window width, in pixels. Defaults to 800. Shortcut: 'w'
• height — Window height, in pixels. Defaults to 600. Shortcut: 'h'
• depth — Screen depth. Defaults to 16. Shortcut: 'd'.
• flags — Any flags you want to pass to SDL::Video upon initialization. Defaults to SDL_ANYFORMAT. Flags should be or'ed together if you're passing more than one (flags => FOO|BAR). Shortcut: 'f'. 🚩
• resizable — Set this to a true value to make the window resizable by the user. Default is off.
• exit_on_quit — Set this to a true value to make the app exit if a SDL_QUIT event is triggered. Shortcut: 'eoq'. 🚪

---

🌈 METHODS 🌈

(part two, electric boogaloo — the getters and tools 💜)

🎀 title()

🎀 title( $new_title )

🎀 title( $window_title, $icon_title )

title()
title( $new_title )
title( $window_title, $icon_title )

SDLx::App::title takes 0, 1, or 2 arguments, no more no less 😤. If no parameter is given, it returns the current application window title. If one parameter is passed, both the window title and the icon title get set to its value. If two parameters are passed, the window title becomes the first one and the icon title becomes the second. Iconic behaviour honestly 🌟

⏳ delay( $ms )

SDLx::App::delay takes 1 argument and will sleep the application for that many ms. Nap time bestie 😴

⏱️ ticks

SDLx::App::ticks returns the number of ms since the application began. Time flies fr 🕰️

💀 error

SDLx::App::error returns the last error message set by the SDL.

📐 resize( $width, $height )

SDLx::App::resize takes a new width and height of the application. Heads up tho — it only works if the application was originally created with the resizable option 🙈

🖥️ fullscreen

SDLx::App::fullscreen toggles the application in and out of fullscreen mode. Big screen mode activated 🔥

🗔 iconify

SDLx::App::iconify iconifies the application window.

🎯 grab_input( $CONSTANT )

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 these three constants:

• SDL_GRAB_QUERY
• SDL_GRAB_ON
• SDL_GRAB_OFF

🔄 sync

SDLx::App::sync encapsulates the various methods of synchronizing 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 preferred to calling flip on the application window — so like, use this one, okay? 💖

🧚 attribute( $attr )

🧚 attribute( $attr, $value )

SDLx::App::attribute lets you get and set GL attributes. Pass a value alongside the attribute selector and the value gets set. SDL:::App::attribute always returns the current value of the given attribute, or Carp::confess on failure 😭 (yes, that's how it's written, don't come for me)

---

👑 CALLBACKS 👑

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{
    my ($event, $app) = @_;
    return $_[0]->type == SDL_QUIT ? 0 : 1;
});

$app->add_show_handler( sub{
    my ($delta, $app) = @_;
    $app->update;
} );

$app->add_move_handler( sub{
    my ($step, $app, $t) = @_;
    #calc your physics here
} );

$app->run();

see SDLx::Controller for more details. Go read it, it's giving essential lore 📚

---

🌟 AUTHORS 🌟

See "AUTHORS" in SDL.

---

🔗 SEE ALSO 🔗

perl SDL::Surface SDL::Event SDL::OpenGL

---

ok that's the whole page bestie, you ate that 🫶💅 go build something iconic ✨

anddd for the record, this was perl v5.42.3, dated 2026-08-19, and it's the pods::SDLx::App(3pm) page — mwah, bye! 😘🎀💖