gstreamer/subprojects/gst-plugins-bad/sys/v4l2codecs/gstv4l2decoder.h
Robert Mader 5189e8b956 v4l2codecs: decoders: Add DMA_DRM caps support
In order to simplify caps negotiations for clients and, notably, be more
compatible with va* decoders.
Crucially this allows clients to know ahead of time whether buffers will
actually be DMABufs.

Similar to GstVaBaseDec we only announce system memory caps if the peer
has ANY caps. Further more, and again like va decoders, we fail in
`decide_allocation()` if DMA_DRM caps are used without VideoMeta.
Apart from buggy peers this can happen e.g. when a peer with ANY caps
is used in combination with caps filters.

Part-of: <https://gitlab.freedesktop.org/gstreamer/gstreamer/-/merge_requests/5890>
2024-03-14 17:32:13 +00:00

166 lines
7.4 KiB
C

/* GStreamer
* Copyright (C) 2020 Nicolas Dufresne <nicolas.dufresne@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_DECODER_H__
#define __GST_V4L2_DECODER_H__
#include <gst/gst.h>
#include <gst/video/video.h>
#include "gstv4l2codecdevice.h"
#include "linux/videodev2.h"
/**
* GST_CODEC_PICTURE_TS_NS:
* @picture: a #GstCodecPicture
*
* Returns system_frame_number field of @picture converted to nanosecond.
*
* Since: 1.24
*/
#define GST_CODEC_PICTURE_TS_NS(picture) \
gst_util_uint64_scale_int (GST_CODEC_PICTURE_FRAME_NUMBER(picture), 1000, 1)
G_BEGIN_DECLS
#define GST_TYPE_V4L2_DECODER gst_v4l2_decoder_get_type ()
G_DECLARE_FINAL_TYPE (GstV4l2Decoder, gst_v4l2_decoder, GST, V4L2_DECODER, GstObject);
typedef struct _GstV4l2Request GstV4l2Request;
GstV4l2Decoder * gst_v4l2_decoder_new (GstV4l2CodecDevice * device);
guint gst_v4l2_decoder_get_version (GstV4l2Decoder * self);
gboolean gst_v4l2_decoder_open (GstV4l2Decoder * decoder);
gboolean gst_v4l2_decoder_close (GstV4l2Decoder * decoder);
gboolean gst_v4l2_decoder_streamon (GstV4l2Decoder * self,
GstPadDirection direction);
gboolean gst_v4l2_decoder_streamoff (GstV4l2Decoder * self,
GstPadDirection direction);
gboolean gst_v4l2_decoder_flush (GstV4l2Decoder * self);
gboolean gst_v4l2_decoder_enum_sink_fmt (GstV4l2Decoder * self,
gint i, guint32 * out_fmt);
gboolean gst_v4l2_decoder_set_sink_fmt (GstV4l2Decoder * self, guint32 fmt,
gint width, gint height,
gint pixel_bitdepth);
GstCaps * gst_v4l2_decoder_enum_src_formats (GstV4l2Decoder * self,
GstStaticCaps * static_filter);
gboolean gst_v4l2_decoder_select_src_format (GstV4l2Decoder * self,
GstCaps * caps,
GstVideoInfo * vinfo,
GstVideoInfoDmaDrm * vinfo_drm);
GstVideoCodecState * gst_v4l2_decoder_set_output_state (GstVideoDecoder * decoder,
GstVideoInfo * vinfo,
GstVideoInfoDmaDrm * drm_info,
guint width,
guint height,
GstVideoCodecState * reference);
gint gst_v4l2_decoder_request_buffers (GstV4l2Decoder * self,
GstPadDirection direction,
guint num_buffers);
gboolean gst_v4l2_decoder_export_buffer (GstV4l2Decoder * self,
GstPadDirection directon,
gint index,
gint * fds,
gsize * sizes,
gsize * offsets,
guint *num_fds);
gboolean gst_v4l2_decoder_set_controls (GstV4l2Decoder * self,
GstV4l2Request * request,
struct v4l2_ext_control *control,
guint count);
gboolean gst_v4l2_decoder_get_controls (GstV4l2Decoder * self,
struct v4l2_ext_control * control,
guint count);
gboolean gst_v4l2_decoder_query_control_size (GstV4l2Decoder * self,
unsigned int control_id,
unsigned int *control_size);
void gst_v4l2_decoder_install_properties (GObjectClass * gobject_class,
gint prop_offset,
GstV4l2CodecDevice * device);
void gst_v4l2_decoder_set_property (GObject * object, guint prop_id,
const GValue * value, GParamSpec * pspec);
void gst_v4l2_decoder_get_property (GObject * object, guint prop_id,
GValue * value, GParamSpec * pspec);
void gst_v4l2_decoder_register (GstPlugin * plugin,
GType dec_type,
GClassInitFunc class_init,
gconstpointer class_data,
GInstanceInitFunc instance_init,
const gchar *element_name_tmpl,
GstV4l2CodecDevice * device,
guint rank,
gchar ** element_name);
GstV4l2Request *gst_v4l2_decoder_alloc_request (GstV4l2Decoder * self,
guint32 frame_num,
GstMemory *bitstream,
GstBuffer * pic_buf);
GstV4l2Request *gst_v4l2_decoder_alloc_sub_request (GstV4l2Decoder * self,
GstV4l2Request * prev_request,
GstMemory *bitstream);
void gst_v4l2_decoder_set_render_delay (GstV4l2Decoder * self,
guint delay);
guint gst_v4l2_decoder_get_render_delay (GstV4l2Decoder * self);
GstV4l2Request * gst_v4l2_request_ref (GstV4l2Request * request);
void gst_v4l2_request_unref (GstV4l2Request * request);
gboolean gst_v4l2_request_queue (GstV4l2Request * request,
guint flags);
gint gst_v4l2_request_poll (GstV4l2Request * request,
GstClockTime timeout);
gint gst_v4l2_request_set_done (GstV4l2Request * request);
gboolean gst_v4l2_request_failed (GstV4l2Request * request);
GstBuffer * gst_v4l2_request_dup_pic_buf (GstV4l2Request * request);
gint gst_v4l2_request_get_fd (GstV4l2Request * request);
G_END_DECLS
#endif /* __GST_V4L2_DECODER_H__ */