ff-sys 0.14.1

Low-level FFmpeg FFI bindings for Rust
Documentation
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
1001
1002
1003
1004
1005
1006
1007
1008
1009
1010
1011
1012
1013
1014
1015
1016
1017
1018
1019
1020
1021
1022
1023
1024
1025
1026
1027
1028
1029
1030
1031
1032
1033
1034
1035
1036
1037
1038
1039
1040
1041
1042
1043
1044
1045
1046
1047
1048
1049
1050
1051
1052
1053
1054
1055
1056
1057
1058
1059
1060
1061
1062
1063
1064
1065
1066
1067
1068
1069
1070
1071
1072
1073
1074
1075
1076
1077
1078
1079
1080
1081
1082
1083
1084
1085
1086
1087
1088
1089
1090
1091
1092
1093
1094
1095
1096
1097
1098
1099
1100
1101
1102
1103
// Shape-compatible stubs used by docs.rs builds (DOCS_RS=1).
//
// These definitions mirror the real bindgen-generated FFmpeg bindings in type
// and name, but contain no actual FFmpeg code.  All functions are no-op stubs
// that never run; they exist only to make the dependent crates compile so that
// rustdoc can render their public APIs.
//
// Maintenance note: add entries here whenever a new ff_sys symbol is referenced
// in ff-probe, ff-decode, or ff-encode.  The values of integer constants are
// taken from the FFmpeg 7.x headers for reference accuracy, but correctness at
// runtime is irrelevant — docs.rs never executes this code.

use std::os::raw::{c_char, c_int, c_uint, c_void};
use std::ptr;

// ── Type aliases ──────────────────────────────────────────────────────────────

pub type AVCodecID = c_uint;
pub type AVPixelFormat = c_int;
pub type AVSampleFormat = c_int;
pub type AVMediaType = c_int;
pub type AVColorPrimaries = c_uint;
pub type AVColorRange = c_uint;
pub type AVColorSpace = c_uint;
pub type AVHWDeviceType = c_int;
pub type AVChannelOrder = c_uint;
pub type AVPictureType = c_int;

// ── Opaque types (only ever used behind raw pointers) ─────────────────────────

pub struct AVDictionary(());
pub struct SwsContext(());
pub struct SwrContext(());
pub struct AVBufferRef(());
pub struct AVIOContext(());
pub struct AVOutputFormat(());
pub struct AVAudioFifo(());

pub struct AVInputFormat {
    pub name: *const c_char,
    pub long_name: *const c_char,
    pub flags: c_int,
}

// ── Structs with field-level access ───────────────────────────────────────────

#[derive(Copy, Clone)]
#[repr(C)]
pub union AVChannelLayout__bindgen_ty_1 {
    pub mask: u64,
}

impl Default for AVChannelLayout__bindgen_ty_1 {
    fn default() -> Self {
        Self { mask: 0 }
    }
}

#[derive(Copy, Clone)]
pub struct AVChannelLayout {
    pub order: AVChannelOrder,
    pub nb_channels: c_int,
    pub u: AVChannelLayout__bindgen_ty_1,
}

impl Default for AVChannelLayout {
    fn default() -> Self {
        Self {
            order: 0,
            nb_channels: 0,
            u: AVChannelLayout__bindgen_ty_1::default(),
        }
    }
}

#[derive(Copy, Clone)]
pub struct AVRational {
    pub num: c_int,
    pub den: c_int,
}

pub struct AVDictionaryEntry {
    pub key: *mut c_char,
    pub value: *mut c_char,
}

pub struct AVChapter {
    pub id: i64,
    pub time_base: AVRational,
    pub start: i64,
    pub end: i64,
    pub metadata: *mut AVDictionary,
}

pub struct AVCodecParameters {
    pub codec_type: AVMediaType,
    pub codec_id: AVCodecID,
    pub codec_tag: c_uint,
    pub extradata: *mut u8,
    pub extradata_size: c_int,
    pub format: c_int,
    pub bit_rate: i64,
    pub width: c_int,
    pub height: c_int,
    pub sample_rate: c_int,
    pub ch_layout: AVChannelLayout,
    pub sample_fmt: AVSampleFormat,
    pub color_space: AVColorSpace,
    pub color_range: AVColorRange,
    pub color_primaries: AVColorPrimaries,
}

pub struct AVStream {
    pub codecpar: *mut AVCodecParameters,
    pub nb_frames: i64,
    pub duration: i64,
    pub time_base: AVRational,
    pub avg_frame_rate: AVRational,
    pub r_frame_rate: AVRational,
    pub start_time: i64,
    pub disposition: c_int,
    pub metadata: *mut AVDictionary,
}

pub struct AVFormatContext {
    pub nb_streams: c_uint,
    pub streams: *mut *mut AVStream,
    pub duration: i64,
    pub metadata: *mut AVDictionary,
    pub nb_chapters: c_uint,
    pub chapters: *mut *mut AVChapter,
    pub iformat: *mut AVInputFormat,
    pub bit_rate: i64,
    pub pb: *mut AVIOContext,
    pub priv_data: *mut c_void,
}

pub struct AVFrame {
    pub data: [*mut u8; 8],
    pub linesize: [c_int; 8],
    pub width: c_int,
    pub height: c_int,
    pub nb_samples: c_int,
    pub format: c_int,
    pub key_frame: c_int,
    pub pict_type: AVPictureType,
    pub pts: i64,
    pub pkt_dts: i64,
    pub sample_rate: c_int,
    pub ch_layout: AVChannelLayout,
    pub duration: i64,
    pub time_base: AVRational,
    pub hw_frames_ctx: *mut AVBufferRef,
    pub metadata: *mut AVDictionary,
}

pub struct AVPacket {
    pub pts: i64,
    pub dts: i64,
    pub data: *mut u8,
    pub size: c_int,
    pub stream_index: c_int,
    pub flags: c_int,
    pub duration: i64,
}

pub type AVColorTransferCharacteristic = c_uint;

pub struct AVCodecContext {
    pub codec_id: AVCodecID,
    pub bit_rate: i64,
    pub width: c_int,
    pub height: c_int,
    pub pix_fmt: AVPixelFormat,
    pub sample_rate: c_int,
    pub ch_layout: AVChannelLayout,
    pub sample_fmt: AVSampleFormat,
    pub time_base: AVRational,
    pub framerate: AVRational,
    pub gop_size: c_int,
    pub max_b_frames: c_int,
    pub qmin: c_int,
    pub qmax: c_int,
    pub thread_count: c_int,
    pub hw_device_ctx: *mut AVBufferRef,
    pub hw_frames_ctx: *mut AVBufferRef,
    pub priv_data: *mut c_void,
    pub color_primaries: AVColorPrimaries,
    pub color_trc: AVColorTransferCharacteristic,
    pub colorspace: AVColorSpace,
    // Fields added for v0.7.0 feature coverage
    pub frame_size: c_int,
    pub color_range: AVColorRange,
    pub refs: c_int,
    pub rc_max_rate: i64,
    pub rc_buffer_size: c_int,
    pub flags: c_int,
    pub stats_out: *mut c_char,
    pub stats_in: *mut c_char,
}

pub struct AVCodec {
    pub id: AVCodecID,
    pub sample_fmts: *const AVSampleFormat,
    pub capabilities: c_int,
}

// ── Constants ─────────────────────────────────────────────────────────────────

pub const AV_DICT_IGNORE_SUFFIX: u32 = 2;
pub const AV_NUM_DATA_POINTERS: usize = 8;
pub const AV_TIME_BASE: u32 = 1_000_000;

pub const AVMediaType_AVMEDIA_TYPE_VIDEO: AVMediaType = 0;
pub const AVMediaType_AVMEDIA_TYPE_AUDIO: AVMediaType = 1;
pub const AVMediaType_AVMEDIA_TYPE_SUBTITLE: AVMediaType = 3;
pub const AVMediaType_AVMEDIA_TYPE_ATTACHMENT: AVMediaType = 4;

pub const AV_DISPOSITION_FORCED: u32 = 0x0040;
pub const AV_DISPOSITION_ATTACHED_PIC: u32 = 0x0400;
pub const AV_INPUT_BUFFER_PADDING_SIZE: u32 = 64;

pub const AVChannelOrder_AV_CHANNEL_ORDER_UNSPEC: AVChannelOrder = 0;
pub const AVChannelOrder_AV_CHANNEL_ORDER_NATIVE: AVChannelOrder = 1;

// AVCodecID — video
pub const AVCodecID_AV_CODEC_ID_NONE: AVCodecID = 0;
pub const AVCodecID_AV_CODEC_ID_MPEG2VIDEO: AVCodecID = 2;
pub const AVCodecID_AV_CODEC_ID_MJPEG: AVCodecID = 7;
pub const AVCodecID_AV_CODEC_ID_MPEG4: AVCodecID = 13;
pub const AVCodecID_AV_CODEC_ID_H264: AVCodecID = 27;
pub const AVCodecID_AV_CODEC_ID_THEORA: AVCodecID = 30;
pub const AVCodecID_AV_CODEC_ID_VP8: AVCodecID = 139;
pub const AVCodecID_AV_CODEC_ID_PRORES: AVCodecID = 147;
pub const AVCodecID_AV_CODEC_ID_VP9: AVCodecID = 167;
pub const AVCodecID_AV_CODEC_ID_HEVC: AVCodecID = 173;
pub const AVCodecID_AV_CODEC_ID_AV1: AVCodecID = 226;
pub const AVCodecID_AV_CODEC_ID_DNXHD: AVCodecID = 99;
pub const AVCodecID_AV_CODEC_ID_FFV1: AVCodecID = 33;

// AVCodecID — image (still image)
pub const AVCodecID_AV_CODEC_ID_PNG: AVCodecID = 61;
pub const AVCodecID_AV_CODEC_ID_BMP: AVCodecID = 76;
pub const AVCodecID_AV_CODEC_ID_TIFF: AVCodecID = 90;
pub const AVCodecID_AV_CODEC_ID_WEBP: AVCodecID = 219;
pub const AVCodecID_AV_CODEC_ID_EXR: AVCodecID = 178;

// AVCodecID — animation
pub const AVCodecID_AV_CODEC_ID_GIF: AVCodecID = 97;

// AVCodecID — subtitle
pub const AVCodecID_AV_CODEC_ID_DVB_SUBTITLE: AVCodecID = 94209;
pub const AVCodecID_AV_CODEC_ID_SSA: AVCodecID = 94212;
pub const AVCodecID_AV_CODEC_ID_HDMV_PGS_SUBTITLE: AVCodecID = 94214;
pub const AVCodecID_AV_CODEC_ID_SRT: AVCodecID = 94216;
pub const AVCodecID_AV_CODEC_ID_SUBRIP: AVCodecID = 94248;
pub const AVCodecID_AV_CODEC_ID_WEBVTT: AVCodecID = 94249;
pub const AVCodecID_AV_CODEC_ID_ASS: AVCodecID = 94253;

// AVCodecID — attachment / data
pub const AVCodecID_AV_CODEC_ID_BIN_DATA: AVCodecID = 98314;

// AVCodecID — audio
pub const AVCodecID_AV_CODEC_ID_PCM_S16LE: AVCodecID = 65536;
pub const AVCodecID_AV_CODEC_ID_PCM_S16BE: AVCodecID = 65537;
pub const AVCodecID_AV_CODEC_ID_PCM_U8: AVCodecID = 65542;
pub const AVCodecID_AV_CODEC_ID_PCM_S24LE: AVCodecID = 65544;
pub const AVCodecID_AV_CODEC_ID_PCM_S24BE: AVCodecID = 65545;
pub const AVCodecID_AV_CODEC_ID_PCM_S32LE: AVCodecID = 65556;
pub const AVCodecID_AV_CODEC_ID_PCM_S32BE: AVCodecID = 65557;
pub const AVCodecID_AV_CODEC_ID_PCM_F32LE: AVCodecID = 65558;
pub const AVCodecID_AV_CODEC_ID_PCM_F32BE: AVCodecID = 65559;
pub const AVCodecID_AV_CODEC_ID_PCM_F64LE: AVCodecID = 65560;
pub const AVCodecID_AV_CODEC_ID_PCM_F64BE: AVCodecID = 65561;
pub const AVCodecID_AV_CODEC_ID_MP3: AVCodecID = 86017;
pub const AVCodecID_AV_CODEC_ID_AAC: AVCodecID = 86018;
pub const AVCodecID_AV_CODEC_ID_AC3: AVCodecID = 86019;
pub const AVCodecID_AV_CODEC_ID_DTS: AVCodecID = 86020;
pub const AVCodecID_AV_CODEC_ID_VORBIS: AVCodecID = 86021;
pub const AVCodecID_AV_CODEC_ID_FLAC: AVCodecID = 86028;
pub const AVCodecID_AV_CODEC_ID_ALAC: AVCodecID = 86032;
pub const AVCodecID_AV_CODEC_ID_WMAV2: AVCodecID = 86047;
pub const AVCodecID_AV_CODEC_ID_EAC3: AVCodecID = 86056;
pub const AVCodecID_AV_CODEC_ID_OPUS: AVCodecID = 86076;

// AVPixelFormat
pub const AVPixelFormat_AV_PIX_FMT_NONE: AVPixelFormat = -1;
pub const AVPixelFormat_AV_PIX_FMT_YUV420P: AVPixelFormat = 0;
pub const AVPixelFormat_AV_PIX_FMT_RGB24: AVPixelFormat = 2;
pub const AVPixelFormat_AV_PIX_FMT_BGR24: AVPixelFormat = 3;
pub const AVPixelFormat_AV_PIX_FMT_YUV422P: AVPixelFormat = 4;
pub const AVPixelFormat_AV_PIX_FMT_YUV444P: AVPixelFormat = 5;
pub const AVPixelFormat_AV_PIX_FMT_GRAY8: AVPixelFormat = 8;
pub const AVPixelFormat_AV_PIX_FMT_PAL8: AVPixelFormat = 77;
pub const AVPixelFormat_AV_PIX_FMT_NV12: AVPixelFormat = 23;
pub const AVPixelFormat_AV_PIX_FMT_NV21: AVPixelFormat = 24;
pub const AVPixelFormat_AV_PIX_FMT_RGBA: AVPixelFormat = 26;
pub const AVPixelFormat_AV_PIX_FMT_BGRA: AVPixelFormat = 28;
pub const AVPixelFormat_AV_PIX_FMT_YUVJ420P: AVPixelFormat = 12;
pub const AVPixelFormat_AV_PIX_FMT_YUVJ422P: AVPixelFormat = 13;
pub const AVPixelFormat_AV_PIX_FMT_YUVJ444P: AVPixelFormat = 14;
pub const AVPixelFormat_AV_PIX_FMT_VAAPI: AVPixelFormat = 51;
pub const AVPixelFormat_AV_PIX_FMT_DXVA2_VLD: AVPixelFormat = 53;
pub const AV_OPT_SEARCH_CHILDREN: u32 = 1;
pub const AVPixelFormat_AV_PIX_FMT_YUV420P10LE: AVPixelFormat = 66;
pub const AVPixelFormat_AV_PIX_FMT_YUV422P10LE: AVPixelFormat = 64;
pub const AVPixelFormat_AV_PIX_FMT_YUV444P10LE: AVPixelFormat = 68;
pub const AVPixelFormat_AV_PIX_FMT_YUVA444P10LE: AVPixelFormat = 91;
pub const AVPixelFormat_AV_PIX_FMT_VDPAU: AVPixelFormat = 101;
pub const AVPixelFormat_AV_PIX_FMT_CUDA: AVPixelFormat = 119;
pub const AVPixelFormat_AV_PIX_FMT_QSV: AVPixelFormat = 123;
pub const AVPixelFormat_AV_PIX_FMT_VIDEOTOOLBOX: AVPixelFormat = 135;
pub const AVPixelFormat_AV_PIX_FMT_MEDIACODEC: AVPixelFormat = 165;
pub const AVPixelFormat_AV_PIX_FMT_P010LE: AVPixelFormat = 161;
pub const AVPixelFormat_AV_PIX_FMT_GBRPF32LE: AVPixelFormat = 175;
pub const AVPixelFormat_AV_PIX_FMT_D3D11: AVPixelFormat = 174;
pub const AVPixelFormat_AV_PIX_FMT_OPENCL: AVPixelFormat = 180;
pub const AVPixelFormat_AV_PIX_FMT_VULKAN: AVPixelFormat = 193;

// AVSampleFormat
pub const AVSampleFormat_AV_SAMPLE_FMT_NONE: AVSampleFormat = -1;
pub const AVSampleFormat_AV_SAMPLE_FMT_U8: AVSampleFormat = 0;
pub const AVSampleFormat_AV_SAMPLE_FMT_S16: AVSampleFormat = 1;
pub const AVSampleFormat_AV_SAMPLE_FMT_S32: AVSampleFormat = 2;
pub const AVSampleFormat_AV_SAMPLE_FMT_FLT: AVSampleFormat = 3;
pub const AVSampleFormat_AV_SAMPLE_FMT_DBL: AVSampleFormat = 4;
pub const AVSampleFormat_AV_SAMPLE_FMT_U8P: AVSampleFormat = 5;
pub const AVSampleFormat_AV_SAMPLE_FMT_S16P: AVSampleFormat = 6;
pub const AVSampleFormat_AV_SAMPLE_FMT_S32P: AVSampleFormat = 7;
pub const AVSampleFormat_AV_SAMPLE_FMT_FLTP: AVSampleFormat = 8;
pub const AVSampleFormat_AV_SAMPLE_FMT_DBLP: AVSampleFormat = 9;
pub const AVSampleFormat_AV_SAMPLE_FMT_S64: AVSampleFormat = 10;
pub const AVSampleFormat_AV_SAMPLE_FMT_S64P: AVSampleFormat = 11;

// AVColorPrimaries
pub const AVColorPrimaries_AVCOL_PRI_BT709: AVColorPrimaries = 1;
pub const AVColorPrimaries_AVCOL_PRI_UNSPECIFIED: AVColorPrimaries = 2;
pub const AVColorPrimaries_AVCOL_PRI_BT470BG: AVColorPrimaries = 5;
pub const AVColorPrimaries_AVCOL_PRI_SMPTE170M: AVColorPrimaries = 6;
pub const AVColorPrimaries_AVCOL_PRI_BT2020: AVColorPrimaries = 9;

// AVColorRange
pub const AVColorRange_AVCOL_RANGE_UNSPECIFIED: AVColorRange = 0;
pub const AVColorRange_AVCOL_RANGE_MPEG: AVColorRange = 1;
pub const AVColorRange_AVCOL_RANGE_JPEG: AVColorRange = 2;

// AVColorSpace
pub const AVColorSpace_AVCOL_SPC_RGB: AVColorSpace = 0;
pub const AVColorSpace_AVCOL_SPC_BT709: AVColorSpace = 1;
pub const AVColorSpace_AVCOL_SPC_UNSPECIFIED: AVColorSpace = 2;
pub const AVColorSpace_AVCOL_SPC_BT470BG: AVColorSpace = 5;
pub const AVColorSpace_AVCOL_SPC_SMPTE170M: AVColorSpace = 6;
pub const AVColorSpace_AVCOL_SPC_BT2020_NCL: AVColorSpace = 9;
pub const AVColorSpace_AVCOL_SPC_BT2020_CL: AVColorSpace = 10;

// AVColorTransferCharacteristic
pub const AVColorTransferCharacteristic_AVCOL_TRC_BT709: AVColorTransferCharacteristic = 1;
pub const AVColorTransferCharacteristic_AVCOL_TRC_UNSPECIFIED: AVColorTransferCharacteristic = 2;
pub const AVColorTransferCharacteristic_AVCOL_TRC_LINEAR: AVColorTransferCharacteristic = 8;
pub const AVColorTransferCharacteristic_AVCOL_TRC_BT2020_10: AVColorTransferCharacteristic = 14;
pub const AVColorTransferCharacteristic_AVCOL_TRC_BT2020_12: AVColorTransferCharacteristic = 15;
pub const AVColorTransferCharacteristic_AVCOL_TRC_SMPTEST2084: AVColorTransferCharacteristic = 16;
pub const AVColorTransferCharacteristic_AVCOL_TRC_ARIB_STD_B67: AVColorTransferCharacteristic = 18;

// AVPacketSideDataType
pub type AVPacketSideDataType = c_uint;
pub const AVPacketSideDataType_AV_PKT_DATA_MASTERING_DISPLAY_METADATA: AVPacketSideDataType = 20;
pub const AVPacketSideDataType_AV_PKT_DATA_CONTENT_LIGHT_LEVEL: AVPacketSideDataType = 22;

// AVHWDeviceType
pub const AVHWDeviceType_AV_HWDEVICE_TYPE_CUDA: AVHWDeviceType = 2;
pub const AVHWDeviceType_AV_HWDEVICE_TYPE_VAAPI: AVHWDeviceType = 4;
pub const AVHWDeviceType_AV_HWDEVICE_TYPE_QSV: AVHWDeviceType = 5;
pub const AVHWDeviceType_AV_HWDEVICE_TYPE_VIDEOTOOLBOX: AVHWDeviceType = 7;
pub const AVHWDeviceType_AV_HWDEVICE_TYPE_D3D11VA: AVHWDeviceType = 8;

// AVPictureType constants
pub const AVPictureType_AV_PICTURE_TYPE_NONE: AVPictureType = 0;
pub const AVPictureType_AV_PICTURE_TYPE_I: AVPictureType = 1;

// ── Raw FFmpeg functions (bindgen-generated counterparts) ─────────────────────
//
// These mirror what bindgen would emit from the real FFmpeg headers.
// All bodies are stubs; the code is compiled but never executed on docs.rs.

// SAFETY: docs.rs stubs — never called at runtime.
pub unsafe fn av_strerror(_errnum: c_int, _errbuf: *mut c_char, _errbuf_size: usize) -> c_int {
    0
}

pub unsafe fn av_dict_get(
    _m: *const AVDictionary,
    _key: *const c_char,
    _prev: *const AVDictionaryEntry,
    _flags: c_int,
) -> *mut AVDictionaryEntry {
    std::ptr::null_mut()
}

pub unsafe fn av_dict_set(
    _pm: *mut *mut AVDictionary,
    _key: *const c_char,
    _value: *const c_char,
    _flags: c_int,
) -> c_int {
    0
}

pub unsafe fn av_dict_free(_m: *mut *mut AVDictionary) {}

pub unsafe fn av_find_input_format(_short_name: *const c_char) -> *const AVInputFormat {
    std::ptr::null()
}

pub unsafe fn avcodec_get_name(_id: AVCodecID) -> *const c_char {
    std::ptr::null()
}

pub unsafe fn av_frame_alloc() -> *mut AVFrame {
    std::ptr::null_mut()
}

pub unsafe fn av_frame_free(_frame: *mut *mut AVFrame) {}

pub unsafe fn av_frame_get_buffer(_frame: *mut AVFrame, _align: c_int) -> c_int {
    0
}

pub unsafe fn av_frame_move_ref(_dst: *mut AVFrame, _src: *mut AVFrame) {}

pub unsafe fn av_frame_unref(_frame: *mut AVFrame) {}

pub unsafe fn av_packet_alloc() -> *mut AVPacket {
    std::ptr::null_mut()
}

pub unsafe fn av_packet_free(_pkt: *mut *mut AVPacket) {}

pub unsafe fn av_packet_unref(_pkt: *mut AVPacket) {}

pub unsafe fn av_packet_new_side_data(
    _pkt: *mut AVPacket,
    _type_: AVPacketSideDataType,
    _size: usize,
) -> *mut u8 {
    std::ptr::null_mut()
}

pub unsafe fn av_buffer_ref(_buf: *mut AVBufferRef) -> *mut AVBufferRef {
    std::ptr::null_mut()
}

pub unsafe fn av_buffer_unref(_buf: *mut *mut AVBufferRef) {}

pub unsafe fn av_hwdevice_ctx_create(
    _device_ctx: *mut *mut AVBufferRef,
    _type_: AVHWDeviceType,
    _device: *const c_char,
    _opts: *mut AVDictionary,
    _flags: c_int,
) -> c_int {
    -1
}

pub unsafe fn av_hwframe_transfer_data(
    _dst: *mut AVFrame,
    _src: *const AVFrame,
    _flags: c_int,
) -> c_int {
    -1
}

pub unsafe fn av_opt_set(
    _obj: *mut c_void,
    _name: *const c_char,
    _val: *const c_char,
    _search_flags: c_int,
) -> c_int {
    0
}

pub unsafe fn av_read_frame(_s: *mut AVFormatContext, _pkt: *mut AVPacket) -> c_int {
    -1
}

pub unsafe fn av_write_trailer(_s: *mut AVFormatContext) -> c_int {
    0
}

pub unsafe fn av_interleaved_write_frame(
    _s: *mut AVFormatContext,
    _pkt: *mut AVPacket,
) -> c_int {
    0
}

pub unsafe fn avcodec_receive_frame(_avctx: *mut AVCodecContext, _frame: *mut AVFrame) -> c_int {
    -1
}

pub unsafe fn avcodec_send_packet(
    _avctx: *mut AVCodecContext,
    _avpkt: *const AVPacket,
) -> c_int {
    -1
}

pub unsafe fn avformat_alloc_output_context2(
    _ctx: *mut *mut AVFormatContext,
    _oformat: *mut AVOutputFormat,
    _format_name: *const c_char,
    _filename: *const c_char,
) -> c_int {
    -1
}

pub unsafe fn avformat_free_context(_s: *mut AVFormatContext) {}

pub unsafe fn avformat_new_stream(
    _s: *mut AVFormatContext,
    _c: *const AVCodec,
) -> *mut AVStream {
    std::ptr::null_mut()
}

pub unsafe fn avformat_write_header(
    _s: *mut AVFormatContext,
    _options: *mut *mut AVDictionary,
) -> c_int {
    -1
}

pub unsafe fn swr_alloc_set_opts2(
    _ps: *mut *mut SwrContext,
    _out_ch_layout: *const AVChannelLayout,
    _out_sample_fmt: AVSampleFormat,
    _out_sample_rate: c_int,
    _in_ch_layout: *const AVChannelLayout,
    _in_sample_fmt: AVSampleFormat,
    _in_sample_rate: c_int,
    _log_offset: c_int,
    _log_ctx: *mut c_void,
) -> c_int {
    -1
}

pub unsafe fn swr_convert(
    _s: *mut SwrContext,
    _out: *mut *mut u8,
    _out_count: c_int,
    _in_: *const *const u8,
    _in_count: c_int,
) -> c_int {
    -1
}

pub unsafe fn swr_free(_s: *mut *mut SwrContext) {}

pub unsafe fn swr_get_out_samples(_s: *mut SwrContext, _in_samples: c_int) -> c_int {
    0
}

pub unsafe fn swr_init(_s: *mut SwrContext) -> c_int {
    -1
}

pub unsafe fn av_channel_layout_default(_ch_layout: *mut AVChannelLayout, _nb_channels: c_int) {}

pub unsafe fn av_channel_layout_uninit(_ch_layout: *mut AVChannelLayout) {}

pub unsafe fn av_rescale_q(_a: i64, _bq: AVRational, _cq: AVRational) -> i64 {
    0
}

pub unsafe fn av_mallocz(_size: usize) -> *mut c_void {
    std::ptr::null_mut()
}

pub unsafe fn av_malloc(_size: usize) -> *mut c_void {
    std::ptr::null_mut()
}

pub unsafe fn av_free(_ptr: *mut c_void) {}

pub unsafe fn av_new_packet(_pkt: *mut AVPacket, _size: c_int) -> c_int {
    -1
}

pub unsafe fn avcodec_parameters_copy(
    _dst: *mut AVCodecParameters,
    _src: *const AVCodecParameters,
) -> c_int {
    0
}

pub unsafe fn av_packet_rescale_ts(
    _pkt: *mut AVPacket,
    _tb_src: AVRational,
    _tb_dst: AVRational,
) {
}

// ── Wrapper module stubs ──────────────────────────────────────────────────────
//
// These mirror the safe wrapper modules in avformat.rs, avcodec.rs,
// swresample.rs, and swscale.rs.  Signatures must exactly match those files.

// ── libavfilter opaque types ──────────────────────────────────────────────────

pub struct AVFilterGraph(());
pub struct AVFilter(());

pub struct AVFilterContext {
    pub hw_device_ctx: *mut AVBufferRef,
}

// ── libavfilter constants ─────────────────────────────────────────────────────

/// Flag for `av_buffersrc_add_frame_flags`: keep a reference to the frame.
pub const AV_BUFFERSRC_FLAG_KEEP_REF: c_int = 8;

// ── libavfilter functions ─────────────────────────────────────────────────────

// SAFETY: docs.rs stubs — never called at runtime.

pub unsafe fn avfilter_graph_alloc() -> *mut AVFilterGraph {
    ptr::null_mut()
}

pub unsafe fn avfilter_graph_free(_graph: *mut *mut AVFilterGraph) {}

pub unsafe fn avfilter_get_by_name(_name: *const c_char) -> *const AVFilter {
    ptr::null()
}

pub unsafe fn avfilter_graph_create_filter(
    _filt_ctx: *mut *mut AVFilterContext,
    _filt: *const AVFilter,
    _name: *const c_char,
    _args: *const c_char,
    _opaque: *mut c_void,
    _graph_ctx: *mut AVFilterGraph,
) -> c_int {
    0
}

pub unsafe fn avfilter_link(
    _src: *mut AVFilterContext,
    _srcpad: c_uint,
    _dst: *mut AVFilterContext,
    _dstpad: c_uint,
) -> c_int {
    0
}

pub unsafe fn avfilter_graph_config(
    _graphctx: *mut AVFilterGraph,
    _log_ctx: *mut c_void,
) -> c_int {
    0
}

pub unsafe fn avfilter_graph_set_auto_convert(_graph: *mut AVFilterGraph, _flags: c_uint) {}

pub unsafe fn avfilter_graph_send_command(
    _graph: *mut AVFilterGraph,
    _target: *const c_char,
    _cmd: *const c_char,
    _arg: *const c_char,
    _res: *mut c_char,
    _res_len: c_int,
    _flags: c_int,
) -> c_int {
    0
}

pub unsafe fn av_buffersrc_add_frame_flags(
    _ctx: *mut AVFilterContext,
    _frame: *mut AVFrame,
    _flags: c_int,
) -> c_int {
    0
}

pub unsafe fn av_buffersrc_close(
    _ctx: *mut AVFilterContext,
    _pts: i64,
    _flags: c_uint,
) -> c_int {
    0
}

pub unsafe fn av_buffersink_get_frame(
    _ctx: *mut AVFilterContext,
    _frame: *mut AVFrame,
) -> c_int {
    // Return EAGAIN to signal no frame available
    -11
}

pub unsafe fn av_buffersink_get_time_base(_ctx: *const AVFilterContext) -> AVRational {
    AVRational { num: 0, den: 1 }
}

/// Stub `avformat` wrapper module.
pub mod avformat {
    use std::os::raw::c_int;
    use std::path::Path;

    use super::{AVFormatContext, AVIOContext, AVPacket};

    pub fn srt_available() -> bool {
        false
    }

    pub unsafe fn open_input(_path: &Path) -> Result<*mut AVFormatContext, c_int> {
        Err(-1)
    }

    pub unsafe fn open_input_url(
        _url: &str,
        _connect_timeout: std::time::Duration,
        _read_timeout: std::time::Duration,
    ) -> Result<*mut AVFormatContext, c_int> {
        Err(-1)
    }

    pub unsafe fn open_input_image_sequence(
        _path: &Path,
        _framerate: u32,
    ) -> Result<*mut AVFormatContext, c_int> {
        Err(-1)
    }

    pub unsafe fn close_input(_ctx: *mut *mut AVFormatContext) {}

    pub unsafe fn find_stream_info(_ctx: *mut AVFormatContext) -> Result<(), c_int> {
        Err(-1)
    }

    pub unsafe fn seek_frame(
        _ctx: *mut AVFormatContext,
        _stream_index: c_int,
        _timestamp: i64,
        _flags: c_int,
    ) -> Result<(), c_int> {
        Err(-1)
    }

    pub unsafe fn seek_file(
        _ctx: *mut AVFormatContext,
        _stream_index: c_int,
        _min_ts: i64,
        _ts: i64,
        _max_ts: i64,
        _flags: c_int,
    ) -> Result<(), c_int> {
        Err(-1)
    }

    pub unsafe fn read_frame(
        _ctx: *mut AVFormatContext,
        _pkt: *mut AVPacket,
    ) -> Result<(), c_int> {
        Err(-1)
    }

    pub unsafe fn write_frame(
        _ctx: *mut AVFormatContext,
        _pkt: *mut AVPacket,
    ) -> Result<(), c_int> {
        Err(-1)
    }

    pub unsafe fn open_output(_path: &Path, _flags: c_int) -> Result<*mut AVIOContext, c_int> {
        Err(-1)
    }

    pub unsafe fn close_output(_pb: *mut *mut AVIOContext) {}

    pub mod avio_flags {
        use std::os::raw::c_int;
        pub const READ: c_int = 1;
        pub const WRITE: c_int = 2;
        pub const READ_WRITE: c_int = 3;
    }

    pub mod seek_flags {
        pub const BACKWARD: i32 = 1;
        pub const BYTE: i32 = 2;
        pub const ANY: i32 = 4;
        pub const FRAME: i32 = 8;
    }
}

/// Stub `avcodec` wrapper module.
pub mod avcodec {
    use std::os::raw::c_int;

    use super::{AVCodec, AVCodecContext, AVCodecID, AVCodecParameters, AVDictionary, AVFrame, AVPacket};

    pub unsafe fn find_decoder(_codec_id: AVCodecID) -> Option<*const AVCodec> {
        None
    }

    pub unsafe fn find_decoder_by_name(_name: *const i8) -> Option<*const AVCodec> {
        None
    }

    pub unsafe fn find_encoder(_codec_id: AVCodecID) -> Option<*const AVCodec> {
        None
    }

    pub unsafe fn find_encoder_by_name(_name: *const i8) -> Option<*const AVCodec> {
        None
    }

    pub unsafe fn alloc_context3(_codec: *const AVCodec) -> Result<*mut AVCodecContext, c_int> {
        Err(-1)
    }

    pub unsafe fn free_context(_ctx: *mut *mut AVCodecContext) {}

    pub unsafe fn parameters_to_context(
        _codec_ctx: *mut AVCodecContext,
        _par: *const AVCodecParameters,
    ) -> Result<(), c_int> {
        Err(-1)
    }

    pub unsafe fn open2(
        _avctx: *mut AVCodecContext,
        _codec: *const AVCodec,
        _options: *mut *mut AVDictionary,
    ) -> Result<(), c_int> {
        Err(-1)
    }

    pub unsafe fn send_packet(
        _ctx: *mut AVCodecContext,
        _pkt: *const AVPacket,
    ) -> Result<(), c_int> {
        Err(-1)
    }

    pub unsafe fn receive_frame(
        _ctx: *mut AVCodecContext,
        _frame: *mut AVFrame,
    ) -> Result<(), c_int> {
        Err(-1)
    }

    pub unsafe fn send_frame(
        _ctx: *mut AVCodecContext,
        _frame: *const AVFrame,
    ) -> Result<(), c_int> {
        Err(-1)
    }

    pub unsafe fn receive_packet(
        _ctx: *mut AVCodecContext,
        _pkt: *mut AVPacket,
    ) -> Result<(), c_int> {
        Err(-1)
    }

    pub unsafe fn flush_buffers(_ctx: *mut AVCodecContext) {}

    pub unsafe fn parameters_from_context(
        _par: *mut AVCodecParameters,
        _ctx: *const AVCodecContext,
    ) -> Result<(), c_int> {
        Err(-1)
    }

    pub mod codec_caps {
        pub const EXPERIMENTAL: u32 = 1 << 9;
        pub const HARDWARE: u32 = 1 << 10;
        pub const HYBRID: u32 = 1 << 11;
        pub const VARIABLE_FRAME_SIZE: u32 = 1 << 16;
        pub const AVOID_PROBING: u32 = 1 << 17;
    }
}

/// Stub `swresample` wrapper module.
pub mod swresample {
    use std::os::raw::c_int;

    use super::{AVChannelLayout, AVSampleFormat, SwrContext};

    pub unsafe fn alloc() -> Result<*mut SwrContext, c_int> {
        Err(-1)
    }

    pub unsafe fn alloc_set_opts2(
        _out_ch_layout: *const AVChannelLayout,
        _out_sample_fmt: AVSampleFormat,
        _out_sample_rate: c_int,
        _in_ch_layout: *const AVChannelLayout,
        _in_sample_fmt: AVSampleFormat,
        _in_sample_rate: c_int,
    ) -> Result<*mut SwrContext, c_int> {
        Err(-1)
    }

    pub unsafe fn init(_ctx: *mut SwrContext) -> Result<(), c_int> {
        Err(-1)
    }

    pub unsafe fn is_initialized(_ctx: *const SwrContext) -> bool {
        false
    }

    pub unsafe fn free(_ctx: *mut *mut SwrContext) {}

    pub unsafe fn convert(
        _s: *mut SwrContext,
        _out: *mut *mut u8,
        _out_count: c_int,
        _in_: *const *const u8,
        _in_count: c_int,
    ) -> Result<c_int, c_int> {
        Err(-1)
    }

    pub unsafe fn get_delay(_ctx: *mut SwrContext, _base: i64) -> i64 {
        0
    }

    pub fn estimate_output_samples(
        _out_sample_rate: i32,
        _in_sample_rate: i32,
        _in_samples: i32,
    ) -> i32 {
        0
    }

    pub mod channel_layout {
        use super::super::AVChannelLayout;

        pub unsafe fn set_default(_ch_layout: *mut AVChannelLayout, _nb_channels: i32) {}
        pub unsafe fn uninit(_ch_layout: *mut AVChannelLayout) {}
        pub unsafe fn copy(
            _dst: *mut AVChannelLayout,
            _src: *const AVChannelLayout,
        ) -> Result<(), i32> {
            Err(-1)
        }
        pub unsafe fn is_equal(
            _chl: *const AVChannelLayout,
            _chl1: *const AVChannelLayout,
        ) -> bool {
            false
        }
        pub fn mono() -> AVChannelLayout {
            AVChannelLayout::default()
        }
        pub fn stereo() -> AVChannelLayout {
            AVChannelLayout::default()
        }
        pub fn with_channels(_nb_channels: i32) -> AVChannelLayout {
            AVChannelLayout::default()
        }
        pub fn is_valid(ch_layout: &AVChannelLayout) -> bool {
            ch_layout.nb_channels > 0
        }
        pub fn nb_channels(ch_layout: &AVChannelLayout) -> i32 {
            ch_layout.nb_channels
        }
        pub fn is_native_order(_ch_layout: &AVChannelLayout) -> bool {
            false
        }
    }

    pub mod audio_fifo {
        use std::ffi::c_void;
        use std::os::raw::c_int;

        use super::super::{AVAudioFifo, AVSampleFormat};

        pub unsafe fn alloc(
            _sample_fmt: AVSampleFormat,
            _channels: c_int,
            _nb_samples: c_int,
        ) -> Result<*mut AVAudioFifo, c_int> {
            Err(-1)
        }

        pub unsafe fn free(_fifo: *mut AVAudioFifo) {}

        pub unsafe fn write(
            _fifo: *mut AVAudioFifo,
            _data: *const *mut c_void,
            _nb_samples: c_int,
        ) -> Result<c_int, c_int> {
            Err(-1)
        }

        pub unsafe fn read(
            _fifo: *mut AVAudioFifo,
            _data: *const *mut c_void,
            _nb_samples: c_int,
        ) -> Result<c_int, c_int> {
            Err(-1)
        }

        pub unsafe fn size(_fifo: *mut AVAudioFifo) -> c_int {
            0
        }
    }

    pub mod sample_format {
        use super::super::{
            AVSampleFormat, AVSampleFormat_AV_SAMPLE_FMT_NONE, AVSampleFormat_AV_SAMPLE_FMT_U8,
            AVSampleFormat_AV_SAMPLE_FMT_S16, AVSampleFormat_AV_SAMPLE_FMT_S32,
            AVSampleFormat_AV_SAMPLE_FMT_FLT, AVSampleFormat_AV_SAMPLE_FMT_DBL,
            AVSampleFormat_AV_SAMPLE_FMT_U8P, AVSampleFormat_AV_SAMPLE_FMT_S16P,
            AVSampleFormat_AV_SAMPLE_FMT_S32P, AVSampleFormat_AV_SAMPLE_FMT_FLTP,
            AVSampleFormat_AV_SAMPLE_FMT_DBLP, AVSampleFormat_AV_SAMPLE_FMT_S64,
            AVSampleFormat_AV_SAMPLE_FMT_S64P,
        };

        pub const NONE: AVSampleFormat = AVSampleFormat_AV_SAMPLE_FMT_NONE;
        pub const U8: AVSampleFormat = AVSampleFormat_AV_SAMPLE_FMT_U8;
        pub const S16: AVSampleFormat = AVSampleFormat_AV_SAMPLE_FMT_S16;
        pub const S32: AVSampleFormat = AVSampleFormat_AV_SAMPLE_FMT_S32;
        pub const FLT: AVSampleFormat = AVSampleFormat_AV_SAMPLE_FMT_FLT;
        pub const DBL: AVSampleFormat = AVSampleFormat_AV_SAMPLE_FMT_DBL;
        pub const U8P: AVSampleFormat = AVSampleFormat_AV_SAMPLE_FMT_U8P;
        pub const S16P: AVSampleFormat = AVSampleFormat_AV_SAMPLE_FMT_S16P;
        pub const S32P: AVSampleFormat = AVSampleFormat_AV_SAMPLE_FMT_S32P;
        pub const FLTP: AVSampleFormat = AVSampleFormat_AV_SAMPLE_FMT_FLTP;
        pub const DBLP: AVSampleFormat = AVSampleFormat_AV_SAMPLE_FMT_DBLP;
        pub const S64: AVSampleFormat = AVSampleFormat_AV_SAMPLE_FMT_S64;
        pub const S64P: AVSampleFormat = AVSampleFormat_AV_SAMPLE_FMT_S64P;

        pub fn bytes_per_sample(_sample_fmt: AVSampleFormat) -> i32 {
            0
        }
        pub fn is_planar(_sample_fmt: AVSampleFormat) -> bool {
            false
        }
    }
}

/// Stub `swscale` wrapper module.
pub mod swscale {
    use std::os::raw::c_int;

    use super::{AVPixelFormat, SwsContext};

    pub unsafe fn get_context(
        _src_w: c_int,
        _src_h: c_int,
        _src_fmt: AVPixelFormat,
        _dst_w: c_int,
        _dst_h: c_int,
        _dst_fmt: AVPixelFormat,
        _flags: c_int,
    ) -> Result<*mut SwsContext, c_int> {
        Err(-1)
    }

    pub unsafe fn free_context(_ctx: *mut SwsContext) {}

    pub unsafe fn scale(
        _ctx: *mut SwsContext,
        _src: *const *const u8,
        _src_stride: *const c_int,
        _src_slice_y: c_int,
        _src_slice_h: c_int,
        _dst: *const *mut u8,
        _dst_stride: *const c_int,
    ) -> Result<c_int, c_int> {
        Err(-1)
    }

    pub unsafe fn is_supported_input(_pix_fmt: AVPixelFormat) -> bool {
        false
    }

    pub unsafe fn is_supported_output(_pix_fmt: AVPixelFormat) -> bool {
        false
    }

    pub unsafe fn is_supported_endianness_conversion(_pix_fmt: AVPixelFormat) -> bool {
        false
    }

    pub mod scale_flags {
        pub const FAST_BILINEAR: i32 = 1;
        pub const BILINEAR: i32 = 2;
        pub const BICUBIC: i32 = 4;
        pub const X: i32 = 8;
        pub const POINT: i32 = 16;
        pub const AREA: i32 = 32;
        pub const BICUBLIN: i32 = 64;
        pub const GAUSS: i32 = 128;
        pub const SINC: i32 = 256;
        pub const LANCZOS: i32 = 512;
        pub const SPLINE: i32 = 1024;
    }
}