| blob | 8b0ad9a64f9db92f107037bca1d93a9541903cf3 |
1 /*****************************************************************************
2 * lsmash.h:
3 *****************************************************************************
4 * Copyright (C) 2010-2014 L-SMASH project
5 *
6 * Authors: Yusuke Nakamura <muken.the.vfrmaniac@gmail.com>
7 *
8 * Permission to use, copy, modify, and/or distribute this software for any
9 * purpose with or without fee is hereby granted, provided that the above
10 * copyright notice and this permission notice appear in all copies.
11 *
12 * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
13 * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
14 * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
15 * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
16 * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
17 * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
18 * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
19 *****************************************************************************/
21 /* This file is available under an ISC license. */
23 #ifndef LSMASH_H
24 #define LSMASH_H
26 #include <stddef.h>
27 #include <stdint.h>
31 #define LSMASH_4CC( a, b, c, d ) (((a)<<24) | ((b)<<16) | ((c)<<8) | (d))
33 /****************************************************************************
34 * Version
35 ****************************************************************************/
36 #define LSMASH_VERSION_MAJOR 2
37 #define LSMASH_VERSION_MINOR 2
38 #define LSMASH_VERSION_MICRO 15
40 #define LSMASH_VERSION_INT( a, b, c ) (((a) << 16) | ((b) << 8) | (c))
42 /****************************************************************************
43 * Error Values
44 ****************************************************************************/
45 enum
46 {
53 };
55 /****************************************************************************
56 * ROOT
57 * The top-level opaque handler for whole file handling.
58 ****************************************************************************/
61 /* Allocate a ROOT.
62 * The allocated ROOT can be deallocate by lsmash_destroy_root().
63 *
64 * Return the address of an allocated ROOT if successful.
65 * Return NULL otherwise. */
68 /* Deallocate a given ROOT. */
69 void lsmash_destroy_root
70 (
72 );
74 /****************************************************************************
75 * File Layer
76 ****************************************************************************/
80 {
90 LSMASH_FILE_MODE_WRITE_FRAGMENTED = LSMASH_FILE_MODE_WRITE | LSMASH_FILE_MODE_FRAGMENTED, /* deprecated */
94 {
96 ISOM_BRAND_TYPE_3GE6 = LSMASH_4CC( '3', 'g', 'e', '6' ), /* 3GPP Release 6 Extended Presentation Profile */
97 ISOM_BRAND_TYPE_3GE9 = LSMASH_4CC( '3', 'g', 'e', '9' ), /* 3GPP Release 9 Extended Presentation Profile */
98 ISOM_BRAND_TYPE_3GF9 = LSMASH_4CC( '3', 'g', 'f', '9' ), /* 3GPP Release 9 File-delivery Server Profile */
101 ISOM_BRAND_TYPE_3GH9 = LSMASH_4CC( '3', 'g', 'h', '9' ), /* 3GPP Release 9 Adaptive Streaming Profile */
102 ISOM_BRAND_TYPE_3GM9 = LSMASH_4CC( '3', 'g', 'm', '9' ), /* 3GPP Release 9 Media Segment Profile */
109 ISOM_BRAND_TYPE_3GR6 = LSMASH_4CC( '3', 'g', 'r', '6' ), /* 3GPP Release 6 Progressive Download Profile */
110 ISOM_BRAND_TYPE_3GR9 = LSMASH_4CC( '3', 'g', 'r', '9' ), /* 3GPP Release 9 Progressive Download Profile */
111 ISOM_BRAND_TYPE_3GS6 = LSMASH_4CC( '3', 'g', 's', '6' ), /* 3GPP Release 6 Streaming Server Profile */
112 ISOM_BRAND_TYPE_3GS9 = LSMASH_4CC( '3', 'g', 's', '9' ), /* 3GPP Release 9 Streaming Server Profile */
113 ISOM_BRAND_TYPE_3GT9 = LSMASH_4CC( '3', 'g', 't', '9' ), /* 3GPP Release 9 Media Stream Recording Profile */
118 ISOM_BRAND_TYPE_M4A = LSMASH_4CC( 'M', '4', 'A', ' ' ), /* iTunes MPEG-4 audio protected or not */
122 ISOM_BRAND_TYPE_MFSM = LSMASH_4CC( 'M', 'F', 'S', 'M' ), /* Media File for Samsung video Metadata */
123 ISOM_BRAND_TYPE_MPPI = LSMASH_4CC( 'M', 'P', 'P', 'I' ), /* Photo Player Multimedia Application Format */
137 ISOM_BRAND_TYPE_DASH = LSMASH_4CC( 'd', 'a', 's', 'h' ), /* Indexed self-initializing Media Segment */
150 ISOM_BRAND_TYPE_ISC2 = LSMASH_4CC( 'i', 's', 'c', '2' ), /* Files encrypted according to ISMACryp 2.0 */
151 ISOM_BRAND_TYPE_ISO2 = LSMASH_4CC( 'i', 's', 'o', '2' ), /* ISO Base Media file format version 2 */
152 ISOM_BRAND_TYPE_ISO3 = LSMASH_4CC( 'i', 's', 'o', '3' ), /* ISO Base Media file format version 3 */
153 ISOM_BRAND_TYPE_ISO4 = LSMASH_4CC( 'i', 's', 'o', '4' ), /* ISO Base Media file format version 4 */
154 ISOM_BRAND_TYPE_ISO5 = LSMASH_4CC( 'i', 's', 'o', '5' ), /* ISO Base Media file format version 5 */
155 ISOM_BRAND_TYPE_ISO6 = LSMASH_4CC( 'i', 's', 'o', '6' ), /* ISO Base Media file format version 6 */
156 ISOM_BRAND_TYPE_ISO7 = LSMASH_4CC( 'i', 's', 'o', '7' ), /* ISO Base Media file format version 7 */
157 ISOM_BRAND_TYPE_ISOM = LSMASH_4CC( 'i', 's', 'o', 'm' ), /* ISO Base Media file format version 1 */
158 ISOM_BRAND_TYPE_JPSI = LSMASH_4CC( 'j', 'p', 's', 'i' ), /* The JPSearch data interchange format */
161 ISOM_BRAND_TYPE_MJP2 = LSMASH_4CC( 'm', 'j', 'p', '2' ), /* Motion JPEG 2000, general profile */
173 ISOM_BRAND_TYPE_PIFF = LSMASH_4CC( 'p', 'i', 'f', 'f' ), /* Protected Interoperable File Format */
184 {
186 /** custom I/O stuff **/
188 /* Attempt to read up to 'size' bytes from the file referenced by 'opaque' into the buffer starting at 'buf'.
189 *
190 * Return the number of bytes read if successful.
191 * Return 0 if no more read.
192 * Return a negative value otherwise. */
194 (
197 int size
198 );
199 /* Write up to 'size' bytes to the file referenced by 'opaque' from the buffer starting at 'buf'.
200 *
201 * Return the number of bytes written if successful.
202 * Return a negative value otherwise. */
204 (
207 int size
208 );
209 /* Change the location of the read/write pointer of 'opaque'.
210 * The offset of the pointer is determined according to the directive 'whence' as follows:
211 * If 'whence' is set to SEEK_SET, the offset is set to 'offset' bytes.
212 * If 'whence' is set to SEEK_CUR, the offset is set to its current location plus 'offset' bytes.
213 * If 'whence' is set to SEEK_END, the offset is set to the size of the file plus 'offset' bytes.
214 *
215 * Return the resulting offset of the location in bytes from the beginning of the file if successful.
216 * Return a negative value otherwise. */
218 (
221 int whence
222 );
223 /** file types or segment types **/
228 * minor_version is informative only i.e. not specifying requirements but merely providing information.
229 * It must not be used to determine the conformance of a file to a standard. */
230 /** muxing only **/
232 double max_async_tolerance; /* max tolerance, in seconds, for amount of interleaving asynchronization between tracks.
233 * 2.0 is default value. At least twice of max_chunk_duration is used. */
234 uint64_t max_chunk_size; /* max size per chunk in bytes. 4*1024*1024 (4MiB) is default value. */
235 /** demuxing only **/
236 uint64_t max_read_size; /* max size of reading from the file at a time. 4*1024*1024 (4MiB) is default value. */
241 {
243 lsmash_adhoc_remux_callback func;
247 /* Open a file where the path is given.
248 * And if successful, set up the parameters by 'open_mode'.
249 * Here, the 'open_mode' parameter is either 0 or 1 as follows:
250 * 0: Create a file for output/muxing operations.
251 * If a file with the same name already exists, its contents are discarded and the file is treated as a new file.
252 * If user specifies "-" for 'filename', operations are done on stdout.
253 * The file types or segment types are set up as specified in 'param'.
254 * 1: Open a file for input/demuxing operations. The file must exist.
255 * If user specifies "-" for 'filename', operations are done on stdin.
256 *
257 * This function sets up file modes minimally.
258 * User can add additional modes and/or remove modes already set later.
259 * The other parameters except for the custom I/O stuff are set to a default.
260 * User shall not touch the custom I/O stuff for the opened file if using this function.
261 *
262 * The opened file can be closed by lsmash_close_file().
263 *
264 * Note:
265 * 'filename' must be encoded by UTF-8 if 'open_mode' is equal to 0.
266 * On Windows, lsmash_convert_ansi_to_utf8() may help you.
267 *
268 * Return 0 if successful.
269 * Return a negative value otherwise. */
270 int lsmash_open_file
271 (
274 lsmash_file_parameters_t *param
275 );
277 /* Close a file opened by lsmash_open_file().
278 *
279 * Return 0 if successful.
280 * Return a negative value otherwise. */
281 int lsmash_close_file
282 (
283 lsmash_file_parameters_t *param
284 );
286 /* Associate a file with a ROOT and allocate the handle of that file.
287 * The all allocated handles can be deallocated by lsmash_destroy_root().
288 * If the ROOT has no associated file yet, the first associated file is activated.
289 *
290 * Return the address of the allocated handle of the added file if successful.
291 * Return NULL otherwise. */
292 lsmash_file_t *lsmash_set_file
293 (
295 lsmash_file_parameters_t *param
296 );
298 /* Read whole boxes in a given file.
299 * You can also get file modes and file types or segment types by this function.
300 *
301 * Return the file size (if seekable) or 0 if successful.
302 * Return a negative value otherwise. */
303 int64_t lsmash_read_file
304 (
306 lsmash_file_parameters_t *param
307 );
309 /* Deallocate all boxes within the current active file in a given ROOT. */
310 void lsmash_discard_boxes
311 (
312 lsmash_root_t *root /* the address of a ROOT you want to deallocate all boxes within the active file in it */
313 );
315 /* Activate a file associated with a ROOT.
316 *
317 * Return 0 if successful.
318 * Return a negative value otherwise. */
319 int lsmash_activate_file
320 (
322 lsmash_file_t *file
323 );
325 /* Switch from the current segment file to the following media segment file.
326 * After switching, the followed segment file can be closed unless that file is an initialization segment.
327 *
328 * The first followed segment file must be also an initialization segment.
329 * The second or later segment files must not be an initialization segment.
330 * For media segment files flagging LSMASH_FILE_MODE_INDEX, 'remux' must be set.
331 *
332 * Users shall call lsmash_flush_pooled_samples() for each track before calling this function.
333 *
334 * Return 0 if successful.
335 * Return a negative value otherwise. */
336 int lsmash_switch_media_segment
337 (
340 lsmash_adhoc_remux_t *remux
341 );
343 /****************************************************************************
344 * Basic Types
345 ****************************************************************************/
346 /* rational types */
348 {
354 {
360 {
365 /****************************************************************************
366 * Allocation
367 ****************************************************************************/
368 /* Allocate a memory block.
369 * The allocated memory block can be deallocate by lsmash_free().
370 *
371 * Return the address to the beginning of a memory block if successful.
372 * Return NULL otherwise. */
374 (
376 );
378 /* Allocate a memory block.
379 * The allocated memory block shall be initialized to all bits 0.
380 * The allocated memory block can be deallocate by lsmash_free().
381 *
382 * Return the address to the beginning of a memory block if successful.
383 * Return NULL otherwise. */
385 (
387 );
389 /* Reallocate a memory block.
390 * The reallocated memory block can be deallocate by lsmash_free().
391 * If this function succeed, the given memory block is deallocated and the address is invalid.
392 * If this function fails, the address to the given memory block is still valid and the memory block is unchanged.
393 *
394 * Return the address to the beginning of a memory block if successful.
395 * Return NULL otherwise. */
397 (
399 * lsmash_malloc(), lsmash_malloc_zero(), lsmash_realloc() or lsmash_memdup()
400 * Alternatively, NULL makes this function to allocate a new memory block. */
402 );
404 /* Allocate a memory block and copy all bits from a given memory block.
405 * The allocated memory block can be deallocate by lsmash_free().
406 *
407 * Return the address to the beginning of an allocated memory block if successful.
408 * Return NULL otherwise. */
410 (
413 );
415 /* Deallocate a given memory block.
416 * If the given address to a memory block is NULL, this function does nothing. */
417 void lsmash_free
418 (
420 * lsmash_malloc(), lsmash_malloc_zero(), lsmash_realloc() or lsmash_memdup() */
421 );
423 /* Deallocate a given memory block.
424 * If the given address to a memory block is NULL, this function does nothing.
425 * Set NULL to the pointer to the memory block after deallocating.
426 *
427 * As an example of usage.
428 * Let's say you allocate a memory block and set the address to the beginning of it to the pointer 'ptr'.
429 * You can deallocate the memory block and set NULL to 'ptr' by lsmash_freep( &ptr ).
430 */
431 void lsmash_freep
432 (
434 * lsmash_malloc(), lsmash_malloc_zero(), lsmash_realloc() or lsmash_memdup() */
435 );
437 /****************************************************************************
438 * Box
439 ****************************************************************************/
443 /* An UUID structure for extended box type */
445 {
447 * If the box is not a UUID box, this field shall be the same as the box type.
448 * Note: characters in this field aren't always printable. */
449 uint8_t id[12]; /* If the box is not a UUID box, this field shall be set to 12-byte ISO reserved value
450 * { 0x00, 0x11, 0x00, 0x10, 0x80, 0x00, 0x00, 0xAA, 0x00, 0x38, 0x9B, 0x71 }
451 * and shall not be written into the stream together with above-defined four characters codes.
452 * As an exception, we could set the value
453 * { 0x0F, 0x11, 0x4D, 0xA5, 0xBF, 0x4E, 0xF2, 0xC4, 0x8C, 0x6A, 0xA1, 0x1E }
454 * to indicate the box is derived from QuickTime file format. */
458 {
460 * Note: characters in this field aren't always printable. */
462 /* If 'fourcc' doesn't equal 'uuid', ignore this field. */
466 {
468 uint32_t number; /* the number of box in ascending order excluding boxes unspecified by 'type' within
469 * the same level of the box nested structure. */
472 #define LSMASH_BOX_TYPE_INITIALIZER { 0x00000000, { 0x00000000, { 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00 } } }
473 #define LSMASH_BOX_TYPE_UNSPECIFIED static_lsmash_box_type_unspecified
474 static const lsmash_box_type_t static_lsmash_box_type_unspecified = LSMASH_BOX_TYPE_INITIALIZER;
476 /* Return extended box type that consists of combination of given FourCC and 12-byte ID. */
477 lsmash_extended_box_type_t lsmash_form_extended_box_type
478 (
481 );
483 /* Return box type that consists of combination of given compact and extended box type. */
484 lsmash_box_type_t lsmash_form_box_type
485 (
486 lsmash_compact_box_type_t type,
487 lsmash_extended_box_type_t user
488 );
490 #define LSMASH_ISO_BOX_TYPE_INITIALIZER( x ) { x, { x, { 0x00, 0x11, 0x00, 0x10, 0x80, 0x00, 0x00, 0xAA, 0x00, 0x38, 0x9B, 0x71 } } }
491 #define LSMASH_QTFF_BOX_TYPE_INITIALIZER( x ) { x, { x, { 0x0F, 0x11, 0x4D, 0xA5, 0xBF, 0x4E, 0xF2, 0xC4, 0x8C, 0x6A, 0xA1, 0x1E } } }
495 /* precedence of the box position
496 * Box with higher value will precede physically other boxes with lower one.
497 * The lower 32-bits are intended to determine order of boxes with the same box type. */
505 /* Check if the type of two boxes is identical or not.
506 *
507 * Return 1 if the both box types are identical.
508 * Return 0 otherwise. */
509 int lsmash_check_box_type_identical
510 (
511 lsmash_box_type_t a,
512 lsmash_box_type_t b
513 );
515 /* Check if the type of a given box is already specified or not.
516 *
517 * Return 1 if the box type is specified.
518 * Return 0 otherwise, i.e. LSMASH_BOX_TYPE_UNSPECIFIED. */
519 int lsmash_check_box_type_specified
520 (
522 );
524 /* Allocate a box.
525 * The allocated box can be deallocated by lsmash_destroy_box().
526 *
527 * Return the address of an allocated box if successful.
528 * Return NULL otherwise. */
529 lsmash_box_t *lsmash_create_box
530 (
531 lsmash_box_type_t type,
534 uint64_t precedence
535 );
537 /* Get a box under a given 'parent' box.
538 * The path of a box must be terminated by LSMASH_BOX_TYPE_UNSPECIFIED.
539 *
540 * Return the address of the box specified by 'box_path'.
541 * Return NULL otherwise. */
542 lsmash_box_t *lsmash_get_box
543 (
546 );
548 /* Add a box into 'parent' box as a child box.
549 *
550 * Return 0 if successful.
551 * Return a negative value otherwise. */
552 int lsmash_add_box
553 (
555 lsmash_box_t *box
556 );
558 /* Add a box into 'parent' box as a child box.
559 * If the adding child box is known and its children (if any) are known, expand them into known
560 * struct formats for the internal references within the L-SMASH library.
561 * If this function succeed, the adding child box is deallocated and the address is invalid.
562 * Instead of that, this function replaces the invalid address with the valid one of the new
563 * allocated memory block representing the added and expanded child box.
564 *
565 * Return 0 if successful.
566 * Return a negative value otherwise. */
567 int lsmash_add_box_ex
568 (
570 lsmash_box_t **box
571 );
573 /* Deallocate a given box and its children. */
574 void lsmash_destroy_box
575 (
576 lsmash_box_t *box
577 );
579 /* Deallocate all children of a given box. */
580 void lsmash_destroy_children
581 (
582 lsmash_box_t *box
583 );
585 /* Get the precedence of a given box.
586 *
587 * Return 0 if successful.
588 * Return a negative value otherwise. */
589 int lsmash_get_box_precedence
590 (
593 );
595 /* This function allows you to handle a ROOT as if it is a box.
596 * Of course, you can deallocate the ROOT by lsmash_destroy_box().
597 *
598 * Return the address of a given ROOT as a box. */
599 lsmash_box_t *lsmash_root_as_box
600 (
601 lsmash_root_t *root
602 );
604 /* This function allows you to handle the handle of a file as if it is a box.
605 * Of course, you can deallocate the handle of the file by lsmash_destroy_box().
606 *
607 * Return the address of the handle of a given file as a box. */
608 lsmash_box_t *lsmash_file_as_box
609 (
610 lsmash_file_t *file
611 );
613 /* Write a top level box and its children already added to a file.
614 * WARNING:
615 * You should not use this function as long as media data is incompletely written.
616 * That is before starting to write a media data or after finishing of writing that.
617 *
618 * Return 0 if successful.
619 * Return a negative value otherwise. */
620 int lsmash_write_top_level_box
621 (
622 lsmash_box_t *box
623 );
625 /* Export the data of a given box and its children as the binary string.
626 * The returned address is of the beginning of an allocated memory block.
627 * You can deallocate the memory block by lsmash_free().
628 *
629 * Note that some boxes cannot be exported since L-SMASH might skip the cache for them.
630 * Media Data Box is an unexportable example.
631 *
632 * Return the address to the beginning of the binary string if successful.
633 * Return NULL otherwise. */
635 (
638 );
640 /****************************************************************************
641 * CODEC identifiers
642 ****************************************************************************/
645 #define LSMASH_CODEC_TYPE_INITIALIZER LSMASH_BOX_TYPE_INITIALIZER
646 #define LSMASH_CODEC_TYPE_UNSPECIFIED LSMASH_BOX_TYPE_UNSPECIFIED
648 #define DEFINE_ISOM_CODEC_TYPE( BOX_TYPE_NAME, BOX_TYPE_FOURCC ) \
649 static const lsmash_codec_type_t BOX_TYPE_NAME = LSMASH_ISO_BOX_TYPE_INITIALIZER( BOX_TYPE_FOURCC )
650 #define DEFINE_QTFF_CODEC_TYPE( BOX_TYPE_NAME, BOX_TYPE_FOURCC ) \
651 static const lsmash_codec_type_t BOX_TYPE_NAME = LSMASH_QTFF_BOX_TYPE_INITIALIZER( BOX_TYPE_FOURCC )
653 /* Audio CODEC identifiers */
654 DEFINE_ISOM_CODEC_TYPE( ISOM_CODEC_TYPE_AC_3_AUDIO, LSMASH_4CC( 'a', 'c', '-', '3' ) ); /* AC-3 audio */
655 DEFINE_ISOM_CODEC_TYPE( ISOM_CODEC_TYPE_ALAC_AUDIO, LSMASH_4CC( 'a', 'l', 'a', 'c' ) ); /* Apple lossless audio codec */
656 DEFINE_ISOM_CODEC_TYPE( ISOM_CODEC_TYPE_DRA1_AUDIO, LSMASH_4CC( 'd', 'r', 'a', '1' ) ); /* DRA Audio */
657 DEFINE_ISOM_CODEC_TYPE( ISOM_CODEC_TYPE_DTSC_AUDIO, LSMASH_4CC( 'd', 't', 's', 'c' ) ); /* DTS Coherent Acoustics audio */
658 DEFINE_ISOM_CODEC_TYPE( ISOM_CODEC_TYPE_DTSH_AUDIO, LSMASH_4CC( 'd', 't', 's', 'h' ) ); /* DTS-HD High Resolution Audio */
659 DEFINE_ISOM_CODEC_TYPE( ISOM_CODEC_TYPE_DTSL_AUDIO, LSMASH_4CC( 'd', 't', 's', 'l' ) ); /* DTS-HD Master Audio */
660 DEFINE_ISOM_CODEC_TYPE( ISOM_CODEC_TYPE_DTSE_AUDIO, LSMASH_4CC( 'd', 't', 's', 'e' ) ); /* DTS Express low bit rate audio, also known as DTS LBR */
661 DEFINE_ISOM_CODEC_TYPE( ISOM_CODEC_TYPE_EC_3_AUDIO, LSMASH_4CC( 'e', 'c', '-', '3' ) ); /* Enhanced AC-3 audio */
662 DEFINE_ISOM_CODEC_TYPE( ISOM_CODEC_TYPE_ENCA_AUDIO, LSMASH_4CC( 'e', 'n', 'c', 'a' ) ); /* Encrypted/Protected audio */
663 DEFINE_ISOM_CODEC_TYPE( ISOM_CODEC_TYPE_G719_AUDIO, LSMASH_4CC( 'g', '7', '1', '9' ) ); /* ITU-T Recommendation G.719 (2008) ); */
664 DEFINE_ISOM_CODEC_TYPE( ISOM_CODEC_TYPE_G726_AUDIO, LSMASH_4CC( 'g', '7', '2', '6' ) ); /* ITU-T Recommendation G.726 (1990) ); */
665 DEFINE_ISOM_CODEC_TYPE( ISOM_CODEC_TYPE_M4AE_AUDIO, LSMASH_4CC( 'm', '4', 'a', 'e' ) ); /* MPEG-4 Audio Enhancement */
666 DEFINE_ISOM_CODEC_TYPE( ISOM_CODEC_TYPE_MLPA_AUDIO, LSMASH_4CC( 'm', 'l', 'p', 'a' ) ); /* MLP Audio */
667 DEFINE_ISOM_CODEC_TYPE( ISOM_CODEC_TYPE_MP4A_AUDIO, LSMASH_4CC( 'm', 'p', '4', 'a' ) ); /* MPEG-4 Audio */
668 DEFINE_ISOM_CODEC_TYPE( ISOM_CODEC_TYPE_RAW_AUDIO, LSMASH_4CC( 'r', 'a', 'w', ' ' ) ); /* Uncompressed audio */
669 DEFINE_ISOM_CODEC_TYPE( ISOM_CODEC_TYPE_SAMR_AUDIO, LSMASH_4CC( 's', 'a', 'm', 'r' ) ); /* Narrowband AMR voice */
670 DEFINE_ISOM_CODEC_TYPE( ISOM_CODEC_TYPE_SAWB_AUDIO, LSMASH_4CC( 's', 'a', 'w', 'b' ) ); /* Wideband AMR voice */
671 DEFINE_ISOM_CODEC_TYPE( ISOM_CODEC_TYPE_SAWP_AUDIO, LSMASH_4CC( 's', 'a', 'w', 'p' ) ); /* Extended AMR-WB (AMR-WB+) ); */
672 DEFINE_ISOM_CODEC_TYPE( ISOM_CODEC_TYPE_SEVC_AUDIO, LSMASH_4CC( 's', 'e', 'v', 'c' ) ); /* EVRC Voice */
673 DEFINE_ISOM_CODEC_TYPE( ISOM_CODEC_TYPE_SQCP_AUDIO, LSMASH_4CC( 's', 'q', 'c', 'p' ) ); /* 13K Voice */
674 DEFINE_ISOM_CODEC_TYPE( ISOM_CODEC_TYPE_SSMV_AUDIO, LSMASH_4CC( 's', 's', 'm', 'v' ) ); /* SMV Voice */
675 DEFINE_ISOM_CODEC_TYPE( ISOM_CODEC_TYPE_TWOS_AUDIO, LSMASH_4CC( 't', 'w', 'o', 's' ) ); /* Uncompressed 16-bit audio */
677 DEFINE_QTFF_CODEC_TYPE( QT_CODEC_TYPE_23NI_AUDIO, LSMASH_4CC( '2', '3', 'n', 'i' ) ); /* 32-bit little endian integer uncompressed */
678 DEFINE_QTFF_CODEC_TYPE( QT_CODEC_TYPE_MAC3_AUDIO, LSMASH_4CC( 'M', 'A', 'C', '3' ) ); /* MACE 3:1 */
679 DEFINE_QTFF_CODEC_TYPE( QT_CODEC_TYPE_MAC6_AUDIO, LSMASH_4CC( 'M', 'A', 'C', '6' ) ); /* MACE 6:1 */
680 DEFINE_QTFF_CODEC_TYPE( QT_CODEC_TYPE_NONE_AUDIO, LSMASH_4CC( 'N', 'O', 'N', 'E' ) ); /* either 'raw ' or 'twos' */
681 DEFINE_QTFF_CODEC_TYPE( QT_CODEC_TYPE_QDM2_AUDIO, LSMASH_4CC( 'Q', 'D', 'M', '2' ) ); /* Qdesign music 2 */
682 DEFINE_QTFF_CODEC_TYPE( QT_CODEC_TYPE_QDMC_AUDIO, LSMASH_4CC( 'Q', 'D', 'M', 'C' ) ); /* Qdesign music 1 */
683 DEFINE_QTFF_CODEC_TYPE( QT_CODEC_TYPE_QCLP_AUDIO, LSMASH_4CC( 'Q', 'c', 'l', 'p' ) ); /* Qualcomm PureVoice */
684 DEFINE_QTFF_CODEC_TYPE( QT_CODEC_TYPE_AC_3_AUDIO, LSMASH_4CC( 'a', 'c', '-', '3' ) ); /* Digital Audio Compression Standard (AC-3, Enhanced AC-3) */
686 DEFINE_QTFF_CODEC_TYPE( QT_CODEC_TYPE_ALAC_AUDIO, LSMASH_4CC( 'a', 'l', 'a', 'c' ) ); /* Apple lossless audio codec */
687 DEFINE_QTFF_CODEC_TYPE( QT_CODEC_TYPE_ALAW_AUDIO, LSMASH_4CC( 'a', 'l', 'a', 'w' ) ); /* a-Law 2:1 */
688 DEFINE_QTFF_CODEC_TYPE( QT_CODEC_TYPE_CDX2_AUDIO, LSMASH_4CC( 'c', 'd', 'x', '2' ) ); /* CD/XA 2:1 */
689 DEFINE_QTFF_CODEC_TYPE( QT_CODEC_TYPE_CDX4_AUDIO, LSMASH_4CC( 'c', 'd', 'x', '4' ) ); /* CD/XA 4:1 */
690 DEFINE_QTFF_CODEC_TYPE( QT_CODEC_TYPE_DVCA_AUDIO, LSMASH_4CC( 'd', 'v', 'c', 'a' ) ); /* DV Audio */
691 DEFINE_QTFF_CODEC_TYPE( QT_CODEC_TYPE_DVI_AUDIO, LSMASH_4CC( 'd', 'v', 'i', ' ' ) ); /* DVI (as used in RTP, 4:1 compression) */
692 DEFINE_QTFF_CODEC_TYPE( QT_CODEC_TYPE_FL32_AUDIO, LSMASH_4CC( 'f', 'l', '3', '2' ) ); /* 32-bit float */
693 DEFINE_QTFF_CODEC_TYPE( QT_CODEC_TYPE_FL64_AUDIO, LSMASH_4CC( 'f', 'l', '6', '4' ) ); /* 64-bit float */
694 DEFINE_QTFF_CODEC_TYPE( QT_CODEC_TYPE_IMA4_AUDIO, LSMASH_4CC( 'i', 'm', 'a', '4' ) ); /* IMA (International Multimedia Assocation, defunct, 4:1) */
695 DEFINE_QTFF_CODEC_TYPE( QT_CODEC_TYPE_IN24_AUDIO, LSMASH_4CC( 'i', 'n', '2', '4' ) ); /* 24-bit integer uncompressed */
696 DEFINE_QTFF_CODEC_TYPE( QT_CODEC_TYPE_IN32_AUDIO, LSMASH_4CC( 'i', 'n', '3', '2' ) ); /* 32-bit integer uncompressed */
697 DEFINE_QTFF_CODEC_TYPE( QT_CODEC_TYPE_LPCM_AUDIO, LSMASH_4CC( 'l', 'p', 'c', 'm' ) ); /* Uncompressed audio (various integer and float formats) */
698 DEFINE_QTFF_CODEC_TYPE( QT_CODEC_TYPE_MP4A_AUDIO, LSMASH_4CC( 'm', 'p', '4', 'a' ) ); /* MPEG-4 Audio */
699 DEFINE_QTFF_CODEC_TYPE( QT_CODEC_TYPE_RAW_AUDIO, LSMASH_4CC( 'r', 'a', 'w', ' ' ) ); /* 8-bit offset-binary uncompressed */
700 DEFINE_QTFF_CODEC_TYPE( QT_CODEC_TYPE_SOWT_AUDIO, LSMASH_4CC( 's', 'o', 'w', 't' ) ); /* 16-bit little endian uncompressed */
701 DEFINE_QTFF_CODEC_TYPE( QT_CODEC_TYPE_TWOS_AUDIO, LSMASH_4CC( 't', 'w', 'o', 's' ) ); /* 8-bit or 16-bit big endian uncompressed */
702 DEFINE_QTFF_CODEC_TYPE( QT_CODEC_TYPE_ULAW_AUDIO, LSMASH_4CC( 'u', 'l', 'a', 'w' ) ); /* uLaw 2:1 */
703 DEFINE_QTFF_CODEC_TYPE( QT_CODEC_TYPE_VDVA_AUDIO, LSMASH_4CC( 'v', 'd', 'v', 'a' ) ); /* DV audio (variable duration per video frame) */
704 DEFINE_QTFF_CODEC_TYPE( QT_CODEC_TYPE_FULLMP3_AUDIO, LSMASH_4CC( '.', 'm', 'p', '3' ) ); /* MPEG-1 layer 3, CBR & VBR (QT4.1 and later) */
705 DEFINE_QTFF_CODEC_TYPE( QT_CODEC_TYPE_MP3_AUDIO, 0x6D730055 ); /* MPEG-1 layer 3, CBR only (pre-QT4.1) */
706 DEFINE_QTFF_CODEC_TYPE( QT_CODEC_TYPE_ADPCM2_AUDIO, 0x6D730002 ); /* Microsoft ADPCM - ACM code 2 */
707 DEFINE_QTFF_CODEC_TYPE( QT_CODEC_TYPE_ADPCM17_AUDIO, 0x6D730011 ); /* DVI/Intel IMA ADPCM - ACM code 17 */
708 DEFINE_QTFF_CODEC_TYPE( QT_CODEC_TYPE_GSM49_AUDIO, 0x6D730031 ); /* Microsoft GSM 6.10 - ACM code 49 */
709 DEFINE_QTFF_CODEC_TYPE( QT_CODEC_TYPE_NOT_SPECIFIED, 0x00000000 ); /* either 'raw ' or 'twos' */
711 /* Video CODEC identifiers */
712 DEFINE_ISOM_CODEC_TYPE( ISOM_CODEC_TYPE_AVC1_VIDEO, LSMASH_4CC( 'a', 'v', 'c', '1' ) ); /* Advanced Video Coding
713 * Any sample must not contain any paramerter set and filler data. */
714 DEFINE_ISOM_CODEC_TYPE( ISOM_CODEC_TYPE_AVC2_VIDEO, LSMASH_4CC( 'a', 'v', 'c', '2' ) ); /* Advanced Video Coding
715 * Any sample must not contain any paramerter set and filler data.
716 * May only be used when Extractors or Aggregators are required to be supported. */
717 DEFINE_ISOM_CODEC_TYPE( ISOM_CODEC_TYPE_AVC3_VIDEO, LSMASH_4CC( 'a', 'v', 'c', '3' ) ); /* Advanced Video Coding
718 * It is allowed that sample contains parameter sets and filler data. */
719 DEFINE_ISOM_CODEC_TYPE( ISOM_CODEC_TYPE_AVC4_VIDEO, LSMASH_4CC( 'a', 'v', 'c', '4' ) ); /* Advanced Video Coding
720 * It is allowed that sample contains parameter sets and filler data.
721 * May only be used when Extractors or Aggregators are required to be supported. */
722 DEFINE_ISOM_CODEC_TYPE( ISOM_CODEC_TYPE_AVCP_VIDEO, LSMASH_4CC( 'a', 'v', 'c', 'p' ) ); /* Advanced Video Coding Parameters */
723 DEFINE_ISOM_CODEC_TYPE( ISOM_CODEC_TYPE_DRAC_VIDEO, LSMASH_4CC( 'd', 'r', 'a', 'c' ) ); /* Dirac Video Coder */
724 DEFINE_ISOM_CODEC_TYPE( ISOM_CODEC_TYPE_ENCV_VIDEO, LSMASH_4CC( 'e', 'n', 'c', 'v' ) ); /* Encrypted/protected video */
725 DEFINE_ISOM_CODEC_TYPE( ISOM_CODEC_TYPE_HVC1_VIDEO, LSMASH_4CC( 'h', 'v', 'c', '1' ) ); /* High Efficiency Video Coding
726 * The default and mandatory value of array_completeness is 1 for arrays of
727 * all types of parameter sets, and 0 for all other arrays.
728 * This means any sample must not contain any paramerter set and filler data. */
729 DEFINE_ISOM_CODEC_TYPE( ISOM_CODEC_TYPE_HEV1_VIDEO, LSMASH_4CC( 'h', 'e', 'v', '1' ) ); /* High Efficiency Video Coding
730 * The default value of array_completeness is 0 for all arrays.
731 * It is allowed that sample contains parameter sets and filler data. */
732 DEFINE_ISOM_CODEC_TYPE( ISOM_CODEC_TYPE_MJP2_VIDEO, LSMASH_4CC( 'm', 'j', 'p', '2' ) ); /* Motion JPEG 2000 */
733 DEFINE_ISOM_CODEC_TYPE( ISOM_CODEC_TYPE_MP4V_VIDEO, LSMASH_4CC( 'm', 'p', '4', 'v' ) ); /* MPEG-4 Visual */
734 DEFINE_ISOM_CODEC_TYPE( ISOM_CODEC_TYPE_MVC1_VIDEO, LSMASH_4CC( 'm', 'v', 'c', '1' ) ); /* Multiview coding */
735 DEFINE_ISOM_CODEC_TYPE( ISOM_CODEC_TYPE_MVC2_VIDEO, LSMASH_4CC( 'm', 'v', 'c', '2' ) ); /* Multiview coding */
736 DEFINE_ISOM_CODEC_TYPE( ISOM_CODEC_TYPE_S263_VIDEO, LSMASH_4CC( 's', '2', '6', '3' ) ); /* ITU H.263 video (3GPP format) */
737 DEFINE_ISOM_CODEC_TYPE( ISOM_CODEC_TYPE_SVC1_VIDEO, LSMASH_4CC( 's', 'v', 'c', '1' ) ); /* Scalable Video Coding */
738 DEFINE_ISOM_CODEC_TYPE( ISOM_CODEC_TYPE_VC_1_VIDEO, LSMASH_4CC( 'v', 'c', '-', '1' ) ); /* SMPTE VC-1 */
740 DEFINE_QTFF_CODEC_TYPE( QT_CODEC_TYPE_2VUY_VIDEO, LSMASH_4CC( '2', 'v', 'u', 'y' ) ); /* Uncompressed Y'CbCr, 8-bit-per-component 4:2:2
741 * |Cb(8)|Y'0(8)|Cr(8)|Y'1(8)| */
742 DEFINE_QTFF_CODEC_TYPE( QT_CODEC_TYPE_CFHD_VIDEO, LSMASH_4CC( 'C', 'F', 'H', 'D' ) ); /* CineForm High-Definition (HD) wavelet codec */
743 DEFINE_QTFF_CODEC_TYPE( QT_CODEC_TYPE_DV10_VIDEO, LSMASH_4CC( 'D', 'V', '1', '0' ) ); /* Digital Voodoo 10 bit Uncompressed 4:2:2 codec */
744 DEFINE_QTFF_CODEC_TYPE( QT_CODEC_TYPE_DVOO_VIDEO, LSMASH_4CC( 'D', 'V', 'O', 'O' ) ); /* Digital Voodoo 8 bit Uncompressed 4:2:2 codec */
745 DEFINE_QTFF_CODEC_TYPE( QT_CODEC_TYPE_DVOR_VIDEO, LSMASH_4CC( 'D', 'V', 'O', 'R' ) ); /* Digital Voodoo intermediate raw */
746 DEFINE_QTFF_CODEC_TYPE( QT_CODEC_TYPE_DVTV_VIDEO, LSMASH_4CC( 'D', 'V', 'T', 'V' ) ); /* Digital Voodoo intermediate 2vuy */
747 DEFINE_QTFF_CODEC_TYPE( QT_CODEC_TYPE_DVVT_VIDEO, LSMASH_4CC( 'D', 'V', 'V', 'T' ) ); /* Digital Voodoo intermediate v210 */
748 DEFINE_QTFF_CODEC_TYPE( QT_CODEC_TYPE_HD10_VIDEO, LSMASH_4CC( 'H', 'D', '1', '0' ) ); /* Digital Voodoo 10 bit Uncompressed 4:2:2 HD codec */
749 DEFINE_QTFF_CODEC_TYPE( QT_CODEC_TYPE_M105_VIDEO, LSMASH_4CC( 'M', '1', '0', '5' ) ); /* Internal format of video data supported by Matrox hardware; pixel organization is proprietary*/
750 DEFINE_QTFF_CODEC_TYPE( QT_CODEC_TYPE_PNTG_VIDEO, LSMASH_4CC( 'P', 'N', 'T', 'G' ) ); /* Apple MacPaint image format */
751 DEFINE_QTFF_CODEC_TYPE( QT_CODEC_TYPE_SVQ1_VIDEO, LSMASH_4CC( 'S', 'V', 'Q', '1' ) ); /* Sorenson Video 1 video */
752 DEFINE_QTFF_CODEC_TYPE( QT_CODEC_TYPE_SVQ3_VIDEO, LSMASH_4CC( 'S', 'V', 'Q', '3' ) ); /* Sorenson Video 3 video */
753 DEFINE_QTFF_CODEC_TYPE( QT_CODEC_TYPE_SHR0_VIDEO, LSMASH_4CC( 'S', 'h', 'r', '0' ) ); /* Generic SheerVideo codec */
754 DEFINE_QTFF_CODEC_TYPE( QT_CODEC_TYPE_SHR1_VIDEO, LSMASH_4CC( 'S', 'h', 'r', '1' ) ); /* SheerVideo RGB[A] 8b - at 8 bits/channel */
755 DEFINE_QTFF_CODEC_TYPE( QT_CODEC_TYPE_SHR2_VIDEO, LSMASH_4CC( 'S', 'h', 'r', '2' ) ); /* SheerVideo Y'CbCr[A] 8bv 4:4:4[:4] - at 8 bits/channel, in ITU-R BT.601-4 video range */
756 DEFINE_QTFF_CODEC_TYPE( QT_CODEC_TYPE_SHR3_VIDEO, LSMASH_4CC( 'S', 'h', 'r', '3' ) ); /* SheerVideo Y'CbCr 8bv 4:2:2 - 2:1 chroma subsampling, at 8 bits/channel, in ITU-R BT.601-4 video range */
757 DEFINE_QTFF_CODEC_TYPE( QT_CODEC_TYPE_SHR4_VIDEO, LSMASH_4CC( 'S', 'h', 'r', '4' ) ); /* SheerVideo Y'CbCr 8bw 4:2:2 - 2:1 chroma subsampling, at 8 bits/channel, with full-range luma and wide-range two's-complement chroma */
758 DEFINE_QTFF_CODEC_TYPE( QT_CODEC_TYPE_WRLE_VIDEO, LSMASH_4CC( 'W', 'R', 'L', 'E' ) ); /* Windows BMP image format */
759 DEFINE_QTFF_CODEC_TYPE( QT_CODEC_TYPE_APCH_VIDEO, LSMASH_4CC( 'a', 'p', 'c', 'h' ) ); /* Apple ProRes 422 High Quality */
760 DEFINE_QTFF_CODEC_TYPE( QT_CODEC_TYPE_APCN_VIDEO, LSMASH_4CC( 'a', 'p', 'c', 'n' ) ); /* Apple ProRes 422 Standard Definition */
761 DEFINE_QTFF_CODEC_TYPE( QT_CODEC_TYPE_APCS_VIDEO, LSMASH_4CC( 'a', 'p', 'c', 's' ) ); /* Apple ProRes 422 LT */
762 DEFINE_QTFF_CODEC_TYPE( QT_CODEC_TYPE_APCO_VIDEO, LSMASH_4CC( 'a', 'p', 'c', 'o' ) ); /* Apple ProRes 422 Proxy */
763 DEFINE_QTFF_CODEC_TYPE( QT_CODEC_TYPE_AP4H_VIDEO, LSMASH_4CC( 'a', 'p', '4', 'h' ) ); /* Apple ProRes 4444 */
764 DEFINE_QTFF_CODEC_TYPE( QT_CODEC_TYPE_CIVD_VIDEO, LSMASH_4CC( 'c', 'i', 'v', 'd' ) ); /* Cinepak Video */
765 DEFINE_QTFF_CODEC_TYPE( QT_CODEC_TYPE_DRAC_VIDEO, LSMASH_4CC( 'd', 'r', 'a', 'c' ) ); /* Dirac Video Coder */
766 DEFINE_QTFF_CODEC_TYPE( QT_CODEC_TYPE_DVC_VIDEO, LSMASH_4CC( 'd', 'v', 'c', ' ' ) ); /* DV NTSC format */
767 DEFINE_QTFF_CODEC_TYPE( QT_CODEC_TYPE_DVCP_VIDEO, LSMASH_4CC( 'd', 'v', 'c', 'p' ) ); /* DV PAL format */
768 DEFINE_QTFF_CODEC_TYPE( QT_CODEC_TYPE_DVPP_VIDEO, LSMASH_4CC( 'd', 'v', 'p', 'p' ) ); /* Panasonic DVCPro PAL format */
769 DEFINE_QTFF_CODEC_TYPE( QT_CODEC_TYPE_DV5N_VIDEO, LSMASH_4CC( 'd', 'v', '5', 'n' ) ); /* Panasonic DVCPro-50 NTSC format */
770 DEFINE_QTFF_CODEC_TYPE( QT_CODEC_TYPE_DV5P_VIDEO, LSMASH_4CC( 'd', 'v', '5', 'p' ) ); /* Panasonic DVCPro-50 PAL format */
771 DEFINE_QTFF_CODEC_TYPE( QT_CODEC_TYPE_DVH2_VIDEO, LSMASH_4CC( 'd', 'v', 'h', '2' ) ); /* Panasonic DVCPro-HD 1080p25 format */
772 DEFINE_QTFF_CODEC_TYPE( QT_CODEC_TYPE_DVH3_VIDEO, LSMASH_4CC( 'd', 'v', 'h', '3' ) ); /* Panasonic DVCPro-HD 1080p30 format */
773 DEFINE_QTFF_CODEC_TYPE( QT_CODEC_TYPE_DVH5_VIDEO, LSMASH_4CC( 'd', 'v', 'h', '5' ) ); /* Panasonic DVCPro-HD 1080i50 format */
774 DEFINE_QTFF_CODEC_TYPE( QT_CODEC_TYPE_DVH6_VIDEO, LSMASH_4CC( 'd', 'v', 'h', '6' ) ); /* Panasonic DVCPro-HD 1080i60 format */
775 DEFINE_QTFF_CODEC_TYPE( QT_CODEC_TYPE_DVHP_VIDEO, LSMASH_4CC( 'd', 'v', 'h', 'p' ) ); /* Panasonic DVCPro-HD 720p60 format */
776 DEFINE_QTFF_CODEC_TYPE( QT_CODEC_TYPE_DVHQ_VIDEO, LSMASH_4CC( 'd', 'v', 'h', 'q' ) ); /* Panasonic DVCPro-HD 720p50 format */
777 DEFINE_QTFF_CODEC_TYPE( QT_CODEC_TYPE_FLIC_VIDEO, LSMASH_4CC( 'f', 'l', 'i', 'c' ) ); /* Autodesk FLIC animation format */
778 DEFINE_QTFF_CODEC_TYPE( QT_CODEC_TYPE_GIF_VIDEO, LSMASH_4CC( 'g', 'i', 'f', ' ' ) ); /* GIF image format */
779 DEFINE_QTFF_CODEC_TYPE( QT_CODEC_TYPE_H261_VIDEO, LSMASH_4CC( 'h', '2', '6', '1' ) ); /* ITU H.261 video */
780 DEFINE_QTFF_CODEC_TYPE( QT_CODEC_TYPE_H263_VIDEO, LSMASH_4CC( 'h', '2', '6', '3' ) ); /* ITU H.263 video */
781 DEFINE_QTFF_CODEC_TYPE( QT_CODEC_TYPE_JPEG_VIDEO, LSMASH_4CC( 'j', 'p', 'e', 'g' ) ); /* JPEG image format */
782 DEFINE_QTFF_CODEC_TYPE( QT_CODEC_TYPE_MJPA_VIDEO, LSMASH_4CC( 'm', 'j', 'p', 'a' ) ); /* Motion-JPEG (format A) */
783 DEFINE_QTFF_CODEC_TYPE( QT_CODEC_TYPE_MJPB_VIDEO, LSMASH_4CC( 'm', 'j', 'p', 'b' ) ); /* Motion-JPEG (format B) */
784 DEFINE_QTFF_CODEC_TYPE( QT_CODEC_TYPE_PNG_VIDEO, LSMASH_4CC( 'p', 'n', 'g', ' ' ) ); /* W3C Portable Network Graphics (PNG) */
785 DEFINE_QTFF_CODEC_TYPE( QT_CODEC_TYPE_RAW_VIDEO, LSMASH_4CC( 'r', 'a', 'w', ' ' ) ); /* Uncompressed RGB */
786 DEFINE_QTFF_CODEC_TYPE( QT_CODEC_TYPE_RLE_VIDEO, LSMASH_4CC( 'r', 'l', 'e', ' ' ) ); /* Apple animation codec */
787 DEFINE_QTFF_CODEC_TYPE( QT_CODEC_TYPE_RPZA_VIDEO, LSMASH_4CC( 'r', 'p', 'z', 'a' ) ); /* Apple simple video 'road pizza' compression */
788 DEFINE_QTFF_CODEC_TYPE( QT_CODEC_TYPE_TGA_VIDEO, LSMASH_4CC( 't', 'g', 'a', ' ' ) ); /* Truvision Targa video format */
789 DEFINE_QTFF_CODEC_TYPE( QT_CODEC_TYPE_TIFF_VIDEO, LSMASH_4CC( 't', 'i', 'f', 'f' ) ); /* Tagged Image File Format (Adobe) */
790 DEFINE_QTFF_CODEC_TYPE( QT_CODEC_TYPE_ULRA_VIDEO, LSMASH_4CC( 'U', 'L', 'R', 'A' ) ); /* Ut Video RGBA 4:4:4:4 8bit full-range */
791 DEFINE_QTFF_CODEC_TYPE( QT_CODEC_TYPE_ULRG_VIDEO, LSMASH_4CC( 'U', 'L', 'R', 'G' ) ); /* Ut Video RGB 4:4:4 8bit full-range */
792 DEFINE_QTFF_CODEC_TYPE( QT_CODEC_TYPE_ULY0_VIDEO, LSMASH_4CC( 'U', 'L', 'Y', '0' ) ); /* Ut Video YCbCr (BT.601) 4:2:0 8bit limited */
793 DEFINE_QTFF_CODEC_TYPE( QT_CODEC_TYPE_ULY2_VIDEO, LSMASH_4CC( 'U', 'L', 'Y', '2' ) ); /* Ut Video YCbCr (BT.601) 4:2:2 8bit limited */
794 DEFINE_QTFF_CODEC_TYPE( QT_CODEC_TYPE_ULH0_VIDEO, LSMASH_4CC( 'U', 'L', 'H', '0' ) ); /* Ut Video YCbCr (BT.709) 4:2:0 8bit limited */
795 DEFINE_QTFF_CODEC_TYPE( QT_CODEC_TYPE_ULH2_VIDEO, LSMASH_4CC( 'U', 'L', 'H', '2' ) ); /* Ut Video YCbCr (BT.709) 4:2:2 8bit limited */
796 DEFINE_QTFF_CODEC_TYPE( QT_CODEC_TYPE_V210_VIDEO, LSMASH_4CC( 'v', '2', '1', '0' ) ); /* Uncompressed Y'CbCr, 10-bit-per-component 4:2:2
797 * |Cb0(10)|Y'0(10)|Cr0(10)|XX(2)|
798 * |Y'1(10)|Cb1(10)|Y'2(10)|XX(2)|
799 * |Cr1(10)|Y'3(10)|Cb2(10)|XX(2)|
800 * |Y'4(10)|Cr2(10)|Y'5(10)|XX(2)| (X is a zero bit) */
801 DEFINE_QTFF_CODEC_TYPE( QT_CODEC_TYPE_V216_VIDEO, LSMASH_4CC( 'v', '2', '1', '6' ) ); /* Uncompressed Y'CbCr, 10, 12, 14, or 16-bit-per-component 4:2:2
802 * |Cb(16 LE)|Y'0(16 LE)|Cr(16 LE)|Y'1(16 LE)| */
803 DEFINE_QTFF_CODEC_TYPE( QT_CODEC_TYPE_V308_VIDEO, LSMASH_4CC( 'v', '3', '0', '8' ) ); /* Uncompressed Y'CbCr, 8-bit-per-component 4:4:4
804 * |Cr(8)|Y'(8)|Cb(8)| */
805 DEFINE_QTFF_CODEC_TYPE( QT_CODEC_TYPE_V408_VIDEO, LSMASH_4CC( 'v', '4', '0', '8' ) ); /* Uncompressed Y'CbCrA, 8-bit-per-component 4:4:4:4
806 * |Cb(8)|Y'(8)|Cr(8)|A(8)| */
807 DEFINE_QTFF_CODEC_TYPE( QT_CODEC_TYPE_V410_VIDEO, LSMASH_4CC( 'v', '4', '1', '0' ) ); /* Uncompressed Y'CbCr, 10-bit-per-component 4:4:4
808 * |XX(2)|Cb(10)|Y'(10)|Cr(10)| (X is a zero bit) */
809 DEFINE_QTFF_CODEC_TYPE( QT_CODEC_TYPE_YUV2_VIDEO, LSMASH_4CC( 'y', 'u', 'v', '2' ) ); /* Uncompressed Y'CbCr, 8-bit-per-component 4:2:2
810 * |Y'0(8)|Cb(8)|Y'1(8)|Cr(8)| */
812 /* Text CODEC identifiers */
813 DEFINE_ISOM_CODEC_TYPE( ISOM_CODEC_TYPE_ENCT_TEXT, LSMASH_4CC( 'e', 'n', 'c', 't' ) ); /* Encrypted Text */
814 DEFINE_ISOM_CODEC_TYPE( ISOM_CODEC_TYPE_STPP_TEXT, LSMASH_4CC( 's', 't', 'p', 'p' ) ); /* Sub-titles (Timed Text) */
815 DEFINE_ISOM_CODEC_TYPE( ISOM_CODEC_TYPE_TX3G_TEXT, LSMASH_4CC( 't', 'x', '3', 'g' ) ); /* 3GPP Timed Text stream */
817 DEFINE_QTFF_CODEC_TYPE( QT_CODEC_TYPE_TEXT_TEXT, LSMASH_4CC( 't', 'e', 'x', 't' ) ); /* QuickTime Text Media */
819 /* Hint CODEC identifiers */
820 DEFINE_ISOM_CODEC_TYPE( ISOM_CODEC_TYPE_FDP_HINT, LSMASH_4CC( 'f', 'd', 'p', ' ' ) ); /* File delivery hints */
821 DEFINE_ISOM_CODEC_TYPE( ISOM_CODEC_TYPE_M2TS_HINT, LSMASH_4CC( 'm', '2', 't', 's' ) ); /* MPEG-2 transport stream for DMB */
822 DEFINE_ISOM_CODEC_TYPE( ISOM_CODEC_TYPE_PM2T_HINT, LSMASH_4CC( 'p', 'm', '2', 't' ) ); /* Protected MPEG-2 Transport */
823 DEFINE_ISOM_CODEC_TYPE( ISOM_CODEC_TYPE_PRTP_HINT, LSMASH_4CC( 'p', 'r', 't', 'p' ) ); /* Protected RTP Reception */
824 DEFINE_ISOM_CODEC_TYPE( ISOM_CODEC_TYPE_RM2T_HINT, LSMASH_4CC( 'r', 'm', '2', 't' ) ); /* MPEG-2 Transport Reception */
825 DEFINE_ISOM_CODEC_TYPE( ISOM_CODEC_TYPE_RRTP_HINT, LSMASH_4CC( 'r', 'r', 't', 'p' ) ); /* RTP reception */
826 DEFINE_ISOM_CODEC_TYPE( ISOM_CODEC_TYPE_RSRP_HINT, LSMASH_4CC( 'r', 's', 'r', 'p' ) ); /* SRTP Reception */
827 DEFINE_ISOM_CODEC_TYPE( ISOM_CODEC_TYPE_RTP_HINT, LSMASH_4CC( 'r', 't', 'p', ' ' ) ); /* RTP Hints */
828 DEFINE_ISOM_CODEC_TYPE( ISOM_CODEC_TYPE_SM2T_HINT, LSMASH_4CC( 's', 'm', '2', 't' ) ); /* MPEG-2 Transport Server */
829 DEFINE_ISOM_CODEC_TYPE( ISOM_CODEC_TYPE_SRTP_HINT, LSMASH_4CC( 's', 'r', 't', 'p' ) ); /* SRTP Hints */
831 /* Metadata CODEC identifiers */
832 DEFINE_ISOM_CODEC_TYPE( ISOM_CODEC_TYPE_IXSE_META, LSMASH_4CC( 'i', 'x', 's', 'e' ) ); /* DVB Track Level Index Track */
833 DEFINE_ISOM_CODEC_TYPE( ISOM_CODEC_TYPE_METT_META, LSMASH_4CC( 'm', 'e', 't', 't' ) ); /* Text timed metadata */
834 DEFINE_ISOM_CODEC_TYPE( ISOM_CODEC_TYPE_METX_META, LSMASH_4CC( 'm', 'e', 't', 'x' ) ); /* XML timed metadata */
835 DEFINE_ISOM_CODEC_TYPE( ISOM_CODEC_TYPE_MLIX_META, LSMASH_4CC( 'm', 'l', 'i', 'x' ) ); /* DVB Movie level index track */
836 DEFINE_ISOM_CODEC_TYPE( ISOM_CODEC_TYPE_OKSD_META, LSMASH_4CC( 'o', 'k', 's', 'd' ) ); /* OMA Keys */
837 DEFINE_ISOM_CODEC_TYPE( ISOM_CODEC_TYPE_SVCM_META, LSMASH_4CC( 's', 'v', 'c', 'M' ) ); /* SVC metadata */
838 DEFINE_ISOM_CODEC_TYPE( ISOM_CODEC_TYPE_TEXT_META, LSMASH_4CC( 't', 'e', 'x', 't' ) ); /* Textual meta-data with MIME type */
839 DEFINE_ISOM_CODEC_TYPE( ISOM_CODEC_TYPE_URIM_META, LSMASH_4CC( 'u', 'r', 'i', 'm' ) ); /* URI identified timed metadata */
840 DEFINE_ISOM_CODEC_TYPE( ISOM_CODEC_TYPE_XML_META, LSMASH_4CC( 'x', 'm', 'l', ' ' ) ); /* XML-formatted meta-data */
842 /* Other CODEC identifiers */
843 DEFINE_ISOM_CODEC_TYPE( ISOM_CODEC_TYPE_ENCS_SYSTEM, LSMASH_4CC( 'e', 'n', 'c', 's' ) ); /* Encrypted Systems stream */
844 DEFINE_ISOM_CODEC_TYPE( ISOM_CODEC_TYPE_MP4S_SYSTEM, LSMASH_4CC( 'm', 'p', '4', 's' ) ); /* MPEG-4 Systems */
846 DEFINE_QTFF_CODEC_TYPE( LSMASH_CODEC_TYPE_RAW, LSMASH_4CC( 'r', 'a', 'w', ' ' ) ); /* Either video or audio */
848 /* Check if the identifier of two CODECs is identical or not.
849 *
850 * Return 1 if the both CODEC identifiers are identical.
851 * Return 0 otherwise. */
854 /****************************************************************************
855 * Summary of Stream Configuration
856 * This is L-SMASH's original structure.
857 ****************************************************************************/
859 {
861 LSMASH_SUMMARY_TYPE_VIDEO,
862 LSMASH_SUMMARY_TYPE_AUDIO,
866 {
867 LSMASH_CODEC_SPECIFIC_DATA_TYPE_UNSPECIFIED = -1, /* must be LSMASH_CODEC_SPECIFIC_FORMAT_UNSPECIFIED */
869 LSMASH_CODEC_SPECIFIC_DATA_TYPE_UNKNOWN = 0, /* must be LSMASH_CODEC_SPECIFIC_FORMAT_UNSTRUCTURED */
871 LSMASH_CODEC_SPECIFIC_DATA_TYPE_MP4SYS_DECODER_CONFIG,
873 LSMASH_CODEC_SPECIFIC_DATA_TYPE_ISOM_VIDEO_H264,
874 LSMASH_CODEC_SPECIFIC_DATA_TYPE_ISOM_VIDEO_HEVC,
875 LSMASH_CODEC_SPECIFIC_DATA_TYPE_ISOM_VIDEO_VC_1,
876 LSMASH_CODEC_SPECIFIC_DATA_TYPE_ISOM_AUDIO_AC_3,
877 LSMASH_CODEC_SPECIFIC_DATA_TYPE_ISOM_AUDIO_EC_3,
878 LSMASH_CODEC_SPECIFIC_DATA_TYPE_ISOM_AUDIO_DTS,
879 LSMASH_CODEC_SPECIFIC_DATA_TYPE_ISOM_AUDIO_ALAC,
881 LSMASH_CODEC_SPECIFIC_DATA_TYPE_ISOM_VIDEO_SAMPLE_SCALE,
882 LSMASH_CODEC_SPECIFIC_DATA_TYPE_ISOM_VIDEO_H264_BITRATE,
884 LSMASH_CODEC_SPECIFIC_DATA_TYPE_QT_VIDEO_COMMON, /* must be LSMASH_CODEC_SPECIFIC_FORMAT_STRUCTURED */
885 LSMASH_CODEC_SPECIFIC_DATA_TYPE_QT_AUDIO_COMMON, /* must be LSMASH_CODEC_SPECIFIC_FORMAT_STRUCTURED */
886 LSMASH_CODEC_SPECIFIC_DATA_TYPE_QT_AUDIO_FORMAT_SPECIFIC_FLAGS, /* must be LSMASH_CODEC_SPECIFIC_FORMAT_STRUCTURED */
887 LSMASH_CODEC_SPECIFIC_DATA_TYPE_QT_AUDIO_DECOMPRESSION_PARAMETERS, /* must be LSMASH_CODEC_SPECIFIC_FORMAT_UNSTRUCTURED */
889 LSMASH_CODEC_SPECIFIC_DATA_TYPE_QT_VIDEO_FIELD_INFO,
890 LSMASH_CODEC_SPECIFIC_DATA_TYPE_QT_VIDEO_PIXEL_FORMAT,
891 LSMASH_CODEC_SPECIFIC_DATA_TYPE_QT_VIDEO_SIGNIFICANT_BITS,
892 LSMASH_CODEC_SPECIFIC_DATA_TYPE_QT_VIDEO_GAMMA_LEVEL,
893 LSMASH_CODEC_SPECIFIC_DATA_TYPE_QT_AUDIO_CHANNEL_LAYOUT,
895 LSMASH_CODEC_SPECIFIC_DATA_TYPE_CODEC_GLOBAL_HEADER,
899 {
906 {
914 {
915 lsmash_codec_specific_data_type type;
916 lsmash_codec_specific_format format;
917 lsmash_codec_specific_data_t data;
919 lsmash_codec_specific_destructor_t destruct;
925 {
927 LSMASH_CODEC_SUPPORT_FLAG_MUX = 1 << 0, /* It's expected that L-SMASH can mux CODEC stream properly.
928 * If not flagged, L-SMASH may recognize and/or handle CODEC specific info incorrectly when muxing. */
929 LSMASH_CODEC_SUPPORT_FLAG_DEMUX = 1 << 1, /* It's expected that L-SMASH can demux CODEC stream properly.
930 * If not flagged, L-SMASH may recognize and/or handle CODEC specific info incorrectly when demuxing. */
931 LSMASH_CODEC_SUPPORT_FLAG_REMUX = LSMASH_CODEC_SUPPORT_FLAG_MUX | LSMASH_CODEC_SUPPORT_FLAG_DEMUX,
934 #define LSMASH_BASE_SUMMARY \
935 lsmash_summary_type summary_type; \
936 lsmash_codec_type_t sample_type; \
937 lsmash_codec_specific_list_t *opaque; \
943 {
944 LSMASH_BASE_SUMMARY
947 /* Allocate a summary by 'summary_type'.
948 * The allocated summary can be deallocated by lsmash_cleanup_summary().
949 *
950 * Return the address of an allocated summary if successful.
951 * Return NULL otherwise. */
952 lsmash_summary_t *lsmash_create_summary
953 (
954 lsmash_summary_type summary_type /* a type of summary you want */
955 );
957 /* Deallocate a given summary. */
958 void lsmash_cleanup_summary
959 (
961 );
963 /* Allocate and append a new sample description to a track by 'summary'.
964 *
965 * Return the index of an allocated and appended sample description if successful.
966 * Return 0 otherwise. */
967 int lsmash_add_sample_entry
968 (
969 lsmash_root_t *root, /* the address of the ROOT containing a track to which you want to append a new sample description */
970 uint32_t track_ID, /* the track_ID of a track to which you want to append a new sample description */
972 );
974 /* Count the number of summaries in a track.
975 *
976 * Return the number of summaries in a track if no error.
977 * Return 0 otherwise. */
978 uint32_t lsmash_count_summary
979 (
980 lsmash_root_t *root, /* the address of the ROOT containing a track in which you want to count the number of summaries */
981 uint32_t track_ID /* the track_ID of a track in which you want to count the number of summaries */
982 );
984 /* Get the summary of a sample description you want in a track.
985 * The summary returned by this function is allocated internally, and can be deallocate by lsmash_cleanup_summary().
986 *
987 * Return the address of an allocated summary you want if successful.
988 * Return NULL otherwise. */
989 lsmash_summary_t *lsmash_get_summary
990 (
991 lsmash_root_t *root, /* the address of the ROOT containing a track which contains a sample description you want */
994 );
996 /* Allocate and initialize a CODEC specific configuration by 'type' and 'format'.
997 * The allocated CODEC specific configuration can be deallocated by lsmash_destroy_codec_specific_data().
998 *
999 * Return the address of an allocated and initialized CODEC specific configuration if successful.
1000 * Return NULL otherwise. */
1001 lsmash_codec_specific_t *lsmash_create_codec_specific_data
1002 (
1003 lsmash_codec_specific_data_type type,
1004 lsmash_codec_specific_format format
1005 );
1007 /* Deallocate a CODEC specific configuration. */
1008 void lsmash_destroy_codec_specific_data
1009 (
1010 lsmash_codec_specific_t *specific /* the address of a CODEC specific configuration you want to deallocate */
1011 );
1013 /* Allocate a CODEC specific configuration which is a copy of 'specific', and append it to 'summary'.
1014 *
1015 * Return 0 if successful.
1016 * Return a negative value otherwise. */
1017 int lsmash_add_codec_specific_data
1018 (
1020 lsmash_codec_specific_t *specific
1021 );
1023 /* Count the number of CODEC specific configuration in a summary.
1024 *
1025 * Return the number of CODEC specific configuration in a summary if successful.
1026 * Return 0 otherwise. */
1027 uint32_t lsmash_count_codec_specific_data
1028 (
1029 lsmash_summary_t *summary /* the address of a summary in which you want to count the number of CODEC specific configuration */
1030 );
1032 /* Get a CODEC specific configuration you want in a summary.
1033 *
1034 * Return the address of a CODEC specific configuration if successful.
1035 * Return NULL otherwise. */
1036 lsmash_codec_specific_t *lsmash_get_codec_specific_data
1037 (
1039 uint32_t extension_number
1040 );
1042 /* Convert a data format of CODEC specific configuration into another.
1043 * User can specify the same data format for the destination.
1044 * If so, a returned CODEC specific configuration is a copy of the source.
1045 *
1046 * Return an allocated CODEC specific configuration by specified 'format' from 'specific' if successful.
1047 * Return NULL otherwise. */
1048 lsmash_codec_specific_t *lsmash_convert_codec_specific_format
1049 (
1050 lsmash_codec_specific_t *specific, /* the address of a CODEC specific configuration as the source */
1051 lsmash_codec_specific_format format /* a data format of the destination */
1052 );
1054 /* Compare two summaries.
1055 *
1056 * Return 0 if the two summaries are identical.
1057 * Return 1 if the two summaries are different.
1058 * Return a negative value if there is any error. */
1059 int lsmash_compare_summary
1060 (
1062 lsmash_summary_t *b
1063 );
1065 /* Check status of CODEC support.
1066 *
1067 * Return support flags of a given CODEC. */
1068 lsmash_codec_support_flag lsmash_check_codec_support
1069 (
1070 lsmash_codec_type_t codec_type
1071 );
1073 /****************************************************************************
1074 * Audio Description Layer
1075 ****************************************************************************/
1076 /* Audio Object Types */
1078 {
1121 /* See ISO/IEC 14496-3 Signaling of SBR, SBR Signaling and Corresponding Decoder Behavior */
1123 {
1126 MP4A_AAC_SBR_BACKWARD_COMPATIBLE, /* explicitly signals SBR present. Recommended method to signal SBR. */
1127 MP4A_AAC_SBR_HIERARCHICAL /* SBR exists. SBR dedicated method. */
1131 {
1132 LSMASH_BASE_SUMMARY
1134 * If neither ISOM_CODEC_TYPE_MP4A_AUDIO nor QT_CODEC_TYPE_MP4A_AUDIO, just ignored. */
1136 * For some audio, this field is used as a nominal value.
1137 * For HE-AAC v1/SBR stream, this is base AAC's one.
1138 * For ISOM_CODEC_TYPE_AC_3_AUDIO and ISOM_CODEC_TYPE_EC_3_AUDIO, this shall be
1139 * equal to the sampling rate (in Hz) of the stream and the media timescale. */
1141 * Even if the stream is HE-AAC v2/SBR+PS, this is base AAC's one. */
1143 * the number of bits in each uncompressed sample for a single channel.
1144 * For some compressed audio, such as audio that uses MDCT,
1145 * N/A (not applicable), and may be set to 16. */
1146 uint32_t samples_in_frame; /* the number of decoded PCM samples in an audio frame at 'frequency'
1147 * Even if the stream is HE-AAC/aacPlus/SBR(+PS), this is base AAC's one, so 1024. */
1149 * Currently we always set this as mp4a_AAC_SBR_NOT_SPECIFIED (Implicit signaling).
1150 * User can set this for treatment in other way. */
1152 * If variable, shall be set to 0. */
1155 /* Facilitate to make exdata (typically DecoderSpecificInfo or AudioSpecificConfig). */
1156 int lsmash_setup_AudioSpecificConfig
1157 (
1158 lsmash_audio_summary_t* summary
1159 );
1161 /****************************************************************************
1162 * Video Description Layer
1163 ****************************************************************************/
1164 /* Clean Aperture */
1166 {
1167 lsmash_rational_u32_t width;
1168 lsmash_rational_u32_t height;
1169 lsmash_rational_s32_t horizontal_offset;
1170 lsmash_rational_s32_t vertical_offset;
1174 {
1175 lsmash_rational_u32_t top;
1176 lsmash_rational_u32_t left;
1177 lsmash_rational_u32_t bottom;
1178 lsmash_rational_u32_t right;
1181 /* Video depth */
1183 {
1186 /* H.264/AVC */
1191 /* QuickTime Video
1192 * (1-32) or (33-40 grayscale) */
1205 /* QuickTime Uncompressed RGB */
1211 /* Index for the chromaticity coordinates of the color primaries */
1212 enum
1213 {
1214 /* for ISO Base Media file format */
1216 * SMPTE 274M-1995, SMPTE 296M-1997,
1217 * IEC 61966-2-1 (sRGB or sYCC), IEC 61966-2-4 (xvYCC),
1218 * SMPTE RP 177M-1993 Annex B
1219 * green x = 0.300 y = 0.600
1220 * blue x = 0.150 y = 0.060
1221 * red x = 0.640 y = 0.330
1222 * white x = 0.3127 y = 0.3290 (CIE III. D65) */
1225 * green x = 0.21 y = 0.71
1226 * blue x = 0.14 y = 0.08
1227 * red x = 0.67 y = 0.33
1228 * white x = 0.310 y = 0.316 */
1230 * ITU-R BT.601-6 625, ITU-R BT.1358 625,
1231 * ITU-R BT.1700 625 PAL and 625 SECAM
1232 * green x = 0.29 y = 0.60
1233 * blue x = 0.15 y = 0.06
1234 * red x = 0.64 y = 0.33
1235 * white x = 0.3127 y = 0.3290 (CIE III. D65) */
1236 ISOM_PRIMARIES_INDEX_SMPTE_170M_2004 = 6, /* SMPTE C Primaries from SMPTE RP 145-1993, SMPTE 170M-2004,
1237 * ITU-R BT.601-6 525, ITU-R BT.1358 525,
1238 * ITU-R BT.1700 NTSC, SMPTE 170M-2004
1239 * green x = 0.310 y = 0.595
1240 * blue x = 0.155 y = 0.070
1241 * red x = 0.630 y = 0.340
1242 * white x = 0.3127 y = 0.3290 (CIE III. D65) */
1244 * functionally the same as the value ISOM_PRIMARIES_INDEX_SMPTE_170M_2004 */
1246 /* for QuickTime file format */
1250 QT_PRIMARIES_INDEX_SMPTE_C = 6, /* the same as the value ISOM_PRIMARIES_INDEX_SMPTE_170M_2004 */
1251 };
1253 /* Index for the opto-electronic transfer characteristic of the image color components */
1254 enum
1255 {
1256 /* for ISO Base Media file format */
1258 * SMPTE 274M-1995, SMPTE 296M-1997,
1259 * SMPTE 293M-1996, SMPTE 170M-1994
1260 * vV = 1.099 * vLc^0.45 - 0.099 for 1 >= vLc >= 0.018
1261 * vV = 4.500 * vLc for 0.018 > vLc >= 0 */
1263 ISOM_TRANSFER_INDEX_ITU_R470M = 4, /* ITU-R BT.470-6 System M, ITU-R BT.1700 625 PAL and 625 SECAM
1264 * Assumed display gamma 2.2 */
1266 * Assumed display gamma 2.8 */
1267 ISOM_TRANSFER_INDEX_SMPTE_170M_2004 = 6, /* ITU-R BT.601-6 525 or 625, ITU-R BT.1358 525 or 625,
1268 * ITU-R BT.1700 NTSC, SMPTE 170M-2004
1269 * functionally the same as the value ISOM_TRANSFER_INDEX_ITU_R709_5
1270 * vV = 1.099 * vLc^0.45 - 0.099 for 1 >= vLc >= 0.018
1271 * vV = 4.500 * vLc for 0.018 > vLc >= 0 */
1272 ISOM_TRANSFER_INDEX_SMPTE_240M_1999 = 7, /* SMPTE 240M-1995/1999, interim color implementation of SMPTE 274M-1995
1273 * vV = 1.1115 * vLc^0.45 - 0.1115 for 1 >= vLc >= 0.0228
1274 * vV = 4.0 * vLc for 0.0228 > vLc >= 0 */
1277 * vV = 1.099 * vLc^0.45 - 0.099 for vLc >= 0.018
1278 * vV = 4.500 * vLc for 0.018 > vLc > -0.018
1279 * vV = -1.099 * (-vLc)^0.45 + 0.099 for -0.018 >= vLc */
1281 * vV = 1.099 * vLc^0.45 - 0.099 for 1.33 > vLc >= 0.018
1282 * vV = 4.500 * vLc for 0.018 > vLc >= -0.0045
1283 * vV = -(1.099 * (-4 * vLc)^0.45 + 0.099) / 4 for -0.0045 > vLc >= -0.25 */
1285 * vV = 1.055 * vLc^(1/2.4) - 0.055 for 1 > vLc >= 0.0031308
1286 * vV = 12.92 * vLc for 0.0031308 > vLc >= 0 */
1288 /* for QuickTime file format */
1291 QT_TRANSFER_INDEX_SMPTE_240M_1995 = 7, /* the same as the value ISOM_TRANSFER_INDEX_SMPTE_240M_1999 */
1292 };
1294 /* Index for the matrix coefficients associated with derivation of luma and chroma signals from the green, blue, and red primaries */
1295 enum
1296 {
1297 /* for ISO Base Media file format */
1299 * IEC 61966-2-1 (sRGB) */
1301 * SMPTE 274M-1995, SMPTE 296M-1997
1302 * IEC 61966-2-1 (sYCC), IEC 61966-2-4 xvYCC_709,
1303 * SMPTE RP 177M-1993 Annex B
1304 * vKr = 0.2126; vKb = 0.0722 */
1306 ISOM_MATRIX_INDEX_USFCCT_47_CFR = 4, /* United States Federal Communications Commission Title 47 Code of Federal Regulations
1307 * vKr = 0.30; vKb = 0.11 */
1309 * ITU-R BT.601-4/6 625, ITU-R BT.1358 625,
1310 * ITU-R BT.1700 625 PAL and 625 SECAM, IEC 61966-2-4 xvYCC601
1311 * vKr = 0.299; vKb = 0.114 */
1313 * ITU-R BT.1700 NTSC,
1314 * SMPTE 170M-1994, SMPTE 293M-1996
1315 * functionally the same as the value ISOM_MATRIX_INDEX_ITU_R470BG
1316 * vKr = 0.299; vKb = 0.114 */
1317 ISOM_MATRIX_INDEX_SMPTE_240M_1999 = 7, /* SMPTE 240M-1995, interim color implementation of SMPTE 274M-1995
1318 * vKr = 0.212; vKb = 0.087 */
1321 /* for QuickTime file format */
1325 QT_MATRIX_INDEX_SMPTE_240M_1995 = 7 /* the same as the value ISOM_MATRIX_INDEX_SMPTE_240M_1999 */
1326 };
1329 {
1330 LSMASH_BASE_SUMMARY
1331 // lsmash_mp4v_VideoObjectType vot; /* Detailed codec type. If not mp4v, just ignored. */
1333 * User can't set this parameter manually. */
1335 * User can't set this parameter manually. */
1337 * User can't set this parameter manually. */
1339 * User can't set this parameter manually. */
1342 char compressorname[33]; /* a 32-byte Pascal string containing the name of the compressor that created the image */
1347 struct
1348 {
1349 /* To omit to write these field, set zero value to all them. */
1351 uint16_t transfer_index; /* the opto-electronic transfer characteristic of the image color components */
1352 uint16_t matrix_index; /* the matrix coefficients associated with derivation of luma and chroma signals from the green, blue, and red primaries */
1357 int lsmash_convert_crop_into_clap
1358 (
1359 lsmash_crop_t crop,
1362 lsmash_clap_t *clap
1363 );
1365 int lsmash_convert_clap_into_crop
1366 (
1367 lsmash_clap_t clap,
1370 lsmash_crop_t *crop
1371 );
1373 /****************************************************************************
1374 * Media Sample
1375 ****************************************************************************/
1377 {
1378 /* allow_ealier */
1380 /* leading */
1385 /* independent */
1389 /* disposable */
1393 /* redundant */
1400 {
1401 /* flags for ISO Base Media file format */
1406 * This flag shall be set together with ISOM_SAMPLE_RANDOM_ACCESS_FLAG_RAP. */
1408 * This flag shall be set together with ISOM_SAMPLE_RANDOM_ACCESS_FLAG_RAP. */
1409 ISOM_SAMPLE_RANDOM_ACCESS_FLAG_GDR = 1 << 5, /* a sample on gradual decoder refresh or random access recovery */
1410 ISOM_SAMPLE_RANDOM_ACCESS_FLAG_GDR_START = 1 << 6, /* a sample that is the starting point of gradual decoder refresh or random access recovery
1411 * This flag shall be set together with ISOM_SAMPLE_RANDOM_ACCESS_FLAG_GDR. */
1412 ISOM_SAMPLE_RANDOM_ACCESS_FLAG_GDR_END = 1 << 7, /* a sample that is the ending point of gradual decoder refresh or random access recovery
1413 * This flag shall be set together with ISOM_SAMPLE_RANDOM_ACCESS_FLAG_GDR. */
1415 ISOM_SAMPLE_RANDOM_ACCESS_FLAG_CLOSED_RAP /* the first sample of a closed GOP */
1416 = ISOM_SAMPLE_RANDOM_ACCESS_FLAG_RAP
1418 ISOM_SAMPLE_RANDOM_ACCESS_FLAG_OPEN_RAP /* the first sample of an open GOP */
1419 = ISOM_SAMPLE_RANDOM_ACCESS_FLAG_RAP
1421 ISOM_SAMPLE_RANDOM_ACCESS_FLAG_POST_ROLL_START /* the post-roll starting point of random access recovery */
1422 = ISOM_SAMPLE_RANDOM_ACCESS_FLAG_GDR
1424 ISOM_SAMPLE_RANDOM_ACCESS_FLAG_PRE_ROLL_END /* the pre-roll ending point of random access recovery */
1425 = ISOM_SAMPLE_RANDOM_ACCESS_FLAG_GDR
1428 /* flags for QuickTime file format */
1432 * Partial sync sample is a sample
1433 * such that this sample and samples following in decoding order can be correctly decoded
1434 * using the first sample of the previous GOP and samples following in decoding order,
1435 * in addition, this sample and non-leading samples following in decoding order can be correctly decoded from this. */
1440 QT_SAMPLE_RANDOM_ACCESS_FLAG_CLOSED_RAP /* the first sample of a closed GOP */
1441 = QT_SAMPLE_RANDOM_ACCESS_FLAG_RAP
1443 QT_SAMPLE_RANDOM_ACCESS_FLAG_OPEN_RAP /* the first sample of an open GOP */
1444 = QT_SAMPLE_RANDOM_ACCESS_FLAG_RAP
1448 #define LSMASH_FLAGS_SATISFIED( x, y ) (((x) & (y)) == (y))
1449 #define LSMASH_IS_CLOSED_RAP( x ) LSMASH_FLAGS_SATISFIED( (x), ISOM_SAMPLE_RANDOM_ACCESS_FLAG_CLOSED_RAP )
1450 #define LSMASH_IS_OPEN_RAP( x ) LSMASH_FLAGS_SATISFIED( (x), ISOM_SAMPLE_RANDOM_ACCESS_FLAG_OPEN_RAP )
1451 #define LSMASH_IS_POST_ROLL_START( x ) LSMASH_FLAGS_SATISFIED( (x), ISOM_SAMPLE_RANDOM_ACCESS_FLAG_POST_ROLL_START )
1452 #define LSMASH_IS_PRE_ROLL_END( x ) LSMASH_FLAGS_SATISFIED( (x), ISOM_SAMPLE_RANDOM_ACCESS_FLAG_PRE_ROLL_END )
1455 {
1457 * If this identifier equals a certain identifier of random access recovery point,
1458 * then this sample is the random access recovery point of the earliest unestablished post-roll group. */
1459 uint32_t complete; /* the identifier of future random access recovery point, which is necessary for the recovery from its starting point to be completed
1460 * For muxing, this value is used only if (ra_flags & ISOM_SAMPLE_RANDOM_ACCESS_TYPE_POST_ROLL_START) is true.
1461 * The following is an example of use for gradual decoder refresh of H.264/AVC.
1462 * For each sample, set 'frame_num' to the 'identifier'.
1463 * For samples with recovery point SEI message, add ISOM_SAMPLE_RANDOM_ACCESS_TYPE_POST_ROLL_START to ra_flags
1464 * and set '(frame_num + recovery_frame_cnt) % MaxFrameNum' to the 'complete'.
1465 * The above-mentioned values are set appropriately, then L-SMASH will establish appropriate post-roll grouping. */
1469 {
1470 uint32_t distance; /* the distance from the previous random access point or pre-roll starting point
1471 * of the random access recovery point to this sample.
1472 * For muxing, this value is used only if ra_flags is not set to ISOM_SAMPLE_RANDOM_ACCESS_TYPE_NONE
1473 * and LSMASH_IS_POST_ROLL_START( ra_flags ) is false.
1474 * Some derived specifications forbid using pre-roll settings and use post-roll settings instead (e.g. AVC uses only post-roll).
1475 * The following is an example of pre-roll distance for representing audio decoder delay derived from composition.
1476 * Typical AAC encoding uses a transform over consecutive sets of 2048 audio samples,
1477 * applied every 1024 audio samples (MDCTs are overlapped).
1478 * For correct audio to be decoded, both transforms for any period of 1024 audio samples are needed.
1479 * For this AAC stream, therefore, 'distance' of each sample shall be set to 1 (one AAC access unit).
1480 * Note: the number of priming audio sample i.e. encoder delay shall be represented by 'start_time' in an edit. */
1484 {
1486 lsmash_post_roll_t post_roll;
1487 lsmash_pre_roll_t pre_roll;
1494 * broken link
1495 * ??? */
1499 {
1501 * Note: this is NOT always an allocated size. */
1507 lsmash_sample_property_t prop;
1511 {
1517 {
1522 /* Allocate a sample and then allocate data of the allocated sample by 'size'.
1523 * If 'size' is set to 0, data of the allocated sample won't be allocated and will be set to NULL instead.
1524 * The allocated sample can be deallocated by lsmash_delete_sample().
1525 *
1526 * Return the address of an allocated sample if successful.
1527 * Return NULL otherwise. */
1528 lsmash_sample_t *lsmash_create_sample
1529 (
1531 );
1533 /* Allocate data of a given allocated sample by 'size'.
1534 * If the sample data is already allocated, reallocate it by 'size'.
1535 *
1536 * Return 0 if successful.
1537 * Return a negative value otherwise. */
1538 int lsmash_sample_alloc
1539 (
1542 );
1544 /* Deallocate a given sample. */
1545 void lsmash_delete_sample
1546 (
1548 );
1550 /* Append a sample to a track.
1551 * Note:
1552 * The appended sample will be deleted by lsmash_delete_sample() internally.
1553 * Users shall not deallocate the sample by lsmash_delete_sample() if successful to append the sample.
1554 *
1555 * Return 0 if successful.
1556 * Return a negative value otherwise. */
1557 int lsmash_append_sample
1558 (
1561 lsmash_sample_t *sample
1562 );
1564 /****************************************************************************
1565 * Media Layer
1566 ****************************************************************************/
1567 /* Media handler types */
1569 {
1597 /* ISO language codes */
1599 {
1600 #define LSMASH_PACK_ISO_LANGUAGE( a, b, c ) ((((a-0x60)&0x1f)<<10) | (((b-0x60)&0x1f)<<5) | ((c-0x60)&0x1f))
1706 {
1708 * You can't change handler_type through this parameter manually. */
1711 * You can't set this parameter manually. */
1713 * Require 'avc1' brand, or ISO Base Media File Format version 2 or later. */
1715 * Require ISO Base Media File Format version 6 or later. */
1716 /* Use either type of language code. */
1719 /* human-readable name for the track type (for debugging and inspection purposes) */
1722 /* Any user shouldn't use the following parameters. */
1728 {
1731 /* Probably, additional string fields such as thing to indicate URN will be added in the future. */
1734 /* Set all the given media parameters to default. */
1735 void lsmash_initialize_media_parameters
1736 (
1737 lsmash_media_parameters_t *param /* the address of the media parameters to which you want to set default value */
1738 );
1740 /* Set media parameters to a track.
1741 *
1742 * Return 0 if successful.
1743 * Return a negative value otherwise. */
1744 int lsmash_set_media_parameters
1745 (
1746 lsmash_root_t *root, /* the address of a ROOT containing a track to which you want to set the media parameters */
1748 lsmash_media_parameters_t *param /* the address of the media parameters you want to set to a track. */
1749 );
1751 /* Set the duration of the last sample to a track.
1752 *
1753 * Return 0 if successful.
1754 * Return a negative value otherwise. */
1755 int lsmash_set_last_sample_delta
1756 (
1759 uint32_t sample_delta
1760 );
1762 /* Flush samples in the internal pool in a track.
1763 * Users shall call this function for each track before calling lsmash_finish_movie() or lsmash_create_fragment_movie().
1764 *
1765 * Return 0 if successful.
1766 * Return a negative value otherwise. */
1767 int lsmash_flush_pooled_samples
1768 (
1771 uint32_t last_sample_delta
1772 );
1774 /* Update the modification time of a media to the most recent.
1775 * If the creation time of that media is larger than the modification time,
1776 * then override the creation one with the modification one.
1777 *
1778 * Return 0 if successful.
1779 * Return a negative value otherwise. */
1780 int lsmash_update_media_modification_time
1781 (
1783 uint32_t track_ID
1784 );
1786 /* Get the media parameters in a track.
1787 *
1788 * Return 0 if successful.
1789 * Return a negative value otherwise. */
1790 int lsmash_get_media_parameters
1791 (
1794 lsmash_media_parameters_t *param
1795 );
1797 /* Get the duration of a media.
1798 *
1799 * Return the duration of a media if successful.
1800 * Return 0 otherwise. */
1801 uint64_t lsmash_get_media_duration
1802 (
1804 uint32_t track_ID
1805 );
1807 /* Get the timescale of a media.
1808 *
1809 * Return the timescale of a media if successful.
1810 * Return 0 otherwise. */
1811 uint32_t lsmash_get_media_timescale
1812 (
1814 uint32_t track_ID
1815 );
1817 /* Get the duration of the last sample in a track.
1818 *
1819 * Return the duration of the last sample in a track if successful.
1820 * Return 0 otherwise. */
1821 uint32_t lsmash_get_last_sample_delta
1822 (
1824 uint32_t track_ID
1825 );
1827 /* Get the composition time offset of the first sample in a track.
1828 *
1829 * Return the composition time offset of the first sample in a track if successful.
1830 * Return 0 otherwise. */
1831 uint32_t lsmash_get_start_time_offset
1832 (
1834 uint32_t track_ID
1835 );
1837 /* Get the shift of composition timeline to decode timeline in a track.
1838 *
1839 * Return the shift of composition timeline to decode timeline in a track. if successful.
1840 * Return 0 otherwise. */
1841 uint32_t lsmash_get_composition_to_decode_shift
1842 (
1844 uint32_t track_ID
1845 );
1847 /* Pack a string of ISO 639-2/T language code into 16-bit data.
1848 *
1849 * Return a packed 16-bit ISO 639-2/T language if successful.
1850 * Return 0 otherwise. */
1851 uint16_t lsmash_pack_iso_language
1852 (
1854 );
1856 /* Count the number of data references in a track.
1857 *
1858 * Return the number of data references in a track if no error.
1859 * Return 0 otherwise. */
1860 uint32_t lsmash_count_data_reference
1861 (
1863 uint32_t track_ID
1864 );
1866 /* Get the location of a data reference in a track by specifying the index in 'data_ref'.
1867 * The string fields in 'data_ref' may be allocated if referencing external media data.
1868 * If referencing self-contained media data, the all string fields are set to NULL.
1869 * You can deallocate the allocated fields by lsmash_free().
1870 * Also you can deallocate all of the allocated fields by lsmash_cleanup_data_reference() at a time.
1871 *
1872 * Return 0 if successful.
1873 * Return a negative value otherwise. */
1874 int lsmash_get_data_reference
1875 (
1878 lsmash_data_reference_t *data_ref
1879 );
1881 /* Deallocate all of allocated fields in a given data reference at a time.
1882 * The deallocated fields are set to NULL. */
1883 void lsmash_cleanup_data_reference
1884 (
1885 lsmash_data_reference_t *data_ref
1886 );
1888 /* Create a data reference in a track and specify its location on playback for writing.
1889 * If no settings for data references in a track, the location of the first data reference is specified to
1890 * the location of the same file implicitly.
1891 * Note that referenced files shall be used as a media, i.e. LSMASH_FILE_MODE_MEDIA shall be set to the 'mode'
1892 * in the lsmash_file_parameters_t before calling lsmash_set_file().
1893 *
1894 * As restrictions of the libary,
1895 * WARNING1: The box structured media files cannot be used as a reference data yet.
1896 * WARNING2: The external media files cannot be used as a reference data for movie fragments yet.
1897 *
1898 * Return 0 if successful.
1899 * Return a negative value otherwise. */
1900 int lsmash_create_data_reference
1901 (
1905 lsmash_file_t *file
1906 );
1908 /* Assign a data reference in a track to a read file.
1909 *
1910 * Return 0 if successful.
1911 * Return a negative value otherwise. */
1912 int lsmash_assign_data_reference
1913 (
1917 lsmash_file_t *file
1918 );
1920 /****************************************************************************
1921 * Track Layer
1922 ****************************************************************************/
1923 /* Track mode */
1925 {
1926 /* In MP4 and/or ISO base media file format, if in a presentation all tracks have neither track_in_movie nor track_in_preview set,
1927 * then all tracks shall be treated as if both flags were set on all tracks. */
1929 * A disabled track is treated as if it were not present. */
1930 ISOM_TRACK_IN_MOVIE = 0x000002, /* Track_in_movie: Indicates that the track is used in the presentation. */
1931 ISOM_TRACK_IN_PREVIEW = 0x000004, /* Track_in_preview: Indicates that the track is used when previewing the presentation. */
1933 QT_TRACK_IN_POSTER = 0x000008, /* Track_in_poster: Indicates that the track is used in the movie's poster. (only defined in QuickTime file format) */
1937 {
1938 lsmash_track_mode mode;
1940 * Don't set to value already used except for zero value.
1941 * Zero value don't override established track_ID. */
1943 * If there is any edit, your setting is ignored. */
1945 * If this field is not 0, it should be the same for tracks that contain alternate data for one another
1946 * and different for tracks belonging to different such groups.
1947 * Only one track within an alternate group should be played or streamed at any one time.
1948 * Note: alternate_group is ignored when a file is read as an MPEG-4. */
1949 /* The following parameters are ignored when a file is read as an MPEG-4 or 3GPP file format. */
1950 int16_t video_layer; /* the front-to-back ordering of video tracks; tracks with lower numbers are closer to the viewer. */
1953 * Each value represents, in order, a, b, u, c, d, v, x, y and w.
1954 * All the values in a matrix are stored as 16.16 fixed-point values,
1955 * except for u, v and w, which are stored as 2.30 fixed-point values.
1956 * Not all derived specifications use matrices.
1957 * If a matrix is used, the point (p, q) is transformed into (p', q') using the matrix as follows:
1958 * | a b u |
1959 * (p, q, 1) * | c d v | = z * (p', q', 1)
1960 * | x y w |
1961 * p' = (a * p + c * q + x) / z; q' = (b * p + d * q + y) / z; z = u * p + v * q + w
1962 * Note: transformation matrix is applied after scaling to display size up to display_width and display_height. */
1963 /* visual presentation region size */
1964 uint32_t display_width; /* visual presentation region size of horizontal direction as fixed point 16.16 number. */
1965 uint32_t display_height; /* visual presentation region size of vertical direction as fixed point 16.16 number. */
1966 /* */
1968 * This feature is only available under QuickTime file format.
1969 * Automatically disabled if multiple sample description is present or scaling method is specified. */
1972 /* Explicit Timeline Map (Edit)
1973 * There are two types of timeline; one is the media timeline, the other is the presentation timeline (or the movie timeline).
1974 * An edit maps the presentation timeline to the media timeline.
1975 * Therefore, an edit can select any portion within the media and specify its playback speed.
1976 * The media within the track is played through the presentation timeline, so you can construct any complex presentation from a media by edits.
1977 * In the absence of any edit, there is an implicit one-to-one mapping of these timelines, and the presentation of a track starts at the beginning of the presentation.
1978 * Note: any edit doesn't restrict decoding and composition. So, if a sample in an edit need to decode from a sample in outside of that edit,
1979 * the decoder shall start to decode from there but player shall not display any sample in outside of that edit. */
1980 #define ISOM_EDIT_MODE_NORMAL (1<<16)
1981 #define ISOM_EDIT_MODE_DWELL 0
1982 #define ISOM_EDIT_MODE_EMPTY -1
1983 #define ISOM_EDIT_DURATION_UNKNOWN32 0xffffffff
1984 #define ISOM_EDIT_DURATION_UNKNOWN64 0xffffffffffffffff
1985 #define ISOM_EDIT_DURATION_IMPLICIT 0
1988 {
1990 * An edit can refer to the media within fragmented tracks.
1991 * The duration can be unknown at the time of creation of the initial movie due to various limiting factors that include
1992 * real-time generation of content, such as live streaming. In such a case it is recommended that the duration is set to
1993 * either ISOM_EDIT_DURATION_UNKNOWN32 (the maximum 32-bit unsigned integer), ISOM_EDIT_DURATION_UNKNOWN64 (the maximum
1994 * 64-bit unsigned integer) or ISOM_EDIT_DURATION_IMPLICIT.
1995 * If you have no interest in the duration of this edit but want to set the offset from media composition time to movie
1996 * presentation time, ISOM_EDIT_DURATION_IMPLICIT is useful for the provision of the offset for the movie and subsequent
1997 * movie fragments. The duration is expected to be constructed by demuxer. */
1999 * If set to ISOM_EDIT_MODE_EMPTY (-1), it construct an empty edit, which doesn't select any portion within the media. */
2000 int32_t rate; /* the relative rate at which to play the media corresponding to this edit, expressed as 16.16 fixed-point number
2001 * If set to ISOM_EDIT_MODE_NORMAL (0x00010000), there is no rate change for timeline mapping.
2002 * If set to ISOM_EDIT_MODE_DWELL (0), the media at start_time is presented for the duration. */
2005 /* Create a track in a movie.
2006 * Users can destroy the created track by lsmash_delete_track().
2007 * When a track is created, its track_ID is assigned automatically so that any duplication of track_ID may be avoided.
2008 *
2009 * Return the current track_ID of a track created by this function if successful.
2010 * Return 0 otherwise. */
2011 uint32_t lsmash_create_track
2012 (
2014 lsmash_media_type media_type
2015 );
2017 /* Destroy the track of a given track_ID in a movie. */
2018 void lsmash_delete_track
2019 (
2021 uint32_t track_ID
2022 );
2024 /* Set all the given track parameters to default. */
2025 void lsmash_initialize_track_parameters
2026 (
2027 lsmash_track_parameters_t *param
2028 );
2030 /* Set track parameters to a track.
2031 *
2032 * Return 0 if successful.
2033 * Return a negative value otherwise. */
2034 int lsmash_set_track_parameters
2035 (
2038 lsmash_track_parameters_t *param
2039 );
2041 /* Update the duration of a track with a new duration of its last sample.
2042 *
2043 * Return 0 if successful.
2044 * Return a negative value otherwise. */
2045 int lsmash_update_track_duration
2046 (
2049 uint32_t last_sample_delta
2050 );
2052 /* Update the modification time of a track to the most recent.
2053 * If the creation time of that track is larger than the modification time,
2054 * then override the creation one with the modification one.
2055 *
2056 * Return 0 if successful.
2057 * Return a negative value otherwise. */
2058 int lsmash_update_track_modification_time
2059 (
2061 uint32_t track_ID
2062 );
2064 /* Get a track_ID by a track number.
2065 * A track number is given in created order in a movie.
2066 * If a track is removed, the track number of tracks with higher track number than one of just removed track will be decremented.
2067 *
2068 * Return a track_ID if successful.
2069 * Return 0 otherwise. */
2070 uint32_t lsmash_get_track_ID
2071 (
2073 uint32_t track_number
2074 );
2076 /* Get the track parameters in a track.
2077 *
2078 * Return 0 if successful.
2079 * Return a negative value otherwise. */
2080 int lsmash_get_track_parameters
2081 (
2084 lsmash_track_parameters_t *param
2085 );
2087 /* Get the duration of a track.
2088 *
2089 * Return the duration of a track if successful.
2090 * Return 0 otherwise. */
2091 uint64_t lsmash_get_track_duration
2092 (
2094 uint32_t track_ID
2095 );
2097 /* Create an explicit timeline map (edit) and append it into a track.
2098 * Users can destroy ALL created edits in a track by lsmash_delete_explicit_timeline_map().
2099 *
2100 * Return 0 if successful.
2101 * Return a negative value otherwise. */
2102 int lsmash_create_explicit_timeline_map
2103 (
2106 lsmash_edit_t edit
2107 );
2109 /* Destroy ALL created edits in a track.
2110 *
2111 * Return 0 if successful.
2112 * Return a negative value otherwise. */
2113 int lsmash_delete_explicit_timeline_map
2114 (
2116 uint32_t track_ID
2117 );
2119 /* Count the number of edits in a track.
2120 *
2121 * Return the number of edits in a track if successful.
2122 * Return 0 otherwise. */
2123 uint32_t lsmash_count_explicit_timeline_map
2124 (
2126 uint32_t track_ID
2127 );
2129 /* Get an edit in a track by an edit number.
2130 * An edit number is given in created order in a track.
2131 * If an edit is removed, the edit number of edits with higher edit number than one of just removed edit will be decremented.
2132 *
2133 * Return 0 if successful.
2134 * Return a negative value otherwise. */
2135 int lsmash_get_explicit_timeline_map
2136 (
2140 lsmash_edit_t *edit
2141 );
2143 /* Modify an edit in a track by an edit number.
2144 * An edit number is given in created order in a track.
2145 * If an edit is removed, the edit number of edits with higher edit number than one of just removed edit will be decremented.
2146 *
2147 * Return 0 if successful.
2148 * Return a negative value otherwise. */
2149 int lsmash_modify_explicit_timeline_map
2150 (
2154 lsmash_edit_t edit
2155 );
2157 /****************************************************************************
2158 * Movie Layer
2159 ****************************************************************************/
2161 {
2164 * You can't set this parameter manually. */
2166 * You can't set this parameter manually. */
2167 /* The following parameters are recognized only when a file is read as an Apple MPEG-4 or QuickTime file format. */
2168 int32_t playback_rate; /* fixed point 16.16 number. 0x00010000 is normal forward playback and default value. */
2169 int32_t playback_volume; /* fixed point 8.8 number. 0x0100 is full volume and default value. */
2175 /* Set all the given movie parameters to default. */
2176 void lsmash_initialize_movie_parameters
2177 (
2178 lsmash_movie_parameters_t *param
2179 );
2181 /* Set movie parameters to a movie.
2182 *
2183 * Return 0 if successful.
2184 * Return a negative value otherwise. */
2185 int lsmash_set_movie_parameters
2186 (
2188 lsmash_movie_parameters_t *param
2189 );
2191 /* Finalize a movie.
2192 * If the movie is not fragmented and 'remux' is set to non-NULL,
2193 * move overall necessary data to access and decode samples into the very front of the file at the end.
2194 * This is useful for progressive downloading.
2195 * Users shall call lsmash_flush_pooled_samples() for each track before calling this function.
2196 *
2197 * Return 0 if successful.
2198 * Return a negative value otherwise. */
2199 int lsmash_finish_movie
2200 (
2202 lsmash_adhoc_remux_t *remux
2203 );
2205 /* Update the modification time of a movie to the most recent.
2206 * If the creation time of that movie is larger than the modification time,
2207 * then override the creation one with the modification one.
2208 *
2209 * Return 0 if successful.
2210 * Return a negative value otherwise. */
2211 int lsmash_update_movie_modification_time
2212 (
2213 lsmash_root_t *root
2214 );
2216 /* Get the movie parameters in a movie.
2217 *
2218 * Return 0 if successful.
2219 * Return a negative value otherwise. */
2220 int lsmash_get_movie_parameters
2221 (
2223 lsmash_movie_parameters_t *param
2224 );
2226 /* Get the timescale of a movie.
2227 *
2228 * Return the timescale of a movie if successful.
2229 * Return 0 otherwise. */
2230 uint32_t lsmash_get_movie_timescale
2231 (
2232 lsmash_root_t *root
2233 );
2235 /****************************************************************************
2236 * Chapter list
2237 ****************************************************************************/
2238 /* Create a track as a chapter list referenced by another track.
2239 *
2240 * Return 0 if successful.
2241 * Return a negative value otherwise. */
2242 int lsmash_create_reference_chapter_track
2243 (
2247 );
2249 /* Create and set a chapter list as a user data to a movie.
2250 * The created chapter list in a movie can be destroyed by lsmash_delete_tyrant_chapter().
2251 *
2252 * Return 0 if successful.
2253 * Return a negative value otherwise. */
2254 int lsmash_set_tyrant_chapter
2255 (
2258 int add_bom
2259 );
2261 /* Destroy a chapter list as a user data in a movie. */
2262 void lsmash_delete_tyrant_chapter
2263 (
2264 lsmash_root_t *root
2265 );
2267 /* Count chapters in the chapter list (moov.udta.chpl). */
2268 uint32_t lsmash_count_tyrant_chapter
2269 (
2270 lsmash_root_t *root
2271 );
2273 /* Retrieve a chapter entry from the chapter list (moov.udta.chpl).
2274 * Returned pointer is owned by the ROOT structure, so user shall not
2275 * modify or free it.
2276 *
2277 * Return chapter title string if successful, otherwise NULL.
2278 */
2280 (
2284 );
2286 /****************************************************************************
2287 * Fragments
2288 ****************************************************************************/
2289 /* Flush the current movie fragment and create a new movie fragment.
2290 * Users shall call lsmash_flush_pooled_samples() for each track before calling this function.
2291 *
2292 * Return 0 if successful.
2293 * Return a negative value otherwise. */
2294 int lsmash_create_fragment_movie
2295 (
2296 lsmash_root_t *root
2297 );
2299 /* Create an empty duration track in the current movie fragment.
2300 * Don't specify track_ID any track fragment in the current movie fragment has.
2301 *
2302 * Return 0 if successful.
2303 * Return a negative value otherwise. */
2304 int lsmash_create_fragment_empty_duration
2305 (
2308 uint32_t duration
2309 );
2311 #ifdef LSMASH_DEMUXER_ENABLED
2312 /****************************************************************************
2313 * Dump / Print
2314 ****************************************************************************/
2315 /* Dump and print box structure of ROOT into the destination.
2316 *
2317 * Return 0 if successful.
2318 * Return a negative value otherwise. */
2319 int lsmash_print_movie
2320 (
2323 );
2325 /* Print a chapter list written as a user data on stdout.
2326 * This function might output BOM on Windows.
2327 *
2328 * Return 0 if successful.
2329 * Return a negative value otherwise. */
2330 int lsmash_print_chapter_list
2331 (
2332 lsmash_root_t *root
2333 );
2335 /****************************************************************************
2336 * Timeline
2337 ****************************************************************************/
2338 /* Copy all edits from the source track to the destination track.
2339 *
2340 * Return 0 if successful.
2341 * Return a negative value otherwise. */
2342 int lsmash_copy_timeline_map
2343 (
2347 uint32_t src_track_ID
2348 );
2350 /* Construct the timeline for a track.
2351 * The constructed timeline can be destructed by lsmash_destruct_timeline().
2352 *
2353 * Return 0 if successful.
2354 * Return a negative value otherwise. */
2355 int lsmash_construct_timeline
2356 (
2358 uint32_t track_ID
2359 );
2361 /* Destruct the timeline for a given track. */
2362 void lsmash_destruct_timeline
2363 (
2365 uint32_t track_ID
2366 );
2368 /* Get the duration of the last sample from the media timeline for a track.
2369 *
2370 * Return 0 if successful.
2371 * Return a negative value otherwise. */
2372 int lsmash_get_last_sample_delta_from_media_timeline
2373 (
2376 uint32_t *last_sample_delta /* the address of a variable to which the duration of the last sample will be set */
2377 );
2379 /* Get the duration of a sample from the media timeline for a track.
2380 *
2381 * Return 0 if successful.
2382 * Return a negative value otherwise. */
2383 int lsmash_get_sample_delta_from_media_timeline
2384 (
2388 uint32_t *sample_delta /* the address of a variable to which the duration of a sample will be set */
2389 );
2391 /* Get the decoding timestamp of a sample from the media timeline for a track.
2392 *
2393 * Return 0 if successful.
2394 * Return a negative value otherwise. */
2395 int lsmash_get_dts_from_media_timeline
2396 (
2401 );
2403 /* Get the composition timestamp of a sample from the media timeline for a track.
2404 *
2405 * Return 0 if successful.
2406 * Return a negative value otherwise. */
2407 int lsmash_get_cts_from_media_timeline
2408 (
2413 );
2415 /* Get the shift of composition timeline to decode timeline from the media timeline for a track.
2416 *
2417 * Return 0 if successful.
2418 * Return a negative value otherwise. */
2419 int lsmash_get_composition_to_decode_shift_from_media_timeline
2420 (
2423 uint32_t *ctd_shift /* the address of a variable to which the shift of composition timeline to decode timeline will be set */
2424 );
2426 /* Get the sample number which is the closest random accessible point to the sample
2427 * corresponding to a given sample number from the media timeline for a track.
2428 * This function tries to find the closest random accessible point from the past at the first.
2429 * If not found, try to find it from the future.
2430 * Note:
2431 * the closest random accessible point doesn't always guarantee that
2432 * the sample corresponding to a given number can be decodable correctly by decoding from there.
2433 *
2434 * Return 0 if successful.
2435 * Return a negative value otherwise. */
2436 int lsmash_get_closest_random_accessible_point_from_media_timeline
2437 (
2441 uint32_t *rap_number /* the address of a variable to which the sample number of the closest random accessible point will be set */
2442 );
2444 /* Get the detailed information of the closest random accessible point to the sample
2445 * corresponding to a given sample number from the media timeline for a track.
2446 * Note:
2447 * the closest random accessible point doesn't always guarantee that
2448 * the sample corresponding to a given number can be decodable correctly by decoding from there.
2449 *
2450 * Return 0 if successful.
2451 * Return a negative value otherwise. */
2452 int lsmash_get_closest_random_accessible_point_detail_from_media_timeline
2453 (
2457 uint32_t *rap_number, /* the address of a variable to which the sample number of the closest random accessible point will be set */
2458 lsmash_random_access_flag *ra_flags, /* the address of a variable to which the flags of the closest random accessible point will be set */
2459 uint32_t *leading, /* the address of a variable to which the number of leading samples will be set */
2460 uint32_t *distance /* the address of a variable to which a distance from the closest random accessible point to a point which guarantees
2461 * that the sample corresponding to a given number can be decodable correctly by decoding from there will be set */
2462 );
2464 /* Get the number of samples in the media timeline for a track.
2465 *
2466 * Return the number of samples in a track if successful.
2467 * Return 0 otherwise. */
2468 uint32_t lsmash_get_sample_count_in_media_timeline
2469 (
2471 uint32_t track_ID
2472 );
2474 /* Get the maximum size of sample in the media timeline for a track.
2475 *
2476 * Return the maximum size of the samples in a track if successful.
2477 * Return 0 otherwise. */
2478 uint32_t lsmash_get_max_sample_size_in_media_timeline
2479 (
2481 uint32_t track_ID
2482 );
2484 /* Get the duration of the media from the media timeline for a track.
2485 *
2486 * Return the duration of the media in a track if successful.
2487 * Return 0 otherwise. */
2488 uint64_t lsmash_get_media_duration_from_media_timeline
2489 (
2491 uint32_t track_ID
2492 );
2494 /* Allocate and get the sample corresponding to a given sample number from the media timeline for a track.
2495 * The allocated sample can be deallocated by lsmash_delete_sample().
2496 *
2497 * Return the address of an allocated and gotten sample if successful.
2498 * Return NULL otherwise. */
2499 lsmash_sample_t *lsmash_get_sample_from_media_timeline
2500 (
2503 uint32_t sample_number
2504 );
2506 /* Get the information of the sample correspondint to a given sample number from the media timeline for a track.
2507 * The information includes the size, timestamps and properties of the sample.
2508 *
2509 * Return 0 if successful.
2510 * Return a negative value otherwise. */
2511 int lsmash_get_sample_info_from_media_timeline
2512 (
2516 lsmash_sample_t *sample
2517 );
2519 /* Get the properties of the sample correspondint to a given sample number from the media timeline for a track.
2520 *
2521 * Return 0 if successful.
2522 * Return a negative value otherwise. */
2523 int lsmash_get_sample_property_from_media_timeline
2524 (
2528 lsmash_sample_property_t *prop
2529 );
2531 /* Check if the sample corresponding to a given sample number exists in the media timeline for a track.
2532 *
2533 * Return 1 if the sample exists.
2534 * Return 0 otherwise. */
2535 int lsmash_check_sample_existence_in_media_timeline
2536 (
2539 uint32_t sample_number
2540 );
2542 /* Set or change the decoding and composition timestamps in the media timeline for a track.
2543 * This function doesn't support for any LPCM track currently.
2544 *
2545 * Return 0 if successful.
2546 * Return a negative value othewise. */
2547 int lsmash_set_media_timestamps
2548 (
2551 lsmash_media_ts_list_t *ts_list
2552 );
2554 /* Allocate and get the decoding and composition timestamps from the media timeline for a track.
2555 * The allocated decoding and composition timestamps can be deallocated by lsmash_delete_media_timestamps().
2556 *
2557 * Return 0 if successful.
2558 * Return a negative value othewise. */
2559 int lsmash_get_media_timestamps
2560 (
2563 lsmash_media_ts_list_t *ts_list
2564 );
2566 /* Deallocate the decoding and composition timestamps in a given media timestamp list. */
2567 void lsmash_delete_media_timestamps
2568 (
2569 lsmash_media_ts_list_t *ts_list
2570 );
2572 /* Get the maximum composition delay derived from composition reordering.
2573 *
2574 * Return 0 if successful.
2575 * Return a negative value otherwise. */
2576 int lsmash_get_max_sample_delay
2577 (
2580 );
2582 /* Sort decoding and composition timestamps in decoding order. */
2583 void lsmash_sort_timestamps_decoding_order
2584 (
2585 lsmash_media_ts_list_t *ts_list
2586 );
2588 /* Sort decoding and composition timestamps in composition order. */
2589 void lsmash_sort_timestamps_composition_order
2590 (
2591 lsmash_media_ts_list_t *ts_list
2592 );
2593 #endif
2595 /****************************************************************************
2596 * Tools for creating CODEC Specific Information Extensions (Magic Cookies)
2597 ****************************************************************************/
2598 /* MPEG-4 Systems Specific Information
2599 * Mandatory :
2600 * ISOM_CODEC_TYPE_MP4A_AUDIO
2601 * QT_CODEC_TYPE_MP4A_AUDIO
2602 * ISOM_CODEC_TYPE_MP4V_AUDIO
2603 * ISOM_CODEC_TYPE_MP4S_AUDIO */
2604 /* objectTypeIndication */
2606 {
2609 * For all 14496-1 streams unless specifically indicated to the contrary.
2610 * Scene Description scenes, which are identified with StreamType=0x03, using
2611 * this object type value shall use the BIFSConfig. */
2613 * This object type shall be used, with StreamType=0x03, for Scene
2614 * Description streams that use the BIFSv2Config.
2615 * Its use with other StreamTypes is reserved. */
2618 * Used, with StreamType=0x03, for Scene Description streams that use the BIFSConfigEx;
2619 * its use with other StreamTypes is reserved.
2620 * (Was previously reserved for MUCommandStream but not used for that purpose.) */
2622 * Used, with StreamType=0x03, for Scene Description streams that use the AFXConfig;
2623 * its use with other StreamTypes is reserved. */
2628 * The actual object types are within the DecoderSpecificInfo and defined in 14496-2. */
2629 MP4SYS_OBJECT_TYPE_Visual_H264_ISO_14496_10 = 0x21, /* Visual ITU-T Recommendation H.264 | ISO/IEC 14496-10
2630 * The actual object types are within the DecoderSpecificInfo and defined in H.264 | 14496-10. */
2631 MP4SYS_OBJECT_TYPE_Parameter_Sets_H_264_ISO_14496_10 = 0x22, /* Parameter Sets for ITU-T Recommendation H.264 | ISO/IEC 14496-10
2632 * The actual object types are within the DecoderSpecificInfo and defined in H.264 | 14496-10. */
2634 * The actual object types are defined in 14496-3 and are in the DecoderSpecificInfo as specified in 14496-3. */
2635 MP4SYS_OBJECT_TYPE_Visual_ISO_13818_2_Simple_Profile = 0x60, /* Visual ISO/IEC 13818-2 Simple Profile (MPEG-2 Video) */
2636 MP4SYS_OBJECT_TYPE_Visual_ISO_13818_2_Main_Profile = 0x61, /* Visual ISO/IEC 13818-2 Main Profile */
2637 MP4SYS_OBJECT_TYPE_Visual_ISO_13818_2_SNR_Profile = 0x62, /* Visual ISO/IEC 13818-2 SNR Profile */
2638 MP4SYS_OBJECT_TYPE_Visual_ISO_13818_2_Spatial_Profile = 0x63, /* Visual ISO/IEC 13818-2 Spatial Profile */
2639 MP4SYS_OBJECT_TYPE_Visual_ISO_13818_2_High_Profile = 0x64, /* Visual ISO/IEC 13818-2 High Profile */
2640 MP4SYS_OBJECT_TYPE_Visual_ISO_13818_2_422_Profile = 0x65, /* Visual ISO/IEC 13818-2 422 Profile */
2641 MP4SYS_OBJECT_TYPE_Audio_ISO_13818_7_Main_Profile = 0x66, /* Audio ISO/IEC 13818-7 Main Profile (MPEG-2 Audio)(AAC) */
2642 MP4SYS_OBJECT_TYPE_Audio_ISO_13818_7_LC_Profile = 0x67, /* Audio ISO/IEC 13818-7 LowComplexity Profile */
2643 MP4SYS_OBJECT_TYPE_Audio_ISO_13818_7_SSR_Profile = 0x68, /* Audio ISO/IEC 13818-7 Scaleable Sampling Rate Profile
2644 * For streams kinda 13818-7 the decoder specific information consists of the ADIF header if present
2645 * (or none if not present) and an access unit is a "raw_data_block()" as defined in 13818-7. */
2646 MP4SYS_OBJECT_TYPE_Audio_ISO_13818_3 = 0x69, /* Audio ISO/IEC 13818-3 (MPEG-2 BC-Audio)(redefined MPEG-1 Audio in MPEG-2)
2647 * For streams kinda 13818-3 the decoder specific information is empty since all necessary data is in the bitstream frames itself.
2648 * The access units in this case are the "frame()" bitstream element as is defined in 11172-3. */
2653 MP4SYS_OBJECT_TYPE_Visual_ISO_15444_1_JPEG2000 = 0x6E, /* Visual ISO/IEC 15444-1 (JPEG 2000) */
2655 /* FIXME: rename these symbols to be explaining, rather than based on four cc */
2668 MP4SYS_OBJECT_TYPE_DTSE_AUDIO = 0xAC, /* DTS Express low bit rate audio, also known as DTS LBR */
2672 * Streams with this value with a StreamType indicating a systems stream (values 1,2,3,6,7,8,9)
2673 * shall be treated as if the ObjectTypeIndication had been set to 0x01. */
2676 /* streamType */
2678 {
2695 /* MPEG-4 Systems Decoder Specific Information
2696 * an opaque container with information for a specific media decoder
2697 * The existence and semantics of decoder specific information depends on the values of streamType and objectTypeIndication. */
2700 /* Note: bufferSizeDB, maxBitrate and avgBitrate are calculated internally when calling lsmash_finish_movie().
2701 * You need not to set up them manually when muxing streams by L-SMASH. */
2703 {
2704 lsmash_mp4sys_object_type_indication objectTypeIndication;
2705 lsmash_mp4sys_stream_type streamType;
2706 uint32_t bufferSizeDB; /* the size of the decoding buffer for this elementary stream in byte */
2708 * any time window of one second duration */
2710 * Set to 0 if the stream is encoded as variable bitrate. */
2714 int lsmash_set_mp4sys_decoder_specific_info
2715 (
2718 uint32_t payload_length
2719 );
2721 void lsmash_destroy_mp4sys_decoder_specific_info
2722 (
2723 lsmash_mp4sys_decoder_parameters_t *param
2724 );
2727 (
2730 );
2732 /* Return MP4SYS_OBJECT_TYPE_Forbidden if objectTypeIndication is not found or there is an error to find it. */
2733 lsmash_mp4sys_object_type_indication lsmash_mp4sys_get_object_type_indication
2734 (
2735 lsmash_summary_t *summary
2736 );
2738 /* Return -1 if any error.
2739 * Even if the decoder specific information is not found, it is not an error since no decoder specific information is allowed for some stream formats. */
2740 int lsmash_get_mp4sys_decoder_specific_info
2741 (
2745 );
2747 /* AC-3 Specific Information
2748 * Mandatory :
2749 * ISOM_CODEC_TYPE_AC_3_AUDIO
2750 *
2751 * Unlike MPEG-4 Audio formats, the decoder does not require this for the initialization.
2752 * Each AC-3 sample is self-contained.
2753 * Users shall set the actual sample rate to 'frequency', which is a member of lsmash_audio_summary_t. */
2755 {
2764 int lsmash_setup_ac3_specific_parameters_from_syncframe
2765 (
2768 uint32_t data_length
2769 );
2772 (
2775 );
2777 /* Enhanced AC-3 Specific Information
2778 * Mandatory :
2779 * ISOM_CODEC_TYPE_EC_3_AUDIO
2780 *
2781 * Unlike MPEG-4 Audio formats, the decoder does not require this for the initialization.
2782 * Each Enhanced AC-3 sample is self-contained.
2783 * Note that this cannot document reduced sample rates (24000, 22050 or 16000 Hz).
2784 * Therefore, users shall set the actual sample rate to 'frequency', which is a member of lsmash_audio_summary_t. */
2786 {
2790 * If the bsmod field is not present in the independent substream, this field shall be set to 0. */
2793 uint8_t num_dep_sub; /* the number of dependent substreams that are associated with the independent substream */
2794 uint16_t chan_loc; /* channel locations of dependent substreams associated with the independent substream
2795 * This information is extracted from the chanmap field of each dependent substream. */
2799 {
2801 * If the Enhanced AC-3 stream is variable bitrate, then this value indicates the maximum data rate of the stream. */
2802 uint8_t num_ind_sub; /* the number of independent substreams that are present in the Enhanced AC-3 bitstream
2803 * The value of this field is one less than the number of independent substreams present
2804 * and shall be in the range of 0 to 7, inclusive. */
2808 int lsmash_setup_eac3_specific_parameters_from_frame
2809 (
2812 uint32_t data_length
2813 );
2815 uint16_t lsmash_eac3_get_chan_loc_from_chanmap
2816 (
2817 uint16_t chanmap
2818 );
2821 (
2824 );
2826 /* DTS Audio Specific Information
2827 * Mandatory :
2828 * ISOM_CODEC_TYPE_DTSC_AUDIO
2829 * ISOM_CODEC_TYPE_DTSH_AUDIO
2830 * ISOM_CODEC_TYPE_DTSL_AUDIO
2831 * ISOM_CODEC_TYPE_DTSE_AUDIO
2832 *
2833 * Unlike MPEG-4 Audio formats, the decoder does not require this for the initialization.
2834 * Each DTS Audio sample is self-contained. */
2836 {
2852 {
2853 uint32_t DTSSamplingFrequency; /* the maximum sampling frequency stored in the compressed audio stream
2854 * 'frequency', which is a member of lsmash_audio_summary_t, shall be set according to DTSSamplingFrequency of either:
2855 * 48000 for original sampling frequencies of 24000Hz, 48000Hz, 96000Hz or 192000Hz;
2856 * 44100 for original sampling frequencies of 22050Hz, 44100Hz, 88200Hz or 176400Hz;
2857 * 32000 for original sampling frequencies of 16000Hz, 32000Hz, 64000Hz or 128000Hz. */
2858 uint32_t maxBitrate; /* the peak bit rate, in bits per second, of the audio elementary stream for the duration of the track,
2859 * including the core substream (if present) and all extension substreams.
2860 * If the stream is a constant bit rate, this parameter shall have the same value as avgBitrate.
2861 * If the maximum bit rate is unknown, this parameter shall be set to 0. */
2862 uint32_t avgBitrate; /* the average bit rate, in bits per second, of the audio elementary stream for the duration of the track,
2863 * including the core substream and any extension substream that may be present. */
2865 * The value is 16 or 24 bits. */
2866 uint8_t FrameDuration; /* the number of audio samples decoded in a complete audio access unit at DTSSamplingFrequency
2867 * 0: 512, 1: 1024, 2: 2048, 3: 4096 */
2868 uint8_t StreamConstruction; /* complete information on the existence and of location of extensions in any synchronized frame */
2870 * 0: none
2871 * 1: LFE exists */
2873 * If no core substream exists, this parameter shall be ignored and ChannelLayout or
2874 * RepresentationType shall be used to determine channel configuration. */
2876 * If no core substream exists, CoreSize = 0. */
2878 * 0: none
2879 * 1: embedded downmix present */
2881 * 0: Audio asset designated for mixing with another audio asset
2882 * 2: Lt/Rt Encoded for matrix surround decoding
2883 * 3: Audio processed for headphone playback
2884 * otherwise: Reserved
2885 * If ChannelLayout != 0, this value shall be ignored. */
2886 uint16_t ChannelLayout; /* complete information on channels coded in the audio stream including core and extensions */
2888 * 0: single asset
2889 * 1: multiple asset
2890 * When multiple assets exist, the remaining parameters only reflect the coding parameters of the first asset. */
2891 uint8_t LBRDurationMod; /* This flag indicates a special case of the LBR coding bandwidth, resulting in 1/3 or 2/3 band limiting.
2892 * If set to 1, LBR frame duration is 50 % larger than indicated in FrameDuration */
2896 int lsmash_setup_dts_specific_parameters_from_frame
2897 (
2900 uint32_t data_length
2901 );
2903 uint8_t lsmash_dts_get_stream_construction
2904 (
2905 lsmash_dts_construction_flag flags
2906 );
2908 lsmash_dts_construction_flag lsmash_dts_get_construction_flags
2909 (
2910 uint8_t stream_construction
2911 );
2913 lsmash_codec_type_t lsmash_dts_get_codingname
2914 (
2915 lsmash_dts_specific_parameters_t *param
2916 );
2919 (
2922 );
2924 int lsmash_append_dts_reserved_box
2925 (
2928 uint32_t box_size
2929 );
2931 void lsmash_remove_dts_reserved_box
2932 (
2933 lsmash_dts_specific_parameters_t *param
2934 );
2936 /* Apple Lossless Audio Specific Information
2937 * Mandatory :
2938 * ISOM_CODEC_TYPE_ALAC_AUDIO
2939 * QT_CODEC_TYPE_ALAC_AUDIO */
2941 {
2942 uint32_t frameLength; /* the frames per packet when no explicit frames per packet setting is present in the packet header
2943 * The encoder frames per packet can be explicitly set but for maximum compatibility,
2944 * the default encoder setting of 4096 should be used. */
2947 * When channel layout info is not provided in the Channel Layout extension,
2948 * a channel count > 2 describes a set of discreet channels with no specific ordering. */
2949 uint32_t maxFrameBytes; /* the maximum size of an Apple Lossless packet within the encoded stream
2950 * Value of 0 indicates unknown. */
2952 * Value of 0 indicates unknown. */
2957 (
2960 );
2962 /* MPEG-4 Bitrate Information.
2963 * Optional :
2964 * ISOM_CODEC_TYPE_AVC1_VIDEO
2965 * ISOM_CODEC_TYPE_AVC2_VIDEO
2966 * ISOM_CODEC_TYPE_AVC3_VIDEO
2967 * ISOM_CODEC_TYPE_AVC4_VIDEO
2968 * ISOM_CODEC_TYPE_HVC1_VIDEO
2969 * ISOM_CODEC_TYPE_HEV1_VIDEO
2970 *
2971 * Though you need not to set these fields manually since lsmash_finish_movie() calls the function
2972 * that calculates these values internally, these fields are optional.
2973 * Therefore, if you want to add this info, append this as an extension via LSMASH_CODEC_SPECIFIC_DATA_TYPE_ISOM_VIDEO_H264_BITRATE at least. */
2975 {
2976 uint32_t bufferSizeDB; /* the size of the decoding buffer for the elementary stream in bytes */
2981 /* Appendability of NAL unit into Decoder Configuration Record */
2983 {
2984 DCR_NALU_APPEND_NEW_SAMPLE_ENTRY_REQUIRED = -3, /* A new sample description entry is needed because e.g. visual presentation size changes. */
2987 DCR_NALU_APPEND_DUPLICATED = 0, /* The same NAL unit is in the Decoder Configuration Record. */
2988 DCR_NALU_APPEND_POSSIBLE = 1, /* It is possible to append the NAL unit into the Decoder Configuration Record. */
2991 /* H.264/AVC Specific Information
2992 * Mandatory :
2993 * ISOM_CODEC_TYPE_AVC1_VIDEO
2994 * ISOM_CODEC_TYPE_AVC2_VIDEO
2995 * ISOM_CODEC_TYPE_AVC3_VIDEO
2996 * ISOM_CODEC_TYPE_AVC4_VIDEO
2997 *
2998 * All members in lsmash_h264_specific_parameters_t except for lengthSizeMinusOne shall be automatically set up
2999 * when appending SPS NAL units by calling lsmash_append_h264_parameter_set(). */
3001 {
3005 /* The number of the NAL unit types defined for AVC Decoder Configuration Record */
3006 H264_PARAMETER_SET_TYPE_NUM
3012 {
3014 * This field must indicate a profile to which the stream associated with
3015 * this configuration record conforms.
3016 * Note: there is no profile to which the entire stream conforms, then
3017 * the entire stream must be split into two or more sub-streams with
3018 * separate configuration records in which these rules can be met. */
3020 * The each bit may only be set if all the included parameter sets set that flag. */
3022 * This field must indicate a level of capability equal to or greater than
3023 * the highest level indicated in the included parameter sets. */
3024 uint8_t lengthSizeMinusOne; /* the length in bytes of the NALUnitLength field prior to NAL unit
3025 * The value of this field shall be one of 0, 1, or 3
3026 * corresponding to a length encoded with 1, 2, or 4 bytes, respectively.
3027 * NALUnitLength indicates the size of a NAL unit measured in bytes,
3028 * and includes the size of both the one byte NAL header and the EBSP payload
3029 * but does not include the length field itself. */
3030 /* chroma format and bit depth information
3031 * These fields must be identical in all the parameter sets. */
3035 /* a set of arrays to carry initialization NAL units
3036 * The NAL unit types are restricted to indicate SPS, PPS and SPS Ext NAL units only. */
3040 int lsmash_setup_h264_specific_parameters_from_access_unit
3041 (
3044 uint32_t data_length
3045 );
3047 void lsmash_destroy_h264_parameter_sets
3048 (
3049 lsmash_h264_specific_parameters_t *param
3050 );
3052 lsmash_dcr_nalu_appendable lsmash_check_h264_parameter_set_appendable
3053 (
3055 lsmash_h264_parameter_set_type ps_type,
3057 uint32_t ps_length
3058 );
3060 int lsmash_append_h264_parameter_set
3061 (
3063 lsmash_h264_parameter_set_type ps_type,
3065 uint32_t ps_length
3066 );
3069 (
3072 );
3074 /* H.265/HEVC Specific Information
3075 * Mandatory :
3076 * ISOM_CODEC_TYPE_HVC1_VIDEO
3077 * ISOM_CODEC_TYPE_HEV1_VIDEO
3078 *
3079 * All members in lsmash_hevc_specific_parameters_t except for avgFrameRate and lengthSizeMinusOne shall be
3080 * automatically set up when appending VPS and SPS NAL units by calling lsmash_append_hevc_dcr_nalu().
3081 * It is recommended that you should append VPS, SPS and PPS in this order so that a parameter set can reference
3082 * another parameter set. */
3084 {
3085 /* Parameter sets
3086 * When the CODEC identifier ISOM_CODEC_TYPE_HVC1_VIDEO is used, at least one parameter set for each array
3087 * of parameter set shall be in the configuration record. */
3091 /* SEI (Supplemental Enhancement Information)
3092 * Only the 'declarative' SEI messages that provide information about the stream as
3093 * a whole are allowed because SEIs themselves basically have no identifier and
3094 * no one can reference dynamically in a configuration record. */
3097 /* The number of the NAL unit types defined for HEVC Decoder Configuration Record */
3098 HEVC_DCR_NALU_TYPE_NUM
3104 {
3105 /* general profile, tier and level from VPS and/or SPS */
3107 * The value in all the parameter sets must be identical. */
3109 * The value must indicate a tier equal to or greater than the highest
3110 * tier indicated in all the parameter sets. */
3112 * The value must indicate a profile to which the stream associated with
3113 * this configuration record conforms.
3114 * Note: there is no profile to which the entire stream conforms, then
3115 * the entire stream must be split into two or more sub-streams with
3116 * separate configuration records in which these rules can be met. */
3117 uint32_t general_profile_compatibility_flags; /* general_profile_compatibility_flag[j] for j from 0 to 31
3118 * The each bit may only be set if all the parameter sets set that bit. */
3119 uint64_t general_constraint_indicator_flags; /* the 6 bytes starting with the byte containing the general_progressive_source_flag
3120 * The each bit may only be set if all the parameter sets set that bit. */
3122 * The value must indicate a level of capability equal to or greater
3123 * than the highest level indicated for the highest tier in all the
3124 * parameter sets. */
3125 /* */
3126 uint16_t min_spatial_segmentation_idc; /* min_spatial_segmentation_idc in VUI (Video Usability Information)
3127 * The value must indicate a level of spatial segmentation equal to
3128 * or less than the lowest level of spatial segmentation indicated in
3129 * all the parameter sets. */
3130 uint8_t parallelismType; /* parallelismType indicates the type of parallelism that is used to meet the
3131 * restrictions imposed by min_spatial_segmentation_idc when the value of
3132 * min_spatial_segmentation_idc is greater than 0.
3133 * For the stream to which this configuration record applies,
3134 * 0: mixed types of parallel decoding or parallelism type is unknown
3135 * 1: slice based parallel decoding
3136 * 2: tile based parallel decoding
3137 * 3: entropy coding synchronization based parallel decoding
3138 * (WPP: Wavefront Parallel Processing) */
3139 /* chroma format and bit depth information
3140 * These fields must be identical in all the parameter sets. */
3144 /* miscellaneous */
3146 * Value 0 indicates an unspecified average frame rate. */
3148 * 1: that the stream to which this configuration record applies is of
3149 * constant frame rate
3150 * 2: the representation of each temporal layer in the stream is of
3151 * constant frame rate. */
3153 * 1: the stream is not temporally scalable.
3154 * otherwise: the stream to which this configuration record applies is
3155 * temporally scalable and the contained number of temporal layers
3156 * (also referred to as temporal sublayer or sub-layer) is equal
3157 * is equal to numTemporalLayers. */
3158 uint8_t temporalIdNested; /* 0: at least one of the SPSs that are activated when the stream to which
3159 * this configuration record applies is decoded has sps_temporal_id_nesting_flag
3160 * equal to 0.
3161 * 1: all SPSs that are activated when the stream to which this configuration
3162 * record applies is decoded have sps_temporal_id_nesting_flag equal to 1
3163 * and temporal sub-layer up-switching to any higher temporal layer can be
3164 * performed at any sample.
3165 * Any step-wise temporal sub-layer access picture shall not be present in
3166 * the sequences to which this configuration record applies. */
3167 uint8_t lengthSizeMinusOne; /* the length in bytes of the NALUnitLength field prior to NAL unit
3168 * The value of this field shall be one of 0, 1, or 3
3169 * corresponding to a length encoded with 1, 2, or 4 bytes, respectively.
3170 * NALUnitLength indicates the size of a NAL unit measured in bytes,
3171 * and includes the size of both the one byte NAL header and the EBSP payload
3172 * but does not include the length field itself. */
3173 /* a set of arrays to carry initialization NAL units
3174 * The NAL unit types are restricted to indicate VPS, SPS, PPS, and SEI NAL units only. */
3178 int lsmash_setup_hevc_specific_parameters_from_access_unit
3179 (
3182 uint32_t data_length
3183 );
3185 void lsmash_destroy_hevc_parameter_arrays
3186 (
3187 lsmash_hevc_specific_parameters_t *param
3188 );
3190 lsmash_dcr_nalu_appendable lsmash_check_hevc_dcr_nalu_appendable
3191 (
3193 lsmash_hevc_dcr_nalu_type ps_type,
3195 uint32_t ps_length
3196 );
3198 int lsmash_append_hevc_dcr_nalu
3199 (
3201 lsmash_hevc_dcr_nalu_type ps_type,
3203 uint32_t ps_length
3204 );
3206 int lsmash_set_hevc_array_completeness
3207 (
3209 lsmash_hevc_dcr_nalu_type ps_type,
3210 int array_completeness
3211 );
3213 int lsmash_get_hevc_array_completeness
3214 (
3216 lsmash_hevc_dcr_nalu_type ps_type,
3218 );
3221 (
3224 );
3226 /* VC-1 Specific Information
3227 * Mandatory :
3228 * ISOM_CODEC_TYPE_VC_1_VIDEO
3229 *
3230 * We support only advanced profile at present. */
3234 {
3235 /* Note: multiple_sequence, multiple_entry, slice_present and bframe_present shall be decided through overall VC-1 bitstream. */
3237 * 0: simple profile (not supported)
3238 * 4: main profile (not supported)
3239 * 12: advanced profile
3240 * Currently, only 12 for advanced profile is available. */
3243 * 1: constant bitrate model */
3245 * 1: frames may use interlaced coding. */
3246 uint8_t multiple_sequence; /* 0: the track contains no sequence headers (stored only in VC-1 specific info structure),
3247 * or
3248 * all sequence headers in the track are identical to the sequence header that is specified in the seqhdr field.
3249 * In this case, random access points are samples that contain an entry-point header.
3250 * 1: the track may contain Sequence headers that are different from the sequence header specified in the seqhdr field.
3251 * In this case, random access points are samples that contain both a sequence Header and an entry-point header. */
3252 uint8_t multiple_entry; /* 0: all entry-point headers in the track are identical to the entry-point header that is specified in the ephdr field.
3253 * 1: the track may contain entry-point headers that are different from the entry-point header specified in the ephdr field. */
3255 * 1: frames may be coded as multiple slices. */
3257 * 1: B-frames or BI-frames may be present in the track. */
3259 * Should be set to 0xffffffff if the frame rate is not known, unspecified, or non-constant. */
3264 int lsmash_setup_vc1_specific_parameters_from_access_unit
3265 (
3268 uint32_t data_length
3269 );
3271 void lsmash_destroy_vc1_headers
3272 (
3273 lsmash_vc1_specific_parameters_t *param
3274 );
3276 int lsmash_put_vc1_header
3277 (
3280 uint32_t hdr_length
3281 );
3284 (
3287 );
3289 /* Sample scaling
3290 * Without this extension, video samples are scaled into the visual presentation region to fill it. */
3292 {
3301 {
3303 * If this flag is set, all samples described by this sample entry shall be scaled
3304 * according to the method specified by the field 'scale_method'. */
3305 lsmash_scale_method scale_method; /* The semantics of the values for scale_method are as specified for the 'fit' attribute of regions in SMIL 1.0. */
3310 /* QuickTime Video CODEC tools */
3312 {
3322 {
3326 * This is a zero-relative value;
3327 * setting this field to 0 means that there is one color in the array. */
3328 /* Color array
3329 * An array of colors. Each color is made of four unsigned 16-bit integers.
3330 * We support up to 256 elements. */
3331 struct
3332 {
3334 /* true color */
3342 {
3347 uint32_t horizontal_resolution; /* a 16.16 fixed-point number containing the horizontal resolution of the image in pixels per inch. */
3348 uint32_t vertical_resolution; /* a 16.16 fixed-point number containing the vertical resolution of the image in pixels per inch. */
3352 * If this field is set to -1, the default color table should be used for the specified depth
3353 * If the color table ID is set to 0, a color table is contained within the sample description itself.
3354 * The color table immediately follows the color table ID field. */
3355 lsmash_qt_color_table_t color_table; /* a list of preferred colors for displaying the movie on devices that support only 256 colors */
3359 {
3360 uint32_t level; /* A fixed-point 16.16 number indicating the gamma level at which the image was captured. */
3364 {
3369 /* field ordering for interlaced material */
3371 {
3380 {
3381 lsmash_qt_number_of_fields fields;
3382 lsmash_qt_field_orderings detail;
3385 /* the native pixel format */
3387 {
3392 QT_PIXEL_FORMAT_TYPE_1_INDEXED_GRAY_WHITE_IS_ZERO = 0x00000021, /* 1 bit indexed gray, white is zero */
3393 QT_PIXEL_FORMAT_TYPE_2_INDEXED_GRAY_WHITE_IS_ZERO = 0x00000022, /* 2 bit indexed gray, white is zero */
3394 QT_PIXEL_FORMAT_TYPE_4_INDEXED_GRAY_WHITE_IS_ZERO = 0x00000024, /* 4 bit indexed gray, white is zero */
3395 QT_PIXEL_FORMAT_TYPE_8_INDEXED_GRAY_WHITE_IS_ZERO = 0x00000028, /* 8 bit indexed gray, white is zero */
3407 QT_PIXEL_FORMAT_TYPE_64ARGB = LSMASH_4CC( 'b', '6', '4', 'a' ), /* 64 bit ARGB, 16-bit big-endian samples */
3408 QT_PIXEL_FORMAT_TYPE_48RGB = LSMASH_4CC( 'b', '4', '8', 'r' ), /* 48 bit RGB, 16-bit big-endian samples */
3409 QT_PIXEL_FORMAT_TYPE_32_ALPHA_GRAY = LSMASH_4CC( 'b', '3', '2', 'a' ), /* 32 bit AlphaGray, 16-bit big-endian samples, black is zero */
3410 QT_PIXEL_FORMAT_TYPE_16_GRAY = LSMASH_4CC( 'b', '1', '6', 'g' ), /* 16 bit Grayscale, 16-bit big-endian samples, black is zero */
3411 QT_PIXEL_FORMAT_TYPE_30RGB = LSMASH_4CC( 'R', '1', '0', 'k' ), /* 30 bit RGB, 10-bit big-endian samples, 2 unused padding bits (at least significant end) */
3412 QT_PIXEL_FORMAT_TYPE_422YpCbCr8 = LSMASH_4CC( '2', 'v', 'u', 'y' ), /* Component Y'CbCr 8-bit 4:2:2, ordered Cb Y'0 Cr Y'1 */
3413 QT_PIXEL_FORMAT_TYPE_4444YpCbCrA8 = LSMASH_4CC( 'v', '4', '0', '8' ), /* Component Y'CbCrA 8-bit 4:4:4:4, ordered Cb Y' Cr A */
3414 QT_PIXEL_FORMAT_TYPE_4444YpCbCrA8R = LSMASH_4CC( 'r', '4', '0', '8' ), /* Component Y'CbCrA 8-bit 4:4:4:4, rendering format. full range alpha, zero biased YUV, ordered A Y' Cb Cr */
3415 QT_PIXEL_FORMAT_TYPE_4444AYpCbCr8 = LSMASH_4CC( 'y', '4', '0', '8' ), /* Component Y'CbCrA 8-bit 4:4:4:4, ordered A Y' Cb Cr, full range alpha, video range Y'CbCr */
3416 QT_PIXEL_FORMAT_TYPE_4444AYpCbCr16 = LSMASH_4CC( 'y', '4', '1', '6' ), /* Component Y'CbCrA 16-bit 4:4:4:4, ordered A Y' Cb Cr, full range alpha, video range Y'CbCr, 16-bit little-endian samples */
3417 QT_PIXEL_FORMAT_TYPE_444YpCbCr8 = LSMASH_4CC( 'v', '3', '0', '8' ), /* Component Y'CbCr 8-bit 4:4:4 */
3418 QT_PIXEL_FORMAT_TYPE_422YpCbCr16 = LSMASH_4CC( 'v', '2', '1', '6' ), /* Component Y'CbCr 10,12,14,16-bit 4:2:2 */
3419 QT_PIXEL_FORMAT_TYPE_422YpCbCr10 = LSMASH_4CC( 'v', '2', '1', '0' ), /* Component Y'CbCr 10-bit 4:2:2 */
3420 QT_PIXEL_FORMAT_TYPE_444YpCbCr10 = LSMASH_4CC( 'v', '4', '1', '0' ), /* Component Y'CbCr 10-bit 4:4:4 */
3421 QT_PIXEL_FORMAT_TYPE_420YpCbCr8_PLANAR = LSMASH_4CC( 'y', '4', '2', '0' ), /* Planar Component Y'CbCr 8-bit 4:2:0 */
3422 QT_PIXEL_FORMAT_TYPE_420YpCbCr8_PLANAR_FULL_RANGE = LSMASH_4CC( 'f', '4', '2', '0' ), /* Planar Component Y'CbCr 8-bit 4:2:0, full range */
3423 QT_PIXEL_FORMAT_TYPE_422YpCbCr_4A_8_BIPLANAR = LSMASH_4CC( 'a', '2', 'v', 'y' ), /* First plane: Video-range Component Y'CbCr 8-bit 4:2:2, ordered Cb Y'0 Cr Y'1; second plane: alpha 8-bit 0-255 */
3424 QT_PIXEL_FORMAT_TYPE_420YpCbCr8_BIPLANAR_VIDEO_RANGE = LSMASH_4CC( '4', '2', '0', 'v' ), /* Bi-Planar Component Y'CbCr 8-bit 4:2:0, video-range (luma=[16,235] chroma=[16,240]) */
3425 QT_PIXEL_FORMAT_TYPE_420YpCbCr8_BIPLANAR_FULL_RANGE = LSMASH_4CC( '4', '2', '0', 'f' ), /* Bi-Planar Component Y'CbCr 8-bit 4:2:0, full-range (luma=[0,255] chroma=[1,255]) */
3426 QT_PIXEL_FORMAT_TYPE_422YpCbCr8_YUVS = LSMASH_4CC( 'y', 'u', 'v', 's' ), /* Component Y'CbCr 8-bit 4:2:2, ordered Y'0 Cb Y'1 Cr */
3427 QT_PIXEL_FORMAT_TYPE_422YpCbCr8_FULL_RANGE = LSMASH_4CC( 'y', 'u', 'v', 'f' ), /* Component Y'CbCr 8-bit 4:2:2, full range, ordered Y'0 Cb Y'1 Cr */
3429 /* Developer specific FourCCs (from dispatch 20) */
3430 QT_PIXEL_FORMAT_TYPE_SOFTVOUT_SOFTCODEC = LSMASH_4CC( 's', 'o', 'f', 't' ), /* Intermediary pixel format used by SoftVout and SoftCodec */
3431 QT_PIXEL_FORMAT_TYPE_VIEW_GRAPHICS = LSMASH_4CC( 'v', 'w', 'g', 'r' ), /* Intermediary pixel format used by View Graphics */
3432 QT_PIXEL_FORMAT_TYPE_SGI = LSMASH_4CC( 'S', 'G', 'V', 'C' ), /* Intermediary pixel format used by SGI */
3436 {
3440 /* Significant Bits Extension
3441 * mandatory extension for 'v216' (Uncompressed Y'CbCr, 10, 12, 14, or 16-bit-per-component 4:2:2) */
3443 {
3447 /* QuickTime Audio CODEC tools */
3449 {
3462 {
3465 lsmash_qt_audio_compression_id compression_ID;
3468 /* Audio Channel Layout
3469 * This CODEC specific extension is for
3470 * QuickTime Audio inside QuickTime file format
3471 * and
3472 * Apple Lossless Audio inside ISO Base Media file format.
3473 * When audio stream has 3 or more number of channels, this extension shall be present. */
3475 {
3516 /* first order ambisonic channels */
3522 /* Mid/Side Recording */
3526 /* X-Y Recording */
3530 /* other */
3536 /* generic discrete channel */
3539 /* numbered discrete channel */
3560 {
3583 {
3591 {
3592 /* indices for accessing the coordinates array in Channel Descriptions */
3593 /* for rectangulare coordinates */
3596 QT_CHANNEL_COORDINATES_DOWN_UP = 2, /* Negative is below ground level, 0 is ground level, and positive is above ground level. */
3597 /* for spherical coordinates */
3598 QT_CHANNEL_COORDINATES_AZIMUTH = 0, /* 0 is front center, positive is right, negative is left. This is measured in degrees. */
3599 QT_CHANNEL_COORDINATES_ELEVATION = 1, /* +90 is zenith, 0 is horizontal, -90 is nadir. This is measured in degrees. */
3604 {
3605 /* channel abbreviations:
3606 * L - left
3607 * R - right
3608 * C - center
3609 * Ls - left surround
3610 * Rs - right surround
3611 * Cs - center surround
3612 * Rls - rear left surround
3613 * Rrs - rear right surround
3614 * Lw - left wide
3615 * Rw - right wide
3616 * Lsd - left surround direct
3617 * Rsd - right surround direct
3618 * Lc - left center
3619 * Rc - right center
3620 * Ts - top surround
3621 * Vhl - vertical height left
3622 * Vhc - vertical height center
3623 * Vhr - vertical height right
3624 * Lt - left matrix total. for matrix encoded stereo.
3625 * Rt - right matrix total. for matrix encoded stereo. */
3627 /* General layouts */
3628 QT_CHANNEL_LAYOUT_USE_CHANNEL_DESCRIPTIONS = 0, /* use the array of Channel Descriptions to define the mapping. */
3632 QT_CHANNEL_LAYOUT_STEREO = (101<<16) | 2, /* a standard stereo stream (L R) - implied playback */
3633 QT_CHANNEL_LAYOUT_STEREO_HEADPHONES = (102<<16) | 2, /* a standard stereo stream (L R) - implied headphone playback */
3640 QT_CHANNEL_LAYOUT_QUADRAPHONIC = (108<<16) | 4, /* front left, front right, back left, back right */
3644 QT_CHANNEL_LAYOUT_HEXAGONAL = (110<<16) | 6, /* left, right, rear left, rear right, center, rear */
3646 QT_CHANNEL_LAYOUT_OCTAGONAL = (111<<16) | 8, /* front left, front right, rear left, rear right,
3647 * front center, rear center, side left, side right */
3650 * top left, top right, top rear left, top rear right */
3652 /* MPEG defined layouts */
3669 QT_CHANNEL_LAYOUT_MPEG_7_1_B = (127<<16) | 8, /* C Lc Rc L R Ls Rs LFE (doc: IS-13818-7 MPEG2-AAC Table 3.1) */
3674 /* ITU defined layouts */
3687 /* DVD defined layouts */
3701 /* 13 through 17 are duplicates of 8 through 12. */
3711 /* These are the symmetrical layouts. */
3716 /* These are the surround-based layouts. */
3724 QT_CHANNEL_LAYOUT_AUDIO_UNIT_7_1_FRONT = QT_CHANNEL_LAYOUT_MPEG_7_1_A, /* L R C LFE Ls Rs Lc Rc */
3737 QT_CHANNEL_LAYOUT_TMH_10_2_STD = (145<<16) | 16, /* L R C Vhc Lsd Rsd Ls Rs Vhl Vhr Lw Rw Csd Cs LFE1 LFE2 */
3788 QT_CHANNEL_LAYOUT_DISCRETE_IN_ORDER = 147<<16, /* needs to be ORed with the actual number of channels */
3789 QT_CHANNEL_LAYOUT_UNKNOWN = (signed)0xffff0000, /* needs to be ORed with the actual number of channels */
3793 {
3795 lsmash_channel_bitmap channelBitmap; /* Only available when layout_tag is set to QT_CHANNEL_LAYOUT_USE_CHANNEL_BITMAP. */
3798 /* QuickTime Audio Format Specific Flags
3799 * Some values are ignored i.e. as if treated as unspecified when you specify certain CODECs.
3800 * For instance, you specify QT_CODEC_TYPE_SOWT_AUDIO, then all these values are ignored.
3801 * These values are basically used for QT_CODEC_TYPE_LPCM_AUDIO.
3802 * The endiannes value can be used for QT_CODEC_TYPE_FL32_AUDIO, QT_CODEC_TYPE_FL64_AUDIO, QT_CODEC_TYPE_IN24_AUDIO and QT_CODEC_TYPE_IN32_AUDIO. */
3804 {
3807 QT_AUDIO_FORMAT_FLAG_SIGNED_INTEGER = 1<<2, /* Set for signed integer, clear for unsigned integer.
3808 * This is only valid if QT_AUDIO_FORMAT_FLAG_FLOAT is clear. */
3809 QT_AUDIO_FORMAT_FLAG_PACKED = 1<<3, /* Set if the sample bits occupy the entire available bits for the channel,
3810 * clear if they are high or low aligned within the channel. */
3811 QT_AUDIO_FORMAT_FLAG_ALIGNED_HIGH = 1<<4, /* Set if the sample bits are placed into the high bits of the channel, clear for low bit placement.
3812 * This is only valid if QT_AUDIO_FORMAT_FLAG_PACKED is clear. */
3813 QT_AUDIO_FORMAT_FLAG_NON_INTERLEAVED = 1<<5, /* Set if the samples for each channel are located contiguously and the channels are layed out end to end,
3814 * clear if the samples for each frame are layed out contiguously and the frames layed out end to end. */
3816 * Note that this flag is only used when interacting with the HAL's stream format information.
3817 * It is not a valid flag for any other uses. */
3818 QT_AUDIO_FORMAT_FLAG_ALL_CLEAR = 1<<31, /* Set if all the flags would be clear in order to preserve 0 as the wild card value. */
3829 /* These flags are set for Apple Lossless data that was sourced from N bit native endian signed integer data. */
3837 {
3838 lsmash_qt_audio_format_specific_flag format_flags;
3841 /* Global Header
3842 * Ut Video inside QuickTime file format requires this extension for storing CODEC specific information. */
3844 {
3849 /****************************************************************************
3850 * iTunes Metadata
3851 ****************************************************************************/
3853 {
3854 /* UTF String type */
3858 ITUNES_METADATA_ITEM_RELEASE_DATE = LSMASH_4CC( 0xA9, 'd', 'a', 'y' ), /* YYYY-MM-DD format string (may be incomplete, i.e. only year) */
3859 ITUNES_METADATA_ITEM_ENCODED_BY = LSMASH_4CC( 0xA9, 'e', 'n', 'c' ), /* Person or company that encoded the recording */
3860 ITUNES_METADATA_ITEM_USER_GENRE = LSMASH_4CC( 0xA9, 'g', 'e', 'n' ), /* User Genre user-specified string */
3865 ITUNES_METADATA_ITEM_ENCODING_TOOL = LSMASH_4CC( 0xA9, 't', 'o', 'o' ), /* Software which encoded the recording */
3867 ITUNES_METADATA_ITEM_ALBUM_ARTIST = LSMASH_4CC( 'a', 'A', 'R', 'T' ), /* Artist for the whole album (if different than the individual tracks) */
3868 ITUNES_METADATA_ITEM_PODCAST_CATEGORY = LSMASH_4CC( 'c', 'a', 't', 'g' ), /* Podcast Category */
3870 ITUNES_METADATA_ITEM_DESCRIPTION = LSMASH_4CC( 'd', 'e', 's', 'c' ), /* Description (limited to 255 bytes) */
3872 * Note: This identifier is defined in
3873 * iTunes Metadata Format Specification (Preliminary draft),
3874 * but not used by iTunes actually it seems.
3875 * We recommend you use ITUNES_METADATA_ITEM_GROUPING instead of this. */
3876 ITUNES_METADATA_ITEM_PODCAST_KEYWORD = LSMASH_4CC( 'k', 'e', 'y', 'w' ), /* Podcast Keywords */
3877 ITUNES_METADATA_ITEM_LONG_DESCRIPTION = LSMASH_4CC( 'l', 'd', 'e', 's' ), /* Long Description */
3882 ITUNES_METADATA_ITEM_ITUNES_PURCHASE_ACCOUNT_ID = LSMASH_4CC( 'a', 'p', 'I', 'D' ), /* iTunes Account Used for Purchase */
3885 ITUNES_METADATA_ITEM_ITUNES_SORT_ALBUM_ARTIST = LSMASH_4CC( 's', 'o', 'a', 'a' ), /* Sort Album Artist */
3886 ITUNES_METADATA_ITEM_ITUNES_SORT_COMPOSER = LSMASH_4CC( 's', 'o', 'c', 'o' ), /* Sort Composer */
3890 /* Integer type
3891 * (X): X means length of bytes */
3892 ITUNES_METADATA_ITEM_EPISODE_GLOBAL_ID = LSMASH_4CC( 'e', 'g', 'i', 'd' ), /* (1) Episode Global Unique ID */
3893 ITUNES_METADATA_ITEM_PREDEFINED_GENRE = LSMASH_4CC( 'g', 'n', 'r', 'e' ), /* (2) Pre-defined Genre / Enumerated value from ID3 tag set, plus 1 */
3895 ITUNES_METADATA_ITEM_CONTENT_RATING = LSMASH_4CC( 'r', 't', 'n', 'g' ), /* (1) Content Rating / Does song have explicit content? 0: none, 2: clean, 4: explicit */
3897 ITUNES_METADATA_ITEM_BEATS_PER_MINUTE = LSMASH_4CC( 't', 'm', 'p', 'o' ), /* (2) Beats Per Minute */
3900 ITUNES_METADATA_ITEM_ITUNES_ACCOUNT_TYPE = LSMASH_4CC( 'a', 'k', 'I', 'D' ), /* (1) iTunes Account Type / 0: iTunes, 1: AOL */
3901 ITUNES_METADATA_ITEM_ITUNES_ARTIST_ID = LSMASH_4CC( 'a', 't', 'I', 'D' ), /* (4) iTunes Artist ID */
3902 ITUNES_METADATA_ITEM_ITUNES_COMPOSER_ID = LSMASH_4CC( 'c', 'm', 'I', 'D' ), /* (4) iTunes Composer ID */
3903 ITUNES_METADATA_ITEM_ITUNES_CATALOG_ID = LSMASH_4CC( 'c', 'n', 'I', 'D' ), /* (4) iTunes Catalog ID */
3904 ITUNES_METADATA_ITEM_ITUNES_TV_GENRE_ID = LSMASH_4CC( 'g', 'e', 'I', 'D' ), /* (4) iTunes TV Genre ID */
3905 ITUNES_METADATA_ITEM_ITUNES_PLAYLIST_ID = LSMASH_4CC( 'p', 'l', 'I', 'D' ), /* (8) iTunes Playlist ID */
3906 ITUNES_METADATA_ITEM_ITUNES_COUNTRY_CODE = LSMASH_4CC( 's', 'f', 'I', 'D' ), /* (4) iTunes Country Code */
3908 /* Boolean type */
3909 ITUNES_METADATA_ITEM_DISC_COMPILATION = LSMASH_4CC( 'c', 'p', 'i', 'l' ), /* Disc Compilation / Is disc part of a compilation? 0: No, 1: Yes */
3910 ITUNES_METADATA_ITEM_HIGH_DEFINITION_VIDEO = LSMASH_4CC( 'h', 'd', 'v', 'd' ), /* High Definition Video / 0: No, 1: Yes */
3912 ITUNES_METADATA_ITEM_GAPLESS_PLAYBACK = LSMASH_4CC( 'p', 'g', 'a', 'p' ), /* Gapless Playback / 0: insert gap, 1: no gap */
3914 /* Binary type */
3915 ITUNES_METADATA_ITEM_COVER_ART = LSMASH_4CC( 'c', 'o', 'v', 'r' ), /* One or more cover art images (JPEG/PNG/BMP data) */
3919 /* Custom type */
3924 {
3933 {
3934 ITUNES_METADATA_SUBTYPE_IMPLICIT = 0, /* for use with tags for which no type needs to be indicated because only one type is allowed */
3937 ITUNES_METADATA_SUBTYPE_SJIS = 3, /* deprecated unless it is needed for special Japanese characters */
3940 ITUNES_METADATA_SUBTYPE_UUID = 8, /* also known as GUID; stored as 16 bytes in binary (valid as an ID) */
3948 ITUNES_METADATA_SUBTYPE_TIME = 17, /* in UTC, counting seconds since midnight on 1 January, 1904; 32 or 64 bits */
3951 ITUNES_METADATA_SUBTYPE_RIAAPA = 24, /* RIAA Parental advisory; -1=no, 1=yes, 0=unspecified. 8-bit integer */
3952 ITUNES_METADATA_SUBTYPE_UPC = 25, /* Universal Product Code, in text UTF-8 format (valid as an ID) */
3957 {
3961 /* for ITUNES_METADATA_TYPE_BINARY */
3962 struct
3963 {
3964 lsmash_itunes_metadata_subtype subtype;
3971 {
3972 /* When 'item' is specified as ITUNES_METADATA_ITEM_CUSTOM, 'type' and 'meaning' is mandatory while 'name' is optionally valid.
3973 * Otherwise 'type', 'meaning' and 'name' are just ignored. 'value' is always mandatory. */
3974 lsmash_itunes_metadata_item item;
3975 lsmash_itunes_metadata_type type;
3976 lsmash_itunes_metadata_value_t value;
3981 /* Append an iTunes metadata to a movie.
3982 *
3983 * Return 0 if successful.
3984 * Return a negative value otherwise. */
3985 int lsmash_set_itunes_metadata
3986 (
3988 lsmash_itunes_metadata_t metadata
3989 );
3991 /* Count the number of iTunes metadata in a movie.
3992 *
3993 * Return the number of iTunes metadata in a movie if successful.
3994 * Return 0 otherwise. */
3995 uint32_t lsmash_count_itunes_metadata
3996 (
3997 lsmash_root_t *root
3998 );
4000 /* Get an iTunes metadata in a movie.
4001 * String and/or binary fields in 'metadata' are allocated if successful.
4002 * You can deallocate the allocated fields by lsmash_free().
4003 * Also you can deallocate all of the allocated fields by lsmash_cleanup_itunes_metadata() at a time.
4004 *
4005 * Return 0 if successful.
4006 * Return a negative value otherwise. */
4007 int lsmash_get_itunes_metadata
4008 (
4011 lsmash_itunes_metadata_t *metadata
4012 );
4014 /* Deallocate all of allocated fields in a given iTunes metadata at a time.
4015 * The deallocated fields are set to NULL.
4016 * Note: the given iTunes metadata itself is NOT deallocated by this function. */
4017 void lsmash_cleanup_itunes_metadata
4018 (
4019 lsmash_itunes_metadata_t *metadata
4020 );
4022 /****************************************************************************
4023 * Others
4024 ****************************************************************************/
4025 /* Set a copyright declaration to a track.
4026 * track_ID == 0 means copyright declaration applies to the entire presentation, not an entire track.
4027 *
4028 * Return 0 if successful.
4029 * Return a negative value otherwise. */
4030 int lsmash_set_copyright
4031 (
4036 );
4038 int lsmash_create_object_descriptor
4039 (
4040 lsmash_root_t *root
4041 );
4043 #ifdef _WIN32
4044 /* Convert string encoded by ACP (ANSI CODE PAGE) to UTF-8.
4045 *
4046 * Return the size of converted string (bytes) if successful.
4047 * Return 0 otherwise. */
4048 int lsmash_convert_ansi_to_utf8
4049 (
4053 );
4054 #endif
4056 #undef PRIVATE
4058 #endif