mirror of
https://gitlab.freedesktop.org/gstreamer/gstreamer.git
synced 2024-11-30 21:51:09 +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 */
|