core/chapter.c

   1 /*****************************************************************************
   2  * chapter.c:
   3  *****************************************************************************
   4  * Copyright (C) 2010-2014 L-SMASH project
   5  *
   6  * Authors: Yusuke Nakamura <muken.the.vfrmaniac@gmail.com>
   7  * Contributors: Takashi Hirata <silverfilain@gmail.com>
   8  *
   9  * Permission to use, copy, modify, and/or distribute this software for any
  10  * purpose with or without fee is hereby granted, provided that the above
  11  * copyright notice and this permission notice appear in all copies.
  12  *
  13  * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
  14  * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
  15  * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
  16  * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
  17  * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
  18  * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
  19  * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  20  *****************************************************************************/
  21
  22 /* This file is available under an ISC license. */
  23
  24 #include "common/internal.h" /* must be placed first */
  25
  26 #include <stdlib.h>
  27 #include <string.h>
  28 #include <inttypes.h>
  29 #include <ctype.h>
  30
  31 #include "box.h"
  32
  33 #define CHAPTER_BUFSIZE 512
  34 #define UTF8_BOM "\xEF\xBB\xBF"
  35 #define UTF8_BOM_LENGTH 3
  36
  37 static int isom_get_start_time( char *chap_time, isom_chapter_entry_t *data )
  38 {
  39     uint64_t hh, mm;
  40     double ss;
  41     if( sscanf( chap_time, "%"SCNu64":%2"SCNu64":%lf", &hh, &mm, &ss ) != 3 )
  42         return -1;
  43     /* check overflow */
  44     if( hh >= 5124095
  45      || mm >= 60
  46      || ss >= 60 )
  47         return -1;
  48     /* 1ns timescale */
  49     data->start_time = (hh * 3600 + mm * 60 + ss) * 1e9;
  50     return 0;
  51 }
  52
  53 static int isom_lumber_line( char *buff, int bufsize, FILE *chapter  )
  54 {
  55     char *tail;
  56     /* remove newline codes and skip empty line */
  57     do
  58     {
  59         if( fgets( buff, bufsize, chapter ) == NULL )
  60             return -1;
  61         tail = &buff[ strlen( buff ) - 1 ];
  62         while( tail >= buff && (*tail == '\n' || *tail == '\r') )
  63             *tail-- = '\0';
  64     } while( tail < buff );
  65     return 0;
  66 }
  67
  68 static int isom_read_simple_chapter( FILE *chapter, isom_chapter_entry_t *data )
  69 {
  70     char buff[CHAPTER_BUFSIZE];
  71     /* get start_time */
  72     if( isom_lumber_line( buff, CHAPTER_BUFSIZE, chapter ) < 0 )
  73         return -1;
  74     char *chapter_time = strchr( buff, '=' );   /* find separator */
  75     if( !chapter_time++
  76      || isom_get_start_time( chapter_time, data ) < 0
  77      || isom_lumber_line( buff, CHAPTER_BUFSIZE, chapter ) < 0 )    /* get chapter_name */
  78         return -1;
  79     char *chapter_name = strchr( buff, '=' );   /* find separator */
  80     if( !chapter_name++ )
  81         return -1;
  82     int len = LSMASH_MIN( 255, strlen( chapter_name ) );    /* We support length of chapter_name up to 255 */
  83     data->chapter_name = (char *)lsmash_malloc( len + 1 );
  84     if( !data->chapter_name )
  85         return -1;
  86     memcpy( data->chapter_name, chapter_name, len );
  87     data->chapter_name[len] = '\0';
  88     return 0;
  89 }
  90
  91 static int isom_read_minimum_chapter( FILE *chapter, isom_chapter_entry_t *data )
  92 {
  93     char buff[CHAPTER_BUFSIZE];
  94     if( isom_lumber_line( buff, CHAPTER_BUFSIZE, chapter ) < 0 )    /* read newline */
  95         return -1;
  96     char *p_buff = &buff[ !memcmp( buff, UTF8_BOM, UTF8_BOM_LENGTH ) ? UTF8_BOM_LENGTH : 0 ];   /* BOM detection */
  97     if( isom_get_start_time( p_buff, data ) < 0 )   /* get start_time */
  98         return -1;
  99     /* get chapter_name */
 100     char *chapter_name = strchr( buff, ' ' );   /* find separator */
 101     if( !chapter_name++ )
 102         return -1;
 103     int len = LSMASH_MIN( 255, strlen( chapter_name ) );    /* We support length of chapter_name up to 255 */
 104     data->chapter_name = (char *)lsmash_malloc( len + 1 );
 105     if( !data->chapter_name )
 106         return -1;
 107     memcpy( data->chapter_name, chapter_name, len );
 108     data->chapter_name[len] = '\0';
 109     return 0;
 110 }
 111
 112 typedef int (*fn_get_chapter_data)( FILE *, isom_chapter_entry_t * );
 113
 114 static fn_get_chapter_data isom_check_chap_line( char *file_name )
 115 {
 116     FILE *fp = lsmash_fopen( file_name, "rb" );
 117     if( !fp )
 118     {
 119         lsmash_log( NULL, LSMASH_LOG_ERROR, "failed to open the chapter file \"%s\".\n", file_name );
 120         return NULL;
 121     }
 122     char buff[CHAPTER_BUFSIZE];
 123     fn_get_chapter_data fnc = NULL;
 124     if( fgets( buff, CHAPTER_BUFSIZE, fp ) != NULL )
 125     {
 126         char *p_buff = &buff[ !memcmp( buff, UTF8_BOM, UTF8_BOM_LENGTH ) ? UTF8_BOM_LENGTH : 0 ];   /* BOM detection */
 127         if( !strncmp( p_buff, "CHAPTER", 7 ) )
 128             fnc = isom_read_simple_chapter;
 129         else if( isdigit( (unsigned char)p_buff[0] ) && isdigit( (unsigned char)p_buff[1] ) && p_buff[2] == ':'
 130               && isdigit( (unsigned char)p_buff[3] ) && isdigit( (unsigned char)p_buff[4] ) && p_buff[5] == ':' )
 131             fnc = isom_read_minimum_chapter;
 132         else
 133             lsmash_log( NULL, LSMASH_LOG_ERROR, "the chapter file is malformed.\n" );
 134     }
 135     fclose( fp );
 136     return fnc;
 137 }
 138
 139 static int isom_add_chpl_entry( isom_chpl_t *chpl, isom_chapter_entry_t *chap_data )
 140 {
 141     if( !chap_data->chapter_name
 142      || !chpl
 143      || !chpl->list )
 144         return -1;
 145     isom_chpl_entry_t *data = lsmash_malloc( sizeof(isom_chpl_entry_t) );
 146     if( !data )
 147         return -1;
 148     data->start_time          = chap_data->start_time;
 149     data->chapter_name_length = strlen( chap_data->chapter_name );
 150     data->chapter_name        = (char *)lsmash_malloc( data->chapter_name_length + 1 );
 151     if( !data->chapter_name )
 152     {
 153         lsmash_free( data );
 154         return -1;
 155     }
 156     memcpy( data->chapter_name, chap_data->chapter_name, data->chapter_name_length );
 157     data->chapter_name[ data->chapter_name_length ] = '\0';
 158     if( lsmash_add_entry( chpl->list, data ) < 0 )
 159     {
 160         lsmash_free( data->chapter_name );
 161         lsmash_free( data );
 162         return -1;
 163     }
 164     return 0;
 165 }
 166
 167 int lsmash_set_tyrant_chapter( lsmash_root_t *root, char *file_name, int add_bom )
 168 {
 169     if( isom_check_initializer_present( root ) < 0 )
 170         goto error_message;
 171     /* This function should be called after updating of the latest movie duration. */
 172     lsmash_file_t *file = root->file;
 173     if( !file
 174      || !file->moov
 175      || !file->moov->mvhd
 176      ||  file->moov->mvhd->timescale == 0
 177      ||  file->moov->mvhd->duration  == 0 )
 178         goto error_message;
 179     /* check each line format */
 180     fn_get_chapter_data fnc = isom_check_chap_line( file_name );
 181     if( !fnc )
 182         goto error_message;
 183     FILE *chapter = lsmash_fopen( file_name, "rb" );
 184     if( !chapter )
 185     {
 186         lsmash_log( NULL, LSMASH_LOG_ERROR, "failed to open the chapter file \"%s\".\n", file_name );
 187         goto error_message;
 188     }
 189     if( (!file->moov->udta       && !isom_add_udta( file->moov ))
 190      || (!file->moov->udta->chpl && !isom_add_chpl( file->moov->udta )) )
 191         goto fail;
 192     file->moov->udta->chpl->version = 1;    /* version = 1 is popular. */
 193     isom_chapter_entry_t data = { 0 };
 194     while( !fnc( chapter, &data ) )
 195     {
 196         if( add_bom )
 197         {
 198             char *chapter_name_with_bom = (char *)lsmash_malloc( strlen( data.chapter_name ) + 1 + UTF8_BOM_LENGTH );
 199             if( !chapter_name_with_bom )
 200                 goto fail2;
 201             sprintf( chapter_name_with_bom, "%s%s", UTF8_BOM, data.chapter_name );
 202             lsmash_free( data.chapter_name );
 203             data.chapter_name = chapter_name_with_bom;
 204         }
 205         data.start_time = (data.start_time + 50) / 100;    /* convert to 100ns unit */
 206         if( data.start_time / 1e7 > (double)file->moov->mvhd->duration / file->moov->mvhd->timescale )
 207         {
 208             lsmash_log( NULL, LSMASH_LOG_WARNING,
 209                         "a chapter point exceeding the actual duration detected."
 210                         "This chapter point and the following ones (if any) will be cut off.\n" );
 211             lsmash_free( data.chapter_name );
 212             break;
 213         }
 214         if( isom_add_chpl_entry( file->moov->udta->chpl, &data ) < 0 )
 215             goto fail2;
 216         lsmash_freep( &data.chapter_name );
 217     }
 218     fclose( chapter );
 219     return 0;
 220 fail2:
 221     lsmash_free( data.chapter_name );
 222 fail:
 223     fclose( chapter );
 224 error_message:
 225     lsmash_log( NULL, LSMASH_LOG_ERROR, "failed to set chapter list.\n" );
 226     return -1;
 227 }
 228
 229 int lsmash_create_reference_chapter_track( lsmash_root_t *root, uint32_t track_ID, char *file_name )
 230 {
 231     if( isom_check_initializer_present( root ) < 0 )
 232         goto error_message;
 233     lsmash_file_t *file = root->file;
 234     if( !file
 235      || !file->moov
 236      || !file->moov->mvhd )
 237         goto error_message;
 238     if( file->forbid_tref || (!file->qt_compatible && !file->itunes_movie) )
 239     {
 240         lsmash_log( NULL, LSMASH_LOG_ERROR, "reference chapter is not available for this file.\n" );
 241         goto error_message;
 242     }
 243     FILE *chapter = NULL;       /* shut up 'uninitialized' warning */
 244     /* Create a Track Reference Box. */
 245     isom_trak_t *trak = isom_get_trak( file, track_ID );
 246     if( !trak )
 247     {
 248         lsmash_log( NULL, LSMASH_LOG_ERROR, "the specified track ID to apply the chapter doesn't exist.\n" );
 249         goto error_message;
 250     }
 251     if( !trak->tref && !isom_add_tref( trak ) )
 252         goto error_message;
 253     /* Create a track_ID for a new chapter track. */
 254     uint32_t *id = (uint32_t *)lsmash_malloc( sizeof(uint32_t) );
 255     if( !id )
 256         goto error_message;
 257     uint32_t chapter_track_ID = *id = file->moov->mvhd->next_track_ID;
 258     /* Create a Track Reference Type Box. */
 259     isom_tref_type_t *chap = isom_add_track_reference_type( trak->tref, QT_TREF_TYPE_CHAP );
 260     if( !chap )
 261         goto error_message;      /* no need to free id */
 262     chap->ref_count = 1;
 263     chap->track_ID  = id;
 264     /* Create a reference chapter track. */
 265     if( chapter_track_ID != lsmash_create_track( root, ISOM_MEDIA_HANDLER_TYPE_TEXT_TRACK ) )
 266         goto error_message;
 267     /* Set track parameters. */
 268     lsmash_track_parameters_t track_param;
 269     lsmash_initialize_track_parameters( &track_param );
 270     track_param.mode = ISOM_TRACK_IN_MOVIE | ISOM_TRACK_IN_PREVIEW;
 271     if( lsmash_set_track_parameters( root, chapter_track_ID, &track_param ) < 0 )
 272         goto fail;
 273     /* Set media parameters. */
 274     uint64_t media_timescale = lsmash_get_media_timescale( root, track_ID );
 275     if( !media_timescale )
 276         goto fail;
 277     lsmash_media_parameters_t media_param;
 278     lsmash_initialize_media_parameters( &media_param );
 279     media_param.timescale    = media_timescale;
 280     media_param.ISO_language = file->max_3gpp_version >= 6 || file->itunes_movie ? ISOM_LANGUAGE_CODE_UNDEFINED : 0;
 281     media_param.MAC_language = 0;
 282     if( lsmash_set_media_parameters( root, chapter_track_ID, &media_param ) < 0 )
 283         goto fail;
 284     /* Create a sample description. */
 285     lsmash_codec_type_t sample_type = file->max_3gpp_version >= 6 || file->itunes_movie
 286                                     ? ISOM_CODEC_TYPE_TX3G_TEXT
 287                                     : QT_CODEC_TYPE_TEXT_TEXT;
 288     lsmash_summary_t summary = { .sample_type = sample_type };
 289     uint32_t sample_entry = lsmash_add_sample_entry( root, chapter_track_ID, &summary );
 290     if( !sample_entry )
 291         goto fail;
 292     /* Check each line format. */
 293     fn_get_chapter_data fnc = isom_check_chap_line( file_name );
 294     if( !fnc )
 295         goto fail;
 296     /* Open chapter format file. */
 297     chapter = lsmash_fopen( file_name, "rb" );
 298     if( !chapter )
 299     {
 300         lsmash_log( NULL, LSMASH_LOG_ERROR, "failed to open the chapter file \"%s\".\n", file_name );
 301         goto fail;
 302     }
 303     /* Parse the file and write text samples. */
 304     isom_chapter_entry_t data;
 305     while( !fnc( chapter, &data ) )
 306     {
 307         /* set start_time */
 308         data.start_time = data.start_time * 1e-9 * media_timescale + 0.5;
 309         /* write a text sample here */
 310         int is_qt_text = lsmash_check_codec_type_identical( sample_type, QT_CODEC_TYPE_TEXT_TEXT );
 311         uint16_t name_length = strlen( data.chapter_name );
 312         lsmash_sample_t *sample = lsmash_create_sample( 2 + name_length + 12 * is_qt_text );
 313         if( !sample )
 314         {
 315             lsmash_free( data.chapter_name );
 316             goto fail;
 317         }
 318         sample->data[0] = (name_length >> 8) & 0xff;
 319         sample->data[1] =  name_length       & 0xff;
 320         memcpy( sample->data + 2, data.chapter_name, name_length );
 321         if( is_qt_text )
 322         {
 323             /* QuickTime Player requires Text Encoding Attribute Box ('encd') if media language is ISO language codes : undefined.
 324              * Also this box can avoid garbling if the QuickTime text sample is encoded by Unicode characters.
 325              * Note: 3GPP Timed Text supports only UTF-8 or UTF-16, so this box isn't needed. */
 326             static const uint8_t encd[12] =
 327                 {
 328                     0x00, 0x00, 0x00, 0x0C,     /* size: 12 */
 329                     0x65, 0x6E, 0x63, 0x64,     /* type: 'encd' */
 330                     0x00, 0x00, 0x01, 0x00      /* Unicode Encoding */
 331                 };
 332             memcpy( sample->data + 2 + name_length, encd, 12 );
 333         }
 334         sample->dts           = data.start_time;
 335         sample->cts           = data.start_time;
 336         sample->prop.ra_flags = ISOM_SAMPLE_RANDOM_ACCESS_FLAG_SYNC;
 337         sample->index         = sample_entry;
 338         if( lsmash_append_sample( root, chapter_track_ID, sample ) < 0 )
 339         {
 340             lsmash_free( data.chapter_name );
 341             goto fail;
 342         }
 343         lsmash_freep( &data.chapter_name );
 344     }
 345     if( lsmash_flush_pooled_samples( root, chapter_track_ID, 0 ) < 0 )
 346         goto fail;
 347     isom_trak_t *chapter_trak = isom_get_trak( file, chapter_track_ID );
 348     if( !chapter_trak )
 349         goto fail;
 350     fclose( chapter );
 351     chapter_trak->is_chapter       = 1;
 352     chapter_trak->related_track_ID = track_ID;
 353     return 0;
 354 fail:
 355     if( chapter )
 356         fclose( chapter );
 357     /* Remove chapter track reference. */
 358     if( trak->tref->ref_list.tail )
 359         isom_remove_box_by_itself( trak->tref->ref_list.tail->data );
 360     if( trak->tref->ref_list.entry_count == 0 )
 361         isom_remove_box_by_itself( trak->tref );
 362     /* Remove the reference chapter track attached at tail of the list. */
 363     if( file->moov->trak_list.tail )
 364         isom_remove_box_by_itself( file->moov->trak_list.tail->data );
 365 error_message:
 366     lsmash_log( NULL, LSMASH_LOG_ERROR, "failed to set reference chapter.\n" );
 367     return -1;
 368 }
 369
 370 uint32_t lsmash_count_tyrant_chapter( lsmash_root_t *root )
 371 {
 372     if( isom_check_initializer_present( root ) < 0
 373      && root->file->initializer->moov
 374      && root->file->initializer->moov->udta
 375      && root->file->initializer->moov->udta->chpl
 376      && root->file->initializer->moov->udta->chpl->list )
 377         return root->file->initializer->moov->udta->chpl->list->entry_count;
 378     return 0;
 379 }
 380
 381 char *lsmash_get_tyrant_chapter( lsmash_root_t *root, uint32_t index, double *timestamp )
 382 {
 383     if( isom_check_initializer_present( root ) < 0 )
 384         return NULL;
 385     lsmash_file_t *file = root->file->initializer;
 386     if( !file->moov
 387      || !file->moov->mvhd
 388      || !file->moov->udta
 389      || !file->moov->udta->chpl )
 390         return NULL;
 391     isom_chpl_t *chpl = file->moov->udta->chpl;
 392     lsmash_entry_t *entry = lsmash_get_entry( chpl->list, index );
 393     if( !entry || !entry->data )
 394         return NULL;
 395     isom_chpl_entry_t *data = (isom_chpl_entry_t *)entry->data;
 396     double timescale = chpl->version ? 10000000.0 : file->moov->mvhd->timescale;
 397     *timestamp = data->start_time / timescale;
 398     if( !memcmp( data->chapter_name, UTF8_BOM, UTF8_BOM_LENGTH ) )
 399         return data->chapter_name + UTF8_BOM_LENGTH;
 400     return data->chapter_name;
 401 }
 402
 403
 404 int lsmash_print_chapter_list( lsmash_root_t *root )
 405 {
 406     if( isom_check_initializer_present( root ) < 0
 407      || !(root->file->initializer->flags & LSMASH_FILE_MODE_READ) )
 408         return -1;
 409     lsmash_file_t *file = root->file->initializer;
 410     if( file->moov
 411      && file->moov->udta
 412      && file->moov->udta->chpl )
 413     {
 414         isom_chpl_t *chpl = file->moov->udta->chpl;
 415         uint32_t timescale;
 416         if( !chpl->version )
 417         {
 418             if( !file->moov
 419              && !file->moov->mvhd )
 420                 return -1;
 421             timescale = file->moov->mvhd->timescale;
 422         }
 423         else
 424             timescale = 10000000;
 425         uint32_t i = 1;
 426         for( lsmash_entry_t *entry = chpl->list->head; entry; entry = entry->next )
 427         {
 428             isom_chpl_entry_t *data = (isom_chpl_entry_t *)entry->data;
 429             int64_t start_time = data->start_time / timescale;
 430             int hh =  start_time / 3600;
 431             int mm = (start_time /   60) % 60;
 432             int ss =  start_time         % 60;
 433             int ms = ((data->start_time / (double)timescale) - hh * 3600 - mm * 60 - ss) * 1e3 + 0.5;
 434             if( !memcmp( data->chapter_name, UTF8_BOM, UTF8_BOM_LENGTH ) )    /* detect BOM */
 435             {
 436                 data->chapter_name += UTF8_BOM_LENGTH;
 437 #ifdef _WIN32
 438                 if( i == 1 )
 439                     printf( UTF8_BOM );    /* add BOM on Windows */
 440 #endif
 441             }
 442             printf( "CHAPTER%02"PRIu32"=%02d:%02d:%02d.%03d\n", i, hh, mm, ss, ms );
 443             printf( "CHAPTER%02"PRIu32"NAME=%s\n", i++, data->chapter_name );
 444         }
 445         return 0;
 446     }
 447     else
 448         lsmash_log( NULL, LSMASH_LOG_ERROR, "this file doesn't have a chapter list.\n" );
 449     return -1;
 450 }