FFmpeg: libavcodec/nvdec.h Source File

FFmpeg

libavcodec

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

26 #include "compat/cuda/dynlink_loader.h"

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

55 struct FFRefStructPool *decoder_pool;

56

57 struct NVDECDecoder *decoder; ///< RefStruct reference

58

59 const uint8_t *bitstream;

60 int bitstream_len;

61 unsigned int bitstream_allocated;

62 uint8_t *bitstream_internal;

63

64 unsigned *slice_offsets;

65 int nb_slices;

66 unsigned int slice_offsets_allocated;

67

68 int supports_444;

69 } NVDECContext;

70

71 int ff_nvdec_decode_init(AVCodecContext *avctx);

72 int ff_nvdec_decode_uninit(AVCodecContext *avctx);

73 int ff_nvdec_start_frame(AVCodecContext *avctx, AVFrame *frame);

74 int ff_nvdec_start_frame_sep_ref(AVCodecContext *avctx, AVFrame *frame, int has_sep_ref);

75 int ff_nvdec_end_frame(AVCodecContext *avctx);

76 int ff_nvdec_simple_end_frame(AVCodecContext *avctx);

77 int ff_nvdec_simple_decode_slice(AVCodecContext *avctx, const uint8_t *buffer,

78 uint32_t size);

79 int ff_nvdec_frame_params(AVCodecContext *avctx,

80 AVBufferRef *hw_frames_ctx,

81 int dpb_size,

82 int supports_444);

83 int ff_nvdec_get_ref_idx(AVFrame *frame);

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

This structure describes decoded (raw) audio or video data.

Definition: frame.h:389

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

dynlink_loader.h

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

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

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

int size

Definition: twinvq_data.h:10344

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

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

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

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

main external API structure.

Definition: avcodec.h:451

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

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

Definition: nvdec.h:52

Generated on Fri Aug 22 2025 13:58:43 for FFmpeg by doxygen 1.8.17