ff_sys/
docsrs_stubs.rs

1// Shape-compatible stubs used by docs.rs builds (DOCS_RS=1).
2//
3// These definitions mirror the real bindgen-generated FFmpeg bindings in type
4// and name, but contain no actual FFmpeg code.  All functions are no-op stubs
5// that never run; they exist only to make the dependent crates compile so that
6// rustdoc can render their public APIs.
7//
8// Maintenance note: add entries here whenever a new ff_sys symbol is referenced
9// in ff-probe, ff-decode, or ff-encode.  The values of integer constants are
10// taken from the FFmpeg 7.x headers for reference accuracy, but correctness at
11// runtime is irrelevant — docs.rs never executes this code.
12
13use std::os::raw::{c_char, c_int, c_uint, c_void};
14use std::ptr;
15
16// ── Type aliases ──────────────────────────────────────────────────────────────
17
18pub type AVCodecID = c_uint;
19pub type AVPixelFormat = c_int;
20pub type AVSampleFormat = c_int;
21pub type AVMediaType = c_int;
22pub type AVColorPrimaries = c_uint;
23pub type AVColorRange = c_uint;
24pub type AVColorSpace = c_uint;
25pub type AVHWDeviceType = c_int;
26pub type AVChannelOrder = c_uint;
27pub type AVPictureType = c_int;
28
29// ── Opaque types (only ever used behind raw pointers) ─────────────────────────
30
31pub struct AVDictionary(());
32pub struct SwsContext(());
33pub struct SwrContext(());
34pub struct AVBufferRef(());
35pub struct AVIOContext(());
36pub struct AVOutputFormat(());
37pub struct AVAudioFifo(());
38
39pub struct AVInputFormat {
40    pub name: *const c_char,
41    pub long_name: *const c_char,
42}
43
44// ── Structs with field-level access ───────────────────────────────────────────
45
46#[derive(Copy, Clone)]
47#[repr(C)]
48pub union AVChannelLayout__bindgen_ty_1 {
49    pub mask: u64,
50}
51
52impl Default for AVChannelLayout__bindgen_ty_1 {
53    fn default() -> Self {
54        Self { mask: 0 }
55    }
56}
57
58#[derive(Copy, Clone)]
59pub struct AVChannelLayout {
60    pub order: AVChannelOrder,
61    pub nb_channels: c_int,
62    pub u: AVChannelLayout__bindgen_ty_1,
63}
64
65impl Default for AVChannelLayout {
66    fn default() -> Self {
67        Self {
68            order: 0,
69            nb_channels: 0,
70            u: AVChannelLayout__bindgen_ty_1::default(),
71        }
72    }
73}
74
75#[derive(Copy, Clone)]
76pub struct AVRational {
77    pub num: c_int,
78    pub den: c_int,
79}
80
81pub struct AVDictionaryEntry {
82    pub key: *mut c_char,
83    pub value: *mut c_char,
84}
85
86pub struct AVChapter {
87    pub id: i64,
88    pub time_base: AVRational,
89    pub start: i64,
90    pub end: i64,
91    pub metadata: *mut AVDictionary,
92}
93
94pub struct AVCodecParameters {
95    pub codec_type: AVMediaType,
96    pub codec_id: AVCodecID,
97    pub codec_tag: c_uint,
98    pub extradata: *mut u8,
99    pub extradata_size: c_int,
100    pub format: c_int,
101    pub bit_rate: i64,
102    pub width: c_int,
103    pub height: c_int,
104    pub sample_rate: c_int,
105    pub ch_layout: AVChannelLayout,
106    pub sample_fmt: AVSampleFormat,
107    pub color_space: AVColorSpace,
108    pub color_range: AVColorRange,
109    pub color_primaries: AVColorPrimaries,
110}
111
112pub struct AVStream {
113    pub codecpar: *mut AVCodecParameters,
114    pub nb_frames: i64,
115    pub duration: i64,
116    pub time_base: AVRational,
117    pub avg_frame_rate: AVRational,
118    pub r_frame_rate: AVRational,
119    pub start_time: i64,
120    pub disposition: c_int,
121    pub metadata: *mut AVDictionary,
122}
123
124pub struct AVFormatContext {
125    pub nb_streams: c_uint,
126    pub streams: *mut *mut AVStream,
127    pub duration: i64,
128    pub metadata: *mut AVDictionary,
129    pub nb_chapters: c_uint,
130    pub chapters: *mut *mut AVChapter,
131    pub iformat: *mut AVInputFormat,
132    pub bit_rate: i64,
133    pub pb: *mut AVIOContext,
134}
135
136pub struct AVFrame {
137    pub data: [*mut u8; 8],
138    pub linesize: [c_int; 8],
139    pub width: c_int,
140    pub height: c_int,
141    pub nb_samples: c_int,
142    pub format: c_int,
143    pub key_frame: c_int,
144    pub pict_type: AVPictureType,
145    pub pts: i64,
146    pub pkt_dts: i64,
147    pub sample_rate: c_int,
148    pub ch_layout: AVChannelLayout,
149    pub duration: i64,
150    pub time_base: AVRational,
151    pub hw_frames_ctx: *mut AVBufferRef,
152}
153
154pub struct AVPacket {
155    pub pts: i64,
156    pub dts: i64,
157    pub data: *mut u8,
158    pub size: c_int,
159    pub stream_index: c_int,
160    pub flags: c_int,
161    pub duration: i64,
162}
163
164pub type AVColorTransferCharacteristic = c_uint;
165
166pub struct AVCodecContext {
167    pub codec_id: AVCodecID,
168    pub bit_rate: i64,
169    pub width: c_int,
170    pub height: c_int,
171    pub pix_fmt: AVPixelFormat,
172    pub sample_rate: c_int,
173    pub ch_layout: AVChannelLayout,
174    pub sample_fmt: AVSampleFormat,
175    pub time_base: AVRational,
176    pub framerate: AVRational,
177    pub gop_size: c_int,
178    pub max_b_frames: c_int,
179    pub qmin: c_int,
180    pub qmax: c_int,
181    pub thread_count: c_int,
182    pub hw_device_ctx: *mut AVBufferRef,
183    pub hw_frames_ctx: *mut AVBufferRef,
184    pub priv_data: *mut c_void,
185    pub color_primaries: AVColorPrimaries,
186    pub color_trc: AVColorTransferCharacteristic,
187    pub colorspace: AVColorSpace,
188    // Fields added for v0.7.0 feature coverage
189    pub frame_size: c_int,
190    pub color_range: AVColorRange,
191    pub refs: c_int,
192    pub rc_max_rate: i64,
193    pub rc_buffer_size: c_int,
194    pub flags: c_int,
195    pub stats_out: *mut c_char,
196    pub stats_in: *mut c_char,
197}
198
199pub struct AVCodec {
200    pub sample_fmts: *const AVSampleFormat,
201    pub capabilities: c_int,
202}
203
204// ── Constants ─────────────────────────────────────────────────────────────────
205
206pub const AV_DICT_IGNORE_SUFFIX: u32 = 2;
207pub const AV_NUM_DATA_POINTERS: usize = 8;
208pub const AV_TIME_BASE: u32 = 1_000_000;
209
210pub const AVMediaType_AVMEDIA_TYPE_VIDEO: AVMediaType = 0;
211pub const AVMediaType_AVMEDIA_TYPE_AUDIO: AVMediaType = 1;
212pub const AVMediaType_AVMEDIA_TYPE_SUBTITLE: AVMediaType = 3;
213pub const AVMediaType_AVMEDIA_TYPE_ATTACHMENT: AVMediaType = 4;
214
215pub const AV_DISPOSITION_FORCED: u32 = 0x0040;
216pub const AV_DISPOSITION_ATTACHED_PIC: u32 = 0x0400;
217pub const AV_INPUT_BUFFER_PADDING_SIZE: u32 = 64;
218
219pub const AVChannelOrder_AV_CHANNEL_ORDER_UNSPEC: AVChannelOrder = 0;
220pub const AVChannelOrder_AV_CHANNEL_ORDER_NATIVE: AVChannelOrder = 1;
221
222// AVCodecID — video
223pub const AVCodecID_AV_CODEC_ID_NONE: AVCodecID = 0;
224pub const AVCodecID_AV_CODEC_ID_MPEG2VIDEO: AVCodecID = 2;
225pub const AVCodecID_AV_CODEC_ID_MJPEG: AVCodecID = 7;
226pub const AVCodecID_AV_CODEC_ID_MPEG4: AVCodecID = 13;
227pub const AVCodecID_AV_CODEC_ID_H264: AVCodecID = 27;
228pub const AVCodecID_AV_CODEC_ID_THEORA: AVCodecID = 30;
229pub const AVCodecID_AV_CODEC_ID_VP8: AVCodecID = 139;
230pub const AVCodecID_AV_CODEC_ID_PRORES: AVCodecID = 147;
231pub const AVCodecID_AV_CODEC_ID_VP9: AVCodecID = 167;
232pub const AVCodecID_AV_CODEC_ID_HEVC: AVCodecID = 173;
233pub const AVCodecID_AV_CODEC_ID_AV1: AVCodecID = 226;
234pub const AVCodecID_AV_CODEC_ID_DNXHD: AVCodecID = 99;
235
236// AVCodecID — image (still image)
237pub const AVCodecID_AV_CODEC_ID_PNG: AVCodecID = 61;
238pub const AVCodecID_AV_CODEC_ID_BMP: AVCodecID = 76;
239pub const AVCodecID_AV_CODEC_ID_TIFF: AVCodecID = 90;
240pub const AVCodecID_AV_CODEC_ID_WEBP: AVCodecID = 219;
241pub const AVCodecID_AV_CODEC_ID_EXR: AVCodecID = 178;
242
243// AVCodecID — subtitle
244pub const AVCodecID_AV_CODEC_ID_DVB_SUBTITLE: AVCodecID = 94209;
245pub const AVCodecID_AV_CODEC_ID_SSA: AVCodecID = 94212;
246pub const AVCodecID_AV_CODEC_ID_HDMV_PGS_SUBTITLE: AVCodecID = 94214;
247pub const AVCodecID_AV_CODEC_ID_SRT: AVCodecID = 94216;
248pub const AVCodecID_AV_CODEC_ID_SUBRIP: AVCodecID = 94248;
249pub const AVCodecID_AV_CODEC_ID_WEBVTT: AVCodecID = 94249;
250pub const AVCodecID_AV_CODEC_ID_ASS: AVCodecID = 94253;
251
252// AVCodecID — attachment / data
253pub const AVCodecID_AV_CODEC_ID_BIN_DATA: AVCodecID = 98314;
254
255// AVCodecID — audio
256pub const AVCodecID_AV_CODEC_ID_PCM_S16LE: AVCodecID = 65536;
257pub const AVCodecID_AV_CODEC_ID_PCM_S16BE: AVCodecID = 65537;
258pub const AVCodecID_AV_CODEC_ID_PCM_U8: AVCodecID = 65542;
259pub const AVCodecID_AV_CODEC_ID_PCM_S24LE: AVCodecID = 65544;
260pub const AVCodecID_AV_CODEC_ID_PCM_S24BE: AVCodecID = 65545;
261pub const AVCodecID_AV_CODEC_ID_PCM_S32LE: AVCodecID = 65556;
262pub const AVCodecID_AV_CODEC_ID_PCM_S32BE: AVCodecID = 65557;
263pub const AVCodecID_AV_CODEC_ID_PCM_F32LE: AVCodecID = 65558;
264pub const AVCodecID_AV_CODEC_ID_PCM_F32BE: AVCodecID = 65559;
265pub const AVCodecID_AV_CODEC_ID_PCM_F64LE: AVCodecID = 65560;
266pub const AVCodecID_AV_CODEC_ID_PCM_F64BE: AVCodecID = 65561;
267pub const AVCodecID_AV_CODEC_ID_MP3: AVCodecID = 86017;
268pub const AVCodecID_AV_CODEC_ID_AAC: AVCodecID = 86018;
269pub const AVCodecID_AV_CODEC_ID_AC3: AVCodecID = 86019;
270pub const AVCodecID_AV_CODEC_ID_DTS: AVCodecID = 86020;
271pub const AVCodecID_AV_CODEC_ID_VORBIS: AVCodecID = 86021;
272pub const AVCodecID_AV_CODEC_ID_FLAC: AVCodecID = 86028;
273pub const AVCodecID_AV_CODEC_ID_ALAC: AVCodecID = 86032;
274pub const AVCodecID_AV_CODEC_ID_WMAV2: AVCodecID = 86047;
275pub const AVCodecID_AV_CODEC_ID_EAC3: AVCodecID = 86056;
276pub const AVCodecID_AV_CODEC_ID_OPUS: AVCodecID = 86076;
277
278// AVPixelFormat
279pub const AVPixelFormat_AV_PIX_FMT_NONE: AVPixelFormat = -1;
280pub const AVPixelFormat_AV_PIX_FMT_YUV420P: AVPixelFormat = 0;
281pub const AVPixelFormat_AV_PIX_FMT_RGB24: AVPixelFormat = 2;
282pub const AVPixelFormat_AV_PIX_FMT_BGR24: AVPixelFormat = 3;
283pub const AVPixelFormat_AV_PIX_FMT_YUV422P: AVPixelFormat = 4;
284pub const AVPixelFormat_AV_PIX_FMT_YUV444P: AVPixelFormat = 5;
285pub const AVPixelFormat_AV_PIX_FMT_GRAY8: AVPixelFormat = 8;
286pub const AVPixelFormat_AV_PIX_FMT_PAL8: AVPixelFormat = 77;
287pub const AVPixelFormat_AV_PIX_FMT_NV12: AVPixelFormat = 23;
288pub const AVPixelFormat_AV_PIX_FMT_NV21: AVPixelFormat = 24;
289pub const AVPixelFormat_AV_PIX_FMT_RGBA: AVPixelFormat = 26;
290pub const AVPixelFormat_AV_PIX_FMT_BGRA: AVPixelFormat = 28;
291pub const AVPixelFormat_AV_PIX_FMT_YUVJ420P: AVPixelFormat = 12;
292pub const AVPixelFormat_AV_PIX_FMT_YUVJ422P: AVPixelFormat = 13;
293pub const AVPixelFormat_AV_PIX_FMT_YUVJ444P: AVPixelFormat = 14;
294pub const AVPixelFormat_AV_PIX_FMT_VAAPI: AVPixelFormat = 51;
295pub const AVPixelFormat_AV_PIX_FMT_DXVA2_VLD: AVPixelFormat = 53;
296pub const AV_OPT_SEARCH_CHILDREN: u32 = 1;
297pub const AVPixelFormat_AV_PIX_FMT_YUV420P10LE: AVPixelFormat = 66;
298pub const AVPixelFormat_AV_PIX_FMT_YUV422P10LE: AVPixelFormat = 64;
299pub const AVPixelFormat_AV_PIX_FMT_YUV444P10LE: AVPixelFormat = 68;
300pub const AVPixelFormat_AV_PIX_FMT_YUVA444P10LE: AVPixelFormat = 91;
301pub const AVPixelFormat_AV_PIX_FMT_VDPAU: AVPixelFormat = 101;
302pub const AVPixelFormat_AV_PIX_FMT_CUDA: AVPixelFormat = 119;
303pub const AVPixelFormat_AV_PIX_FMT_QSV: AVPixelFormat = 123;
304pub const AVPixelFormat_AV_PIX_FMT_VIDEOTOOLBOX: AVPixelFormat = 135;
305pub const AVPixelFormat_AV_PIX_FMT_MEDIACODEC: AVPixelFormat = 165;
306pub const AVPixelFormat_AV_PIX_FMT_P010LE: AVPixelFormat = 161;
307pub const AVPixelFormat_AV_PIX_FMT_GBRPF32LE: AVPixelFormat = 175;
308pub const AVPixelFormat_AV_PIX_FMT_D3D11: AVPixelFormat = 174;
309pub const AVPixelFormat_AV_PIX_FMT_OPENCL: AVPixelFormat = 180;
310pub const AVPixelFormat_AV_PIX_FMT_VULKAN: AVPixelFormat = 193;
311
312// AVSampleFormat
313pub const AVSampleFormat_AV_SAMPLE_FMT_NONE: AVSampleFormat = -1;
314pub const AVSampleFormat_AV_SAMPLE_FMT_U8: AVSampleFormat = 0;
315pub const AVSampleFormat_AV_SAMPLE_FMT_S16: AVSampleFormat = 1;
316pub const AVSampleFormat_AV_SAMPLE_FMT_S32: AVSampleFormat = 2;
317pub const AVSampleFormat_AV_SAMPLE_FMT_FLT: AVSampleFormat = 3;
318pub const AVSampleFormat_AV_SAMPLE_FMT_DBL: AVSampleFormat = 4;
319pub const AVSampleFormat_AV_SAMPLE_FMT_U8P: AVSampleFormat = 5;
320pub const AVSampleFormat_AV_SAMPLE_FMT_S16P: AVSampleFormat = 6;
321pub const AVSampleFormat_AV_SAMPLE_FMT_S32P: AVSampleFormat = 7;
322pub const AVSampleFormat_AV_SAMPLE_FMT_FLTP: AVSampleFormat = 8;
323pub const AVSampleFormat_AV_SAMPLE_FMT_DBLP: AVSampleFormat = 9;
324pub const AVSampleFormat_AV_SAMPLE_FMT_S64: AVSampleFormat = 10;
325pub const AVSampleFormat_AV_SAMPLE_FMT_S64P: AVSampleFormat = 11;
326
327// AVColorPrimaries
328pub const AVColorPrimaries_AVCOL_PRI_BT709: AVColorPrimaries = 1;
329pub const AVColorPrimaries_AVCOL_PRI_UNSPECIFIED: AVColorPrimaries = 2;
330pub const AVColorPrimaries_AVCOL_PRI_BT470BG: AVColorPrimaries = 5;
331pub const AVColorPrimaries_AVCOL_PRI_SMPTE170M: AVColorPrimaries = 6;
332pub const AVColorPrimaries_AVCOL_PRI_BT2020: AVColorPrimaries = 9;
333
334// AVColorRange
335pub const AVColorRange_AVCOL_RANGE_UNSPECIFIED: AVColorRange = 0;
336pub const AVColorRange_AVCOL_RANGE_MPEG: AVColorRange = 1;
337pub const AVColorRange_AVCOL_RANGE_JPEG: AVColorRange = 2;
338
339// AVColorSpace
340pub const AVColorSpace_AVCOL_SPC_RGB: AVColorSpace = 0;
341pub const AVColorSpace_AVCOL_SPC_BT709: AVColorSpace = 1;
342pub const AVColorSpace_AVCOL_SPC_UNSPECIFIED: AVColorSpace = 2;
343pub const AVColorSpace_AVCOL_SPC_BT470BG: AVColorSpace = 5;
344pub const AVColorSpace_AVCOL_SPC_SMPTE170M: AVColorSpace = 6;
345pub const AVColorSpace_AVCOL_SPC_BT2020_NCL: AVColorSpace = 9;
346pub const AVColorSpace_AVCOL_SPC_BT2020_CL: AVColorSpace = 10;
347
348// AVColorTransferCharacteristic
349pub const AVColorTransferCharacteristic_AVCOL_TRC_BT709: AVColorTransferCharacteristic = 1;
350pub const AVColorTransferCharacteristic_AVCOL_TRC_UNSPECIFIED: AVColorTransferCharacteristic = 2;
351pub const AVColorTransferCharacteristic_AVCOL_TRC_LINEAR: AVColorTransferCharacteristic = 8;
352pub const AVColorTransferCharacteristic_AVCOL_TRC_BT2020_10: AVColorTransferCharacteristic = 14;
353pub const AVColorTransferCharacteristic_AVCOL_TRC_BT2020_12: AVColorTransferCharacteristic = 15;
354pub const AVColorTransferCharacteristic_AVCOL_TRC_SMPTEST2084: AVColorTransferCharacteristic = 16;
355pub const AVColorTransferCharacteristic_AVCOL_TRC_ARIB_STD_B67: AVColorTransferCharacteristic = 18;
356
357// AVPacketSideDataType
358pub type AVPacketSideDataType = c_uint;
359pub const AVPacketSideDataType_AV_PKT_DATA_MASTERING_DISPLAY_METADATA: AVPacketSideDataType = 20;
360pub const AVPacketSideDataType_AV_PKT_DATA_CONTENT_LIGHT_LEVEL: AVPacketSideDataType = 22;
361
362// AVHWDeviceType
363pub const AVHWDeviceType_AV_HWDEVICE_TYPE_CUDA: AVHWDeviceType = 2;
364pub const AVHWDeviceType_AV_HWDEVICE_TYPE_VAAPI: AVHWDeviceType = 4;
365pub const AVHWDeviceType_AV_HWDEVICE_TYPE_QSV: AVHWDeviceType = 5;
366pub const AVHWDeviceType_AV_HWDEVICE_TYPE_VIDEOTOOLBOX: AVHWDeviceType = 7;
367pub const AVHWDeviceType_AV_HWDEVICE_TYPE_D3D11VA: AVHWDeviceType = 8;
368
369// AVPictureType constants
370pub const AVPictureType_AV_PICTURE_TYPE_NONE: AVPictureType = 0;
371pub const AVPictureType_AV_PICTURE_TYPE_I: AVPictureType = 1;
372
373// ── Raw FFmpeg functions (bindgen-generated counterparts) ─────────────────────
374//
375// These mirror what bindgen would emit from the real FFmpeg headers.
376// All bodies are stubs; the code is compiled but never executed on docs.rs.
377
378// SAFETY: docs.rs stubs — never called at runtime.
379pub unsafe fn av_strerror(_errnum: c_int, _errbuf: *mut c_char, _errbuf_size: usize) -> c_int {
380    0
381}
382
383pub unsafe fn av_dict_get(
384    _m: *const AVDictionary,
385    _key: *const c_char,
386    _prev: *const AVDictionaryEntry,
387    _flags: c_int,
388) -> *mut AVDictionaryEntry {
389    std::ptr::null_mut()
390}
391
392pub unsafe fn av_dict_set(
393    _pm: *mut *mut AVDictionary,
394    _key: *const c_char,
395    _value: *const c_char,
396    _flags: c_int,
397) -> c_int {
398    0
399}
400
401pub unsafe fn av_dict_free(_m: *mut *mut AVDictionary) {}
402
403pub unsafe fn av_find_input_format(_short_name: *const c_char) -> *const AVInputFormat {
404    std::ptr::null()
405}
406
407pub unsafe fn avcodec_get_name(_id: AVCodecID) -> *const c_char {
408    std::ptr::null()
409}
410
411pub unsafe fn av_frame_alloc() -> *mut AVFrame {
412    std::ptr::null_mut()
413}
414
415pub unsafe fn av_frame_free(_frame: *mut *mut AVFrame) {}
416
417pub unsafe fn av_frame_get_buffer(_frame: *mut AVFrame, _align: c_int) -> c_int {
418    0
419}
420
421pub unsafe fn av_frame_move_ref(_dst: *mut AVFrame, _src: *mut AVFrame) {}
422
423pub unsafe fn av_frame_unref(_frame: *mut AVFrame) {}
424
425pub unsafe fn av_packet_alloc() -> *mut AVPacket {
426    std::ptr::null_mut()
427}
428
429pub unsafe fn av_packet_free(_pkt: *mut *mut AVPacket) {}
430
431pub unsafe fn av_packet_unref(_pkt: *mut AVPacket) {}
432
433pub unsafe fn av_packet_new_side_data(
434    _pkt: *mut AVPacket,
435    _type_: AVPacketSideDataType,
436    _size: usize,
437) -> *mut u8 {
438    std::ptr::null_mut()
439}
440
441pub unsafe fn av_buffer_ref(_buf: *mut AVBufferRef) -> *mut AVBufferRef {
442    std::ptr::null_mut()
443}
444
445pub unsafe fn av_buffer_unref(_buf: *mut *mut AVBufferRef) {}
446
447pub unsafe fn av_hwdevice_ctx_create(
448    _device_ctx: *mut *mut AVBufferRef,
449    _type_: AVHWDeviceType,
450    _device: *const c_char,
451    _opts: *mut AVDictionary,
452    _flags: c_int,
453) -> c_int {
454    -1
455}
456
457pub unsafe fn av_hwframe_transfer_data(
458    _dst: *mut AVFrame,
459    _src: *const AVFrame,
460    _flags: c_int,
461) -> c_int {
462    -1
463}
464
465pub unsafe fn av_opt_set(
466    _obj: *mut c_void,
467    _name: *const c_char,
468    _val: *const c_char,
469    _search_flags: c_int,
470) -> c_int {
471    0
472}
473
474pub unsafe fn av_read_frame(_s: *mut AVFormatContext, _pkt: *mut AVPacket) -> c_int {
475    -1
476}
477
478pub unsafe fn av_write_trailer(_s: *mut AVFormatContext) -> c_int {
479    0
480}
481
482pub unsafe fn av_interleaved_write_frame(
483    _s: *mut AVFormatContext,
484    _pkt: *mut AVPacket,
485) -> c_int {
486    0
487}
488
489pub unsafe fn avcodec_receive_frame(_avctx: *mut AVCodecContext, _frame: *mut AVFrame) -> c_int {
490    -1
491}
492
493pub unsafe fn avcodec_send_packet(
494    _avctx: *mut AVCodecContext,
495    _avpkt: *const AVPacket,
496) -> c_int {
497    -1
498}
499
500pub unsafe fn avformat_alloc_output_context2(
501    _ctx: *mut *mut AVFormatContext,
502    _oformat: *mut AVOutputFormat,
503    _format_name: *const c_char,
504    _filename: *const c_char,
505) -> c_int {
506    -1
507}
508
509pub unsafe fn avformat_free_context(_s: *mut AVFormatContext) {}
510
511pub unsafe fn avformat_new_stream(
512    _s: *mut AVFormatContext,
513    _c: *const AVCodec,
514) -> *mut AVStream {
515    std::ptr::null_mut()
516}
517
518pub unsafe fn avformat_write_header(
519    _s: *mut AVFormatContext,
520    _options: *mut *mut AVDictionary,
521) -> c_int {
522    -1
523}
524
525pub unsafe fn swr_alloc_set_opts2(
526    _ps: *mut *mut SwrContext,
527    _out_ch_layout: *const AVChannelLayout,
528    _out_sample_fmt: AVSampleFormat,
529    _out_sample_rate: c_int,
530    _in_ch_layout: *const AVChannelLayout,
531    _in_sample_fmt: AVSampleFormat,
532    _in_sample_rate: c_int,
533    _log_offset: c_int,
534    _log_ctx: *mut c_void,
535) -> c_int {
536    -1
537}
538
539pub unsafe fn swr_convert(
540    _s: *mut SwrContext,
541    _out: *mut *mut u8,
542    _out_count: c_int,
543    _in_: *const *const u8,
544    _in_count: c_int,
545) -> c_int {
546    -1
547}
548
549pub unsafe fn swr_free(_s: *mut *mut SwrContext) {}
550
551pub unsafe fn swr_get_out_samples(_s: *mut SwrContext, _in_samples: c_int) -> c_int {
552    0
553}
554
555pub unsafe fn swr_init(_s: *mut SwrContext) -> c_int {
556    -1
557}
558
559pub unsafe fn av_channel_layout_default(_ch_layout: *mut AVChannelLayout, _nb_channels: c_int) {}
560
561pub unsafe fn av_channel_layout_uninit(_ch_layout: *mut AVChannelLayout) {}
562
563pub unsafe fn av_rescale_q(_a: i64, _bq: AVRational, _cq: AVRational) -> i64 {
564    0
565}
566
567pub unsafe fn av_mallocz(_size: usize) -> *mut c_void {
568    std::ptr::null_mut()
569}
570
571pub unsafe fn av_malloc(_size: usize) -> *mut c_void {
572    std::ptr::null_mut()
573}
574
575pub unsafe fn av_free(_ptr: *mut c_void) {}
576
577pub unsafe fn av_new_packet(_pkt: *mut AVPacket, _size: c_int) -> c_int {
578    -1
579}
580
581pub unsafe fn avcodec_parameters_copy(
582    _dst: *mut AVCodecParameters,
583    _src: *const AVCodecParameters,
584) -> c_int {
585    0
586}
587
588pub unsafe fn av_packet_rescale_ts(
589    _pkt: *mut AVPacket,
590    _tb_src: AVRational,
591    _tb_dst: AVRational,
592) {
593}
594
595// ── Wrapper module stubs ──────────────────────────────────────────────────────
596//
597// These mirror the safe wrapper modules in avformat.rs, avcodec.rs,
598// swresample.rs, and swscale.rs.  Signatures must exactly match those files.
599
600// ── libavfilter opaque types ──────────────────────────────────────────────────
601
602pub struct AVFilterGraph(());
603pub struct AVFilter(());
604
605pub struct AVFilterContext {
606    pub hw_device_ctx: *mut AVBufferRef,
607}
608
609// ── libavfilter constants ─────────────────────────────────────────────────────
610
611/// Flag for `av_buffersrc_add_frame_flags`: keep a reference to the frame.
612pub const AV_BUFFERSRC_FLAG_KEEP_REF: c_int = 8;
613
614// ── libavfilter functions ─────────────────────────────────────────────────────
615
616// SAFETY: docs.rs stubs — never called at runtime.
617
618pub unsafe fn avfilter_graph_alloc() -> *mut AVFilterGraph {
619    ptr::null_mut()
620}
621
622pub unsafe fn avfilter_graph_free(_graph: *mut *mut AVFilterGraph) {}
623
624pub unsafe fn avfilter_get_by_name(_name: *const c_char) -> *const AVFilter {
625    ptr::null()
626}
627
628pub unsafe fn avfilter_graph_create_filter(
629    _filt_ctx: *mut *mut AVFilterContext,
630    _filt: *const AVFilter,
631    _name: *const c_char,
632    _args: *const c_char,
633    _opaque: *mut c_void,
634    _graph_ctx: *mut AVFilterGraph,
635) -> c_int {
636    0
637}
638
639pub unsafe fn avfilter_link(
640    _src: *mut AVFilterContext,
641    _srcpad: c_uint,
642    _dst: *mut AVFilterContext,
643    _dstpad: c_uint,
644) -> c_int {
645    0
646}
647
648pub unsafe fn avfilter_graph_config(
649    _graphctx: *mut AVFilterGraph,
650    _log_ctx: *mut c_void,
651) -> c_int {
652    0
653}
654
655pub unsafe fn avfilter_graph_set_auto_convert(_graph: *mut AVFilterGraph, _flags: c_uint) {}
656
657pub unsafe fn av_buffersrc_add_frame_flags(
658    _ctx: *mut AVFilterContext,
659    _frame: *mut AVFrame,
660    _flags: c_int,
661) -> c_int {
662    0
663}
664
665pub unsafe fn av_buffersink_get_frame(
666    _ctx: *mut AVFilterContext,
667    _frame: *mut AVFrame,
668) -> c_int {
669    // Return EAGAIN to signal no frame available
670    -11
671}
672
673/// Stub `avformat` wrapper module.
674pub mod avformat {
675    use std::os::raw::c_int;
676    use std::path::Path;
677
678    use super::{AVFormatContext, AVIOContext, AVPacket};
679
680    pub unsafe fn open_input(_path: &Path) -> Result<*mut AVFormatContext, c_int> {
681        Err(-1)
682    }
683
684    pub unsafe fn open_input_image_sequence(
685        _path: &Path,
686        _framerate: u32,
687    ) -> Result<*mut AVFormatContext, c_int> {
688        Err(-1)
689    }
690
691    pub unsafe fn close_input(_ctx: *mut *mut AVFormatContext) {}
692
693    pub unsafe fn find_stream_info(_ctx: *mut AVFormatContext) -> Result<(), c_int> {
694        Err(-1)
695    }
696
697    pub unsafe fn seek_frame(
698        _ctx: *mut AVFormatContext,
699        _stream_index: c_int,
700        _timestamp: i64,
701        _flags: c_int,
702    ) -> Result<(), c_int> {
703        Err(-1)
704    }
705
706    pub unsafe fn seek_file(
707        _ctx: *mut AVFormatContext,
708        _stream_index: c_int,
709        _min_ts: i64,
710        _ts: i64,
711        _max_ts: i64,
712        _flags: c_int,
713    ) -> Result<(), c_int> {
714        Err(-1)
715    }
716
717    pub unsafe fn read_frame(
718        _ctx: *mut AVFormatContext,
719        _pkt: *mut AVPacket,
720    ) -> Result<(), c_int> {
721        Err(-1)
722    }
723
724    pub unsafe fn write_frame(
725        _ctx: *mut AVFormatContext,
726        _pkt: *mut AVPacket,
727    ) -> Result<(), c_int> {
728        Err(-1)
729    }
730
731    pub unsafe fn open_output(_path: &Path, _flags: c_int) -> Result<*mut AVIOContext, c_int> {
732        Err(-1)
733    }
734
735    pub unsafe fn close_output(_pb: *mut *mut AVIOContext) {}
736
737    pub mod avio_flags {
738        use std::os::raw::c_int;
739        pub const READ: c_int = 1;
740        pub const WRITE: c_int = 2;
741        pub const READ_WRITE: c_int = 3;
742    }
743
744    pub mod seek_flags {
745        pub const BACKWARD: i32 = 1;
746        pub const BYTE: i32 = 2;
747        pub const ANY: i32 = 4;
748        pub const FRAME: i32 = 8;
749    }
750}
751
752/// Stub `avcodec` wrapper module.
753pub mod avcodec {
754    use std::os::raw::c_int;
755
756    use super::{AVCodec, AVCodecContext, AVCodecID, AVCodecParameters, AVDictionary, AVFrame, AVPacket};
757
758    pub unsafe fn find_decoder(_codec_id: AVCodecID) -> Option<*const AVCodec> {
759        None
760    }
761
762    pub unsafe fn find_decoder_by_name(_name: *const i8) -> Option<*const AVCodec> {
763        None
764    }
765
766    pub unsafe fn find_encoder(_codec_id: AVCodecID) -> Option<*const AVCodec> {
767        None
768    }
769
770    pub unsafe fn find_encoder_by_name(_name: *const i8) -> Option<*const AVCodec> {
771        None
772    }
773
774    pub unsafe fn alloc_context3(_codec: *const AVCodec) -> Result<*mut AVCodecContext, c_int> {
775        Err(-1)
776    }
777
778    pub unsafe fn free_context(_ctx: *mut *mut AVCodecContext) {}
779
780    pub unsafe fn parameters_to_context(
781        _codec_ctx: *mut AVCodecContext,
782        _par: *const AVCodecParameters,
783    ) -> Result<(), c_int> {
784        Err(-1)
785    }
786
787    pub unsafe fn open2(
788        _avctx: *mut AVCodecContext,
789        _codec: *const AVCodec,
790        _options: *mut *mut AVDictionary,
791    ) -> Result<(), c_int> {
792        Err(-1)
793    }
794
795    pub unsafe fn send_packet(
796        _ctx: *mut AVCodecContext,
797        _pkt: *const AVPacket,
798    ) -> Result<(), c_int> {
799        Err(-1)
800    }
801
802    pub unsafe fn receive_frame(
803        _ctx: *mut AVCodecContext,
804        _frame: *mut AVFrame,
805    ) -> Result<(), c_int> {
806        Err(-1)
807    }
808
809    pub unsafe fn send_frame(
810        _ctx: *mut AVCodecContext,
811        _frame: *const AVFrame,
812    ) -> Result<(), c_int> {
813        Err(-1)
814    }
815
816    pub unsafe fn receive_packet(
817        _ctx: *mut AVCodecContext,
818        _pkt: *mut AVPacket,
819    ) -> Result<(), c_int> {
820        Err(-1)
821    }
822
823    pub unsafe fn flush_buffers(_ctx: *mut AVCodecContext) {}
824
825    pub unsafe fn parameters_from_context(
826        _par: *mut AVCodecParameters,
827        _ctx: *const AVCodecContext,
828    ) -> Result<(), c_int> {
829        Err(-1)
830    }
831
832    pub mod codec_caps {
833        pub const EXPERIMENTAL: u32 = 1 << 9;
834        pub const HARDWARE: u32 = 1 << 10;
835        pub const HYBRID: u32 = 1 << 11;
836        pub const VARIABLE_FRAME_SIZE: u32 = 1 << 16;
837        pub const AVOID_PROBING: u32 = 1 << 17;
838    }
839}
840
841/// Stub `swresample` wrapper module.
842pub mod swresample {
843    use std::os::raw::c_int;
844
845    use super::{AVChannelLayout, AVSampleFormat, SwrContext};
846
847    pub unsafe fn alloc() -> Result<*mut SwrContext, c_int> {
848        Err(-1)
849    }
850
851    pub unsafe fn alloc_set_opts2(
852        _out_ch_layout: *const AVChannelLayout,
853        _out_sample_fmt: AVSampleFormat,
854        _out_sample_rate: c_int,
855        _in_ch_layout: *const AVChannelLayout,
856        _in_sample_fmt: AVSampleFormat,
857        _in_sample_rate: c_int,
858    ) -> Result<*mut SwrContext, c_int> {
859        Err(-1)
860    }
861
862    pub unsafe fn init(_ctx: *mut SwrContext) -> Result<(), c_int> {
863        Err(-1)
864    }
865
866    pub unsafe fn is_initialized(_ctx: *const SwrContext) -> bool {
867        false
868    }
869
870    pub unsafe fn free(_ctx: *mut *mut SwrContext) {}
871
872    pub unsafe fn convert(
873        _s: *mut SwrContext,
874        _out: *mut *mut u8,
875        _out_count: c_int,
876        _in_: *const *const u8,
877        _in_count: c_int,
878    ) -> Result<c_int, c_int> {
879        Err(-1)
880    }
881
882    pub unsafe fn get_delay(_ctx: *mut SwrContext, _base: i64) -> i64 {
883        0
884    }
885
886    pub fn estimate_output_samples(
887        _out_sample_rate: i32,
888        _in_sample_rate: i32,
889        _in_samples: i32,
890    ) -> i32 {
891        0
892    }
893
894    pub mod channel_layout {
895        use super::super::AVChannelLayout;
896
897        pub unsafe fn set_default(_ch_layout: *mut AVChannelLayout, _nb_channels: i32) {}
898        pub unsafe fn uninit(_ch_layout: *mut AVChannelLayout) {}
899        pub unsafe fn copy(
900            _dst: *mut AVChannelLayout,
901            _src: *const AVChannelLayout,
902        ) -> Result<(), i32> {
903            Err(-1)
904        }
905        pub unsafe fn is_equal(
906            _chl: *const AVChannelLayout,
907            _chl1: *const AVChannelLayout,
908        ) -> bool {
909            false
910        }
911        pub fn mono() -> AVChannelLayout {
912            AVChannelLayout::default()
913        }
914        pub fn stereo() -> AVChannelLayout {
915            AVChannelLayout::default()
916        }
917        pub fn with_channels(_nb_channels: i32) -> AVChannelLayout {
918            AVChannelLayout::default()
919        }
920        pub fn is_valid(ch_layout: &AVChannelLayout) -> bool {
921            ch_layout.nb_channels > 0
922        }
923        pub fn nb_channels(ch_layout: &AVChannelLayout) -> i32 {
924            ch_layout.nb_channels
925        }
926        pub fn is_native_order(_ch_layout: &AVChannelLayout) -> bool {
927            false
928        }
929    }
930
931    pub mod audio_fifo {
932        use std::ffi::c_void;
933        use std::os::raw::c_int;
934
935        use super::super::{AVAudioFifo, AVSampleFormat};
936
937        pub unsafe fn alloc(
938            _sample_fmt: AVSampleFormat,
939            _channels: c_int,
940            _nb_samples: c_int,
941        ) -> Result<*mut AVAudioFifo, c_int> {
942            Err(-1)
943        }
944
945        pub unsafe fn free(_fifo: *mut AVAudioFifo) {}
946
947        pub unsafe fn write(
948            _fifo: *mut AVAudioFifo,
949            _data: *const *mut c_void,
950            _nb_samples: c_int,
951        ) -> Result<c_int, c_int> {
952            Err(-1)
953        }
954
955        pub unsafe fn read(
956            _fifo: *mut AVAudioFifo,
957            _data: *const *mut c_void,
958            _nb_samples: c_int,
959        ) -> Result<c_int, c_int> {
960            Err(-1)
961        }
962
963        pub unsafe fn size(_fifo: *mut AVAudioFifo) -> c_int {
964            0
965        }
966    }
967
968    pub mod sample_format {
969        use super::super::{
970            AVSampleFormat, AVSampleFormat_AV_SAMPLE_FMT_NONE, AVSampleFormat_AV_SAMPLE_FMT_U8,
971            AVSampleFormat_AV_SAMPLE_FMT_S16, AVSampleFormat_AV_SAMPLE_FMT_S32,
972            AVSampleFormat_AV_SAMPLE_FMT_FLT, AVSampleFormat_AV_SAMPLE_FMT_DBL,
973            AVSampleFormat_AV_SAMPLE_FMT_U8P, AVSampleFormat_AV_SAMPLE_FMT_S16P,
974            AVSampleFormat_AV_SAMPLE_FMT_S32P, AVSampleFormat_AV_SAMPLE_FMT_FLTP,
975            AVSampleFormat_AV_SAMPLE_FMT_DBLP, AVSampleFormat_AV_SAMPLE_FMT_S64,
976            AVSampleFormat_AV_SAMPLE_FMT_S64P,
977        };
978
979        pub const NONE: AVSampleFormat = AVSampleFormat_AV_SAMPLE_FMT_NONE;
980        pub const U8: AVSampleFormat = AVSampleFormat_AV_SAMPLE_FMT_U8;
981        pub const S16: AVSampleFormat = AVSampleFormat_AV_SAMPLE_FMT_S16;
982        pub const S32: AVSampleFormat = AVSampleFormat_AV_SAMPLE_FMT_S32;
983        pub const FLT: AVSampleFormat = AVSampleFormat_AV_SAMPLE_FMT_FLT;
984        pub const DBL: AVSampleFormat = AVSampleFormat_AV_SAMPLE_FMT_DBL;
985        pub const U8P: AVSampleFormat = AVSampleFormat_AV_SAMPLE_FMT_U8P;
986        pub const S16P: AVSampleFormat = AVSampleFormat_AV_SAMPLE_FMT_S16P;
987        pub const S32P: AVSampleFormat = AVSampleFormat_AV_SAMPLE_FMT_S32P;
988        pub const FLTP: AVSampleFormat = AVSampleFormat_AV_SAMPLE_FMT_FLTP;
989        pub const DBLP: AVSampleFormat = AVSampleFormat_AV_SAMPLE_FMT_DBLP;
990        pub const S64: AVSampleFormat = AVSampleFormat_AV_SAMPLE_FMT_S64;
991        pub const S64P: AVSampleFormat = AVSampleFormat_AV_SAMPLE_FMT_S64P;
992
993        pub fn bytes_per_sample(_sample_fmt: AVSampleFormat) -> i32 {
994            0
995        }
996        pub fn is_planar(_sample_fmt: AVSampleFormat) -> bool {
997            false
998        }
999    }
1000}
1001
1002/// Stub `swscale` wrapper module.
1003pub mod swscale {
1004    use std::os::raw::c_int;
1005
1006    use super::{AVPixelFormat, SwsContext};
1007
1008    pub unsafe fn get_context(
1009        _src_w: c_int,
1010        _src_h: c_int,
1011        _src_fmt: AVPixelFormat,
1012        _dst_w: c_int,
1013        _dst_h: c_int,
1014        _dst_fmt: AVPixelFormat,
1015        _flags: c_int,
1016    ) -> Result<*mut SwsContext, c_int> {
1017        Err(-1)
1018    }
1019
1020    pub unsafe fn free_context(_ctx: *mut SwsContext) {}
1021
1022    pub unsafe fn scale(
1023        _ctx: *mut SwsContext,
1024        _src: *const *const u8,
1025        _src_stride: *const c_int,
1026        _src_slice_y: c_int,
1027        _src_slice_h: c_int,
1028        _dst: *const *mut u8,
1029        _dst_stride: *const c_int,
1030    ) -> Result<c_int, c_int> {
1031        Err(-1)
1032    }
1033
1034    pub unsafe fn is_supported_input(_pix_fmt: AVPixelFormat) -> bool {
1035        false
1036    }
1037
1038    pub unsafe fn is_supported_output(_pix_fmt: AVPixelFormat) -> bool {
1039        false
1040    }
1041
1042    pub unsafe fn is_supported_endianness_conversion(_pix_fmt: AVPixelFormat) -> bool {
1043        false
1044    }
1045
1046    pub mod scale_flags {
1047        pub const FAST_BILINEAR: i32 = 1;
1048        pub const BILINEAR: i32 = 2;
1049        pub const BICUBIC: i32 = 4;
1050        pub const X: i32 = 8;
1051        pub const POINT: i32 = 16;
1052        pub const AREA: i32 = 32;
1053        pub const BICUBLIN: i32 = 64;
1054        pub const GAUSS: i32 = 128;
1055        pub const SINC: i32 = 256;
1056        pub const LANCZOS: i32 = 512;
1057        pub const SPLINE: i32 = 1024;
1058    }
1059}
ff_sys/docsrs_stubs.rs

ff_sys/
docsrs_stubs.rs
