268 lines
6.5 KiB
C
268 lines
6.5 KiB
C
/******************************************************************************
|
|
Copyright (C) 2013 by Hugh Bailey <obs.jim@gmail.com>
|
|
|
|
This program is free software: you can redistribute it and/or modify
|
|
it under the terms of the GNU General Public License as published by
|
|
the Free Software Foundation, either version 2 of the License, or
|
|
(at your option) any later version.
|
|
|
|
This program is distributed in the hope that it will be useful,
|
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
GNU General Public License for more details.
|
|
|
|
You should have received a copy of the GNU General Public License
|
|
along with this program. If not, see <http://www.gnu.org/licenses/>.
|
|
******************************************************************************/
|
|
|
|
#pragma once
|
|
|
|
#include "media-io-defs.h"
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
struct video_frame;
|
|
|
|
/* Base video output component. Use this to create a video output track. */
|
|
|
|
struct video_output;
|
|
typedef struct video_output video_t;
|
|
|
|
enum video_format {
|
|
VIDEO_FORMAT_NONE,
|
|
|
|
/* planar 420 format */
|
|
VIDEO_FORMAT_I420, /* three-plane */
|
|
VIDEO_FORMAT_NV12, /* two-plane, luma and packed chroma */
|
|
|
|
/* packed 422 formats */
|
|
VIDEO_FORMAT_YVYU,
|
|
VIDEO_FORMAT_YUY2, /* YUYV */
|
|
VIDEO_FORMAT_UYVY,
|
|
|
|
/* packed uncompressed formats */
|
|
VIDEO_FORMAT_RGBA,
|
|
VIDEO_FORMAT_BGRA,
|
|
VIDEO_FORMAT_BGRX,
|
|
VIDEO_FORMAT_Y800, /* grayscale */
|
|
|
|
/* planar 4:4:4 */
|
|
VIDEO_FORMAT_I444,
|
|
|
|
/* more packed uncompressed formats */
|
|
VIDEO_FORMAT_BGR3,
|
|
|
|
/* planar 4:2:2 */
|
|
VIDEO_FORMAT_I422,
|
|
|
|
/* planar 4:2:0 with alpha */
|
|
VIDEO_FORMAT_I40A,
|
|
|
|
/* planar 4:2:2 with alpha */
|
|
VIDEO_FORMAT_I42A,
|
|
|
|
/* planar 4:4:4 with alpha */
|
|
VIDEO_FORMAT_YUVA,
|
|
|
|
/* packed 4:4:4 with alpha */
|
|
VIDEO_FORMAT_AYUV,
|
|
};
|
|
|
|
enum video_colorspace {
|
|
VIDEO_CS_DEFAULT,
|
|
VIDEO_CS_601,
|
|
VIDEO_CS_709,
|
|
};
|
|
|
|
enum video_range_type {
|
|
VIDEO_RANGE_DEFAULT,
|
|
VIDEO_RANGE_PARTIAL,
|
|
VIDEO_RANGE_FULL
|
|
};
|
|
|
|
struct video_data {
|
|
uint8_t *data[MAX_AV_PLANES];
|
|
uint32_t linesize[MAX_AV_PLANES];
|
|
uint64_t timestamp;
|
|
};
|
|
|
|
struct video_output_info {
|
|
const char *name;
|
|
|
|
enum video_format format;
|
|
uint32_t fps_num;
|
|
uint32_t fps_den;
|
|
uint32_t width;
|
|
uint32_t height;
|
|
size_t cache_size;
|
|
|
|
enum video_colorspace colorspace;
|
|
enum video_range_type range;
|
|
};
|
|
|
|
static inline bool format_is_yuv(enum video_format format)
|
|
{
|
|
switch (format) {
|
|
case VIDEO_FORMAT_I420:
|
|
case VIDEO_FORMAT_NV12:
|
|
case VIDEO_FORMAT_I422:
|
|
case VIDEO_FORMAT_YVYU:
|
|
case VIDEO_FORMAT_YUY2:
|
|
case VIDEO_FORMAT_UYVY:
|
|
case VIDEO_FORMAT_I444:
|
|
case VIDEO_FORMAT_I40A:
|
|
case VIDEO_FORMAT_I42A:
|
|
case VIDEO_FORMAT_YUVA:
|
|
case VIDEO_FORMAT_AYUV:
|
|
return true;
|
|
case VIDEO_FORMAT_NONE:
|
|
case VIDEO_FORMAT_RGBA:
|
|
case VIDEO_FORMAT_BGRA:
|
|
case VIDEO_FORMAT_BGRX:
|
|
case VIDEO_FORMAT_Y800:
|
|
case VIDEO_FORMAT_BGR3:
|
|
return false;
|
|
}
|
|
|
|
return false;
|
|
}
|
|
|
|
static inline const char *get_video_format_name(enum video_format format)
|
|
{
|
|
switch (format) {
|
|
case VIDEO_FORMAT_I420:
|
|
return "I420";
|
|
case VIDEO_FORMAT_NV12:
|
|
return "NV12";
|
|
case VIDEO_FORMAT_I422:
|
|
return "I422";
|
|
case VIDEO_FORMAT_YVYU:
|
|
return "YVYU";
|
|
case VIDEO_FORMAT_YUY2:
|
|
return "YUY2";
|
|
case VIDEO_FORMAT_UYVY:
|
|
return "UYVY";
|
|
case VIDEO_FORMAT_RGBA:
|
|
return "RGBA";
|
|
case VIDEO_FORMAT_BGRA:
|
|
return "BGRA";
|
|
case VIDEO_FORMAT_BGRX:
|
|
return "BGRX";
|
|
case VIDEO_FORMAT_I444:
|
|
return "I444";
|
|
case VIDEO_FORMAT_Y800:
|
|
return "Y800";
|
|
case VIDEO_FORMAT_BGR3:
|
|
return "BGR3";
|
|
case VIDEO_FORMAT_I40A:
|
|
return "I40A";
|
|
case VIDEO_FORMAT_I42A:
|
|
return "I42A";
|
|
case VIDEO_FORMAT_YUVA:
|
|
return "YUVA";
|
|
case VIDEO_FORMAT_AYUV:
|
|
return "AYUV";
|
|
case VIDEO_FORMAT_NONE:;
|
|
}
|
|
|
|
return "None";
|
|
}
|
|
|
|
static inline const char *get_video_colorspace_name(enum video_colorspace cs)
|
|
{
|
|
switch (cs) {
|
|
case VIDEO_CS_709:
|
|
return "709";
|
|
case VIDEO_CS_601:
|
|
case VIDEO_CS_DEFAULT:;
|
|
}
|
|
|
|
return "601";
|
|
}
|
|
|
|
static inline enum video_range_type
|
|
resolve_video_range(enum video_format format, enum video_range_type range)
|
|
{
|
|
if (range == VIDEO_RANGE_DEFAULT) {
|
|
range = format_is_yuv(format) ? VIDEO_RANGE_PARTIAL
|
|
: VIDEO_RANGE_FULL;
|
|
}
|
|
|
|
return range;
|
|
}
|
|
|
|
static inline const char *get_video_range_name(enum video_format format,
|
|
enum video_range_type range)
|
|
{
|
|
range = resolve_video_range(format, range);
|
|
return range == VIDEO_RANGE_FULL ? "Full" : "Partial";
|
|
}
|
|
|
|
enum video_scale_type {
|
|
VIDEO_SCALE_DEFAULT,
|
|
VIDEO_SCALE_POINT,
|
|
VIDEO_SCALE_FAST_BILINEAR,
|
|
VIDEO_SCALE_BILINEAR,
|
|
VIDEO_SCALE_BICUBIC,
|
|
};
|
|
|
|
struct video_scale_info {
|
|
enum video_format format;
|
|
uint32_t width;
|
|
uint32_t height;
|
|
enum video_range_type range;
|
|
enum video_colorspace colorspace;
|
|
};
|
|
|
|
EXPORT enum video_format video_format_from_fourcc(uint32_t fourcc);
|
|
|
|
EXPORT bool video_format_get_parameters(enum video_colorspace color_space,
|
|
enum video_range_type range,
|
|
float matrix[16], float min_range[3],
|
|
float max_range[3]);
|
|
|
|
#define VIDEO_OUTPUT_SUCCESS 0
|
|
#define VIDEO_OUTPUT_INVALIDPARAM -1
|
|
#define VIDEO_OUTPUT_FAIL -2
|
|
|
|
EXPORT int video_output_open(video_t **video, struct video_output_info *info);
|
|
EXPORT void video_output_close(video_t *video);
|
|
|
|
EXPORT bool
|
|
video_output_connect(video_t *video, const struct video_scale_info *conversion,
|
|
void (*callback)(void *param, struct video_data *frame),
|
|
void *param);
|
|
EXPORT void video_output_disconnect(video_t *video,
|
|
void (*callback)(void *param,
|
|
struct video_data *frame),
|
|
void *param);
|
|
|
|
EXPORT bool video_output_active(const video_t *video);
|
|
|
|
EXPORT const struct video_output_info *
|
|
video_output_get_info(const video_t *video);
|
|
EXPORT bool video_output_lock_frame(video_t *video, struct video_frame *frame,
|
|
int count, uint64_t timestamp);
|
|
EXPORT void video_output_unlock_frame(video_t *video);
|
|
EXPORT uint64_t video_output_get_frame_time(const video_t *video);
|
|
EXPORT void video_output_stop(video_t *video);
|
|
EXPORT bool video_output_stopped(video_t *video);
|
|
|
|
EXPORT enum video_format video_output_get_format(const video_t *video);
|
|
EXPORT uint32_t video_output_get_width(const video_t *video);
|
|
EXPORT uint32_t video_output_get_height(const video_t *video);
|
|
EXPORT double video_output_get_frame_rate(const video_t *video);
|
|
|
|
EXPORT uint32_t video_output_get_skipped_frames(const video_t *video);
|
|
EXPORT uint32_t video_output_get_total_frames(const video_t *video);
|
|
|
|
extern void video_output_inc_texture_encoders(video_t *video);
|
|
extern void video_output_dec_texture_encoders(video_t *video);
|
|
extern void video_output_inc_texture_frames(video_t *video);
|
|
extern void video_output_inc_texture_skipped_frames(video_t *video);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|