开通博客赚积分
发布资源赚积分
分类

源码开发语言/平台
当前位置：首页 > 源码/资料 > 多媒体 > 流媒体/Mpeg4/MP4 > 查看源码
mp4.h
资源名称：NETVIDEO.rar　[点击查看]
上传用户：sun1608
上传日期：2007-02-02
资源大小：6116k
文件大小：23k
源码类别：

流媒体/Mpeg4/MP4

开发平台：

Visual C++

mp4.h：源码内容
  1. /*
  2.  * The contents of this file are subject to the Mozilla Public
  3.  * License Version 1.1 (the "License"); you may not use this file
  4.  * except in compliance with the License. You may obtain a copy of
  5.  * the License at http://www.mozilla.org/MPL/
  6.  * 
  7.  * Software distributed under the License is distributed on an "AS
  8.  * IS" basis, WITHOUT WARRANTY OF ANY KIND, either express or
  9.  * implied. See the License for the specific language governing
  10.  * rights and limitations under the License.
  11.  * 
  12.  * The Original Code is MPEG4IP.
  13.  * 
  14.  * The Initial Developer of the Original Code is Cisco Systems Inc.
  15.  * Portions created by Cisco Systems Inc. are
  16.  * Copyright (C) Cisco Systems Inc. 2001.  All Rights Reserved.
  17.  * 
  18.  * Contributor(s): 
  19.  * Dave Mackie dmackie@cisco.com
  20.  */
  22. #ifndef __MP4_INCLUDED__
  23. #define __MP4_INCLUDED__
  25. /* include system and project specific headers */
  26. #include "mpeg4ip.h"
  28. #include <math.h> /* to define float HUGE_VAL and/or NAN */
  29. #ifndef NAN
  30. #define NAN HUGE_VAL
  31. #endif
  33. #ifdef __cplusplus
  34. /* exploit C++ ability of default values for function parameters */
  35. #define DEFAULT(x) =x
  36. #else
  37. #define DEFAULT(x)
  38. #endif
  40. /* MP4 API types */
  41. typedef void* MP4FileHandle;
  42. typedef u_int32_t MP4TrackId;
  43. typedef u_int32_t MP4SampleId;
  44. typedef u_int64_t MP4Timestamp;
  45. typedef u_int64_t MP4Duration;
  46. typedef u_int32_t MP4EditId;
  48. /* Invalid values for API types */
  49. #define MP4_INVALID_FILE_HANDLE ((MP4FileHandle)NULL)
  50. #define MP4_INVALID_TRACK_ID ((MP4TrackId)0)
  51. #define MP4_INVALID_SAMPLE_ID ((MP4SampleId)0)
  52. #define MP4_INVALID_TIMESTAMP ((MP4Timestamp)-1)
  53. #define MP4_INVALID_DURATION ((MP4Duration)-1)
  54. #define MP4_INVALID_EDIT_ID ((MP4EditId)0)
  56. /* Macros to test for API type validity */
  57. #define MP4_IS_VALID_FILE_HANDLE(x) ((x) != MP4_INVALID_FILE_HANDLE) 
  58. #define MP4_IS_VALID_TRACK_ID(x) ((x) != MP4_INVALID_TRACK_ID) 
  59. #define MP4_IS_VALID_SAMPLE_ID(x) ((x) != MP4_INVALID_SAMPLE_ID) 
  60. #define MP4_IS_VALID_TIMESTAMP(x) ((x) != MP4_INVALID_TIMESTAMP) 
  61. #define MP4_IS_VALID_DURATION(x) ((x) != MP4_INVALID_DURATION) 
  62. #define MP4_IS_VALID_EDIT_ID(x) ((x) != MP4_INVALID_EDIT_ID) 
  64. /* MP4 verbosity levels - e.g. MP4SetVerbosity() */
  65. #define MP4_DETAILS_ALL 0xFFFFFFFF
  66. #define MP4_DETAILS_ERROR 0x00000001
  67. #define MP4_DETAILS_WARNING 0x00000002
  68. #define MP4_DETAILS_READ 0x00000004
  69. #define MP4_DETAILS_WRITE 0x00000008
  70. #define MP4_DETAILS_FIND 0x00000010
  71. #define MP4_DETAILS_TABLE 0x00000020
  72. #define MP4_DETAILS_SAMPLE 0x00000040
  73. #define MP4_DETAILS_HINT 0x00000080
  74. #define MP4_DETAILS_ISMA 0x00000100
  75. #define MP4_DETAILS_EDIT 0x00000200
  77. #define MP4_DETAILS_READ_ALL
  78. (MP4_DETAILS_READ | MP4_DETAILS_TABLE | MP4_DETAILS_SAMPLE)
  79. #define MP4_DETAILS_WRITE_ALL
  80. (MP4_DETAILS_WRITE | MP4_DETAILS_TABLE | MP4_DETAILS_SAMPLE)
  82. /*
  83.  * MP4 Known track type names - e.g. MP4GetNumberOfTracks(type) 
  84.  *
  85.  * Note this first group of track types should be created 
  86.  * via the MP4Add<Type>Track() functions, and not MP4AddTrack(type)
  87.  */
  88. #define MP4_OD_TRACK_TYPE "odsm"
  89. #define MP4_SCENE_TRACK_TYPE "sdsm"
  90. #define MP4_AUDIO_TRACK_TYPE "soun"
  91. #define MP4_VIDEO_TRACK_TYPE "vide"
  92. #define MP4_HINT_TRACK_TYPE "hint"
  93. /*
  94.  * This second set of track types should be created 
  95.  * via MP4AddSystemsTrack(type)
  96.  */
  97. #define MP4_CLOCK_TRACK_TYPE "crsm"
  98. #define MP4_MPEG7_TRACK_TYPE "m7sm"
  99. #define MP4_OCI_TRACK_TYPE "ocsm"
  100. #define MP4_IPMP_TRACK_TYPE "ipsm"
  101. #define MP4_MPEGJ_TRACK_TYPE "mjsm"
  103. #define MP4_IS_VIDEO_TRACK_TYPE(type) 
  104. (!strcasecmp(type, MP4_VIDEO_TRACK_TYPE))
  106. #define MP4_IS_AUDIO_TRACK_TYPE(type) 
  107. (!strcasecmp(type, MP4_AUDIO_TRACK_TYPE))
  109. #define MP4_IS_OD_TRACK_TYPE(type) 
  110. (!strcasecmp(type, MP4_OD_TRACK_TYPE))
  112. #define MP4_IS_SCENE_TRACK_TYPE(type) 
  113. (!strcasecmp(type, MP4_SCENE_TRACK_TYPE))
  115. #define MP4_IS_HINT_TRACK_TYPE(type) 
  116. (!strcasecmp(type, MP4_HINT_TRACK_TYPE))
  118. #define MP4_IS_SYSTEMS_TRACK_TYPE(type) 
  119. (!strcasecmp(type, MP4_CLOCK_TRACK_TYPE) 
  120. || !strcasecmp(type, MP4_MPEG7_TRACK_TYPE) 
  121. || !strcasecmp(type, MP4_OCI_TRACK_TYPE) 
  122. || !strcasecmp(type, MP4_IPMP_TRACK_TYPE) 
  123. || !strcasecmp(type, MP4_MPEGJ_TRACK_TYPE))
  125. /* MP4 Audio track types - see MP4AddAudioTrack()*/
  126. #define MP4_INVALID_AUDIO_TYPE 0x00
  127. #define MP4_MPEG1_AUDIO_TYPE 0x6B
  128. #define MP4_MPEG2_AUDIO_TYPE 0x69
  129. #define MP4_MP3_AUDIO_TYPE MP4_MPEG2_AUDIO_TYPE
  130. #define MP4_MPEG2_AAC_MAIN_AUDIO_TYPE 0x66
  131. #define MP4_MPEG2_AAC_LC_AUDIO_TYPE 0x67
  132. #define MP4_MPEG2_AAC_SSR_AUDIO_TYPE 0x68
  133. #define MP4_MPEG2_AAC_AUDIO_TYPE MP4_MPEG2_AAC_MAIN_AUDIO_TYPE
  134. #define MP4_MPEG4_AUDIO_TYPE 0x40
  135. #define MP4_PRIVATE_AUDIO_TYPE 0xC0
  136. #define MP4_PCM16_AUDIO_TYPE 0xE0 /* a private definition */
  137. #define MP4_VORBIS_AUDIO_TYPE 0xE1 /* a private definition */
  138. #define MP4_AC3_AUDIO_TYPE 0xE2 /* a private definition */
  140. /* MP4 MPEG-4 Audio types from 14496-3 Table 1.5.1 */
  141. #define MP4_MPEG4_INVALID_AUDIO_TYPE 0
  142. #define MP4_MPEG4_AAC_MAIN_AUDIO_TYPE 1
  143. #define MP4_MPEG4_AAC_LC_AUDIO_TYPE 2
  144. #define MP4_MPEG4_AAC_SSR_AUDIO_TYPE 3
  145. #define MP4_MPEG4_AAC_LTP_AUDIO_TYPE 4
  146. #define MP4_MPEG4_AAC_SCALABLE_AUDIO_TYPE 6
  147. #define MP4_MPEG4_CELP_AUDIO_TYPE 8
  148. #define MP4_MPEG4_HVXC_AUDIO_TYPE 9
  149. #define MP4_MPEG4_TTSI_AUDIO_TYPE 12
  150. #define MP4_MPEG4_MAIN_SYNTHETIC_AUDIO_TYPE 13
  151. #define MP4_MPEG4_WAVETABLE_AUDIO_TYPE 14
  152. #define MP4_MPEG4_MIDI_AUDIO_TYPE 15
  153. #define MP4_MPEG4_ALGORITHMIC_FX_AUDIO_TYPE 16
  155. /* MP4 Audio type utilities following common usage */
  156. #define MP4_IS_MP3_AUDIO_TYPE(type) 
  157. ((type) == MP4_MPEG1_AUDIO_TYPE || (type) == MP4_MPEG2_AUDIO_TYPE) 
  159. #define MP4_IS_MPEG2_AAC_AUDIO_TYPE(type) 
  160. (((type) >= MP4_MPEG2_AAC_MAIN_AUDIO_TYPE 
  161. && (type) <= MP4_MPEG2_AAC_SSR_AUDIO_TYPE))
  163. #define MP4_IS_MPEG4_AAC_AUDIO_TYPE(mpeg4Type) 
  164. (((mpeg4Type) >= MP4_MPEG4_AAC_MAIN_AUDIO_TYPE 
  165. && (mpeg4Type) <= MP4_MPEG4_AAC_LTP_AUDIO_TYPE) 
  166.   || (mpeg4Type) == MP4_MPEG4_AAC_SCALABLE_AUDIO_TYPE)
  168. #define MP4_IS_AAC_AUDIO_TYPE(type) 
  169. (MP4_IS_MPEG2_AAC_AUDIO_TYPE(type) 
  170. || (type) == MP4_MPEG4_AUDIO_TYPE)
  172. /* MP4 Video track types - see MP4AddVideoTrack() */
  173. #define MP4_INVALID_VIDEO_TYPE 0x00
  174. #define MP4_MPEG1_VIDEO_TYPE 0x6A
  175. #define MP4_MPEG2_SIMPLE_VIDEO_TYPE 0x60
  176. #define MP4_MPEG2_MAIN_VIDEO_TYPE 0x61
  177. #define MP4_MPEG2_SNR_VIDEO_TYPE 0x62
  178. #define MP4_MPEG2_SPATIAL_VIDEO_TYPE 0x63
  179. #define MP4_MPEG2_HIGH_VIDEO_TYPE 0x64
  180. #define MP4_MPEG2_442_VIDEO_TYPE 0x65
  181. #define MP4_MPEG2_VIDEO_TYPE MP4_MPEG2_MAIN_VIDEO_TYPE
  182. #define MP4_MPEG4_VIDEO_TYPE 0x20
  183. #define MP4_JPEG_VIDEO_TYPE 0x6C
  184. #define MP4_PRIVATE_VIDEO_TYPE 0xD0
  185. #define MP4_YUV12_VIDEO_TYPE 0xF0 /* a private definition */
  186. #define MP4_H26L_VIDEO_TYPE 0xF1 /* a private definition */
  187. #define MP4_H263_VIDEO_TYPE 0xF2 /* a private definition */
  189. /* MP4 Video type utilities */
  190. #define MP4_IS_MPEG1_VIDEO_TYPE(type) 
  191. ((type) == MP4_MPEG1_VIDEO_TYPE)
  193. #define MP4_IS_MPEG2_VIDEO_TYPE(type) 
  194. (((type) >= MP4_MPEG2_SIMPLE_VIDEO_TYPE 
  195. && (type) <= MP4_MPEG2_442_VIDEO_TYPE) 
  196.   || MP4_IS_MPEG1_VIDEO_TYPE(type))
  198. #define MP4_IS_MPEG4_VIDEO_TYPE(type) 
  199. ((type) == MP4_MPEG4_VIDEO_TYPE)
  202. /* MP4 API declarations */
  204. #ifdef __cplusplus
  205. extern "C" {
  206. #endif
  208. /* file operations */
  210. MP4FileHandle MP4Create(
  211. const char* fileName, 
  212. u_int32_t verbosity DEFAULT(0),
  213. bool use64bits DEFAULT(0),
  214. bool useExtensibleFormat DEFAULT(0));
  216. MP4FileHandle MP4Modify(
  217. const char* fileName, 
  218. u_int32_t verbosity DEFAULT(0),
  219. bool useExtensibleFormat DEFAULT(0));
  221. MP4FileHandle MP4Read(
  222. const char* fileName, 
  223. u_int32_t verbosity DEFAULT(0));
  225. bool MP4Close(
  226. MP4FileHandle hFile);
  228. bool MP4Optimize(
  229. const char* existingFileName, 
  230. const char* newFileName DEFAULT(NULL), 
  231. u_int32_t verbosity DEFAULT(0));
  233. bool MP4Dump(
  234. MP4FileHandle hFile, 
  235. FILE* pDumpFile DEFAULT(NULL), 
  236. bool dumpImplicits DEFAULT(0));
  238. char* MP4Info(
  239. MP4FileHandle hFile, 
  240. MP4TrackId trackId DEFAULT(MP4_INVALID_TRACK_ID));
  242. char* MP4FileInfo(
  243. const char* fileName,
  244. MP4TrackId trackId DEFAULT(MP4_INVALID_TRACK_ID));
  246. /* file properties */
  248. /* specific file properties */
  250. u_int32_t MP4GetVerbosity(MP4FileHandle hFile);
  252. bool MP4SetVerbosity(MP4FileHandle hFile, u_int32_t verbosity);
  254. MP4Duration MP4GetDuration(MP4FileHandle hFile);
  256. u_int32_t MP4GetTimeScale(MP4FileHandle hFile);
  258. bool MP4SetTimeScale(MP4FileHandle hFile, u_int32_t value);
  260. u_int8_t MP4GetODProfileLevel(MP4FileHandle hFile);
  262. bool MP4SetODProfileLevel(MP4FileHandle hFile, u_int8_t value);
  264. u_int8_t MP4GetSceneProfileLevel(MP4FileHandle hFile);
  266. bool MP4SetSceneProfileLevel(MP4FileHandle hFile, u_int8_t value);
  268. u_int8_t MP4GetVideoProfileLevel(MP4FileHandle hFile);
  270. bool MP4SetVideoProfileLevel(MP4FileHandle hFile, u_int8_t value);
  272. u_int8_t MP4GetAudioProfileLevel(MP4FileHandle hFile);
  274. bool MP4SetAudioProfileLevel(MP4FileHandle hFile, u_int8_t value);
  276. u_int8_t MP4GetGraphicsProfileLevel(MP4FileHandle hFile);
  278. bool MP4SetGraphicsProfileLevel(MP4FileHandle hFile, u_int8_t value);
  280. /* generic file properties */
  282. u_int64_t MP4GetIntegerProperty(
  283. MP4FileHandle hFile, 
  284. const char* propName);
  286. float MP4GetFloatProperty(
  287. MP4FileHandle hFile, 
  288. const char* propName);
  290. const char* MP4GetStringProperty(
  291. MP4FileHandle hFile, 
  292. const char* propName);
  294. void MP4GetBytesProperty(
  295. MP4FileHandle hFile, 
  296. const char* propName,
  297. u_int8_t** ppValue, 
  298. u_int32_t* pValueSize);
  300. bool MP4SetIntegerProperty(
  301. MP4FileHandle hFile, 
  302. const char* propName, 
  303. int64_t value);
  305. bool MP4SetFloatProperty(
  306. MP4FileHandle hFile, 
  307. const char* propName, 
  308. float value);
  310. bool MP4SetStringProperty(
  311. MP4FileHandle hFile, const char* propName, const char* value);
  313. bool MP4SetBytesProperty(
  314. MP4FileHandle hFile, const char* propName, 
  315. const u_int8_t* pValue, u_int32_t valueSize);
  317. /* track operations */
  319. MP4TrackId MP4AddTrack(
  320. MP4FileHandle hFile, 
  321. const char* type);
  323. MP4TrackId MP4AddSystemsTrack(
  324. MP4FileHandle hFile, 
  325. const char* type);
  327. MP4TrackId MP4AddODTrack(
  328. MP4FileHandle hFile);
  330. MP4TrackId MP4AddSceneTrack(
  331. MP4FileHandle hFile);
  333. MP4TrackId MP4AddAudioTrack(
  334. MP4FileHandle hFile, 
  335. u_int32_t timeScale, 
  336. MP4Duration sampleDuration,
  337. u_int8_t audioType DEFAULT(MP4_MPEG4_AUDIO_TYPE));
  339. MP4TrackId MP4AddVideoTrack(
  340. MP4FileHandle hFile, 
  341. u_int32_t timeScale, 
  342. MP4Duration sampleDuration,
  343. u_int16_t width, 
  344. u_int16_t height,
  345. u_int8_t videoType DEFAULT(MP4_MPEG4_VIDEO_TYPE));
  347. MP4TrackId MP4AddHintTrack(
  348. MP4FileHandle hFile, 
  349. MP4TrackId refTrackId);
  351. MP4TrackId MP4CloneTrack(
  352. MP4FileHandle srcFile, 
  353. MP4TrackId srcTrackId,
  354. MP4FileHandle dstFile DEFAULT(MP4_INVALID_FILE_HANDLE));
  356. MP4TrackId MP4CopyTrack(
  357. MP4FileHandle srcFile, 
  358. MP4TrackId srcTrackId,
  359. MP4FileHandle dstFile DEFAULT(MP4_INVALID_FILE_HANDLE), 
  360. bool applyEdits DEFAULT(false));
  362. bool MP4DeleteTrack(
  363. MP4FileHandle hFile, 
  364. MP4TrackId trackId);
  366. u_int32_t MP4GetNumberOfTracks(
  367. MP4FileHandle hFile, 
  368. const char* type DEFAULT(NULL),
  369. u_int8_t subType DEFAULT(0));
  371. MP4TrackId MP4FindTrackId(
  372. MP4FileHandle hFile, 
  373. u_int16_t index, 
  374. const char* type DEFAULT(NULL),
  375. u_int8_t subType DEFAULT(0));
  377. u_int16_t MP4FindTrackIndex(
  378. MP4FileHandle hFile, 
  379. MP4TrackId trackId);
  381. /* track properties */
  383. /* specific track properties */
  385. const char* MP4GetTrackType(
  386. MP4FileHandle hFile, 
  387. MP4TrackId trackId);
  389. MP4Duration MP4GetTrackDuration(
  390. MP4FileHandle hFile, 
  391. MP4TrackId trackId);
  393. u_int32_t MP4GetTrackTimeScale(
  394. MP4FileHandle hFile, 
  395. MP4TrackId trackId);
  397. bool MP4SetTrackTimeScale(
  398. MP4FileHandle hFile, 
  399. MP4TrackId trackId, 
  400. u_int32_t value);
  402. u_int8_t MP4GetTrackAudioType(
  403. MP4FileHandle hFile, 
  404. MP4TrackId trackId);
  406. u_int8_t MP4GetTrackAudioMpeg4Type(
  407. MP4FileHandle hFile, 
  408. MP4TrackId trackId);
  410. u_int8_t MP4GetTrackVideoType(
  411. MP4FileHandle hFile, 
  412. MP4TrackId trackId);
  414. /* returns MP4_INVALID_DURATION if track samples do not have a fixed duration */
  415. MP4Duration MP4GetTrackFixedSampleDuration(
  416. MP4FileHandle hFile, 
  417. MP4TrackId trackId);
  419. u_int32_t MP4GetTrackBitRate(
  420. MP4FileHandle hFile, 
  421. MP4TrackId trackId);
  423. void MP4GetTrackESConfiguration(
  424. MP4FileHandle hFile, 
  425. MP4TrackId trackId, 
  426. u_int8_t** ppConfig, 
  427. u_int32_t* pConfigSize);
  429. bool MP4SetTrackESConfiguration(
  430. MP4FileHandle hFile, 
  431. MP4TrackId trackId, 
  432. const u_int8_t* pConfig, 
  433. u_int32_t configSize);
  435. MP4SampleId MP4GetTrackNumberOfSamples(
  436. MP4FileHandle hFile, 
  437. MP4TrackId trackId);
  439. u_int16_t MP4GetTrackVideoWidth(
  440. MP4FileHandle hFile, 
  441. MP4TrackId trackId);
  443. u_int16_t MP4GetTrackVideoHeight(
  444. MP4FileHandle hFile, 
  445. MP4TrackId trackId);
  447. float MP4GetTrackVideoFrameRate(
  448. MP4FileHandle hFile, 
  449. MP4TrackId trackId);
  451. /* generic track properties */
  453. u_int64_t MP4GetTrackIntegerProperty(
  454. MP4FileHandle hFile, 
  455. MP4TrackId trackId, 
  456. const char* propName);
  458. float MP4GetTrackFloatProperty(
  459. MP4FileHandle hFile, 
  460. MP4TrackId trackId, 
  461. const char* propName);
  463. const char* MP4GetTrackStringProperty(
  464. MP4FileHandle hFile, 
  465. MP4TrackId trackId, 
  466. const char* propName);
  468. void MP4GetTrackBytesProperty(
  469. MP4FileHandle hFile, 
  470. MP4TrackId trackId, 
  471. const char* propName,
  472. u_int8_t** ppValue, 
  473. u_int32_t* pValueSize);
  475. bool MP4SetTrackIntegerProperty(
  476. MP4FileHandle hFile, 
  477. MP4TrackId trackId, 
  478. const char* propName, 
  479. int64_t value);
  481. bool MP4SetTrackFloatProperty(
  482. MP4FileHandle hFile, 
  483. MP4TrackId trackId, 
  484. const char* propName, 
  485. float value);
  487. bool MP4SetTrackStringProperty(
  488. MP4FileHandle hFile, 
  489. MP4TrackId trackId, 
  490. const char* propName, 
  491. const char* value);
  493. bool MP4SetTrackBytesProperty(
  494. MP4FileHandle hFile, 
  495. MP4TrackId trackId, 
  496. const char* propName, 
  497. const u_int8_t* pValue, 
  498. u_int32_t valueSize);
  500. /* sample operations */
  502. bool MP4ReadSample(
  503. /* input parameters */
  504. MP4FileHandle hFile,
  505. MP4TrackId trackId, 
  506. MP4SampleId sampleId,
  507. /* input/output parameters */
  508. u_int8_t** ppBytes, 
  509. u_int32_t* pNumBytes, 
  510. /* output parameters */
  511. MP4Timestamp* pStartTime DEFAULT(NULL), 
  512. MP4Duration* pDuration DEFAULT(NULL),
  513. MP4Duration* pRenderingOffset DEFAULT(NULL), 
  514. bool* pIsSyncSample DEFAULT(NULL));
  516. /* uses (unedited) time to specify sample instead of sample id */
  517. bool MP4ReadSampleFromTime(
  518. /* input parameters */
  519. MP4FileHandle hFile,
  520. MP4TrackId trackId, 
  521. MP4Timestamp when,
  522. /* input/output parameters */
  523. u_int8_t** ppBytes, 
  524. u_int32_t* pNumBytes, 
  525. /* output parameters */
  526. MP4Timestamp* pStartTime DEFAULT(NULL), 
  527. MP4Duration* pDuration DEFAULT(NULL),
  528. MP4Duration* pRenderingOffset DEFAULT(NULL), 
  529. bool* pIsSyncSample DEFAULT(NULL));
  531. bool MP4WriteSample(
  532. MP4FileHandle hFile,
  533. MP4TrackId trackId,
  534. u_int8_t* pBytes, 
  535. u_int32_t numBytes,
  536. MP4Duration duration DEFAULT(MP4_INVALID_DURATION),
  537. MP4Duration renderingOffset DEFAULT(0), 
  538. bool isSyncSample DEFAULT(true));
  540. bool MP4CopySample(
  541. MP4FileHandle srcFile,
  542. MP4TrackId srcTrackId, 
  543. MP4SampleId srcSampleId,
  544. MP4FileHandle dstFile DEFAULT(MP4_INVALID_FILE_HANDLE),
  545. MP4TrackId dstTrackId DEFAULT(MP4_INVALID_TRACK_ID),
  546. MP4Duration dstSampleDuration DEFAULT(MP4_INVALID_DURATION));
  548. /* Note this function is not yet implemented */
  549. bool MP4ReferenceSample(
  550. MP4FileHandle srcFile,
  551. MP4TrackId srcTrackId, 
  552. MP4SampleId srcSampleId,
  553. MP4FileHandle dstFile,
  554. MP4TrackId dstTrackId,
  555. MP4Duration dstSampleDuration DEFAULT(MP4_INVALID_DURATION));
  557. u_int32_t MP4GetSampleSize(
  558. MP4FileHandle hFile,
  559. MP4TrackId trackId, 
  560. MP4SampleId sampleId);
  562. u_int32_t MP4GetTrackMaxSampleSize(
  563. MP4FileHandle hFile,
  564. MP4TrackId trackId); 
  566. MP4SampleId MP4GetSampleIdFromTime(
  567. MP4FileHandle hFile,
  568. MP4TrackId trackId, 
  569. MP4Timestamp when, 
  570. bool wantSyncSample DEFAULT(false));
  572. MP4Timestamp MP4GetSampleTime(
  573. MP4FileHandle hFile,
  574. MP4TrackId trackId, 
  575. MP4SampleId sampleId);
  577. MP4Duration MP4GetSampleDuration(
  578. MP4FileHandle hFile,
  579. MP4TrackId trackId, 
  580. MP4SampleId sampleId);
  582. MP4Duration MP4GetSampleRenderingOffset(
  583. MP4FileHandle hFile,
  584. MP4TrackId trackId, 
  585. MP4SampleId sampleId);
  587. bool MP4SetSampleRenderingOffset(
  588. MP4FileHandle hFile,
  589. MP4TrackId trackId, 
  590. MP4SampleId sampleId,
  591. MP4Duration renderingOffset);
  593. int8_t MP4GetSampleSync(
  594. MP4FileHandle hFile,
  595. MP4TrackId trackId, 
  596. MP4SampleId sampleId);
  598. /* rtp hint track operations */
  600. bool MP4GetHintTrackRtpPayload(
  601. MP4FileHandle hFile,
  602. MP4TrackId hintTrackId,
  603. char** ppPayloadName DEFAULT(NULL),
  604. u_int8_t* pPayloadNumber DEFAULT(NULL),
  605. u_int16_t* pMaxPayloadSize DEFAULT(NULL));
  607. bool MP4SetHintTrackRtpPayload(
  608. MP4FileHandle hFile,
  609. MP4TrackId hintTrackId,
  610. const char* pPayloadName,
  611. u_int8_t* pPayloadNumber,
  612. u_int16_t maxPayloadSize DEFAULT(0));
  614. const char* MP4GetSessionSdp(
  615. MP4FileHandle hFile);
  617. bool MP4SetSessionSdp(
  618. MP4FileHandle hFile,
  619. const char* sdpString);
  621. bool MP4AppendSessionSdp(
  622. MP4FileHandle hFile,
  623. const char* sdpString);
  625. const char* MP4GetHintTrackSdp(
  626. MP4FileHandle hFile,
  627. MP4TrackId hintTrackId);
  629. bool MP4SetHintTrackSdp(
  630. MP4FileHandle hFile,
  631. MP4TrackId hintTrackId,
  632. const char* sdpString);
  634. bool MP4AppendHintTrackSdp(
  635. MP4FileHandle hFile,
  636. MP4TrackId hintTrackId,
  637. const char* sdpString);
  639. MP4TrackId MP4GetHintTrackReferenceTrackId(
  640. MP4FileHandle hFile,
  641. MP4TrackId hintTrackId);
  643. bool MP4ReadRtpHint(
  644. MP4FileHandle hFile,
  645. MP4TrackId hintTrackId,
  646. MP4SampleId hintSampleId,
  647. u_int16_t* pNumPackets DEFAULT(NULL));
  649. u_int16_t MP4GetRtpHintNumberOfPackets(
  650. MP4FileHandle hFile,
  651. MP4TrackId hintTrackId);
  653. int8_t MP4GetRtpPacketBFrame(
  654. MP4FileHandle hFile,
  655. MP4TrackId hintTrackId,
  656. u_int16_t packetIndex);
  658. int32_t MP4GetRtpPacketTransmitOffset(
  659. MP4FileHandle hFile,
  660. MP4TrackId hintTrackId,
  661. u_int16_t packetIndex);
  663. bool MP4ReadRtpPacket(
  664. MP4FileHandle hFile,
  665. MP4TrackId hintTrackId,
  666. u_int16_t packetIndex,
  667. u_int8_t** ppBytes, 
  668. u_int32_t* pNumBytes,
  669. u_int32_t ssrc DEFAULT(0),
  670. bool includeHeader DEFAULT(true),
  671. bool includePayload DEFAULT(true));
  673. MP4Timestamp MP4GetRtpTimestampStart(
  674. MP4FileHandle hFile,
  675. MP4TrackId hintTrackId);
  677. bool MP4SetRtpTimestampStart(
  678. MP4FileHandle hFile,
  679. MP4TrackId hintTrackId,
  680. MP4Timestamp rtpStart);
  682. bool MP4AddRtpHint(
  683. MP4FileHandle hFile,
  684. MP4TrackId hintTrackId);
  686. bool MP4AddRtpVideoHint(
  687. MP4FileHandle hFile,
  688. MP4TrackId hintTrackId,
  689. bool isBframe DEFAULT(false), 
  690. u_int32_t timestampOffset DEFAULT(0));
  692. bool MP4AddRtpPacket(
  693. MP4FileHandle hFile,
  694. MP4TrackId hintTrackId,
  695. bool setMbit DEFAULT(false),
  696. int32_t transmitOffset DEFAULT(0));
  698. bool MP4AddRtpImmediateData(
  699. MP4FileHandle hFile,
  700. MP4TrackId hintTrackId,
  701. const u_int8_t* pBytes,
  702. u_int32_t numBytes);
  704. bool MP4AddRtpSampleData(
  705. MP4FileHandle hFile,
  706. MP4TrackId hintTrackId,
  707. MP4SampleId sampleId,
  708. u_int32_t dataOffset,
  709. u_int32_t dataLength);
  711. bool MP4AddRtpESConfigurationPacket(
  712. MP4FileHandle hFile,
  713. MP4TrackId hintTrackId);
  715. bool MP4WriteRtpHint(
  716. MP4FileHandle hFile,
  717. MP4TrackId hintTrackId,
  718. MP4Duration duration,
  719. bool isSyncSample DEFAULT(true));
  721. /* ISMA specific utilities */
  723. bool MP4MakeIsmaCompliant(const char* fileName, 
  724. u_int32_t verbosity DEFAULT(0),
  725. bool addIsmaComplianceSdp DEFAULT(true));
  727. char* MP4MakeIsmaSdpIod(
  728. u_int8_t videoProfile,
  729. u_int32_t videoBitrate,
  730. u_int8_t* videoConfig,
  731. u_int32_t videoConfigLength,
  732. u_int8_t audioProfile,
  733. u_int32_t audioBitrate,
  734. u_int8_t* audioConfig,
  735. u_int32_t audioConfigLength,
  736. u_int32_t verbosity DEFAULT(0));
  738. /* edit list */
  740. /* NOTE this section of functionality 
  741.  * has not yet been fully tested 
  742.  */
  744. MP4EditId MP4AddTrackEdit(
  745. MP4FileHandle hFile,
  746. MP4TrackId trackId,
  747. MP4EditId editId DEFAULT(MP4_INVALID_EDIT_ID),
  748. MP4Timestamp startTime DEFAULT(0),
  749. MP4Duration duration DEFAULT(0),
  750. bool dwell DEFAULT(false));
  752. bool MP4DeleteTrackEdit(
  753. MP4FileHandle hFile,
  754. MP4TrackId trackId,
  755. MP4EditId editId);
  757. u_int32_t MP4GetTrackNumberOfEdits(
  758. MP4FileHandle hFile,
  759. MP4TrackId trackId);
  761. MP4Timestamp MP4GetTrackEditStart(
  762. MP4FileHandle hFile,
  763. MP4TrackId trackId,
  764. MP4EditId editId);
  766. MP4Duration MP4GetTrackEditTotalDuration(
  767. MP4FileHandle hFile,
  768. MP4TrackId trackId,
  769. MP4EditId editId DEFAULT(MP4_INVALID_EDIT_ID));
  771. MP4Timestamp MP4GetTrackEditMediaStart(
  772. MP4FileHandle hFile,
  773. MP4TrackId trackId,
  774. MP4EditId editId);
  776. bool MP4SetTrackEditMediaStart(
  777. MP4FileHandle hFile,
  778. MP4TrackId trackId,
  779. MP4EditId editId,
  780. MP4Timestamp startTime);
  782. MP4Duration MP4GetTrackEditDuration(
  783. MP4FileHandle hFile,
  784. MP4TrackId trackId,
  785. MP4EditId editId);
  787. bool MP4SetTrackEditDuration(
  788. MP4FileHandle hFile,
  789. MP4TrackId trackId,
  790. MP4EditId editId,
  791. MP4Duration duration);
  793. int8_t MP4GetTrackEditDwell(
  794. MP4FileHandle hFile,
  795. MP4TrackId trackId,
  796. MP4EditId editId);
  798. bool MP4SetTrackEditDwell(
  799. MP4FileHandle hFile,
  800. MP4TrackId trackId,
  801. MP4EditId editId,
  802. bool dwell);
  804. bool MP4ReadSampleFromEditTime(
  805. /* input parameters */
  806. MP4FileHandle hFile,
  807. MP4TrackId trackId, 
  808. MP4Timestamp when, 
  809. /* input/output parameters */
  810. u_int8_t** ppBytes, 
  811. u_int32_t* pNumBytes, 
  812. /* output parameters */
  813. MP4Timestamp* pStartTime DEFAULT(NULL), 
  814. MP4Duration* pDuration DEFAULT(NULL),
  815. MP4Duration* pRenderingOffset DEFAULT(NULL), 
  816. bool* pIsSyncSample DEFAULT(NULL));
  818. MP4SampleId MP4GetSampleIdFromEditTime(
  819. MP4FileHandle hFile,
  820. MP4TrackId trackId, 
  821. MP4Timestamp when, 
  822. MP4Timestamp* pStartTime DEFAULT(NULL), 
  823. MP4Duration* pDuration DEFAULT(NULL));
  825. /* time conversion utilties */
  827. /* predefined values for timeScale parameter below */
  828. #define MP4_SECONDS_TIME_SCALE 1
  829. #define MP4_MILLISECONDS_TIME_SCALE 1000
  830. #define MP4_MICROSECONDS_TIME_SCALE 1000000
  831. #define MP4_NANOSECONDS_TIME_SCALE  1000000000
  833. #define MP4_SECS_TIME_SCALE  MP4_SECONDS_TIME_SCALE
  834. #define MP4_MSECS_TIME_SCALE MP4_MILLISECONDS_TIME_SCALE
  835. #define MP4_USECS_TIME_SCALE MP4_MICROSECONDS_TIME_SCALE
  836. #define MP4_NSECS_TIME_SCALE MP4_NANOSECONDS_TIME_SCALE
  838. u_int64_t MP4ConvertFromMovieDuration(
  839. MP4FileHandle hFile,
  840. MP4Duration duration,
  841. u_int32_t timeScale);
  843. u_int64_t MP4ConvertFromTrackTimestamp(
  844. MP4FileHandle hFile,
  845. MP4TrackId trackId, 
  846. MP4Timestamp timeStamp,
  847. u_int32_t timeScale);
  849. MP4Timestamp MP4ConvertToTrackTimestamp(
  850. MP4FileHandle hFile,
  851. MP4TrackId trackId, 
  852. u_int64_t timeStamp,
  853. u_int32_t timeScale);
  855. u_int64_t MP4ConvertFromTrackDuration(
  856. MP4FileHandle hFile,
  857. MP4TrackId trackId, 
  858. MP4Duration duration,
  859. u_int32_t timeScale);
  861. MP4Duration MP4ConvertToTrackDuration(
  862. MP4FileHandle hFile,
  863. MP4TrackId trackId, 
  864. u_int64_t duration,
  865. u_int32_t timeScale);
  867. char* MP4BinaryToBase16(
  868. const u_int8_t* pData, 
  869. u_int32_t dataSize);
  871. char* MP4BinaryToBase64(
  872. const u_int8_t* pData, 
  873. u_int32_t dataSize);
  875. #ifdef __cplusplus
  876. }
  877. #endif
  879. /* undefined our utlity macro to avoid conflicts */
  880. #undef DEFAULT
  882. #endif /* __MP4_INCLUDED__ */