request_scroll(3)

✨ NAME ✨

okay so bestie, this is the Allegro manual, and request_scroll(3) is the function that queues a hardware scroll request with triple buffering. Allegro game programming library, periodt. 💅

🎀 SYNOPSIS 🎀

the exact vibe:

#include <allegro.h>

int request_scroll(int x, int y);

🦋 DESCRIPTION 🦋

request_scroll is for triple buffering. It requests a hardware scroll to the position you pass in, but it returns immediately instead of waiting for a retrace. The scroll will then happen during the next vertical retrace. You can keep running other code in the meantime, no cap, and use poll_scroll() to detect when the flip has actually taken place. ✨

Triple buffering is only possible with certain drivers, so look at the GFX_CAN_TRIPLE_BUFFER bit in the gfx_capabilities flag to see if it will work with the current driver. 👑

💖 RETURN VALUE 💖

It returns zero on success, non-zero otherwise. that's the whole tea. 😭

🌸 SEE ALSO 🌸

• poll_scroll(3)
• request_video_bitmap(3)
• gfx_capabilities(3)
• scroll_screen(3)

sending love from the Allegro manual, version 4.4.3 💖✨🫶