mirror of
https://gitlab.freedesktop.org/gstreamer/gstreamer.git
synced 2024-12-04 23:46:43 +00:00
5750bd7850
A new FEI based encoder element for h264 is added: vaapih264feienc FEI is a an extension to VA-API which is providing low level advanced control over different stages of encoding. Extending vaapih264enc with fei support is possible, but it will make the code too much complicated and will be difficult to debug. So adding the new encoder element, but keeping the rank as 0 , vaapih264enc will stay as the primary encoder for normal use cases. The vaaih264feienc is mainly useful for customers who want to play with MotionVectors and Macroblock Predictions. Also user can do one stage of encoding(eg: only the Motion Vector Calculation) in software and offload trasformation/entroy-coding etc to Hardware (which is what PAK module is doing) using FEI element. vaapih264feienc can work in different modes using fei-mode properoty eg: gst-launch-1.0 videotestsrc ! vaapih264feienc fei-mode=ENC+PAK ! filesink location=sample.264 Important Note: ENC only mode won't produce any encoded data which is expected. But ENC alwys requires the output of PAK in order to do the inter-prediction over reconstructed frames. Similary PAK mode alway requires MV and MBCode as input, so unless there is an upstream element providing those buffers, PAK only won't work as expected. In a nutshell, ENC_PAK and the ENC+PAK modes are the only options we can verify with vaapih264feienc. But ideally, EN+PAK mode verification is enough to make sure that ENC and PAK are working as expected since ENC+PAK mode always invoke ENC and PAK separately in vaapih264feienc. People contributed: Wang, Yi <yi.a.wang@intel.com> Leilei <leilei.shang@intel.com> Zhong, Xiaoxia <xiaoxia.zhong@intel.com> xiaominc <xiaomin.chen@intel.com> Li, Jing B <jing.b.li@intel.com> https://bugzilla.gnome.org/show_bug.cgi?id=785712 https://bugzilla.gnome.org/show_bug.cgi?id=784667 Signed-off-by: Sreerenj Balachandran <sreerenj.balachandran@intel.com>
72 lines
2.4 KiB
C
72 lines
2.4 KiB
C
/*
|
|
* gstvaapiencode_h264i_fei.h - VA-API H.264 FEI encoder
|
|
*
|
|
* Copyright (C) 2016-2017 Intel Corporation
|
|
* Author: Sreerenj Balachandran <sreerenj.balachandran@intel.com>
|
|
* Author: Yi A Wang <yi.a.wang@intel.com>
|
|
*
|
|
* This library 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 library 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 library; if not, write to the Free
|
|
* Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
|
|
* Boston, MA 02110-1301 USA
|
|
*/
|
|
|
|
#ifndef GST_VAAPIENCODE_H264_FEI_FEI_H
|
|
#define GST_VAAPIENCODE_H264_FEI_FEI_H
|
|
|
|
#include <gst/gst.h>
|
|
#include "gstvaapiencode.h"
|
|
|
|
G_BEGIN_DECLS
|
|
|
|
#define GST_TYPE_VAAPIENCODE_H264_FEI \
|
|
(gst_vaapiencode_h264_fei_get_type ())
|
|
#define GST_VAAPIENCODE_H264_FEI_CAST(obj) \
|
|
((GstVaapiEncodeH264Fei *)(obj))
|
|
#define GST_VAAPIENCODE_H264_FEI(obj) \
|
|
(G_TYPE_CHECK_INSTANCE_CAST ((obj), GST_TYPE_VAAPIENCODE_H264_FEI, \
|
|
GstVaapiEncodeH264Fei))
|
|
#define GST_VAAPIENCODE_H264_FEI_CLASS(klass) \
|
|
(G_TYPE_CHECK_CLASS_CAST ((klass), GST_TYPE_VAAPIENCODE_H264_FEI, \
|
|
GstVaapiEncodeH264FeiClass))
|
|
#define GST_VAAPIENCODE_H264_FEI_GET_CLASS(obj) \
|
|
(G_TYPE_INSTANCE_GET_CLASS ((obj), GST_TYPE_VAAPIENCODE_H264_FEI, \
|
|
GstVaapiEncodeH264FeiClass))
|
|
#define GST_IS_VAAPIENCODE_H264_FEI(obj) \
|
|
(G_TYPE_CHECK_INSTANCE_TYPE ((obj), GST_TYPE_VAAPIENCODE_H264_FEI))
|
|
#define GST_IS_VAAPIENCODE_H264_FEI_CLASS(klass) \
|
|
(G_TYPE_CHECK_CLASS_TYPE ((klass), GST_TYPE_VAAPIENCODE_H264_FEI))
|
|
|
|
typedef struct _GstVaapiEncodeH264Fei GstVaapiEncodeH264Fei;
|
|
typedef struct _GstVaapiEncodeH264FeiClass GstVaapiEncodeH264FeiClass;
|
|
|
|
struct _GstVaapiEncodeH264Fei
|
|
{
|
|
/*< private >*/
|
|
GstVaapiEncode parent_instance;
|
|
|
|
guint is_avc:1; /* [FALSE]=byte-stream (default); [TRUE]=avcC */
|
|
};
|
|
|
|
struct _GstVaapiEncodeH264FeiClass
|
|
{
|
|
/*< private >*/
|
|
GstVaapiEncodeClass parent_class;
|
|
};
|
|
|
|
GType
|
|
gst_vaapiencode_h264_fei_get_type (void) G_GNUC_CONST;
|
|
|
|
G_END_DECLS
|
|
|
|
#endif /* GST_VAAPIENCODE_H264_FEI_FEI_H */
|