gstreamer/sys/v4l2codecs/gstv4l2codecalphadecodebin.h
Daniel Almeida 9e86ac4a22 v4l2codecs: add wrappers for alpha decode
codecalpha is a new plugin introduced to support VP8/VP9 alpha as
defined in the WebM and Matroska specifications. It splits the stream
into two streams, one for the alpha and one for the actual content,
then it decodes them separately with vpxdec and finally combine the
results as A420 or AV12 (i.e. YUV + an extra alpha plane).

The workflow above is setup by means of a bin, gstcodecalphabin.

This patch simulates the same workflow into the v4l2codecs namespace,
thus using the new v4l2 stateless decoders for hardware acceleration.

This is so we can register the new alpha decode elements only if the
hardware produces formats we support, i.e. I420 or NV12 for now.

Part-of: <https://gitlab.freedesktop.org/gstreamer/gst-plugins-bad/-/merge_requests/2272>
2021-05-27 17:00:06 -04:00

57 lines
2.2 KiB
C

/* GStreamer
* Copyright (C) <2021> Collabora Ltd.
* Author: Daniel Almeida <daniel.almeida@collabora.com>
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Library General Public
* License as published by the Free Software Foundation; either
* version 2 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
* Library General Public License for more details.
*
* You should have received a copy of the GNU Library General Public
* License along with this library; if not, write to the
* Free Software Foundation, Inc., 51 Franklin St, Fifth Floor,
* Boston, MA 02110-1301, USA.
*/
#ifndef __GST_V4L2_CODEC_ALPHA_DECODE_BIN_H__
#define __GST_V4L2_CODEC_ALPHA_DECODE_BIN_H__
#include <gst/gst.h>
#include <gstv4l2decoder.h>
/* When wrapping, use the original rank plus this offset. The ad-hoc rules is
* that hardware implementation will use PRIMARY+1 or +2 to override the
* software decoder, so the offset must be large enough to jump over those.
* This should also be small enough so that a marginal (64) or secondary
* wrapper does not cross the PRIMARY line.
*/
#define GST_V4L2_CODEC_ALPHA_DECODE_BIN_RANK_OFFSET 10
G_BEGIN_DECLS
#define GST_TYPE_V4L2_CODEC_ALPHA_DECODE_BIN (gst_v4l2_codec_alpha_decode_bin_get_type())
G_DECLARE_DERIVABLE_TYPE (GstV4l2CodecAlphaDecodeBin,
gst_v4l2_codec_alpha_decode_bin, GST, V4L2_CODEC_ALPHA_DECODE_BIN, GstBin);
struct _GstV4l2CodecAlphaDecodeBinClass
{
GstBinClass parent_class;
gchar *decoder_name;
};
void gst_v4l2_codec_alpha_decode_bin_register (GstPlugin * plugin,
GClassInitFunc class_init,
gconstpointer class_data,
const gchar * element_name_tmpl,
GstV4l2CodecDevice * device,
guint rank);
G_END_DECLS
#endif /* __GST_V4L2_CODEC_ALPHA_DECODE_BIN_H__ */