NAME

       al_get_video_frame - Allegro 5 API

SYNOPSIS

              #include <allegro5/allegro_video.h>

              ALLEGRO_BITMAP *al_get_video_frame(ALLEGRO_VIDEO *video)

DESCRIPTION

       Returns  the  current  video frame.  The bitmap is owned by the video so do not attempt to
       free it.  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:

              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

       5.1.0

SEE ALSO

       al_get_video_scaled_width(3alleg5), al_get_video_scaled_height(3alleg5)