You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
122 lines
4.2 KiB
122 lines
4.2 KiB
/*****************************************************************************
|
|
* va.h: Video Acceleration API for avcodec
|
|
*****************************************************************************
|
|
* Copyright (C) 2009 Laurent Aimar
|
|
* $Id$
|
|
*
|
|
* Authors: Laurent Aimar <fenrir_AT_ videolan _DOT_ org>
|
|
*
|
|
* This program is free software; you can redistribute it and/or modify it
|
|
* under the terms of the GNU Lesser General Public License as published by
|
|
* the Free Software Foundation; either version 2.1 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 Lesser General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU Lesser General Public License
|
|
* along with this program; if not, write to the Free Software Foundation,
|
|
* Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
|
|
*****************************************************************************/
|
|
|
|
#include "avcommon_compat.h"
|
|
|
|
#ifndef VLC_AVCODEC_VA_H
|
|
#define VLC_AVCODEC_VA_H 1
|
|
|
|
typedef struct vlc_va_t vlc_va_t;
|
|
typedef struct vlc_va_sys_t vlc_va_sys_t;
|
|
|
|
struct vlc_va_t {
|
|
VLC_COMMON_MEMBERS
|
|
|
|
vlc_va_sys_t *sys;
|
|
module_t *module;
|
|
const char *description;
|
|
|
|
#ifdef _WIN32
|
|
VLC_DEPRECATED
|
|
void (*setup)(vlc_va_t *, vlc_fourcc_t *output);
|
|
#endif
|
|
int (*get)(vlc_va_t *, picture_t *pic, uint8_t **data);
|
|
void (*release)(void *pic, uint8_t *data);
|
|
int (*extract)(vlc_va_t *, picture_t *pic, uint8_t *data);
|
|
};
|
|
|
|
/**
|
|
* Determines the VLC video chroma value for a pair of hardware acceleration
|
|
* PixelFormat and software PixelFormat.
|
|
* @param hwfmt the hardware acceleration pixel format
|
|
* @param swfmt the software pixel format
|
|
* @return a VLC chroma value, or 0 on error.
|
|
*/
|
|
vlc_fourcc_t vlc_va_GetChroma(enum PixelFormat hwfmt, enum PixelFormat swfmt);
|
|
|
|
/**
|
|
* Creates an accelerated video decoding back-end for libavcodec.
|
|
* @param obj parent VLC object
|
|
* @param fmt VLC format of the content to decode
|
|
* @return a new VLC object on success, NULL on error.
|
|
*/
|
|
vlc_va_t *vlc_va_New(vlc_object_t *obj, AVCodecContext *,
|
|
enum PixelFormat, const es_format_t *fmt,
|
|
picture_sys_t *p_sys);
|
|
|
|
/**
|
|
* Allocates a hardware video surface for a libavcodec frame.
|
|
* The surface will be used as output for the hardware decoder, and possibly
|
|
* also as a reference frame to decode other surfaces.
|
|
*
|
|
* @param pic pointer to VLC picture being allocated [IN/OUT]
|
|
* @param data pointer to the AVFrame data[0] and data[3] pointers [OUT]
|
|
*
|
|
* @note This function needs not be reentrant. However it may be called
|
|
* concurrently with vlc_va_Extract() and/or vlc_va_Release() from other
|
|
* threads and other frames.
|
|
*
|
|
* @return VLC_SUCCESS on success, otherwise an error code.
|
|
*/
|
|
static inline int vlc_va_Get(vlc_va_t *va, picture_t *pic, uint8_t **data)
|
|
{
|
|
return va->get(va, pic, data);
|
|
}
|
|
|
|
/**
|
|
* Releases a hardware surface from a libavcodec frame.
|
|
* The surface has been previously allocated with vlc_va_Get().
|
|
*
|
|
* @param pic VLC picture being released [IN/OUT]
|
|
*
|
|
* @note This function needs not be reentrant. However it may be called
|
|
* concurrently with vlc_va_Get() and/or vlc_va_Extract() from other threads
|
|
* and other frames.
|
|
*/
|
|
static inline void vlc_va_Release(vlc_va_t *va, picture_t *pic)
|
|
{
|
|
va->release(pic, NULL);
|
|
}
|
|
|
|
/**
|
|
* Extracts a hardware surface from a libavcodec frame into a VLC picture.
|
|
* The surface has been previously allocated with vlc_va_Get() and decoded
|
|
* by the libavcodec hardware acceleration.
|
|
* The surface may still be used by libavcodec as a reference frame until it is
|
|
* freed with vlc_va_Release().
|
|
*
|
|
* @note This function needs not be reentrant, but it may run concurrently with
|
|
* vlc_va_Get() or vlc_va_Release() in other threads (with distinct frames).
|
|
*/
|
|
static inline int vlc_va_Extract(vlc_va_t *va, picture_t *pic, uint8_t *data)
|
|
{
|
|
return va->extract(va, pic, data);
|
|
}
|
|
|
|
/**
|
|
* Destroys a libavcodec hardware acceleration back-end.
|
|
* All allocated surfaces shall have been released beforehand.
|
|
*/
|
|
void vlc_va_Delete(vlc_va_t *, void **);
|
|
|
|
#endif
|
|
|