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
|
/*****************************************************************
|
| Bento4 - C API Main Header
|
| Copyright 2002-2008 Gilles Boccon-Gibod & Julien Boeuf
|
|
| This file is part of Bento4/AP4 (MP4 Atom Processing Library).
|
| Unless you have obtained Bento4 under a difference license,
| this version of Bento4 is Bento4|GPL.
| Bento4|GPL is free software; you can redistribute it and/or modify
| it under the terms of the GNU General Public License as published by
| the Free Software Foundation; either version 2, or (at your option)
| any later version.
|
| Bento4|GPL 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 General Public License for more details.
|
| You should have received a copy of the GNU General Public License
| along with Bento4|GPL; see the file COPYING. If not, write to the
| Free Software Foundation, 59 Temple Place - Suite 330, Boston, MA
| 02111-1307, USA.
|
****************************************************************/
/*----------------------------------------------------------------------
| includes
+---------------------------------------------------------------------*/
#include "Ap4Types.h"
/*----------------------------------------------------------------------
| types
+---------------------------------------------------------------------*/
#if defined(__cplusplus)
class AP4_ByteStream;
class AP4_DataBuffer;
class AP4_File;
class AP4_Movie;
class AP4_Track;
class AP4_MetaData;
class AP4_Sample;
class AP4_SampleDescription;
class AP4_AudioSampleDescription;
class AP4_VideoSampleDescription;
class AP4_AvcSampleDescription;
class AP4_MpegSampleDescription;
class AP4_MpegAudioSampleDescription;
class AP4_ProtectedSampleDescription;
class AP4_SyntheticSampleTable;
class AP4_AtomInspector;
#else
typedef struct AP4_ByteStream AP4_ByteStream;
typedef struct AP4_DataBuffer AP4_DataBuffer;
typedef struct AP4_File AP4_File;
typedef struct AP4_Movie AP4_Movie;
typedef struct AP4_Track AP4_Track;
typedef struct AP4_MetaData AP4_MetaData;
typedef struct AP4_Sample AP4_Sample;
typedef struct AP4_SampleDescription AP4_SampleDescription;
typedef struct AP4_AudioSampleDescription AP4_AudioSampleDescription;
typedef struct AP4_VideoSampleDescription AP4_VideoSampleDescription;
typedef struct AP4_AvcSampleDescription AP4_AvcSampleDescription;
typedef struct AP4_MpegSampleDescription AP4_MpegSampleDescription;
typedef struct AP4_MpegAudioSampleDescription AP4_MpegAudioSampleDescription;
typedef struct AP4_ProtectedSampleDescription AP4_ProtectedSampleDescription;
typedef struct AP4_SyntheticSampleTable AP4_SyntheticSampleTable;
typedef struct AP4_AtomInspector AP4_AtomInspector;
#endif
typedef enum {
AP4_FALSE = 0,
AP4_TRUE = 1
} AP4_Boolean;
/*----------------------------------------------------------------------
| Delegate types: allow to provide an implementation
+---------------------------------------------------------------------*/
typedef struct AP4_ByteStreamDelegate {
AP4_Result (*ReadPartial)(struct AP4_ByteStreamDelegate* self,
void* buffer,
AP4_Size bytes_to_read,
AP4_Size* bytes_read);
AP4_Result (*WritePartial)(struct AP4_ByteStreamDelegate* self,
const void* buffer,
AP4_Size bytes_to_write,
AP4_Size* bytes_written);
AP4_Result (*Seek)(struct AP4_ByteStreamDelegate* self,
AP4_Position position);
AP4_Result (*Tell)(struct AP4_ByteStreamDelegate* self,
AP4_Position* position);
AP4_Result (*GetSize)(struct AP4_ByteStreamDelegate* self,
AP4_LargeSize* size);
AP4_Result (*Flush)(struct AP4_ByteStreamDelegate* self);
/**
* the reference counting is done for you.
* The Destroy method will be called when the refcount hits 0.
* Can be set to NULL if no cleanup of the delegate is necessary
*/
void (*Destroy)(struct AP4_ByteStreamDelegate* self);
} AP4_ByteStreamDelegate;
typedef struct AP4_AtomInspectorDelegate {
void (*StartElement)(struct AP4_AtomInspectorDelegate* self,
const char* name,
const char* extra);
void (*EndElement)(struct AP4_AtomInspectorDelegate* self);
void (*AddIntField)(struct AP4_AtomInspectorDelegate* self,
const char* name,
AP4_UI64 value,
int hint);
void (*AddFloatField)(struct AP4_AtomInspectorDelegate* self,
const char* name,
float value,
int hint);
void (*AddStringField)(struct AP4_AtomInspectorDelegate* self,
const char* name,
const char* value,
int hint);
void (*AddBytesField)(struct AP4_AtomInspectorDelegate* self,
const char* name,
const unsigned char* bytes,
AP4_Size byte_count,
int hint);
/**
* The Destroy method will be called when the AtomInspector is destroyed.
* Can be set to NULL if no cleanup of the delegate is necessary
*/
void (*Destroy)(struct AP4_AtomInspectorDelegate* self);
} AP4_AtomInspectorDelegate;
/*----------------------------------------------------------------------
| constants
+---------------------------------------------------------------------*/
extern const int AP4_FILE_BYTE_STREAM_MODE_READ;
extern const int AP4_FILE_BYTE_STREAM_MODE_WRITE;
extern const int AP4_FILE_BYTE_STREAM_MODE_READ_WRITE;
extern const AP4_UI32 AP4_FILE_BRAND_QT__;
extern const AP4_UI32 AP4_FILE_BRAND_ISOM;
extern const AP4_UI32 AP4_FILE_BRAND_MP41;
extern const AP4_UI32 AP4_FILE_BRAND_MP42;
extern const AP4_UI32 AP4_FILE_BRAND_3GP1;
extern const AP4_UI32 AP4_FILE_BRAND_3GP2;
extern const AP4_UI32 AP4_FILE_BRAND_3GP3;
extern const AP4_UI32 AP4_FILE_BRAND_3GP4;
extern const AP4_UI32 AP4_FILE_BRAND_3GP5;
extern const AP4_UI32 AP4_FILE_BRAND_3G2A;
extern const AP4_UI32 AP4_FILE_BRAND_MMP4;
extern const AP4_UI32 AP4_FILE_BRAND_M4A_;
extern const AP4_UI32 AP4_FILE_BRAND_M4P_;
extern const AP4_UI32 AP4_FILE_BRAND_MJP2;
extern const int AP4_TRACK_TYPE_UNKNOWN;
extern const int AP4_TRACK_TYPE_AUDIO;
extern const int AP4_TRACK_TYPE_VIDEO;
extern const int AP4_TRACK_TYPE_SYSTEM;
extern const int AP4_TRACK_TYPE_HINT;
extern const int AP4_TRACK_TYPE_TEXT;
extern const int AP4_TRACK_TYPE_JPEG;
extern const int AP4_TRACK_TYPE_RTP;
extern const int AP4_TRACK_TYPE_SUBTITLES;
extern const AP4_UI32 AP4_HANDLER_TYPE_SOUN;
extern const AP4_UI32 AP4_HANDLER_TYPE_VIDE;
extern const AP4_UI32 AP4_HANDLER_TYPE_HINT;
extern const AP4_UI32 AP4_HANDLER_TYPE_MDIR;
extern const AP4_UI32 AP4_HANDLER_TYPE_TEXT;
extern const AP4_UI32 AP4_HANDLER_TYPE_TX3G;
extern const AP4_UI32 AP4_HANDLER_TYPE_JPEG;
extern const AP4_UI32 AP4_HANDLER_TYPE_ODSM;
extern const AP4_UI32 AP4_HANDLER_TYPE_SDSM;
extern const AP4_UI32 AP4_TRACK_DEFAULT_MOVIE_TIMESCALE;
extern const int AP4_SAMPLE_DESCRIPTION_TYPE_UNKNOWN;
extern const int AP4_SAMPLE_DESCRIPTION_TYPE_MPEG;
extern const int AP4_SAMPLE_DESCRIPTION_TYPE_PROTECTED;
extern const int AP4_SAMPLE_DESCRIPTION_TYPE_AVC;
extern const int AP4_SAMPLE_DESCRIPTION_TYPE_HEVC;
extern const AP4_UI08 AP4_STREAM_TYPE_FORBIDDEN;
extern const AP4_UI08 AP4_STREAM_TYPE_OD;
extern const AP4_UI08 AP4_STREAM_TYPE_CR;
extern const AP4_UI08 AP4_STREAM_TYPE_BIFS;
extern const AP4_UI08 AP4_STREAM_TYPE_VISUAL;
extern const AP4_UI08 AP4_STREAM_TYPE_AUDIO;
extern const AP4_UI08 AP4_STREAM_TYPE_MPEG7;
extern const AP4_UI08 AP4_STREAM_TYPE_IPMP;
extern const AP4_UI08 AP4_STREAM_TYPE_OCI;
extern const AP4_UI08 AP4_STREAM_TYPE_MPEGJ;
extern const AP4_UI08 AP4_STREAM_TYPE_TEXT;
extern const AP4_UI08 AP4_OTI_MPEG4_SYSTEM;
extern const AP4_UI08 AP4_OTI_MPEG4_SYSTEM_COR;
extern const AP4_UI08 AP4_OTI_MPEG4_TEXT;
extern const AP4_UI08 AP4_OTI_MPEG4_VISUAL;
extern const AP4_UI08 AP4_OTI_MPEG4_AUDIO;
extern const AP4_UI08 AP4_OTI_MPEG2_VISUAL_SIMPLE;
extern const AP4_UI08 AP4_OTI_MPEG2_VISUAL_MAIN;
extern const AP4_UI08 AP4_OTI_MPEG2_VISUAL_SNR;
extern const AP4_UI08 AP4_OTI_MPEG2_VISUAL_SPATIAL;
extern const AP4_UI08 AP4_OTI_MPEG2_VISUAL_HIGH;
extern const AP4_UI08 AP4_OTI_MPEG2_VISUAL_422;
extern const AP4_UI08 AP4_OTI_MPEG2_AAC_AUDIO_MAIN;
extern const AP4_UI08 AP4_OTI_MPEG2_AAC_AUDIO_LC;
extern const AP4_UI08 AP4_OTI_MPEG2_AAC_AUDIO_SSRP;
extern const AP4_UI08 AP4_OTI_MPEG2_PART3_AUDIO;
extern const AP4_UI08 AP4_OTI_MPEG1_VISUAL;
extern const AP4_UI08 AP4_OTI_MPEG1_AUDIO;
extern const AP4_UI08 AP4_OTI_JPEG;
extern const AP4_UI08 AP4_MPEG4_AUDIO_OBJECT_TYPE_AAC_MAIN; /**< AAC Main Profile */
extern const AP4_UI08 AP4_MPEG4_AUDIO_OBJECT_TYPE_AAC_LC; /**< AAC Low Complexity */
extern const AP4_UI08 AP4_MPEG4_AUDIO_OBJECT_TYPE_AAC_SSR; /**< AAC Scalable Sample Rate */
extern const AP4_UI08 AP4_MPEG4_AUDIO_OBJECT_TYPE_AAC_LTP; /**< AAC Long Term Predictor */
extern const AP4_UI08 AP4_MPEG4_AUDIO_OBJECT_TYPE_SBR; /**< Spectral Band Replication */
extern const AP4_UI08 AP4_MPEG4_AUDIO_OBJECT_TYPE_AAC_SCALABLE; /**< AAC Scalable */
extern const AP4_UI08 AP4_MPEG4_AUDIO_OBJECT_TYPE_TWINVQ; /**< Twin VQ */
extern const AP4_UI08 AP4_MPEG4_AUDIO_OBJECT_TYPE_ER_AAC_LC; /**< Error Resilient AAC Low Complexity */
extern const AP4_UI08 AP4_MPEG4_AUDIO_OBJECT_TYPE_ER_AAC_LTP; /**< Error Resilient AAC Long Term Prediction */
extern const AP4_UI08 AP4_MPEG4_AUDIO_OBJECT_TYPE_ER_AAC_SCALABLE; /**< Error Resilient AAC Scalable */
extern const AP4_UI08 AP4_MPEG4_AUDIO_OBJECT_TYPE_ER_TWINVQ; /**< Error Resilient Twin VQ */
extern const AP4_UI08 AP4_MPEG4_AUDIO_OBJECT_TYPE_ER_BSAC; /**< Error Resilient Bit Sliced Arithmetic Coding */
extern const AP4_UI08 AP4_MPEG4_AUDIO_OBJECT_TYPE_ER_AAC_LD; /**< Error Resilient AAC Low Delay */
extern const AP4_UI08 AP4_MPEG4_AUDIO_OBJECT_TYPE_LAYER_1; /**< MPEG Layer 1 */
extern const AP4_UI08 AP4_MPEG4_AUDIO_OBJECT_TYPE_LAYER_2; /**< MPEG Layer 2 */
extern const AP4_UI08 AP4_MPEG4_AUDIO_OBJECT_TYPE_LAYER_3; /**< MPEG Layer 3 */
extern const AP4_Cardinal AP4_SYNTHETIC_SAMPLE_TABLE_DEFAULT_CHUNK_SIZE;
extern const int AP4_ATOM_INSPECTOR_HINT_NONE;
extern const int AP4_ATOM_INSPECTOR_HINT_HEX;
extern const int AP4_ATOM_INSPECTOR_HIN_BOOLEAN;
/*----------------------------------------------------------------------
| result codes
+---------------------------------------------------------------------*/
extern const int AP4_SUCCESS;
extern const int AP4_FAILURE;
extern const int AP4_ERROR_OUT_OF_MEMORY;
extern const int AP4_ERROR_INVALID_PARAMETERS;
extern const int AP4_ERROR_NO_SUCH_FILE;
extern const int AP4_ERROR_PERMISSION_DENIED;
extern const int AP4_ERROR_CANNOT_OPEN_FILE;
extern const int AP4_ERROR_EOS;
extern const int AP4_ERROR_WRITE_FAILED;
extern const int AP4_ERROR_READ_FAILED;
extern const int AP4_ERROR_INVALID_FORMAT;
extern const int AP4_ERROR_NO_SUCH_ITEM;
extern const int AP4_ERROR_OUT_OF_RANGE;
extern const int AP4_ERROR_INTERNAL;
extern const int AP4_ERROR_INVALID_STATE;
extern const int AP4_ERROR_LIST_EMPTY;
extern const int AP4_ERROR_LIST_OPERATION_ABORTED;
extern const int AP4_ERROR_INVALID_RTP_CONSTRUCTOR_TYPE;
extern const int AP4_ERROR_NOT_SUPPORTED;
extern const int AP4_ERROR_INVALID_TRACK_TYPE;
extern const int AP4_ERROR_INVALID_RTP_PACKET_EXTRA_DATA;
extern const int AP4_ERROR_BUFFER_TOO_SMALL;
extern const int AP4_ERROR_NOT_ENOUGH_DATA;
#ifdef __cplusplus
extern "C" {
#endif /* __cplusplus */
/*----------------------------------------------------------------------
| AP4_ByteStream methods
+---------------------------------------------------------------------*/
void
AP4_ByteStream_AddReference(AP4_ByteStream* self);
void
AP4_ByteStream_Release(AP4_ByteStream* self);
AP4_Result
AP4_ByteStream_ReadPartial(AP4_ByteStream* self,
void* buffer,
AP4_Size bytes_to_read,
AP4_Size* bytes_read);
AP4_Result
AP4_ByteStream_Read(AP4_ByteStream* self,
void* buffer,
AP4_Size bytes_to_read);
AP4_Result
AP4_ByteStream_ReadDouble(AP4_ByteStream* self, double* value);
AP4_Result
AP4_ByteStream_ReadUI64(AP4_ByteStream* self, AP4_UI64* value);
AP4_Result
AP4_ByteStream_ReadUI32(AP4_ByteStream* self, AP4_UI32* value);
AP4_Result
AP4_ByteStream_ReadUI24(AP4_ByteStream* self, AP4_UI32* value);
AP4_Result
AP4_ByteStream_ReadUI16(AP4_ByteStream* self, AP4_UI16* value);
AP4_Result
AP4_ByteStream_ReadUI08(AP4_ByteStream* self, AP4_UI08* value);
AP4_Result
AP4_ByteStream_ReadString(AP4_ByteStream* self,
char* buffer,
AP4_Size size);
AP4_Result
AP4_ByteStream_WritePartial(AP4_ByteStream* self,
const void* buffer,
AP4_Size bytes_to_write,
AP4_Size* bytes_written);
AP4_Result
AP4_ByteStream_Write(AP4_ByteStream* self,
const void* buffer,
AP4_Size bytes_to_write);
AP4_Result
AP4_ByteStream_WriteDouble(AP4_ByteStream* self, double value);
AP4_Result
AP4_ByteStream_WriteUI64(AP4_ByteStream* self, AP4_UI64 value);
AP4_Result
AP4_ByteStream_WriteUI32(AP4_ByteStream* self, AP4_UI32 value);
AP4_Result
AP4_ByteStream_WriteUI24(AP4_ByteStream* self, AP4_UI32 value);
AP4_Result
AP4_ByteStream_WriteUI16(AP4_ByteStream* self, AP4_UI16 value);
AP4_Result
AP4_ByteStream_WriteUI08(AP4_ByteStream* self, AP4_UI08 value);
AP4_Result
AP4_ByteStream_WriteString(AP4_ByteStream* self, const char* buffer);
AP4_Result
AP4_ByteStream_Seek(AP4_ByteStream* self, AP4_Position position);
AP4_Result
AP4_ByteStream_Tell(AP4_ByteStream* self, AP4_Position* position);
AP4_Result
AP4_ByteStream_GetSize(AP4_ByteStream* self, AP4_LargeSize* size);
AP4_Result
AP4_ByteStream_CopyTo(AP4_ByteStream* self,
AP4_ByteStream* receiver,
AP4_LargeSize size);
AP4_Result Ap4_ByteStream_Flush(AP4_ByteStream* self);
/*----------------------------------------------------------------------
| AP4_ByteStream construtors
+---------------------------------------------------------------------*/
AP4_ByteStream*
AP4_SubStream_Create(AP4_ByteStream* container,
AP4_Position position,
AP4_LargeSize size);
AP4_ByteStream*
AP4_MemoryByteStream_Create(AP4_Size size);
AP4_ByteStream*
AP4_MemoryByteStream_FromBuffer(const AP4_UI08* buffer, AP4_Size size);
AP4_ByteStream*
AP4_MemoryByteStream_AdaptDataBuffer(AP4_DataBuffer* buffer); /* data is read/written from the supplied data buffer */
AP4_ByteStream*
AP4_FileByteStream_Create(const char* name, int mode, AP4_Result* result);
AP4_ByteStream*
AP4_ByteStream_FromDelegate(AP4_ByteStreamDelegate* delegate);
/*----------------------------------------------------------------------
| AP4_DataBuffer methods
+---------------------------------------------------------------------*/
AP4_Result
AP4_DataBuffer_SetBuffer(AP4_DataBuffer* self, AP4_Byte* buffer, AP4_Size size);
AP4_Result
AP4_DataBuffer_SetBufferSize(AP4_DataBuffer* self, AP4_Size size);
AP4_Size
AP4_DataBuffer_GetBufferSize(const AP4_DataBuffer* self);
const AP4_Byte*
AP4_DataBuffer_GetData(const AP4_DataBuffer* self);
AP4_Byte*
AP4_DataBuffer_UseData(AP4_DataBuffer* self);
AP4_Size
AP4_DataBuffer_GetDataSize(const AP4_DataBuffer* self);
AP4_Result
AP4_DataBuffer_SetDataSize(AP4_DataBuffer* self, AP4_Size size);
AP4_Result
AP4_DataBuffer_SetData(AP4_DataBuffer* self,
const AP4_Byte* data,
AP4_Size data_size);
AP4_Result
AP4_DataBuffer_Reserve(AP4_DataBuffer* self, AP4_Size size);
void
AP4_DataBuffer_Destroy(AP4_DataBuffer* self);
/*----------------------------------------------------------------------
| AP4_DataBuffer constructors
+---------------------------------------------------------------------*/
AP4_DataBuffer*
AP4_DataBuffer_Create(AP4_Size size);
AP4_DataBuffer*
AP4_DataBuffer_FromData(const void* data, AP4_Size data_size);
AP4_DataBuffer*
AP4_DataBuffer_Clone(const AP4_DataBuffer* other);
/*----------------------------------------------------------------------
| AP4_File methods
+---------------------------------------------------------------------*/
AP4_Movie*
AP4_File_GetMovie(AP4_File* self);
AP4_Result
AP4_File_GetFileType(AP4_File* self,
AP4_UI32* major_brand,
AP4_UI32* minor_version,
AP4_Cardinal* compatible_brand_count);
AP4_Result
AP4_File_GetCompatibleBrand(AP4_File* self,
AP4_Ordinal index,
AP4_UI32* brand);
AP4_Result
AP4_File_SetFileType(AP4_File* self,
AP4_UI32 major_brand,
AP4_UI32 minor_version,
AP4_UI32* compatible_brands,
AP4_Cardinal compatible_brand_count);
int
AP4_File_IsMoovBeforeMdat(const AP4_File* self);
AP4_Result
AP4_File_Inspect(AP4_File* self, AP4_AtomInspector* inspector);
const AP4_MetaData*
AP4_File_GetMetaData(AP4_File* self);
void
AP4_File_Destroy(AP4_File* self);
/*----------------------------------------------------------------------
| AP4_File constructors
+---------------------------------------------------------------------*/
AP4_File*
AP4_File_Create(AP4_Movie* movie);
AP4_File*
AP4_File_FromStream(AP4_ByteStream* stream, int moov_only);
/*----------------------------------------------------------------------
| AP4_Movie methods
+---------------------------------------------------------------------*/
AP4_Cardinal
AP4_Movie_GetTrackCount(AP4_Movie* self);
AP4_Track*
AP4_Movie_GetTrackByIndex(AP4_Movie* self, AP4_Ordinal index);
AP4_Track*
AP4_Movie_GetTrackById(AP4_Movie* self, AP4_UI32 track_id);
AP4_Track*
AP4_Movie_GetTrackByType(AP4_Movie* self, int type, AP4_Ordinal index);
AP4_UI32
AP4_Movie_GetTimeScale(AP4_Movie* self);
AP4_UI64
AP4_Movie_GetDuration(AP4_Movie* self);
AP4_UI32
AP4_Movie_GetDurationMs(AP4_Movie* self);
AP4_Result
AP4_Movie_AddTrack(AP4_Movie* self, AP4_Track* track);
void
AP4_Movie_Destroy(AP4_Movie* self);
/*----------------------------------------------------------------------
| AP4_Movie constructors
+---------------------------------------------------------------------*/
AP4_Movie*
AP4_Movie_Create(AP4_UI32 time_scale);
/*----------------------------------------------------------------------
| AP4_Track methods
+---------------------------------------------------------------------*/
int
AP4_Track_GetType(AP4_Track* self);
AP4_UI32
AP4_Track_GetHandlerType(AP4_Track* self);
AP4_UI64
AP4_Track_GetDuration(AP4_Track* self); /* timescale of the movie */
AP4_UI32
AP4_Track_GetDurationMs(AP4_Track* self);
AP4_Cardinal
AP4_Track_GetSampleCount(AP4_Track* self);
AP4_Result
AP4_Track_GetSample(AP4_Track* self, AP4_Ordinal index, AP4_Sample* sample);
AP4_Result
AP4_Track_ReadSample(AP4_Track* self,
AP4_Ordinal index,
AP4_Sample* sample,
AP4_DataBuffer* data);
AP4_Result
AP4_Track_GetSampleIndexForTimeStampMs(AP4_Track* self,
AP4_UI32 ts,
AP4_Ordinal* index);
AP4_Ordinal
AP4_Track_GetNearestSyncSampleIndex(AP4_Track* self,
AP4_Ordinal index,
AP4_Boolean before);
AP4_SampleDescription*
AP4_Track_GetSampleDescription(AP4_Track* self, AP4_Ordinal index);
AP4_UI32
AP4_Track_GetId(AP4_Track* self);
AP4_Result
AP4_Track_SetId(AP4_Track* self, AP4_UI32 track_id);
AP4_Result
AP4_Track_SetMovieTimeScale(AP4_Track* self, AP4_UI32 time_scale);
AP4_UI32
AP4_Track_GetMediaTimeScale(AP4_Track* self);
AP4_UI64
AP4_Track_GetMediaDuration(AP4_Track* self); /* in the timescale of the media */
const char*
AP4_Track_GetName(AP4_Track* self);
const char*
AP4_Track_GetLanguage(AP4_Track* self);
void
AP4_Track_Destroy(AP4_Track* self);
/*----------------------------------------------------------------------
| AP4_Track constructors
+---------------------------------------------------------------------*/
AP4_Track*
AP4_Track_Create(int type,
AP4_SyntheticSampleTable* sample_table,
AP4_UI32 track_id,
AP4_UI32 movie_time_scale, /* 0 = use default */
AP4_UI32 track_duration, /* in the movie time scale */
AP4_UI32 media_time_scale,
AP4_UI32 media_duration, /* in the media time scale */
const char* language,
AP4_UI32 width,
AP4_UI32 height);
/*----------------------------------------------------------------------
| AP4_SampleDescription methods
+---------------------------------------------------------------------*/
int
AP4_SampleDescription_GetType(AP4_SampleDescription* self);
AP4_UI32
AP4_SampleDescription_GetFormat(AP4_SampleDescription* self);
AP4_AudioSampleDescription*
AP4_SampleDescription_AsAudio(AP4_SampleDescription* self);
AP4_VideoSampleDescription*
AP4_SampleDescription_AsVideo(AP4_SampleDescription* self);
AP4_AvcSampleDescription*
AP4_SampleDescription_AsAvc(AP4_SampleDescription* self);
AP4_MpegSampleDescription*
AP4_SampleDescription_AsMpeg(AP4_SampleDescription* self);
AP4_MpegAudioSampleDescription*
AP4_SampleDescription_AsMpegAudio(AP4_SampleDescription* self);
AP4_ProtectedSampleDescription*
AP4_SampleDescription_AsProtected(AP4_SampleDescription* self);
AP4_UI32
AP4_AudioSampleDescription_GetSampleRate(AP4_AudioSampleDescription* self);
AP4_UI16
AP4_AudioSampleDescription_GetSampleSize(AP4_AudioSampleDescription* self);
AP4_UI16
AP4_AudioSampleDescription_GetChannelCount(AP4_AudioSampleDescription* self);
AP4_UI32
AP4_VideoSampleDescription_GetWidth(AP4_VideoSampleDescription* self);
AP4_UI16
AP4_VideoSampleDescription_GetHeight(AP4_VideoSampleDescription* self);
AP4_UI16
AP4_VideoSampleDescription_GetDepth(AP4_VideoSampleDescription* self);
const char*
AP4_VideoSampleDescription_GetCompressorName(AP4_VideoSampleDescription* self);
AP4_UI08
AP4_AvcSampleDescription_GetConfigurationVersion(AP4_AvcSampleDescription* self);
AP4_UI08
AP4_AvcSampleDescription_GetProfile(AP4_AvcSampleDescription* self);
AP4_UI08
AP4_AvcSampleDescription_GetLevel(AP4_AvcSampleDescription* self);
AP4_UI08
AP4_AvcSampleDescription_GetProfileCompatibility(AP4_AvcSampleDescription* self);
AP4_UI08
AP4_AvcSampleDescription_GetNaluLengthSize(AP4_AvcSampleDescription* self);
AP4_Cardinal
AP4_AvcSampleDescription_GetSequenceParameterCount(AP4_AvcSampleDescription* self);
const AP4_DataBuffer*
AP4_AvcSampleDescription_GetSequenceParameter(AP4_AvcSampleDescription* self,
AP4_Ordinal index);
AP4_Cardinal
AP4_AvcSampleDescription_GetPictureParameterCount(AP4_AvcSampleDescription* self);
const AP4_DataBuffer*
AP4_AvcSampleDescription_GetPictureParameter(AP4_AvcSampleDescription* self,
AP4_Ordinal index);
const AP4_DataBuffer*
AP4_AvcSampleDescription_GetRawBytes(AP4_AvcSampleDescription* self);
const char*
AP4_AvcSampleDescription_GetProfileName(AP4_UI08 profile); /* class method */
AP4_UI08
AP4_MpegSampleDescription_GetStreamType(AP4_MpegSampleDescription* self);
AP4_UI08
AP4_MpegSampleDescription_GetObjectTypeId(AP4_MpegSampleDescription* self);
AP4_UI32
AP4_MpegSampleDescription_GetBufferSize(AP4_MpegSampleDescription* self);
AP4_UI32
AP4_MpegSampleDescription_GetMaxBitrate(AP4_MpegSampleDescription* self);
AP4_UI32
AP4_MpegSampleDescription_GetAvgBitrate(AP4_MpegSampleDescription* self);
const AP4_DataBuffer*
AP4_MpegSampleDescription_GetDecoderInfo(AP4_MpegSampleDescription* self);
AP4_UI08
AP4_MpegAudioSampleDescription_GetMpeg4AudioObjectType(AP4_MpegAudioSampleDescription* self);
const char*
AP4_MpegAudioSampleDescription_GetMpegAudioObjectTypeString(AP4_UI08 type); /* class method */
AP4_SampleDescription*
AP4_ProtectedSampleDescription_GetOriginalSampleDescription(AP4_ProtectedSampleDescription* self);
AP4_UI32
AP4_ProtectedSampleDescription_GetOriginalFormat(AP4_ProtectedSampleDescription* self);
AP4_UI32
AP4_ProtectedSampleDescription_GetSchemeType(AP4_ProtectedSampleDescription* self);
AP4_UI32
AP4_ProtectedSampleDescription_GetSchemeVersion(AP4_ProtectedSampleDescription* self);
const char*
AP4_ProtectedSampleDescription_GetSchemeUri(AP4_ProtectedSampleDescription* self);
void AP4_SampleDescription_Destroy(AP4_SampleDescription* self);
/*----------------------------------------------------------------------
| AP4_SampleDescription constructors
+---------------------------------------------------------------------*/
AP4_SampleDescription*
AP4_MpegVideoSampleDescription_Create(AP4_UI08 oti,
AP4_UI16 width,
AP4_UI16 height,
AP4_UI16 depth,
const char* compressor_name,
const AP4_Byte* decoder_info,
AP4_Size decoder_info_size,
AP4_UI32 buffer_size,
AP4_UI32 max_bitrate,
AP4_UI32 avg_bitrate);
AP4_SampleDescription*
AP4_MpegAudioSampleDescription_Create(AP4_UI08 oti,
AP4_UI32 sample_rate,
AP4_UI32 sample_size,
AP4_UI32 channel_count,
const AP4_Byte* decoder_info,
AP4_Size decoder_info_size,
AP4_UI32 buffer_size,
AP4_UI32 max_bitrate,
AP4_UI32 avg_bitrate);
AP4_SampleDescription*
AP4_MpegSystemSampleDescription_Create(AP4_UI08 stream_type,
AP4_UI08 oti,
const AP4_Byte* decoder_info,
AP4_Size decoder_info_size,
AP4_UI32 buffer_size,
AP4_UI32 max_bitrate,
AP4_UI32 avg_bitrate);
AP4_SampleDescription*
AP4_AvcSampleDescription_Create(AP4_UI16 width,
AP4_UI16 height,
AP4_UI16 depth,
const char* compressor_name,
AP4_UI08 config_version,
AP4_UI08 profile,
AP4_UI08 level,
AP4_UI08 profile_compatibility,
AP4_UI08 nalu_length_size,
AP4_DataBuffer** sequence_parameters,
AP4_Size sequence_parameter_count,
AP4_DataBuffer** picture_parameters,
AP4_Size picture_parameter_count);
/*----------------------------------------------------------------------
| AP4_Sample methods
+---------------------------------------------------------------------*/
AP4_Result
AP4_Sample_ReadData(AP4_Sample* self, AP4_DataBuffer* data);
AP4_Result
AP4_Sample_ReadPartialData(AP4_Sample* self,
AP4_DataBuffer* data,
AP4_Size size,
AP4_Size offset);
AP4_ByteStream*
AP4_Sample_GetDataStream(AP4_Sample* self);
void
AP4_Sample_SetDataStream(AP4_Sample* self, AP4_ByteStream* stream);
AP4_Position
AP4_Sample_GetOffset(AP4_Sample* self);
void
AP4_Sample_SetOffset(AP4_Sample* self, AP4_Position offset);
AP4_Size
AP4_Sample_GetSize(AP4_Sample* self);
void
AP4_Sample_SetSize(AP4_Sample* self, AP4_Size size);
AP4_Ordinal
AP4_Sample_GetDescriptionIndex(AP4_Sample* self);
void
AP4_Sample_SetDescriptionIndex(AP4_Sample* self, AP4_Ordinal index);
AP4_UI64
AP4_Sample_GetDts(AP4_Sample* self);
void
AP4_SampleSetDts(AP4_Sample* self, AP4_UI64 dts);
AP4_UI64
AP4_Sample_GetCts(AP4_Sample* self);
void
AP4_Sample_SetCts(AP4_Sample* self, AP4_UI64 cts);
AP4_UI32
AP4_Sample_GetDuration(AP4_Sample* self);
void
AP4_Sample_SetDuration(AP4_Sample* self, AP4_UI32 duration);
int
AP4_Sample_IsSync(AP4_Sample* self);
void
AP4_Sample_SetSync(AP4_Sample* self, int is_sync);
void
AP4_Sample_Destroy(AP4_Sample* self);
/*----------------------------------------------------------------------
| AP4_Sample constructors
+---------------------------------------------------------------------*/
AP4_Sample*
AP4_Sample_CreateEmpty(void);
AP4_Sample*
AP4_Sample_Create(AP4_ByteStream* data_stream,
AP4_Position offset,
AP4_Size size,
AP4_Ordinal description_index,
AP4_UI32 dts,
AP4_UI32 cts_offset,
int is_sync);
AP4_Sample*
AP4_Sample_Clone(const AP4_Sample* other);
/*----------------------------------------------------------------------
| AP4_SyntheticSampleTable methods
+---------------------------------------------------------------------*/
AP4_Result
AP4_SyntheticSampleTable_AddSampleDescription(AP4_SyntheticSampleTable* self,
AP4_SampleDescription* desc);
AP4_Result
AP4_SyntheticSampleTable_AddSample(AP4_SyntheticSampleTable* self,
AP4_ByteStream* data_stream,
AP4_Position offset,
AP4_Size size,
AP4_Ordinal desc_index,
AP4_UI32 cts,
AP4_UI32 dts,
int is_sync);
void
AP4_SyntheticSampleTable_Destroy(AP4_SyntheticSampleTable* self);
/*----------------------------------------------------------------------
| AP4_SyntheticSampleTable constructors
+---------------------------------------------------------------------*/
AP4_SyntheticSampleTable*
AP4_SyntheticSampleTable_Create(AP4_Cardinal chunk_size); /* see AP4_SYNTHETIC_SAMPLE_TABLE_DEFAULT_CHUNK_SIZE constant */
/*----------------------------------------------------------------------
| AP4_AtomInspector methods
+---------------------------------------------------------------------*/
void
AP4_AtomInspector_Destroy(AP4_AtomInspector* self);
/*----------------------------------------------------------------------
| AP4_AtomInspector constructors
+---------------------------------------------------------------------*/
AP4_AtomInspector*
AP4_PrintInspector_Create(AP4_ByteStream* stream);
AP4_AtomInspector*
AP4_AtomInspector_FromDelegate(AP4_AtomInspectorDelegate* delegate);
#ifdef __cplusplus
}
#endif /*__cplusplus */
|
