al_open_video_f(3)         Library Functions Manual         al_open_video_f(3)

NAME
       al_open_video_f - Allegro 5 API

SYNOPSIS
              #include <allegro5/allegro_video.h>

              ALLEGRO_VIDEO* al_open_video_f(ALLEGRO_FILE *fp, const char *ident)

DESCRIPTION
       Opens a video file from an existing ALLEGRO_FILE* using the Allegro
       file interface system.  This allows videos to be loaded from custom
       sources such as memory streams, virtual file systems, archives, or any
       other source supported by a custom ALLEGRO_FILE_INTERFACE.

       Parameters:

       o file: A pointer to an ALLEGRO_FILE object.  Ownership of this file is
         transferred to the video object; the file will be closed
         automatically when al_close_video is called.

       Returns: A pointer to a new ALLEGRO_VIDEO object if successful, or NULL
       on failure.

       Remarks:

       o The function does not require the file to be seeked or rewound; it
         reads from the current position.

       o After calling al_open_video_f, you must not manually close the
         ALLEGRO_FILE; call al_close_video to free all associated resources.

       o This function mirrors the behavior of other _f variants in the
         Allegro API, enabling video streaming from custom file systems.

       Example:

              ALLEGRO_FILE *f = al_fopen("video.ogv", "rb");
              if (f) {
                  ALLEGRO_VIDEO *vid = al_open_video_f(f);
                  if (vid) {
                      float fps = al_get_video_fps(vid);
                      // ... use the video ...
                      al_close_video(vid); // also closes f
                  }
              }

SEE ALSO
       al_open_video(3)

SINCE
       5.2.11

Allegro reference manual                                    al_open_video_f(3)