103 lines
2.9 KiB
C
103 lines
2.9 KiB
C
|
#pragma once
|
||
|
|
|
||
|
|
#include <kinc/global.h>
|
||
|
|
|
||
|
|
#include <kinc/backend/video.h>
|
||
|
|
#include <kinc/graphics4/texture.h>
|
||
|
|
|
||
|
|
/*! \file video.h
|
||
|
|
\brief Hardware-assisted video decoding support. Actually supported
|
||
|
|
formats vary per target-system.
|
||
|
|
*/
|
||
|
|
|
||
|
|
#ifdef __cplusplus
|
||
|
|
extern "C" {
|
||
|
|
#endif
|
||
|
|
|
||
|
|
typedef struct kinc_video {
|
||
|
|
kinc_video_impl_t impl;
|
||
|
|
} kinc_video_t;
|
||
|
|
|
||
|
|
/// <summary>
|
||
|
|
/// Returns the list of video formats which are supported on the current system.
|
||
|
|
/// </summary>
|
||
|
|
/// <returns>A NULL-terminated list of strings representing the supported video-formats</returns>
|
||
|
|
KINC_FUNC const char **kinc_video_formats(void);
|
||
|
|
|
||
|
|
/// <summary>
|
||
|
|
/// Prepares a video object based on an encoded video-file.
|
||
|
|
/// </summary>
|
||
|
|
KINC_FUNC void kinc_video_init(kinc_video_t *video, const char *filename);
|
||
|
|
|
||
|
|
/// <summary>
|
||
|
|
/// Destroys a video object.
|
||
|
|
/// </summary>
|
||
|
|
KINC_FUNC void kinc_video_destroy(kinc_video_t *video);
|
||
|
|
|
||
|
|
/// <summary>
|
||
|
|
/// Starts playing a video.
|
||
|
|
/// </summary>
|
||
|
|
KINC_FUNC void kinc_video_play(kinc_video_t *video, bool loop);
|
||
|
|
|
||
|
|
/// <summary>
|
||
|
|
/// Pauses a video.
|
||
|
|
/// </summary>
|
||
|
|
KINC_FUNC void kinc_video_pause(kinc_video_t *video);
|
||
|
|
|
||
|
|
/// <summary>
|
||
|
|
/// Stops a video which is equivalent to pausing it and setting the position to 0.
|
||
|
|
/// </summary>
|
||
|
|
KINC_FUNC void kinc_video_stop(kinc_video_t *video);
|
||
|
|
|
||
|
|
/// <summary>
|
||
|
|
/// Gets the width of the video in pixels.
|
||
|
|
/// </summary>
|
||
|
|
/// <returns>The width of the video in pixels</returns>
|
||
|
|
KINC_FUNC int kinc_video_width(kinc_video_t *video);
|
||
|
|
|
||
|
|
/// <summary>
|
||
|
|
/// Gets the height of the video in pixels.
|
||
|
|
/// </summary>
|
||
|
|
/// <returns>The height of the video in pixels</returns>
|
||
|
|
KINC_FUNC int kinc_video_height(kinc_video_t *video);
|
||
|
|
|
||
|
|
/// <summary>
|
||
|
|
/// Gets the current image of a playing video which can be rendered using any of Kinc's graphics APIs.
|
||
|
|
/// </summary>
|
||
|
|
/// <returns>The current image of a playing video</returns>
|
||
|
|
KINC_FUNC kinc_g4_texture_t *kinc_video_current_image(kinc_video_t *video);
|
||
|
|
|
||
|
|
/// <summary>
|
||
|
|
/// Gets the duration of the video in seconds.
|
||
|
|
/// </summary>
|
||
|
|
/// <returns>The duration of the video in seconds</returns>
|
||
|
|
KINC_FUNC double kinc_video_duration(kinc_video_t *video);
|
||
|
|
|
||
|
|
/// <summary>
|
||
|
|
/// Returns the current playback-position of the video in seconds.
|
||
|
|
/// </summary>
|
||
|
|
/// <returns>The current playback-position in seconds</returns>
|
||
|
|
KINC_FUNC double kinc_video_position(kinc_video_t *video);
|
||
|
|
|
||
|
|
/// <summary>
|
||
|
|
/// Returns whether the video reached its end.
|
||
|
|
/// </summary>
|
||
|
|
/// <returns>the end-state of the video</returns>
|
||
|
|
KINC_FUNC bool kinc_video_finished(kinc_video_t *video);
|
||
|
|
|
||
|
|
/// <summary>
|
||
|
|
/// Returns whether the video is currently paused.
|
||
|
|
/// </summary>
|
||
|
|
/// <returns>The current pause state of the video</returns>
|
||
|
|
KINC_FUNC bool kinc_video_paused(kinc_video_t *video);
|
||
|
|
|
||
|
|
/// <summary>
|
||
|
|
/// Call this every frame to update the video. This is not required on all targets but where it's not required the function just does nothing - so please call
|
||
|
|
/// it.
|
||
|
|
/// </summary>
|
||
|
|
KINC_FUNC void kinc_video_update(kinc_video_t *video, double time);
|
||
|
|
|
||
|
|
#ifdef __cplusplus
|
||
|
|
}
|
||
|
|
#endif
|