FFmpeg
nvdec.h
Go to the documentation of this file.
1 /*
2  * HW decode acceleration through NVDEC
3  *
4  * Copyright (c) 2016 Anton Khirnov
5  *
6  * This file is part of FFmpeg.
7  *
8  * FFmpeg is free software; you can redistribute it and/or
9  * modify it under the terms of the GNU Lesser General Public
10  * License as published by the Free Software Foundation; either
11  * version 2.1 of the License, or (at your option) any later version.
12  *
13  * FFmpeg is distributed in the hope that it will be useful,
14  * but WITHOUT ANY WARRANTY; without even the implied warranty of
15  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
16  * Lesser General Public License for more details.
17  *
18  * You should have received a copy of the GNU Lesser General Public
19  * License along with FFmpeg; if not, write to the Free Software
20  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
21  */
22 
23 #ifndef AVCODEC_NVDEC_H
24 #define AVCODEC_NVDEC_H
25 
27 
28 #include <stdint.h>
29 
30 #include "libavutil/buffer.h"
31 #include "libavutil/frame.h"
32 
33 #include "avcodec.h"
34 
35 #if defined(NVDECAPI_MAJOR_VERSION) && defined(NVDECAPI_MINOR_VERSION)
36 # define NVDECAPI_CHECK_VERSION(major, minor) \
37  ((major) < NVDECAPI_MAJOR_VERSION || ((major) == NVDECAPI_MAJOR_VERSION && (minor) <= NVDECAPI_MINOR_VERSION))
38 #else
39 /* version macros were added in SDK 8.1 ffnvcodec */
40 # define NVDECAPI_CHECK_VERSION(major, minor) \
41  ((major) < 8 || ((major) == 8 && (minor) <= 0))
42 #endif
43 
44 typedef struct NVDECFrame {
45  unsigned int idx;
46  unsigned int ref_idx;
47  unsigned int *idx_ref; ///< RefStruct reference
48  unsigned int *ref_idx_ref; ///< RefStruct reference
49  struct NVDECDecoder *decoder; ///< RefStruct reference
50 } NVDECFrame;
51 
52 typedef struct NVDECContext {
53  CUVIDPICPARAMS pic_params;
54 
56 
57  struct NVDECDecoder *decoder; ///< RefStruct reference
58 
59  const uint8_t *bitstream;
61  unsigned int bitstream_allocated;
63 
64  unsigned *slice_offsets;
65  int nb_slices;
67 
69 } NVDECContext;
70 
74 int ff_nvdec_start_frame_sep_ref(AVCodecContext *avctx, AVFrame *frame, int has_sep_ref);
77 int ff_nvdec_simple_decode_slice(AVCodecContext *avctx, const uint8_t *buffer,
78  uint32_t size);
80  AVBufferRef *hw_frames_ctx,
81  int dpb_size,
82  int supports_444);
84 
85 #endif /* AVCODEC_NVDEC_H */
ff_nvdec_decode_uninit
int ff_nvdec_decode_uninit(AVCodecContext *avctx)
Definition: nvdec.c:259
ff_nvdec_start_frame
int ff_nvdec_start_frame(AVCodecContext *avctx, AVFrame *frame)
Definition: nvdec.c:561
AVFrame
This structure describes decoded (raw) audio or video data.
Definition: frame.h:374
NVDECContext::decoder
struct NVDECDecoder * decoder
RefStruct reference.
Definition: nvdec.h:57
NVDECContext::bitstream_len
int bitstream_len
Definition: nvdec.h:60
ff_nvdec_simple_end_frame
int ff_nvdec_simple_end_frame(AVCodecContext *avctx)
Definition: nvdec.c:663
NVDECContext::pic_params
CUVIDPICPARAMS pic_params
Definition: nvdec.h:53
ff_nvdec_frame_params
int ff_nvdec_frame_params(AVCodecContext *avctx, AVBufferRef *hw_frames_ctx, int dpb_size, int supports_444)
Definition: nvdec.c:695
NVDECFrame::idx_ref
unsigned int * idx_ref
RefStruct reference.
Definition: nvdec.h:47
ff_nvdec_get_ref_idx
int ff_nvdec_get_ref_idx(AVFrame *frame)
Definition: nvdec.c:747
NVDECFrame::ref_idx
unsigned int ref_idx
Definition: nvdec.h:46
NVDECContext::bitstream
const uint8_t * bitstream
Definition: nvdec.h:59
NVDECContext::nb_slices
int nb_slices
Definition: nvdec.h:65
NVDECFrame
Definition: nvdec.h:44
FFRefStructPool
FFRefStructPool is an API for a thread-safe pool of objects managed via the RefStruct API.
Definition: refstruct.c:183
dpb_size
int dpb_size
Definition: h264_levels.c:111
NVDECContext::bitstream_allocated
unsigned int bitstream_allocated
Definition: nvdec.h:61
NVDECFrame::ref_idx_ref
unsigned int * ref_idx_ref
RefStruct reference.
Definition: nvdec.h:48
NVDECFrame::idx
unsigned int idx
Definition: nvdec.h:45
size
int size
Definition: twinvq_data.h:10344
frame.h
buffer.h
NVDECContext::slice_offsets
unsigned * slice_offsets
Definition: nvdec.h:64
NVDECFrame::decoder
struct NVDECDecoder * decoder
RefStruct reference.
Definition: nvdec.h:49
ff_nvdec_decode_init
int ff_nvdec_decode_init(AVCodecContext *avctx)
Definition: nvdec.c:327
NVDECDecoder
Definition: nvdec.c:46
NVDECContext::supports_444
int supports_444
Definition: nvdec.h:68
ff_nvdec_start_frame_sep_ref
int ff_nvdec_start_frame_sep_ref(AVCodecContext *avctx, AVFrame *frame, int has_sep_ref)
Definition: nvdec.c:599
avcodec.h
ff_nvdec_end_frame
int ff_nvdec_end_frame(AVCodecContext *avctx)
Definition: nvdec.c:633
ff_nvdec_simple_decode_slice
int ff_nvdec_simple_decode_slice(AVCodecContext *avctx, const uint8_t *buffer, uint32_t size)
Definition: nvdec.c:673
frame
these buffered frames must be flushed immediately if a new input produces new the filter must not call request_frame to get more It must just process the frame or queue it The task of requesting more frames is left to the filter s request_frame method or the application If a filter has several the filter must be ready for frames arriving randomly on any input any filter with several inputs will most likely require some kind of queuing mechanism It is perfectly acceptable to have a limited queue and to drop frames when the inputs are too unbalanced request_frame For filters that do not use the this method is called when a frame is wanted on an output For a it should directly call filter_frame on the corresponding output For a if there are queued frames already one of these frames should be pushed If the filter should request a frame on one of its repeatedly until at least one frame has been pushed Return or at least make progress towards producing a frame
Definition: filter_design.txt:264
AVCodecContext
main external API structure.
Definition: avcodec.h:445
buffer
the frame and frame reference mechanism is intended to as much as expensive copies of that data while still allowing the filters to produce correct results The data is stored in buffers represented by AVFrame structures Several references can point to the same frame buffer
Definition: filter_design.txt:49
AVBufferRef
A reference to a data buffer.
Definition: buffer.h:82
NVDECContext::bitstream_internal
uint8_t * bitstream_internal
Definition: nvdec.h:62
NVDECContext::slice_offsets_allocated
unsigned int slice_offsets_allocated
Definition: nvdec.h:66
NVDECContext::decoder_pool
struct FFRefStructPool * decoder_pool
Definition: nvdec.h:55
NVDECContext
Definition: nvdec.h:52