gstreamer/subprojects/gst-plugins-bad/sys/nvcodec/gstnvenc.h

Ignoring revisions in .git-blame-ignore-revs. Click here to bypass and see the normal blame view.

81 lines
2.7 KiB
C
Raw Normal View History

/* GStreamer NVENC plugin
* Copyright (C) 2015 Centricular Ltd
*
* 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_NVENC_H_INCLUDED__
#define __GST_NVENC_H_INCLUDED__
#include <gst/gst.h>
#include <gst/video/video.h>
#include <gst/cuda/gstcuda.h>
#include "nvEncodeAPI.h"
nvcodec: Add new Direct3D11/CUDA mode encoder implementation Adding new encoder elements nvd3d11{h264,h265}enc for Direct3D11 input support and re-written nvcuda{h264,h265}enc elements. Newly writeen elements have some differences compared with old nv{h264,h265}enc including non-backward compatible changes. * RGBA is not a supported input format any more: New elements will support only YUV formats to avoid implicit conversion done by hardware. Ideally it should be done by upstream element in order to have more control on it. Moreover, RGBA support can cause redundant RGBA -> YUV conversion if multiple encoders are used for the same RGBA input * Subsampled planar format support is dropped: I420 and YV12 format are not supported formats for Direct3D11. Although it's supported in CUDA mode, it's not a hardware friendly memory layout and it will waste GPU memory since UV planes will have large padding due to the memory layout requirement of NVENC. * GL support is dropped: Similar to the RGBA case, GL support in encoder would be suboptimal if GL input is used by multiple encoders, because each encoder will copy GL memory into CUDA memory. Upstream cudaupload element can be used for GL <-> CUDA interop instead. * No more pre-allocation of encoder input surfaces. New implementation will use input CUDA memory without copy (zero-copy) or will copy into a NVENC's input buffer struct in case of system memory input. Part-of: <https://gitlab.freedesktop.org/gstreamer/gstreamer/-/merge_requests/1997>
2022-03-15 19:58:16 +00:00
G_BEGIN_DECLS
guint32 gst_nvenc_get_api_version (void);
guint32 gst_nvenc_get_caps_param_version (void);
guint32 gst_nvenc_get_encode_out_params_version (void);
guint32 gst_nvenc_get_create_input_buffer_version (void);
guint32 gst_nvenc_get_create_bitstream_buffer_version (void);
guint32 gst_nvenc_get_create_mv_buffer_version (void);
guint32 gst_nvenc_get_rc_params_version (void);
guint32 gst_nvenc_get_config_version (void);
guint32 gst_nvenc_get_initialize_params_version (void);
guint32 gst_nvenc_get_reconfigure_params_version (void);
guint32 gst_nvenc_get_preset_config_version (void);
guint32 gst_nvenc_get_pic_params_version (void);
guint32 gst_nvenc_get_meonly_params_version (void);
guint32 gst_nvenc_get_lock_bitstream_version (void);
guint32 gst_nvenc_get_lock_input_buffer_version (void);
guint32 gst_nvenc_get_map_input_resource_version (void);
guint32 gst_nvenc_get_register_resource_version (void);
guint32 gst_nvenc_get_stat_version (void);
guint32 gst_nvenc_get_sequence_param_payload_version (void);
guint32 gst_nvenc_get_event_params_version (void);
guint32 gst_nvenc_get_open_encode_session_ex_params_version (void);
gboolean gst_nvenc_have_set_io_cuda_streams (void);
gboolean gst_nvenc_load_library (guint * api_major_ver,
guint * api_minor_ver);
nvcodec: Add new Direct3D11/CUDA mode encoder implementation Adding new encoder elements nvd3d11{h264,h265}enc for Direct3D11 input support and re-written nvcuda{h264,h265}enc elements. Newly writeen elements have some differences compared with old nv{h264,h265}enc including non-backward compatible changes. * RGBA is not a supported input format any more: New elements will support only YUV formats to avoid implicit conversion done by hardware. Ideally it should be done by upstream element in order to have more control on it. Moreover, RGBA support can cause redundant RGBA -> YUV conversion if multiple encoders are used for the same RGBA input * Subsampled planar format support is dropped: I420 and YV12 format are not supported formats for Direct3D11. Although it's supported in CUDA mode, it's not a hardware friendly memory layout and it will waste GPU memory since UV planes will have large padding due to the memory layout requirement of NVENC. * GL support is dropped: Similar to the RGBA case, GL support in encoder would be suboptimal if GL input is used by multiple encoders, because each encoder will copy GL memory into CUDA memory. Upstream cudaupload element can be used for GL <-> CUDA interop instead. * No more pre-allocation of encoder input surfaces. New implementation will use input CUDA memory without copy (zero-copy) or will copy into a NVENC's input buffer struct in case of system memory input. Part-of: <https://gitlab.freedesktop.org/gstreamer/gstreamer/-/merge_requests/1997>
2022-03-15 19:58:16 +00:00
G_END_DECLS
#endif /* __GST_NVENC_H_INCLUDED__ */