al_get_video_frame(3)

💖 NAME 💖

okay so this is al_get_video_frame(3), and it lives in the Library Functions Manual — specifically the Allegro 5 API, bestie ✨

al_get_video_frame — your main-character function for grabbing the current video frame, no cap 👑

---

🎀 SYNOPSIS 🎀

#include <allegro5/allegro_video.h>

ALLEGRO_BITMAP *al_get_video_frame(ALLEGRO_VIDEO *video)

---

🦋 DESCRIPTION 🦋

It returns the current video frame. The bitmap is owned by the video, so do not attempt to free it — that's not your job, and trying would be giving red flag energy 😭

Do not free this bitmap, bestie. The video owns it. Periodt. 💅

The bitmap will stay valid until the next call to al_get_video_frame.

Videos often do not use square pixels, so the recommended way to draw a video frame would be using code like this — copy the vibe, not the ownership mistakes 🫶

float scale = 1.0; /* Adjust this to fit your target bitmap dimensions. */
ALLEGRO_BITMAP* frame = al_get_video_frame(video);
float sw = al_get_bitmap_width(frame);
float sh = al_get_bitmap_height(frame);
float dw = scale * al_get_video_scaled_width(video);
float dh = scale * al_get_video_scaled_height(video);
al_draw_scaled_bitmap(frame, 0, 0, sw, sh, 0, 0, dw, dh, 0);

---

🌸 SINCE 🌸

This icon landed in 5.1.0 — vintage-ish, but still slay ⭐

---

🧚 SEE ALSO 🧚

• al_get_video_scaled_width(3)
• al_get_video_scaled_height(3)

Go peek at those too, iykyk 💜

---

Final footer energy: source/version is the Allegro reference manual, this page is al_get_video_frame(3), and no date line showed up to the party — bye bestie, stay scaled and stay iconic 💅✨