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:

•

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:

•

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

•

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

•

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