Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
al_get_video_frame(3)	   Library Functions Manual	 al_get_video_frame(3)

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(3), al_get_video_scaled_height(3)

Allegro	reference manual				 al_get_video_frame(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=al_get_video_frame&sektion=3&manpath=FreeBSD+Ports+14.3.quarterly>

home | help