pods::...terface(3pm)

🎀 pods::...terface(3pm) 🎀

okay bestie, welcome to the User Contributed Perl Documentation corner of the group chat 💖 this page is pods::...terface(3pm), and it's serving Interface Physics and Rendering with the Controller with callbacks. we're so back.

---

🌸 NAME 🌸

SDLx::Controller::Interface — Interface Physics and Rendering with the Controller with callbacks. no cap, that's the whole name vibe 🦋

🦋 CATEGORY 🦋

Extension, Controller — that's it, that's the category duo ✨

🎀 SYNOPSIS 🎀

okay so here's the demo code, and we're keeping it exactly as it is, bestie:

        use SDL;
        use SDLx::App;
        use SDLx::Controller::Interface;

        #SDLx::App is a controller
        my $app = SDLx::App->new(width => 200, height => 200 );

        my $ball = SDLx::Controller::Interface->new( x=> 10, y => 50, v_x => 10, v_y=> 20 );
        #Set the initial state of the ball's physics, this is optional

        $ball->set_acceleration(
           sub {
                     my ($time, $current_state) = @_;
                     return( 0, -10, 0 ); # Return accelerations (x,y,rotation)
               }
        );

        my $ball_render = sub {
              my $state = shift;

              $app->draw_rect( undef, 0 );
              $app->draw_rect( [$state->x, $state->y, 10,10], [255,0,0,255] );
              $app->update();
        };

        $ball->attach( $app, $ball_render, @params );

        $app->run();

        $ball->detach(); #can be called at anytime (for example when ball 'dies')

🫶 DESCRIPTION 🫶

the original DESCRIPTION is giving mysterious silent treatment — literally no extra prose here, so we're sliding straight into the methods. periodt 💅

✨ METHODS ✨

💅 set_acceleration 💅

this lets you set the acceleration callback, which defines the interface's behaviour in terms of x, y, and rotation. iconic.

         $interface->set_acceleration (
             sub {
                my ($time, $current_state) = @_;

                return ( $accel_x, $accel_y, $torque );
             }
         );

these accelerations are arbitrary and can be set to any frame of reference. your render callback will handle how to interpret it. iykyk 💫

the callback will receive the time and the current state as a SDLx::Controller::State element.

🦋 attach 🦋

attaches the interface to a controller with a render callback. we love a callback moment 🫶

         $interface->attach( $controller, $render, @params );

where $render is a callback that receives the interpolated SDLx::Controller::State.

         my $render = sub {
               my ($state, @params) = @_;
               # draw the current $state.
         };

the @params are any extra parameters you would like to pass to the $render callback. slay ✨

🌈 current 🌈

         my $current_state = $interface->current();

returns the current state of the interface as a SDLx::Controller::State. bestie, that's the now-now state 💖

🌸 previous 🌸

         my $previous_state = $interface->previous();

returns the previous state of the interface as a SDLx::Controller::State. the before-times, but make it state 🎀

💀 detach 💀

         $interface->detach();

if $interface has been attach()'ed to any controller it will be detached now. boom, un-attached, bye-bye 👋

🙈 OTHER METHODS 🙈

Don't use these unless you really really want to. seriously, bestie, this is the handle with care shelf.

🔥 acceleration 🔥

call the acceleration callback once. one little callback, one little moment ⭐

🧚 interpolate 🧚

interpolate the current state. smooth moves only 💫

💜 evaluate 💜

evaluate the new current and previous state. it's giving state inspection era 🔍

👑 update 👑

update the states by integrating with time. math girlies rise 🌈

🌟 AUTHORS 🌟

see "AUTHORS" in SDL. that's the whole authors section, no notes 💅

---

and that's the page, bestie 💖 it's filed under pods::...terface(3pm), running with perl v5.42.3, dated 2026-08-19 — mwah, go render something iconic 🎀✨