gstreamer/sys/nvcodec/gstnvdecoder.h
Seungha Yang 9c21923f04 nvcodec: Add H264 stateless codec implementation
Introduce GstH264Decoder based Nvidia H.264 decoder element.
Similar the element factory name of to v4l2 stateless codec,
this element can be configured with factory name "gstnvh264sldec".
Note that "sl" in the name stands for "stateless"

For now, existing nvh264dec covers more profile and formats
(e.g., interlaced stream) than this implementation.
However, this implementation allows us to control lower level
parameters such as decoded picture buffer management and therefore
we can get a chance to improve performance in terms of latency.

Part-of: <https://gitlab.freedesktop.org/gstreamer/gst-plugins-bad/-/merge_requests/1198>
2020-04-24 09:23:10 +00:00

89 lines
2.8 KiB
C

/* GStreamer
* Copyright (C) 2020 Seungha Yang <seungha@centricular.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_NV_DECODER_H__
#define __GST_NV_DECODER_H__
#include <gst/gst.h>
#include <gst/video/video.h>
#include "gstcudautils.h"
#include "gstcuvidloader.h"
G_BEGIN_DECLS
#define GST_TYPE_NV_DECODER (gst_nv_decoder_get_type())
G_DECLARE_FINAL_TYPE (GstNvDecoder,
gst_nv_decoder, GST, NV_DECODER, GstObject);
typedef struct _GstNvDecoderFrame
{
/* CUVIDPICPARAMS::CurrPicIdx */
gint index;
guintptr devptr;
guint pitch;
gboolean mapped;
/*< private >*/
GstNvDecoder *decoder;
} GstNvDecoderFrame;
typedef enum
{
GST_NV_DECOCER_OUTPUT_TYPE_SYSTEM = 0,
GST_NV_DECOCER_OUTPUT_TYPE_GL,
/* FIXME: add support CUDA, D3D11 memory */
} GstNvDecoderOutputType;
G_GNUC_INTERNAL
GstNvDecoder * gst_nv_decoder_new (GstCudaContext * context,
cudaVideoCodec codec,
GstVideoInfo * info,
guint pool_size);
G_GNUC_INTERNAL
GstNvDecoderFrame * gst_nv_decoder_new_frame (GstNvDecoder * decoder);
G_GNUC_INTERNAL
void gst_nv_decoder_frame_free (GstNvDecoderFrame * frame);
G_GNUC_INTERNAL
gboolean gst_nv_decoder_decode_picture (GstNvDecoder * decoder,
CUVIDPICPARAMS * params);
G_GNUC_INTERNAL
gboolean gst_nv_decoder_finish_frame (GstNvDecoder * decoder,
GstNvDecoderOutputType output_type,
GstObject * graphics_context,
GstNvDecoderFrame *frame,
GstBuffer *buffer);
/* utils for class registration */
G_GNUC_INTERNAL
gboolean gst_nv_decoder_check_device_caps (CUcontext cuda_ctx,
cudaVideoCodec codec,
GstCaps **sink_template,
GstCaps **src_template);
G_GNUC_INTERNAL
const gchar * gst_cuda_video_codec_to_string (cudaVideoCodec codec);
G_END_DECLS
#endif /* __GST_NV_DECODER_H__ */