exswitch(3)

💖 exswitch 💖

okay bestie, welcome to the Allegro manual page for exswitch — yes that's the manual name, it's the page for the exswitch example program, and we're gonna have a whole moment with it. 🦋

✨ NAME ✨

exswitch — controlling the console switch mode for background running. it's part of the Allegro game programming library, bestie. 👑

🌸 SYNOPSIS 🌸

#include <allegro.h>

Example exswitch

like, that's it. that's the whole vibe. #include <allegro.h> and then you run the example called exswitch. periodt. 💅

🎀 DESCRIPTION 🎀

so this program shows you how to control the console switching mode, and how to let your program run in the background. main character energy fr fr. ✨

⚠️ real talk though: these functions don't apply to every platform and driver. for example, you can't control the switching mode from a DOS program. no cap. so don't come for me when it doesn't work on your random setup, okay? 🙈

and yes, I know the fractal drawing is very slow — that's literally the point!! 😭 it's slow on purpose so you can easily check whether it keeps on working in the background after you switch away from the app. the slowness is not a bug, it's the whole personality of the demo. slay. 🔥

depending on the type of selected switching mode, you will see whether the contents of the screen are preserved or not. so like, watch the screen and see what happens — that's the experiment, bestie. 🧚

👑 SEE ALSO 👑

the whole friend group, one by one, no skips, we love them all:

• BITMAP(3)
• END_OF_FUNCTION(3)
• END_OF_MAIN(3)
• LOCK_FUNCTION(3)
• LOCK_VARIABLE(3)
• PALETTE(3)
• SCREEN_H(3)
• SCREEN_W(3)
• acquire_bitmap(3)
• acquire_screen(3)
• allegro_error(3)
• allegro_exit(3)
• allegro_init(3)
• allegro_message(3)
• bitmap_color_depth(3)
• blit(3)
• clear_to_color(3)
• create_sub_bitmap(3)
• desktop_palette(3)
• destroy_bitmap(3)
• font(3)
• get_display_switch_mode(3)
• gfx_mode_select_ex(3)
• install_int(3)
• install_keyboard(3)
• install_mouse(3)
• install_timer(3)
• keypressed(3)
• makecol(3)
• palette_color(3)
• putpixel(3)
• readkey(3)
• rectfill(3)
• release_bitmap(3)
• release_screen(3)
• screen(3)
• set_color_depth(3)
• set_display_switch_callback(3)
• set_display_switch_mode(3)
• set_gfx_mode(3)
• set_palette(3)
• textout_centre_ex(3)
• textprintf_centre_ex(3)

and that's the whole page!! 🫶

this was brought to you by Allegro, version 4.4.3 — that's the source and version of this very manual page, and it's the exswitch(3) page we've been hanging out in this whole time. go forth, switch consoles, run in the background, and stay iconic. 💜🌸⭐