libhb/encx264.c

   1 /* $Id: encx264.c,v 1.21 2005/11/04 13:09:41 titer Exp $
   2
   3    This file is part of the HandBrake source code.
   4    Homepage: <http://handbrake.fr/>.
   5    It may be used under the terms of the GNU General Public License. */
   6
   7 #include <stdarg.h>
   8
   9 #include "hb.h"
  10
  11 #include "x264.h"
  12
  13 int  encx264Init( hb_work_object_t *, hb_job_t * );
  14 int  encx264Work( hb_work_object_t *, hb_buffer_t **, hb_buffer_t ** );
  15 void encx264Close( hb_work_object_t * );
  16
  17 hb_work_object_t hb_encx264 =
  18 {
  19     WORK_ENCX264,
  20     "H.264/AVC encoder (libx264)",
  21     encx264Init,
  22     encx264Work,
  23     encx264Close
  24 };
  25
  26 #define DTS_BUFFER_SIZE 32
  27
  28 /*
  29  * The frame info struct remembers information about each frame across calls
  30  * to x264_encoder_encode. Since frames are uniquely identified by their
  31  * timestamp, we use some bits of the timestamp as an index. The LSB is
  32  * chosen so that two successive frames will have different values in the
  33  * bits over any plausible range of frame rates. (Starting with bit 8 allows
  34  * any frame rate slower than 352fps.) The MSB determines the size of the array.
  35  * It is chosen so that two frames can't use the same slot during the
  36  * encoder's max frame delay (set by the standard as 16 frames) and so
  37  * that, up to some minimum frame rate, frames are guaranteed to map to
  38  * different slots. (An MSB of 17 which is 2^(17-8+1) = 1024 slots guarantees
  39  * no collisions down to a rate of .7 fps).
  40  */
  41 #define FRAME_INFO_MAX2 (8)     // 2^8 = 256; 90000/256 = 352 frames/sec
  42 #define FRAME_INFO_MIN2 (17)    // 2^17 = 128K; 90000/131072 = 1.4 frames/sec
  43 #define FRAME_INFO_SIZE (1 << (FRAME_INFO_MIN2 - FRAME_INFO_MAX2 + 1))
  44 #define FRAME_INFO_MASK (FRAME_INFO_SIZE - 1)
  45
  46 struct hb_work_private_s
  47 {
  48     hb_job_t       * job;
  49     x264_t         * x264;
  50     x264_picture_t   pic_in;
  51     uint8_t         *x264_allocated_pic;
  52
  53     uint32_t       frames_in;
  54     uint32_t       frames_out;
  55     uint32_t       frames_split; // number of frames we had to split
  56     int            chap_mark;   // saved chap mark when we're propagating it
  57     int64_t        last_stop;   // Debugging - stop time of previous input frame
  58     int64_t        init_delay;
  59     int64_t        next_chap;
  60
  61     struct {
  62         int64_t duration;
  63     } frame_info[FRAME_INFO_SIZE];
  64
  65     char             filename[1024];
  66 };
  67
  68 /***********************************************************************
  69  * hb_work_encx264_init
  70  ***********************************************************************
  71  *
  72  **********************************************************************/
  73 int encx264Init( hb_work_object_t * w, hb_job_t * job )
  74 {
  75     x264_param_t       param;
  76     x264_nal_t       * nal;
  77     int                nal_count;
  78
  79     hb_work_private_t * pv = calloc( 1, sizeof( hb_work_private_t ) );
  80     w->private_data = pv;
  81
  82     pv->job = job;
  83
  84     memset( pv->filename, 0, 1024 );
  85     hb_get_tempory_filename( job->h, pv->filename, "x264.log" );
  86
  87     x264_param_default( &param );
  88
  89     /* Temporarily default mbtree to off for baseline,
  90        overridable through x264 option strings. */
  91     if( job->x264opts != NULL && *job->x264opts != '\0' )
  92     {
  93         char *x264opts, *x264opts_start;
  94
  95         x264opts = x264opts_start = strdup(job->x264opts);
  96
  97         while( x264opts_start && *x264opts )
  98         {
  99             char *name = x264opts;
 100             char *value;
 101
 102             x264opts += strcspn( x264opts, ":" );
 103             if( *x264opts )
 104             {
 105                 *x264opts = 0;
 106                 x264opts++;
 107             }
 108
 109             value = strchr( name, '=' );
 110             if( value )
 111             {
 112                 *value = 0;
 113                 value++;
 114             }
 115
 116             /*
 117                When B-frames are enabled, the max frame count increments
 118                by 1 (regardless of the number of B-frames). If you don't
 119                change the duration of the video track when you mux, libmp4
 120                barfs.  So, check if the x264opts aren't using B-frames, and
 121                when they aren't, set the boolean job->areBframes as false.
 122              */
 123             if( !( strcmp( name, "bframes" ) ) )
 124             {
 125                 if( atoi( value ) == 0 )
 126                 {
 127                     param.rc.b_mb_tree = 0;
 128                 }
 129             }
 130         }
 131     }
 132
 133     /* Enable metrics */
 134     param.analyse.b_psnr = 1;
 135     param.analyse.b_ssim = 1;
 136
 137     param.i_threads    = ( hb_get_cpu_count() * 3 / 2 );
 138     param.i_width      = job->width;
 139     param.i_height     = job->height;
 140     param.i_fps_num    = job->vrate;
 141     param.i_fps_den    = job->vrate_base;
 142
 143     /* Disable annexb. Inserts size into nal header instead of start code */
 144     param.b_annexb     = 0;
 145
 146     /* Set min:max key intervals ratio to 1:10 of fps.
 147      * This section is skipped if fps=25 (default).
 148      */
 149     if (job->vrate_base != 1080000)
 150     {
 151         if (job->pass == 2 && !job->cfr )
 152         {
 153             /* Even though the framerate might be different due to VFR,
 154                we still want the same keyframe intervals as the 1st pass,
 155                so the 1st pass stats won't conflict on frame decisions.    */
 156             hb_interjob_t * interjob = hb_interjob_get( job->h );
 157             param.i_keyint_min     = ( interjob->vrate / interjob->vrate_base ) + 1;
 158             param.i_keyint_max = ( 10 * interjob->vrate / interjob->vrate_base ) + 1;
 159         }
 160         else
 161         {
 162             int fps = job->vrate / job->vrate_base;
 163
 164             /* adjust +1 when fps has remainder to bump
 165                { 23.976, 29.976, 59.94 } to { 24, 30, 60 } */
 166             if (job->vrate % job->vrate_base)
 167                 fps += 1;
 168
 169             param.i_keyint_min = fps;
 170             param.i_keyint_max = fps * 10;
 171         }
 172
 173         hb_log("encx264: keyint-min: %i, keyint-max: %i", param.i_keyint_min, param.i_keyint_max);
 174     }
 175
 176     param.i_log_level  = X264_LOG_INFO;
 177     if( job->h264_level )
 178     {
 179         param.b_cabac     = 0;
 180         param.i_level_idc = job->h264_level;
 181         hb_log( "encx264: encoding at level %i",
 182                 param.i_level_idc );
 183     }
 184
 185     /* B-frames are on by default.*/
 186     job->areBframes = 1;
 187
 188     /*
 189         This section passes the string x264opts to libx264 for parsing into
 190         parameter names and values.
 191
 192         The string is set up like this:
 193         option1=value1:option2=value 2
 194
 195         So, you have to iterate through based on the colons, and then put
 196         the left side of the equals sign in "name" and the right side into
 197         "value." Then you hand those strings off to x264 for interpretation.
 198
 199         This is all based on the universal x264 option handling Loren
 200         Merritt implemented in the Mplayer/Mencoder project.
 201      */
 202
 203     if( job->x264opts != NULL && *job->x264opts != '\0' )
 204     {
 205         char *x264opts, *x264opts_start;
 206
 207         x264opts = x264opts_start = strdup(job->x264opts);
 208
 209         while( x264opts_start && *x264opts )
 210         {
 211             char *name = x264opts;
 212             char *value;
 213             int ret;
 214
 215             x264opts += strcspn( x264opts, ":" );
 216             if( *x264opts )
 217             {
 218                 *x264opts = 0;
 219                 x264opts++;
 220             }
 221
 222             value = strchr( name, '=' );
 223             if( value )
 224             {
 225                 *value = 0;
 226                 value++;
 227             }
 228
 229             /*
 230                When B-frames are enabled, the max frame count increments
 231                by 1 (regardless of the number of B-frames). If you don't
 232                change the duration of the video track when you mux, libmp4
 233                barfs.  So, check if the x264opts aren't using B-frames, and
 234                when they aren't, set the boolean job->areBframes as false.
 235              */
 236             if( !( strcmp( name, "bframes" ) ) )
 237             {
 238                 if( atoi( value ) == 0 )
 239                 {
 240                     job->areBframes = 0;
 241                 }
 242             }
 243
 244             /* Note b-pyramid here, so the initial delay can be doubled */
 245             if( !( strcmp( name, "b-pyramid" ) ) )
 246             {
 247                 if( value != NULL )
 248                 {
 249                     if( atoi( value ) > 0 )
 250                     {
 251                         job->areBframes = 2;
 252                     }
 253                 }
 254                 else
 255                 {
 256                     job->areBframes = 2;
 257                 }
 258             }
 259
 260             /* Here's where the strings are passed to libx264 for parsing. */
 261             ret = x264_param_parse( &param, name, value );
 262
 263             /*  Let x264 sanity check the options for us*/
 264             if( ret == X264_PARAM_BAD_NAME )
 265                 hb_log( "x264 options: Unknown suboption %s", name );
 266             if( ret == X264_PARAM_BAD_VALUE )
 267                 hb_log( "x264 options: Bad argument %s=%s", name, value ? value : "(null)" );
 268         }
 269         free(x264opts_start);
 270     }
 271
 272     /* set up the VUI color model & gamma to match what the COLR atom
 273      * set in muxmp4.c says. See libhb/muxmp4.c for notes. */
 274     if( job->color_matrix == 1 )
 275     {
 276         // ITU BT.601 DVD or SD TV content
 277         param.vui.i_colorprim = 6;
 278         param.vui.i_transfer = 1;
 279         param.vui.i_colmatrix = 6;
 280     }
 281     else if( job->color_matrix == 2 )
 282     {
 283         // ITU BT.709 HD content
 284         param.vui.i_colorprim = 1;
 285         param.vui.i_transfer = 1;
 286         param.vui.i_colmatrix = 1;
 287     }
 288     else if ( job->title->width >= 1280 || job->title->height >= 720 )
 289     {
 290         // we guess that 720p or above is ITU BT.709 HD content
 291         param.vui.i_colorprim = 1;
 292         param.vui.i_transfer = 1;
 293         param.vui.i_colmatrix = 1;
 294     }
 295     else
 296     {
 297         // ITU BT.601 DVD or SD TV content
 298         param.vui.i_colorprim = 6;
 299         param.vui.i_transfer = 1;
 300         param.vui.i_colmatrix = 6;
 301     }
 302
 303     if( job->anamorphic.mode )
 304     {
 305         param.vui.i_sar_width  = job->anamorphic.par_width;
 306         param.vui.i_sar_height = job->anamorphic.par_height;
 307
 308         hb_log( "encx264: encoding with stored aspect %d/%d",
 309                 param.vui.i_sar_width, param.vui.i_sar_height );
 310     }
 311
 312
 313     if( job->vquality > 0.0 && job->vquality < 1.0 )
 314     {
 315         /*Constant RF*/
 316         param.rc.i_rc_method = X264_RC_CRF;
 317         param.rc.f_rf_constant = 51 - job->vquality * 51;
 318         hb_log( "encx264: Encoding at constant RF %f", param.rc.f_rf_constant );
 319     }
 320     else if( job->vquality == 0 || job->vquality >= 1.0 )
 321     {
 322         /* Use the vquality as a raw RF or QP
 323           instead of treating it like a percentage. */
 324         /*Constant RF*/
 325         param.rc.i_rc_method = X264_RC_CRF;
 326         param.rc.f_rf_constant = job->vquality;
 327         hb_log( "encx264: Encoding at constant RF %f", param.rc.f_rf_constant );
 328     }
 329     else
 330     {
 331         /* Rate control */
 332         param.rc.i_rc_method = X264_RC_ABR;
 333         param.rc.i_bitrate = job->vbitrate;
 334         switch( job->pass )
 335         {
 336             case 1:
 337                 param.rc.b_stat_write  = 1;
 338                 param.rc.psz_stat_out = pv->filename;
 339                 break;
 340             case 2:
 341                 param.rc.b_stat_read = 1;
 342                 param.rc.psz_stat_in = pv->filename;
 343                 break;
 344         }
 345     }
 346
 347     hb_deep_log( 2, "encx264: opening libx264 (pass %d)", job->pass );
 348     pv->x264 = x264_encoder_open( &param );
 349
 350     x264_encoder_headers( pv->x264, &nal, &nal_count );
 351
 352     /* Sequence Parameter Set */
 353     memcpy(w->config->h264.sps, nal[1].p_payload + 4, nal[1].i_payload - 4);
 354     w->config->h264.sps_length = nal[1].i_payload - 4;
 355
 356     /* Picture Parameter Set */
 357     memcpy(w->config->h264.pps, nal[2].p_payload + 4, nal[2].i_payload - 4);
 358     w->config->h264.pps_length = nal[2].i_payload - 4;
 359
 360     x264_picture_alloc( &pv->pic_in, X264_CSP_I420,
 361                         job->width, job->height );
 362
 363     pv->pic_in.img.i_stride[2] = pv->pic_in.img.i_stride[1] = ( ( job->width + 1 ) >> 1 );
 364     pv->x264_allocated_pic = pv->pic_in.img.plane[0];
 365
 366     if (job->areBframes)
 367     {
 368         /* Basic initDelay value is the clockrate divided by the FPS
 369            -- the length of one frame in clockticks.                  */
 370         pv->init_delay = 90000. / ((double)job->vrate / (double)job->vrate_base);
 371
 372         /* 23.976-length frames are 3753.75 ticks long on average but the DVD
 373            creates that average rate by repeating 59.95 fields so the max
 374            frame size is actually 4504.5 (3 field times). The field durations
 375            are computed based on quantized times (see below) so we need an extra
 376            two ticks to account for the rounding. */
 377         if (pv->init_delay == 3753)
 378             pv->init_delay = 4507;
 379
 380         /* frame rates are not exact in the DVD 90KHz PTS clock (they are
 381            exact in the DVD 27MHz system clock but we never see that) so the
 382            rates computed above are all +-1 due to quantization. Worst case
 383            is when a clock-rounded-down frame is adjacent to a rounded-up frame
 384            which makes one of the frames 2 ticks longer than the nominal
 385            frame time. */
 386         pv->init_delay += 2;
 387
 388         /* For VFR, libhb sees the FPS as 29.97, but the longest frames
 389            will use the duration of frames running at 23.976fps instead.
 390            Since detelecine occasionally makes mistakes and since we have
 391            to deal with some really horrible timing jitter from mkvs and
 392            mp4s encoded with low resolution clocks, make the delay very
 393            conservative if we're not doing CFR. */
 394         if ( job->cfr != 1 )
 395         {
 396             pv->init_delay *= 2;
 397         }
 398
 399         /* The delay is 1 frames for regular b-frames, 2 for b-pyramid. */
 400         pv->init_delay *= job->areBframes;
 401     }
 402     w->config->h264.init_delay = pv->init_delay;
 403
 404     return 0;
 405 }
 406
 407 void encx264Close( hb_work_object_t * w )
 408 {
 409     hb_work_private_t * pv = w->private_data;
 410
 411     if ( pv->frames_split )
 412     {
 413         hb_log( "encx264: %u frames had to be split (%u in, %u out)",
 414                 pv->frames_split, pv->frames_in, pv->frames_out );
 415     }
 416     /*
 417      * Patch the x264 allocated data back in so that x264 can free it
 418      * we have been using our own buffers during the encode to avoid copying.
 419      */
 420     pv->pic_in.img.plane[0] = pv->x264_allocated_pic;
 421     x264_picture_clean( &pv->pic_in );
 422     x264_encoder_close( pv->x264 );
 423     free( pv );
 424     w->private_data = NULL;
 425
 426     /* TODO */
 427 }
 428
 429 /*
 430  * see comments in definition of 'frame_info' in pv struct for description
 431  * of what these routines are doing.
 432  */
 433 static void save_frame_info( hb_work_private_t * pv, hb_buffer_t * in )
 434 {
 435     int i = (in->start >> FRAME_INFO_MAX2) & FRAME_INFO_MASK;
 436     pv->frame_info[i].duration = in->stop - in->start;
 437 }
 438
 439 static int64_t get_frame_duration( hb_work_private_t * pv, int64_t pts )
 440 {
 441     int i = (pts >> FRAME_INFO_MAX2) & FRAME_INFO_MASK;
 442     return pv->frame_info[i].duration;
 443 }
 444
 445 static hb_buffer_t *nal_encode( hb_work_object_t *w, x264_picture_t *pic_out,
 446                                 int i_nal, x264_nal_t *nal )
 447 {
 448     hb_buffer_t *buf = NULL;
 449     hb_work_private_t *pv = w->private_data;
 450     hb_job_t *job = pv->job;
 451
 452     /* Should be way too large */
 453     buf = hb_video_buffer_init( job->width, job->height );
 454     buf->size = 0;
 455     buf->frametype = 0;
 456
 457     // use the pts to get the original frame's duration.
 458     int64_t duration  = get_frame_duration( pv, pic_out->i_pts );
 459     buf->start = pic_out->i_pts;
 460     buf->stop  = pic_out->i_pts + duration;
 461
 462     /* Encode all the NALs we were given into buf.
 463        NOTE: This code assumes one video frame per NAL (but there can
 464              be other stuff like SPS and/or PPS). If there are multiple
 465              frames we only get the duration of the first which will
 466              eventually screw up the muxer & decoder. */
 467     int i;
 468     for( i = 0; i < i_nal; i++ )
 469     {
 470         int size = nal[i].i_payload;
 471         memcpy(buf->data + buf->size, nal[i].p_payload, size);
 472         if( size < 1 )
 473         {
 474             continue;
 475         }
 476
 477         if( job->mux & HB_MUX_AVI )
 478         {
 479             if( nal[i].i_ref_idc == NAL_PRIORITY_HIGHEST )
 480             {
 481                 buf->frametype = HB_FRAME_KEY;
 482             }
 483             buf->size += size;
 484             continue;
 485         }
 486
 487         /* H.264 in .mp4 or .mkv */
 488         switch( nal[i].i_type )
 489         {
 490             /* Sequence Parameter Set & Program Parameter Set go in the
 491              * mp4 header so skip them here
 492              */
 493             case NAL_SPS:
 494             case NAL_PPS:
 495                 continue;
 496
 497             case NAL_SLICE:
 498             case NAL_SLICE_IDR:
 499             case NAL_SEI:
 500             default:
 501                 break;
 502         }
 503
 504         /* Decide what type of frame we have. */
 505         switch( pic_out->i_type )
 506         {
 507             case X264_TYPE_IDR:
 508                 buf->frametype = HB_FRAME_IDR;
 509                 /* if we have a chapter marker pending and this
 510                    frame's presentation time stamp is at or after
 511                    the marker's time stamp, use this as the
 512                    chapter start. */
 513                 if( pv->next_chap != 0 && pv->next_chap <= pic_out->i_pts )
 514                 {
 515                     pv->next_chap = 0;
 516                     buf->new_chap = pv->chap_mark;
 517                 }
 518                 break;
 519
 520             case X264_TYPE_I:
 521                 buf->frametype = HB_FRAME_I;
 522                 break;
 523
 524             case X264_TYPE_P:
 525                 buf->frametype = HB_FRAME_P;
 526                 break;
 527
 528             case X264_TYPE_B:
 529                 buf->frametype = HB_FRAME_B;
 530                 break;
 531
 532         /*  This is for b-pyramid, which has reference b-frames
 533             However, it doesn't seem to ever be used... */
 534             case X264_TYPE_BREF:
 535                 buf->frametype = HB_FRAME_BREF;
 536                 break;
 537
 538             // If it isn't the above, what type of frame is it??
 539             default:
 540                 buf->frametype = 0;
 541                 break;
 542         }
 543
 544         /* Since libx264 doesn't tell us when b-frames are
 545            themselves reference frames, figure it out on our own. */
 546         if( (buf->frametype == HB_FRAME_B) &&
 547             (nal[i].i_ref_idc != NAL_PRIORITY_DISPOSABLE) )
 548             buf->frametype = HB_FRAME_BREF;
 549
 550         /* Expose disposable bit to muxer. */
 551         if( nal[i].i_ref_idc == NAL_PRIORITY_DISPOSABLE )
 552             buf->flags &= ~HB_FRAME_REF;
 553         else
 554             buf->flags |= HB_FRAME_REF;
 555
 556         buf->size += size;
 557     }
 558     // make sure we found at least one video frame
 559     if ( buf->size <= 0 )
 560     {
 561         // no video - discard the buf
 562         hb_buffer_close( &buf );
 563     }
 564     return buf;
 565 }
 566
 567 static hb_buffer_t *x264_encode( hb_work_object_t *w, hb_buffer_t *in )
 568 {
 569     hb_work_private_t *pv = w->private_data;
 570     hb_job_t *job = pv->job;
 571
 572     /* Point x264 at our current buffers Y(UV) data.  */
 573     pv->pic_in.img.plane[0] = in->data;
 574
 575     int uvsize = ( (job->width + 1) >> 1 ) * ( (job->height + 1) >> 1 );
 576     if( job->grayscale )
 577     {
 578         /* XXX x264 has currently no option for grayscale encoding */
 579         memset( pv->pic_in.img.plane[1], 0x80, uvsize );
 580         memset( pv->pic_in.img.plane[2], 0x80, uvsize );
 581     }
 582     else
 583     {
 584         /* Point x264 at our buffers (Y)UV data */
 585         pv->pic_in.img.plane[1] = in->data + job->width * job->height;
 586         pv->pic_in.img.plane[2] = pv->pic_in.img.plane[1] + uvsize;
 587     }
 588     if( in->new_chap && job->chapter_markers )
 589     {
 590         /* chapters have to start with an IDR frame so request that this
 591            frame be coded as IDR. Since there may be up to 16 frames
 592            currently buffered in the encoder remember the timestamp so
 593            when this frame finally pops out of the encoder we'll mark
 594            its buffer as the start of a chapter. */
 595         pv->pic_in.i_type = X264_TYPE_IDR;
 596         if( pv->next_chap == 0 )
 597         {
 598             pv->next_chap = in->start;
 599             pv->chap_mark = in->new_chap;
 600         }
 601         /* don't let 'work_loop' put a chapter mark on the wrong buffer */
 602         in->new_chap = 0;
 603     }
 604     else
 605     {
 606         pv->pic_in.i_type = X264_TYPE_AUTO;
 607     }
 608     pv->pic_in.i_qpplus1 = 0;
 609
 610     /* XXX this is temporary debugging code to check that the upstream
 611      * modules (render & sync) have generated a continuous, self-consistent
 612      * frame stream with the current frame's start time equal to the
 613      * previous frame's stop time.
 614      */
 615     if( pv->last_stop != in->start )
 616     {
 617         hb_log("encx264 input continuity err: last stop %"PRId64"  start %"PRId64,
 618                 pv->last_stop, in->start);
 619     }
 620     pv->last_stop = in->stop;
 621
 622     // Remember info about this frame that we need to pass across
 623     // the x264_encoder_encode call (since it reorders frames).
 624     save_frame_info( pv, in );
 625
 626     /* Feed the input PTS to x264 so it can figure out proper output PTS */
 627     pv->pic_in.i_pts = in->start;
 628
 629     x264_picture_t pic_out;
 630     int i_nal;
 631     x264_nal_t *nal;
 632
 633     x264_encoder_encode( pv->x264, &nal, &i_nal, &pv->pic_in, &pic_out );
 634     if ( i_nal > 0 )
 635     {
 636         return nal_encode( w, &pic_out, i_nal, nal );
 637     }
 638     return NULL;
 639 }
 640
 641 int encx264Work( hb_work_object_t * w, hb_buffer_t ** buf_in,
 642                   hb_buffer_t ** buf_out )
 643 {
 644     hb_work_private_t *pv = w->private_data;
 645     hb_buffer_t *in = *buf_in;
 646
 647     *buf_out = NULL;
 648
 649     if( in->size <= 0 )
 650     {
 651         // EOF on input. Flush any frames still in the decoder then
 652         // send the eof downstream to tell the muxer we're done.
 653         x264_picture_t pic_out;
 654         int i_nal;
 655         x264_nal_t *nal;
 656         hb_buffer_t *last_buf = NULL;
 657
 658         while (1)
 659         {
 660             x264_encoder_encode( pv->x264, &nal, &i_nal, NULL, &pic_out );
 661             if ( i_nal <= 0 )
 662                 break;
 663
 664             hb_buffer_t *buf = nal_encode( w, &pic_out, i_nal, nal );
 665             if ( buf )
 666             {
 667                 ++pv->frames_out;
 668                 if ( last_buf == NULL )
 669                     *buf_out = buf;
 670                 else
 671                     last_buf->next = buf;
 672                 last_buf = buf;
 673             }
 674         }
 675         // Flushed everything - add the eof to the end of the chain.
 676         if ( last_buf == NULL )
 677             *buf_out = in;
 678         else
 679             last_buf->next = in;
 680
 681         *buf_in = NULL;
 682         return HB_WORK_DONE;
 683     }
 684
 685     // Not EOF - encode the packet & wrap it in a NAL
 686     ++pv->frames_in;
 687
 688     // if we're re-ordering frames, check if this frame is too large to reorder
 689     if ( pv->init_delay && in->stop - in->start > pv->init_delay )
 690     {
 691         // This frame's duration is larger than the time allotted for b-frame
 692         // reordering. That means that if it's used as a reference the decoder
 693         // won't be able to move it early enough to render it in correct
 694         // sequence & the playback will have odd jumps & twitches. To make
 695         // sure this doesn't happen we pretend this frame is multiple
 696         // frames, each with duration <= init_delay. Since each of these
 697         // new frames contains the same image the visual effect is identical
 698         // to the original but the resulting stream can now be coded without
 699         // error. We take advantage of the fact that x264 buffers frame
 700         // data internally to feed the same image into the encoder multiple
 701         // times, just changing its start & stop times each time.
 702         ++pv->frames_split;
 703         int64_t orig_stop = in->stop;
 704         int64_t new_stop = in->start;
 705         hb_buffer_t *last_buf = NULL;
 706
 707         // We want to spread the new frames uniformly over the total time
 708         // so that we don't end up with a very short frame at the end.
 709         // In the number of pieces calculation we add in init_delay-1 to
 710         // round up but not add an extra piece if the frame duration is
 711         // a multiple of init_delay. The final increment of frame_dur is
 712         // to restore the bits that got truncated by the divide on the
 713         // previous line. If we don't do this we end up with an extra tiny
 714         // frame at the end whose duration is npieces-1.
 715         int64_t frame_dur = orig_stop - new_stop;
 716         int64_t npieces = ( frame_dur + pv->init_delay - 1 ) / pv->init_delay;
 717         frame_dur /= npieces;
 718         ++frame_dur;
 719
 720         while ( in->start < orig_stop )
 721         {
 722             new_stop += frame_dur;
 723             if ( new_stop > orig_stop )
 724                 new_stop = orig_stop;
 725             in->stop = new_stop;
 726             hb_buffer_t *buf = x264_encode( w, in );
 727             if ( buf )
 728             {
 729                 ++pv->frames_out;
 730                 if ( last_buf == NULL )
 731                     *buf_out = buf;
 732                 else
 733                     last_buf->next = buf;
 734                 last_buf = buf;
 735             }
 736             in->start = new_stop;
 737         }
 738     }
 739     else
 740     {
 741         ++pv->frames_out;
 742         *buf_out = x264_encode( w, in );
 743     }
 744     return HB_WORK_OK;
 745 }