src/libFLAC/stream_encoder.c

   1 /* libFLAC - Free Lossless Audio Codec library
   2  * Copyright (C) 2000,2001,2002  Josh Coalson
   3  *
   4  * This library is free software; you can redistribute it and/or
   5  * modify it under the terms of the GNU Library General Public
   6  * License as published by the Free Software Foundation; either
   7  * version 2 of the License, or (at your option) any later version.
   8  *
   9  * This library is distributed in the hope that it will be useful,
  10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  12  * Library General Public License for more details.
  13  *
  14  * You should have received a copy of the GNU Library General Public
  15  * License along with this library; if not, write to the
  16  * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
  17  * Boston, MA  02111-1307, USA.
  18  */
  19
  20 #include <limits.h>
  21 #include <stdio.h>
  22 #include <stdlib.h> /* for malloc() */
  23 #include <string.h> /* for memcpy() */
  24 #include "FLAC/assert.h"
  25 #include "FLAC/stream_decoder.h"
  26 #include "protected/stream_encoder.h"
  27 #include "private/bitbuffer.h"
  28 #include "private/bitmath.h"
  29 #include "private/crc.h"
  30 #include "private/cpu.h"
  31 #include "private/fixed.h"
  32 #include "private/format.h"
  33 #include "private/lpc.h"
  34 #include "private/md5.h"
  35 #include "private/memory.h"
  36 #include "private/stream_encoder_framing.h"
  37
  38 #ifdef HAVE_CONFIG_H
  39 #include <config.h>
  40 #endif
  41
  42 #ifdef min
  43 #undef min
  44 #endif
  45 #define min(x,y) ((x)<(y)?(x):(y))
  46
  47 #ifdef max
  48 #undef max
  49 #endif
  50 #define max(x,y) ((x)>(y)?(x):(y))
  51
  52 typedef struct {
  53         FLAC__int32 *data[FLAC__MAX_CHANNELS];
  54         unsigned size; /* of each data[] in samples */
  55         unsigned tail;
  56 } verify_input_fifo;
  57
  58 typedef struct {
  59         const FLAC__byte *data;
  60         unsigned capacity;
  61         unsigned bytes;
  62 } verify_output;
  63
  64 typedef enum {
  65         ENCODER_IN_MAGIC = 0,
  66         ENCODER_IN_METADATA = 1,
  67         ENCODER_IN_AUDIO = 2
  68 } EncoderStateHint;
  69
  70 /***********************************************************************
  71  *
  72  * Private class method prototypes
  73  *
  74  ***********************************************************************/
  75
  76 static void set_defaults_(FLAC__StreamEncoder *encoder);
  77 static void free_(FLAC__StreamEncoder *encoder);
  78 static FLAC__bool resize_buffers_(FLAC__StreamEncoder *encoder, unsigned new_size);
  79 static FLAC__bool write_bitbuffer_(FLAC__StreamEncoder *encoder, unsigned samples);
  80 static FLAC__bool process_frame_(FLAC__StreamEncoder *encoder, FLAC__bool is_last_frame);
  81 static FLAC__bool process_subframes_(FLAC__StreamEncoder *encoder, FLAC__bool is_last_frame);
  82
  83 static FLAC__bool process_subframe_(
  84         FLAC__StreamEncoder *encoder,
  85         unsigned min_partition_order,
  86         unsigned max_partition_order,
  87         FLAC__bool precompute_partition_sums,
  88         const FLAC__FrameHeader *frame_header,
  89         unsigned subframe_bps,
  90         const FLAC__int32 integer_signal[],
  91         const FLAC__real real_signal[],
  92         FLAC__Subframe *subframe[2],
  93         FLAC__EntropyCodingMethod_PartitionedRiceContents *partitioned_rice_contents[2],
  94         FLAC__int32 *residual[2],
  95         unsigned *best_subframe,
  96         unsigned *best_bits
  97 );
  98
  99 static FLAC__bool add_subframe_(
 100         FLAC__StreamEncoder *encoder,
 101         const FLAC__FrameHeader *frame_header,
 102         unsigned subframe_bps,
 103         const FLAC__Subframe *subframe,
 104         FLAC__BitBuffer *frame
 105 );
 106
 107 static unsigned evaluate_constant_subframe_(
 108         const FLAC__int32 signal,
 109         unsigned subframe_bps,
 110         FLAC__Subframe *subframe
 111 );
 112
 113 static unsigned evaluate_fixed_subframe_(
 114         FLAC__StreamEncoder *encoder,
 115         const FLAC__int32 signal[],
 116         FLAC__int32 residual[],
 117         FLAC__uint32 abs_residual[],
 118         FLAC__uint64 abs_residual_partition_sums[],
 119         unsigned raw_bits_per_partition[],
 120         unsigned blocksize,
 121         unsigned subframe_bps,
 122         unsigned order,
 123         unsigned rice_parameter,
 124         unsigned min_partition_order,
 125         unsigned max_partition_order,
 126         FLAC__bool precompute_partition_sums,
 127         FLAC__bool do_escape_coding,
 128         unsigned rice_parameter_search_dist,
 129         FLAC__Subframe *subframe,
 130         FLAC__EntropyCodingMethod_PartitionedRiceContents *partitioned_rice_contents
 131 );
 132
 133 static unsigned evaluate_lpc_subframe_(
 134         FLAC__StreamEncoder *encoder,
 135         const FLAC__int32 signal[],
 136         FLAC__int32 residual[],
 137         FLAC__uint32 abs_residual[],
 138         FLAC__uint64 abs_residual_partition_sums[],
 139         unsigned raw_bits_per_partition[],
 140         const FLAC__real lp_coeff[],
 141         unsigned blocksize,
 142         unsigned subframe_bps,
 143         unsigned order,
 144         unsigned qlp_coeff_precision,
 145         unsigned rice_parameter,
 146         unsigned min_partition_order,
 147         unsigned max_partition_order,
 148         FLAC__bool precompute_partition_sums,
 149         FLAC__bool do_escape_coding,
 150         unsigned rice_parameter_search_dist,
 151         FLAC__Subframe *subframe,
 152         FLAC__EntropyCodingMethod_PartitionedRiceContents *partitioned_rice_contents
 153 );
 154
 155 static unsigned evaluate_verbatim_subframe_(
 156         const FLAC__int32 signal[],
 157         unsigned blocksize,
 158         unsigned subframe_bps,
 159         FLAC__Subframe *subframe
 160 );
 161
 162 static unsigned find_best_partition_order_(
 163         struct FLAC__StreamEncoderPrivate *private_,
 164         const FLAC__int32 residual[],
 165         FLAC__uint32 abs_residual[],
 166         FLAC__uint64 abs_residual_partition_sums[],
 167         unsigned raw_bits_per_partition[],
 168         unsigned residual_samples,
 169         unsigned predictor_order,
 170         unsigned rice_parameter,
 171         unsigned min_partition_order,
 172         unsigned max_partition_order,
 173         FLAC__bool precompute_partition_sums,
 174         FLAC__bool do_escape_coding,
 175         unsigned rice_parameter_search_dist,
 176         FLAC__EntropyCodingMethod_PartitionedRice *best_partitioned_rice
 177 );
 178
 179 static void precompute_partition_info_sums_(
 180         const FLAC__uint32 abs_residual[],
 181         FLAC__uint64 abs_residual_partition_sums[],
 182         unsigned residual_samples,
 183         unsigned predictor_order,
 184         unsigned min_partition_order,
 185         unsigned max_partition_order
 186 );
 187
 188 static void precompute_partition_info_escapes_(
 189         const FLAC__int32 residual[],
 190         unsigned raw_bits_per_partition[],
 191         unsigned residual_samples,
 192         unsigned predictor_order,
 193         unsigned min_partition_order,
 194         unsigned max_partition_order
 195 );
 196
 197 #ifdef DONT_ESTIMATE_RICE_BITS
 198 static FLAC__bool set_partitioned_rice_(
 199         const FLAC__uint32 abs_residual[],
 200         const FLAC__int32 residual[],
 201         const unsigned residual_samples,
 202         const unsigned predictor_order,
 203         const unsigned suggested_rice_parameter,
 204         const unsigned rice_parameter_search_dist,
 205         const unsigned partition_order,
 206         FLAC__EntropyCodingMethod_PartitionedRiceContents *partitioned_rice_contents,
 207         unsigned *bits
 208 );
 209
 210 static FLAC__bool set_partitioned_rice_with_precompute_(
 211         const FLAC__int32 residual[],
 212         const FLAC__uint64 abs_residual_partition_sums[],
 213         const unsigned raw_bits_per_partition[],
 214         const unsigned residual_samples,
 215         const unsigned predictor_order,
 216         const unsigned suggested_rice_parameter,
 217         const unsigned rice_parameter_search_dist,
 218         const unsigned partition_order,
 219         const FLAC__bool search_for_escapes,
 220         FLAC__EntropyCodingMethod_PartitionedRiceContents *partitioned_rice_contents,
 221         unsigned *bits
 222 );
 223 #else
 224 static FLAC__bool set_partitioned_rice_(
 225         const FLAC__uint32 abs_residual[],
 226         const unsigned residual_samples,
 227         const unsigned predictor_order,
 228         const unsigned suggested_rice_parameter,
 229         const unsigned rice_parameter_search_dist,
 230         const unsigned partition_order,
 231         FLAC__EntropyCodingMethod_PartitionedRiceContents *partitioned_rice_contents,
 232         unsigned *bits
 233 );
 234
 235 static FLAC__bool set_partitioned_rice_with_precompute_(
 236         const FLAC__uint32 abs_residual[],
 237         const FLAC__uint64 abs_residual_partition_sums[],
 238         const unsigned raw_bits_per_partition[],
 239         const unsigned residual_samples,
 240         const unsigned predictor_order,
 241         const unsigned suggested_rice_parameter,
 242         const unsigned rice_parameter_search_dist,
 243         const unsigned partition_order,
 244         const FLAC__bool search_for_escapes,
 245         FLAC__EntropyCodingMethod_PartitionedRiceContents *partitioned_rice_contents,
 246         unsigned *bits
 247 );
 248 #endif
 249
 250 static unsigned get_wasted_bits_(FLAC__int32 signal[], unsigned samples);
 251
 252 /* verify-related routines: */
 253 static void append_to_verify_fifo_(
 254         verify_input_fifo *fifo,
 255         const FLAC__int32 * const input[],
 256         unsigned input_offset,
 257         unsigned channels,
 258         unsigned wide_samples
 259 );
 260
 261 static void append_to_verify_fifo_interleaved_(
 262         verify_input_fifo *fifo,
 263         const FLAC__int32 input[],
 264         unsigned input_offset,
 265         unsigned channels,
 266         unsigned wide_samples
 267 );
 268
 269 static FLAC__StreamDecoderReadStatus verify_read_callback_(
 270         const FLAC__StreamDecoder *decoder,
 271         FLAC__byte buffer[],
 272         unsigned *bytes,
 273         void *client_data
 274 );
 275
 276 static FLAC__StreamDecoderWriteStatus verify_write_callback_(
 277         const FLAC__StreamDecoder *decoder,
 278         const FLAC__Frame *frame,
 279         const FLAC__int32 * const buffer[],
 280         void *client_data
 281 );
 282
 283 static void verify_metadata_callback_(
 284         const FLAC__StreamDecoder *decoder,
 285         const FLAC__StreamMetadata *metadata,
 286         void *client_data
 287 );
 288
 289 static void verify_error_callback_(
 290         const FLAC__StreamDecoder *decoder,
 291         FLAC__StreamDecoderErrorStatus status,
 292         void *client_data
 293 );
 294
 295
 296 /***********************************************************************
 297  *
 298  * Private class data
 299  *
 300  ***********************************************************************/
 301
 302 typedef struct FLAC__StreamEncoderPrivate {
 303         unsigned input_capacity;                          /* current size (in samples) of the signal and residual buffers */
 304         FLAC__int32 *integer_signal[FLAC__MAX_CHANNELS];  /* the integer version of the input signal */
 305         FLAC__int32 *integer_signal_mid_side[2];          /* the integer version of the mid-side input signal (stereo only) */
 306         FLAC__real *real_signal[FLAC__MAX_CHANNELS];      /* the floating-point version of the input signal */
 307         FLAC__real *real_signal_mid_side[2];              /* the floating-point version of the mid-side input signal (stereo only) */
 308         unsigned subframe_bps[FLAC__MAX_CHANNELS];        /* the effective bits per sample of the input signal (stream bps - wasted bits) */
 309         unsigned subframe_bps_mid_side[2];                /* the effective bits per sample of the mid-side input signal (stream bps - wasted bits + 0/1) */
 310         FLAC__int32 *residual_workspace[FLAC__MAX_CHANNELS][2]; /* each channel has a candidate and best workspace where the subframe residual signals will be stored */
 311         FLAC__int32 *residual_workspace_mid_side[2][2];
 312         FLAC__Subframe subframe_workspace[FLAC__MAX_CHANNELS][2];
 313         FLAC__Subframe subframe_workspace_mid_side[2][2];
 314         FLAC__Subframe *subframe_workspace_ptr[FLAC__MAX_CHANNELS][2];
 315         FLAC__Subframe *subframe_workspace_ptr_mid_side[2][2];
 316         FLAC__EntropyCodingMethod_PartitionedRiceContents partitioned_rice_contents_workspace[FLAC__MAX_CHANNELS][2];
 317         FLAC__EntropyCodingMethod_PartitionedRiceContents partitioned_rice_contents_workspace_mid_side[FLAC__MAX_CHANNELS][2];
 318         FLAC__EntropyCodingMethod_PartitionedRiceContents *partitioned_rice_contents_workspace_ptr[FLAC__MAX_CHANNELS][2];
 319         FLAC__EntropyCodingMethod_PartitionedRiceContents *partitioned_rice_contents_workspace_ptr_mid_side[FLAC__MAX_CHANNELS][2];
 320         unsigned best_subframe[FLAC__MAX_CHANNELS];       /* index into the above workspaces */
 321         unsigned best_subframe_mid_side[2];
 322         unsigned best_subframe_bits[FLAC__MAX_CHANNELS];  /* size in bits of the best subframe for each channel */
 323         unsigned best_subframe_bits_mid_side[2];
 324         FLAC__uint32 *abs_residual;                       /* workspace where abs(candidate residual) is stored */
 325         FLAC__uint64 *abs_residual_partition_sums;        /* workspace where the sum of abs(candidate residual) for each partition is stored */
 326         unsigned *raw_bits_per_partition;                 /* workspace where the sum of silog2(candidate residual) for each partition is stored */
 327         FLAC__BitBuffer *frame;                           /* the current frame being worked on */
 328         double loose_mid_side_stereo_frames_exact;        /* exact number of frames the encoder will use before trying both independent and mid/side frames again */
 329         unsigned loose_mid_side_stereo_frames;            /* rounded number of frames the encoder will use before trying both independent and mid/side frames again */
 330         unsigned loose_mid_side_stereo_frame_count;       /* number of frames using the current channel assignment */
 331         FLAC__ChannelAssignment last_channel_assignment;
 332         FLAC__StreamMetadata metadata;
 333         unsigned current_sample_number;
 334         unsigned current_frame_number;
 335         struct MD5Context md5context;
 336         FLAC__CPUInfo cpuinfo;
 337         unsigned (*local_fixed_compute_best_predictor)(const FLAC__int32 data[], unsigned data_len, FLAC__real residual_bits_per_sample[FLAC__MAX_FIXED_ORDER+1]);
 338         void (*local_lpc_compute_autocorrelation)(const FLAC__real data[], unsigned data_len, unsigned lag, FLAC__real autoc[]);
 339         void (*local_lpc_compute_residual_from_qlp_coefficients)(const FLAC__int32 data[], unsigned data_len, const FLAC__int32 qlp_coeff[], unsigned order, int lp_quantization, FLAC__int32 residual[]);
 340         void (*local_lpc_compute_residual_from_qlp_coefficients_64bit)(const FLAC__int32 data[], unsigned data_len, const FLAC__int32 qlp_coeff[], unsigned order, int lp_quantization, FLAC__int32 residual[]);
 341         void (*local_lpc_compute_residual_from_qlp_coefficients_16bit)(const FLAC__int32 data[], unsigned data_len, const FLAC__int32 qlp_coeff[], unsigned order, int lp_quantization, FLAC__int32 residual[]);
 342         FLAC__bool use_wide_by_block;          /* use slow 64-bit versions of some functions because of the block size */
 343         FLAC__bool use_wide_by_partition;      /* use slow 64-bit versions of some functions because of the min partition order and blocksize */
 344         FLAC__bool use_wide_by_order;          /* use slow 64-bit versions of some functions because of the lpc order */
 345         FLAC__bool precompute_partition_sums;  /* our initial guess as to whether precomputing the partitions sums will be a speed improvement */
 346         FLAC__bool disable_constant_subframes;
 347         FLAC__bool disable_fixed_subframes;
 348         FLAC__bool disable_verbatim_subframes;
 349         FLAC__StreamEncoderWriteCallback write_callback;
 350         FLAC__StreamEncoderMetadataCallback metadata_callback;
 351         void *client_data;
 352         /* unaligned (original) pointers to allocated data */
 353         FLAC__int32 *integer_signal_unaligned[FLAC__MAX_CHANNELS];
 354         FLAC__int32 *integer_signal_mid_side_unaligned[2];
 355         FLAC__real *real_signal_unaligned[FLAC__MAX_CHANNELS];
 356         FLAC__real *real_signal_mid_side_unaligned[2];
 357         FLAC__int32 *residual_workspace_unaligned[FLAC__MAX_CHANNELS][2];
 358         FLAC__int32 *residual_workspace_mid_side_unaligned[2][2];
 359         FLAC__uint32 *abs_residual_unaligned;
 360         FLAC__uint64 *abs_residual_partition_sums_unaligned;
 361         unsigned *raw_bits_per_partition_unaligned;
 362         /*
 363          * These fields have been moved here from private function local
 364          * declarations merely to save stack space during encoding.
 365          */
 366         FLAC__real lp_coeff[FLAC__MAX_LPC_ORDER][FLAC__MAX_LPC_ORDER]; /* from process_subframe_() */
 367         FLAC__EntropyCodingMethod_PartitionedRiceContents partitioned_rice_contents_extra[2]; /* from find_best_partition_order_() */
 368         /*
 369          * The data for the verify section
 370          */
 371         struct {
 372                 FLAC__StreamDecoder *decoder;
 373                 EncoderStateHint state_hint;
 374                 FLAC__bool needs_magic_hack;
 375                 verify_input_fifo input_fifo;
 376                 verify_output output;
 377                 struct {
 378                         FLAC__uint64 absolute_sample;
 379                         unsigned frame_number;
 380                         unsigned channel;
 381                         unsigned sample;
 382                         FLAC__int32 expected;
 383                         FLAC__int32 got;
 384                 } error_stats;
 385         } verify;
 386         FLAC__bool is_being_deleted; /* if true, call to ..._finish() from ..._delete() will not call the callbacks */
 387 } FLAC__StreamEncoderPrivate;
 388
 389 /***********************************************************************
 390  *
 391  * Public static class data
 392  *
 393  ***********************************************************************/
 394
 395 FLAC_API const char * const FLAC__StreamEncoderStateString[] = {
 396         "FLAC__STREAM_ENCODER_OK",
 397         "FLAC__STREAM_ENCODER_VERIFY_DECODER_ERROR",
 398         "FLAC__STREAM_ENCODER_VERIFY_MISMATCH_IN_AUDIO_DATA",
 399         "FLAC__STREAM_ENCODER_INVALID_CALLBACK",
 400         "FLAC__STREAM_ENCODER_INVALID_NUMBER_OF_CHANNELS",
 401         "FLAC__STREAM_ENCODER_INVALID_BITS_PER_SAMPLE",
 402         "FLAC__STREAM_ENCODER_INVALID_SAMPLE_RATE",
 403         "FLAC__STREAM_ENCODER_INVALID_BLOCK_SIZE",
 404         "FLAC__STREAM_ENCODER_INVALID_MAX_LPC_ORDER",
 405         "FLAC__STREAM_ENCODER_INVALID_QLP_COEFF_PRECISION",
 406         "FLAC__STREAM_ENCODER_MID_SIDE_CHANNELS_MISMATCH",
 407         "FLAC__STREAM_ENCODER_MID_SIDE_SAMPLE_SIZE_MISMATCH",
 408         "FLAC__STREAM_ENCODER_ILLEGAL_MID_SIDE_FORCE",
 409         "FLAC__STREAM_ENCODER_BLOCK_SIZE_TOO_SMALL_FOR_LPC_ORDER",
 410         "FLAC__STREAM_ENCODER_NOT_STREAMABLE",
 411         "FLAC__STREAM_ENCODER_FRAMING_ERROR",
 412         "FLAC__STREAM_ENCODER_INVALID_METADATA",
 413         "FLAC__STREAM_ENCODER_FATAL_ERROR_WHILE_ENCODING",
 414         "FLAC__STREAM_ENCODER_FATAL_ERROR_WHILE_WRITING",
 415         "FLAC__STREAM_ENCODER_MEMORY_ALLOCATION_ERROR",
 416         "FLAC__STREAM_ENCODER_ALREADY_INITIALIZED",
 417         "FLAC__STREAM_ENCODER_UNINITIALIZED"
 418 };
 419
 420 FLAC_API const char * const FLAC__StreamEncoderWriteStatusString[] = {
 421         "FLAC__STREAM_ENCODER_WRITE_STATUS_OK",
 422         "FLAC__STREAM_ENCODER_WRITE_STATUS_FATAL_ERROR"
 423 };
 424
 425 /***********************************************************************
 426  *
 427  * Class constructor/destructor
 428  *
 429  */
 430 FLAC_API FLAC__StreamEncoder *FLAC__stream_encoder_new()
 431 {
 432         FLAC__StreamEncoder *encoder;
 433         unsigned i;
 434
 435         FLAC__ASSERT(sizeof(int) >= 4); /* we want to die right away if this is not true */
 436
 437         encoder = (FLAC__StreamEncoder*)calloc(1, sizeof(FLAC__StreamEncoder));
 438         if(encoder == 0) {
 439                 return 0;
 440         }
 441
 442         encoder->protected_ = (FLAC__StreamEncoderProtected*)calloc(1, sizeof(FLAC__StreamEncoderProtected));
 443         if(encoder->protected_ == 0) {
 444                 free(encoder);
 445                 return 0;
 446         }
 447
 448         encoder->private_ = (FLAC__StreamEncoderPrivate*)calloc(1, sizeof(FLAC__StreamEncoderPrivate));
 449         if(encoder->private_ == 0) {
 450                 free(encoder->protected_);
 451                 free(encoder);
 452                 return 0;
 453         }
 454
 455         encoder->private_->frame = FLAC__bitbuffer_new();
 456         if(encoder->private_->frame == 0) {
 457                 free(encoder->private_);
 458                 free(encoder->protected_);
 459                 free(encoder);
 460                 return 0;
 461         }
 462
 463         set_defaults_(encoder);
 464
 465         encoder->private_->is_being_deleted = false;
 466
 467         for(i = 0; i < FLAC__MAX_CHANNELS; i++) {
 468                 encoder->private_->subframe_workspace_ptr[i][0] = &encoder->private_->subframe_workspace[i][0];
 469                 encoder->private_->subframe_workspace_ptr[i][1] = &encoder->private_->subframe_workspace[i][1];
 470         }
 471         for(i = 0; i < 2; i++) {
 472                 encoder->private_->subframe_workspace_ptr_mid_side[i][0] = &encoder->private_->subframe_workspace_mid_side[i][0];
 473                 encoder->private_->subframe_workspace_ptr_mid_side[i][1] = &encoder->private_->subframe_workspace_mid_side[i][1];
 474         }
 475         for(i = 0; i < FLAC__MAX_CHANNELS; i++) {
 476                 encoder->private_->partitioned_rice_contents_workspace_ptr[i][0] = &encoder->private_->partitioned_rice_contents_workspace[i][0];
 477                 encoder->private_->partitioned_rice_contents_workspace_ptr[i][1] = &encoder->private_->partitioned_rice_contents_workspace[i][1];
 478         }
 479         for(i = 0; i < 2; i++) {
 480                 encoder->private_->partitioned_rice_contents_workspace_ptr_mid_side[i][0] = &encoder->private_->partitioned_rice_contents_workspace_mid_side[i][0];
 481                 encoder->private_->partitioned_rice_contents_workspace_ptr_mid_side[i][1] = &encoder->private_->partitioned_rice_contents_workspace_mid_side[i][1];
 482         }
 483
 484         for(i = 0; i < FLAC__MAX_CHANNELS; i++) {
 485                 FLAC__format_entropy_coding_method_partitioned_rice_contents_init(&encoder->private_->partitioned_rice_contents_workspace[i][0]);
 486                 FLAC__format_entropy_coding_method_partitioned_rice_contents_init(&encoder->private_->partitioned_rice_contents_workspace[i][1]);
 487         }
 488         for(i = 0; i < 2; i++) {
 489                 FLAC__format_entropy_coding_method_partitioned_rice_contents_init(&encoder->private_->partitioned_rice_contents_workspace_mid_side[i][0]);
 490                 FLAC__format_entropy_coding_method_partitioned_rice_contents_init(&encoder->private_->partitioned_rice_contents_workspace_mid_side[i][1]);
 491         }
 492         for(i = 0; i < 2; i++)
 493                 FLAC__format_entropy_coding_method_partitioned_rice_contents_init(&encoder->private_->partitioned_rice_contents_extra[i]);
 494
 495         encoder->protected_->state = FLAC__STREAM_ENCODER_UNINITIALIZED;
 496
 497         return encoder;
 498 }
 499
 500 FLAC_API void FLAC__stream_encoder_delete(FLAC__StreamEncoder *encoder)
 501 {
 502         unsigned i;
 503
 504         FLAC__ASSERT(0 != encoder);
 505         FLAC__ASSERT(0 != encoder->protected_);
 506         FLAC__ASSERT(0 != encoder->private_);
 507         FLAC__ASSERT(0 != encoder->private_->frame);
 508
 509         encoder->private_->is_being_deleted = true;
 510
 511         FLAC__stream_encoder_finish(encoder);
 512
 513         if(0 != encoder->private_->verify.decoder)
 514                 FLAC__stream_decoder_delete(encoder->private_->verify.decoder);
 515
 516         for(i = 0; i < FLAC__MAX_CHANNELS; i++) {
 517                 FLAC__format_entropy_coding_method_partitioned_rice_contents_clear(&encoder->private_->partitioned_rice_contents_workspace[i][0]);
 518                 FLAC__format_entropy_coding_method_partitioned_rice_contents_clear(&encoder->private_->partitioned_rice_contents_workspace[i][1]);
 519         }
 520         for(i = 0; i < 2; i++) {
 521                 FLAC__format_entropy_coding_method_partitioned_rice_contents_clear(&encoder->private_->partitioned_rice_contents_workspace_mid_side[i][0]);
 522                 FLAC__format_entropy_coding_method_partitioned_rice_contents_clear(&encoder->private_->partitioned_rice_contents_workspace_mid_side[i][1]);
 523         }
 524         for(i = 0; i < 2; i++)
 525                 FLAC__format_entropy_coding_method_partitioned_rice_contents_clear(&encoder->private_->partitioned_rice_contents_extra[i]);
 526
 527         FLAC__bitbuffer_delete(encoder->private_->frame);
 528         free(encoder->private_);
 529         free(encoder->protected_);
 530         free(encoder);
 531 }
 532
 533 /***********************************************************************
 534  *
 535  * Public class methods
 536  *
 537  ***********************************************************************/
 538
 539 FLAC_API FLAC__StreamEncoderState FLAC__stream_encoder_init(FLAC__StreamEncoder *encoder)
 540 {
 541         unsigned i;
 542         FLAC__bool metadata_has_seektable, metadata_has_vorbis_comment;
 543
 544         FLAC__ASSERT(0 != encoder);
 545
 546         if(encoder->protected_->state != FLAC__STREAM_ENCODER_UNINITIALIZED)
 547                 return encoder->protected_->state = FLAC__STREAM_ENCODER_ALREADY_INITIALIZED;
 548
 549         encoder->protected_->state = FLAC__STREAM_ENCODER_OK;
 550
 551         if(0 == encoder->private_->write_callback || 0 == encoder->private_->metadata_callback)
 552                 return encoder->protected_->state = FLAC__STREAM_ENCODER_INVALID_CALLBACK;
 553
 554         if(encoder->protected_->channels == 0 || encoder->protected_->channels > FLAC__MAX_CHANNELS)
 555                 return encoder->protected_->state = FLAC__STREAM_ENCODER_INVALID_NUMBER_OF_CHANNELS;
 556
 557         if(encoder->protected_->do_mid_side_stereo && encoder->protected_->channels != 2)
 558                 return encoder->protected_->state = FLAC__STREAM_ENCODER_MID_SIDE_CHANNELS_MISMATCH;
 559
 560         if(encoder->protected_->loose_mid_side_stereo && !encoder->protected_->do_mid_side_stereo)
 561                 return encoder->protected_->state = FLAC__STREAM_ENCODER_ILLEGAL_MID_SIDE_FORCE;
 562
 563         if(encoder->protected_->bits_per_sample >= 32)
 564                 encoder->protected_->do_mid_side_stereo = false; /* since we do 32-bit math, the side channel would have 33 bps and overflow */
 565
 566         if(encoder->protected_->bits_per_sample < FLAC__MIN_BITS_PER_SAMPLE || encoder->protected_->bits_per_sample > FLAC__REFERENCE_CODEC_MAX_BITS_PER_SAMPLE)
 567                 return encoder->protected_->state = FLAC__STREAM_ENCODER_INVALID_BITS_PER_SAMPLE;
 568
 569         if(!FLAC__format_sample_rate_is_valid(encoder->protected_->sample_rate))
 570                 return encoder->protected_->state = FLAC__STREAM_ENCODER_INVALID_SAMPLE_RATE;
 571
 572         if(encoder->protected_->blocksize < FLAC__MIN_BLOCK_SIZE || encoder->protected_->blocksize > FLAC__MAX_BLOCK_SIZE)
 573                 return encoder->protected_->state = FLAC__STREAM_ENCODER_INVALID_BLOCK_SIZE;
 574
 575         if(encoder->protected_->max_lpc_order > FLAC__MAX_LPC_ORDER)
 576                 return encoder->protected_->state = FLAC__STREAM_ENCODER_INVALID_MAX_LPC_ORDER;
 577
 578         if(encoder->protected_->blocksize < encoder->protected_->max_lpc_order)
 579                 return encoder->protected_->state = FLAC__STREAM_ENCODER_BLOCK_SIZE_TOO_SMALL_FOR_LPC_ORDER;
 580
 581         if(encoder->protected_->qlp_coeff_precision == 0) {
 582                 if(encoder->protected_->bits_per_sample < 16) {
 583                         /* @@@ need some data about how to set this here w.r.t. blocksize and sample rate */
 584                         /* @@@ until then we'll make a guess */
 585                         encoder->protected_->qlp_coeff_precision = max(FLAC__MIN_QLP_COEFF_PRECISION, 2 + encoder->protected_->bits_per_sample / 2);
 586                 }
 587                 else if(encoder->protected_->bits_per_sample == 16) {
 588                         if(encoder->protected_->blocksize <= 192)
 589                                 encoder->protected_->qlp_coeff_precision = 7;
 590                         else if(encoder->protected_->blocksize <= 384)
 591                                 encoder->protected_->qlp_coeff_precision = 8;
 592                         else if(encoder->protected_->blocksize <= 576)
 593                                 encoder->protected_->qlp_coeff_precision = 9;
 594                         else if(encoder->protected_->blocksize <= 1152)
 595                                 encoder->protected_->qlp_coeff_precision = 10;
 596                         else if(encoder->protected_->blocksize <= 2304)
 597                                 encoder->protected_->qlp_coeff_precision = 11;
 598                         else if(encoder->protected_->blocksize <= 4608)
 599                                 encoder->protected_->qlp_coeff_precision = 12;
 600                         else
 601                                 encoder->protected_->qlp_coeff_precision = 13;
 602                 }
 603                 else {
 604                         if(encoder->protected_->blocksize <= 384)
 605                                 encoder->protected_->qlp_coeff_precision = FLAC__MAX_QLP_COEFF_PRECISION-2;
 606                         else if(encoder->protected_->blocksize <= 1152)
 607                                 encoder->protected_->qlp_coeff_precision = FLAC__MAX_QLP_COEFF_PRECISION-1;
 608                         else
 609                                 encoder->protected_->qlp_coeff_precision = FLAC__MAX_QLP_COEFF_PRECISION;
 610                 }
 611                 FLAC__ASSERT(encoder->protected_->qlp_coeff_precision <= FLAC__MAX_QLP_COEFF_PRECISION);
 612         }
 613         else if(encoder->protected_->qlp_coeff_precision < FLAC__MIN_QLP_COEFF_PRECISION || encoder->protected_->qlp_coeff_precision > FLAC__MAX_QLP_COEFF_PRECISION)
 614                 return encoder->protected_->state = FLAC__STREAM_ENCODER_INVALID_QLP_COEFF_PRECISION;
 615
 616         if(encoder->protected_->streamable_subset) {
 617                 if(
 618                         encoder->protected_->blocksize != 192 &&
 619                         encoder->protected_->blocksize != 576 &&
 620                         encoder->protected_->blocksize != 1152 &&
 621                         encoder->protected_->blocksize != 2304 &&
 622                         encoder->protected_->blocksize != 4608 &&
 623                         encoder->protected_->blocksize != 256 &&
 624                         encoder->protected_->blocksize != 512 &&
 625                         encoder->protected_->blocksize != 1024 &&
 626                         encoder->protected_->blocksize != 2048 &&
 627                         encoder->protected_->blocksize != 4096 &&
 628                         encoder->protected_->blocksize != 8192 &&
 629                         encoder->protected_->blocksize != 16384
 630                 )
 631                         return encoder->protected_->state = FLAC__STREAM_ENCODER_NOT_STREAMABLE;
 632                 if(
 633                         encoder->protected_->sample_rate != 8000 &&
 634                         encoder->protected_->sample_rate != 16000 &&
 635                         encoder->protected_->sample_rate != 22050 &&
 636                         encoder->protected_->sample_rate != 24000 &&
 637                         encoder->protected_->sample_rate != 32000 &&
 638                         encoder->protected_->sample_rate != 44100 &&
 639                         encoder->protected_->sample_rate != 48000 &&
 640                         encoder->protected_->sample_rate != 96000
 641                 )
 642                         return encoder->protected_->state = FLAC__STREAM_ENCODER_NOT_STREAMABLE;
 643                 if(
 644                         encoder->protected_->bits_per_sample != 8 &&
 645                         encoder->protected_->bits_per_sample != 12 &&
 646                         encoder->protected_->bits_per_sample != 16 &&
 647                         encoder->protected_->bits_per_sample != 20 &&
 648                         encoder->protected_->bits_per_sample != 24
 649                 )
 650                         return encoder->protected_->state = FLAC__STREAM_ENCODER_NOT_STREAMABLE;
 651                 if(encoder->protected_->max_residual_partition_order > FLAC__SUBSET_MAX_RICE_PARTITION_ORDER)
 652                         return encoder->protected_->state = FLAC__STREAM_ENCODER_NOT_STREAMABLE;
 653         }
 654
 655         if(encoder->protected_->max_residual_partition_order >= (1u << FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE_ORDER_LEN))
 656                 encoder->protected_->max_residual_partition_order = (1u << FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE_ORDER_LEN) - 1;
 657         if(encoder->protected_->min_residual_partition_order >= encoder->protected_->max_residual_partition_order)
 658                 encoder->protected_->min_residual_partition_order = encoder->protected_->max_residual_partition_order;
 659
 660         /* validate metadata */
 661         if(0 == encoder->protected_->metadata && encoder->protected_->num_metadata_blocks > 0)
 662                 return encoder->protected_->state = FLAC__STREAM_ENCODER_INVALID_METADATA;
 663         metadata_has_seektable = false;
 664         metadata_has_vorbis_comment = false;
 665         for(i = 0; i < encoder->protected_->num_metadata_blocks; i++) {
 666                 if(encoder->protected_->metadata[i]->type >= FLAC__METADATA_TYPE_UNDEFINED)
 667                         return encoder->protected_->state = FLAC__STREAM_ENCODER_INVALID_METADATA;
 668                 else if(encoder->protected_->metadata[i]->type == FLAC__METADATA_TYPE_STREAMINFO)
 669                         return encoder->protected_->state = FLAC__STREAM_ENCODER_INVALID_METADATA;
 670                 else if(encoder->protected_->metadata[i]->type == FLAC__METADATA_TYPE_SEEKTABLE) {
 671                         if(metadata_has_seektable) /* only one is allowed */
 672                                 return encoder->protected_->state = FLAC__STREAM_ENCODER_INVALID_METADATA;
 673                         metadata_has_seektable = true;
 674                         if(!FLAC__format_seektable_is_legal(&encoder->protected_->metadata[i]->data.seek_table))
 675                                 return encoder->protected_->state = FLAC__STREAM_ENCODER_INVALID_METADATA;
 676                 }
 677                 else if(encoder->protected_->metadata[i]->type == FLAC__METADATA_TYPE_VORBIS_COMMENT) {
 678                         if(metadata_has_vorbis_comment) /* only one is allowed */
 679                                 return encoder->protected_->state = FLAC__STREAM_ENCODER_INVALID_METADATA;
 680                         metadata_has_vorbis_comment = true;
 681                 }
 682                 else if(encoder->protected_->metadata[i]->type == FLAC__METADATA_TYPE_CUESHEET) {
 683                         if(!FLAC__format_cuesheet_is_legal(&encoder->protected_->metadata[i]->data.cue_sheet, /*check_cd_da_subset=*/false, /*violation=*/0))
 684                                 return encoder->protected_->state = FLAC__STREAM_ENCODER_INVALID_METADATA;
 685                 }
 686         }
 687
 688         encoder->private_->input_capacity = 0;
 689         for(i = 0; i < encoder->protected_->channels; i++) {
 690                 encoder->private_->integer_signal_unaligned[i] = encoder->private_->integer_signal[i] = 0;
 691                 encoder->private_->real_signal_unaligned[i] = encoder->private_->real_signal[i] = 0;
 692         }
 693         for(i = 0; i < 2; i++) {
 694                 encoder->private_->integer_signal_mid_side_unaligned[i] = encoder->private_->integer_signal_mid_side[i] = 0;
 695                 encoder->private_->real_signal_mid_side_unaligned[i] = encoder->private_->real_signal_mid_side[i] = 0;
 696         }
 697         for(i = 0; i < encoder->protected_->channels; i++) {
 698                 encoder->private_->residual_workspace_unaligned[i][0] = encoder->private_->residual_workspace[i][0] = 0;
 699                 encoder->private_->residual_workspace_unaligned[i][1] = encoder->private_->residual_workspace[i][1] = 0;
 700                 encoder->private_->best_subframe[i] = 0;
 701         }
 702         for(i = 0; i < 2; i++) {
 703                 encoder->private_->residual_workspace_mid_side_unaligned[i][0] = encoder->private_->residual_workspace_mid_side[i][0] = 0;
 704                 encoder->private_->residual_workspace_mid_side_unaligned[i][1] = encoder->private_->residual_workspace_mid_side[i][1] = 0;
 705                 encoder->private_->best_subframe_mid_side[i] = 0;
 706         }
 707         encoder->private_->abs_residual_unaligned = encoder->private_->abs_residual = 0;
 708         encoder->private_->abs_residual_partition_sums_unaligned = encoder->private_->abs_residual_partition_sums = 0;
 709         encoder->private_->raw_bits_per_partition_unaligned = encoder->private_->raw_bits_per_partition = 0;
 710         encoder->private_->loose_mid_side_stereo_frames_exact = (double)encoder->protected_->sample_rate * 0.4 / (double)encoder->protected_->blocksize;
 711         encoder->private_->loose_mid_side_stereo_frames = (unsigned)(encoder->private_->loose_mid_side_stereo_frames_exact + 0.5);
 712         if(encoder->private_->loose_mid_side_stereo_frames == 0)
 713                 encoder->private_->loose_mid_side_stereo_frames = 1;
 714         encoder->private_->loose_mid_side_stereo_frame_count = 0;
 715         encoder->private_->current_sample_number = 0;
 716         encoder->private_->current_frame_number = 0;
 717
 718         encoder->private_->use_wide_by_block = (encoder->protected_->bits_per_sample + FLAC__bitmath_ilog2(encoder->protected_->blocksize)+1 > 30);
 719         encoder->private_->use_wide_by_order = (encoder->protected_->bits_per_sample + FLAC__bitmath_ilog2(max(encoder->protected_->max_lpc_order, FLAC__MAX_FIXED_ORDER))+1 > 30); /*@@@ need to use this? */
 720         encoder->private_->use_wide_by_partition = (false); /*@@@ need to set this */
 721
 722         /*
 723          * get the CPU info and set the function pointers
 724          */
 725         FLAC__cpu_info(&encoder->private_->cpuinfo);
 726         /* first default to the non-asm routines */
 727         encoder->private_->local_lpc_compute_autocorrelation = FLAC__lpc_compute_autocorrelation;
 728         encoder->private_->local_fixed_compute_best_predictor = FLAC__fixed_compute_best_predictor;
 729         encoder->private_->local_lpc_compute_residual_from_qlp_coefficients = FLAC__lpc_compute_residual_from_qlp_coefficients;
 730         encoder->private_->local_lpc_compute_residual_from_qlp_coefficients_64bit = FLAC__lpc_compute_residual_from_qlp_coefficients_wide;
 731         encoder->private_->local_lpc_compute_residual_from_qlp_coefficients_16bit = FLAC__lpc_compute_residual_from_qlp_coefficients;
 732         /* now override with asm where appropriate */
 733 #ifndef FLAC__NO_ASM
 734         if(encoder->private_->cpuinfo.use_asm) {
 735 #ifdef FLAC__CPU_IA32
 736                 FLAC__ASSERT(encoder->private_->cpuinfo.type == FLAC__CPUINFO_TYPE_IA32);
 737 #ifdef FLAC__HAS_NASM
 738                 if(0 && encoder->private_->cpuinfo.data.ia32.sse) {
 739                         if(encoder->protected_->max_lpc_order < 4)
 740                                 encoder->private_->local_lpc_compute_autocorrelation = FLAC__lpc_compute_autocorrelation_asm_ia32_sse_lag_4;
 741                         else if(encoder->protected_->max_lpc_order < 8)
 742                                 encoder->private_->local_lpc_compute_autocorrelation = FLAC__lpc_compute_autocorrelation_asm_ia32_sse_lag_8;
 743                         else if(encoder->protected_->max_lpc_order < 12)
 744                                 encoder->private_->local_lpc_compute_autocorrelation = FLAC__lpc_compute_autocorrelation_asm_ia32_sse_lag_12;
 745                         else
 746                                 encoder->private_->local_lpc_compute_autocorrelation = FLAC__lpc_compute_autocorrelation_asm_ia32;
 747                 }
 748                 else if(encoder->private_->cpuinfo.data.ia32._3dnow)
 749                         encoder->private_->local_lpc_compute_autocorrelation = FLAC__lpc_compute_autocorrelation_asm_ia32_3dnow;
 750                 else
 751                         encoder->private_->local_lpc_compute_autocorrelation = FLAC__lpc_compute_autocorrelation_asm_ia32;
 752                 if(encoder->private_->cpuinfo.data.ia32.mmx && encoder->private_->cpuinfo.data.ia32.cmov)
 753                         encoder->private_->local_fixed_compute_best_predictor = FLAC__fixed_compute_best_predictor_asm_ia32_mmx_cmov;
 754                 if(encoder->private_->cpuinfo.data.ia32.mmx) {
 755                         encoder->private_->local_lpc_compute_residual_from_qlp_coefficients = FLAC__lpc_compute_residual_from_qlp_coefficients_asm_ia32;
 756                         encoder->private_->local_lpc_compute_residual_from_qlp_coefficients_16bit = FLAC__lpc_compute_residual_from_qlp_coefficients_asm_ia32_mmx;
 757                 }
 758                 else {
 759                         encoder->private_->local_lpc_compute_residual_from_qlp_coefficients = FLAC__lpc_compute_residual_from_qlp_coefficients_asm_ia32;
 760                         encoder->private_->local_lpc_compute_residual_from_qlp_coefficients_16bit = FLAC__lpc_compute_residual_from_qlp_coefficients_asm_ia32;
 761                 }
 762 #endif
 763 #endif
 764         }
 765 #endif
 766         /* finally override based on wide-ness if necessary */
 767         if(encoder->private_->use_wide_by_block) {
 768                 encoder->private_->local_fixed_compute_best_predictor = FLAC__fixed_compute_best_predictor_wide;
 769         }
 770
 771         /* we require precompute_partition_sums if do_escape_coding because of their intertwined nature */
 772         encoder->private_->precompute_partition_sums = (encoder->protected_->max_residual_partition_order > encoder->protected_->min_residual_partition_order) || encoder->protected_->do_escape_coding;
 773
 774         if(!resize_buffers_(encoder, encoder->protected_->blocksize)) {
 775                 /* the above function sets the state for us in case of an error */
 776                 return encoder->protected_->state;
 777         }
 778
 779         if(!FLAC__bitbuffer_init(encoder->private_->frame))
 780                 return encoder->protected_->state = FLAC__STREAM_ENCODER_MEMORY_ALLOCATION_ERROR;
 781
 782         /*
 783          * Set up the verify stuff if necessary
 784          */
 785         if(encoder->protected_->verify) {
 786                 /*
 787                  * First, set up the fifo which will hold the
 788                  * original signal to compare against
 789                  */
 790                 encoder->private_->verify.input_fifo.size = encoder->protected_->blocksize;
 791                 for(i = 0; i < encoder->protected_->channels; i++) {
 792                         if(0 == (encoder->private_->verify.input_fifo.data[i] = (FLAC__int32*)malloc(sizeof(FLAC__int32) * encoder->private_->verify.input_fifo.size)))
 793                                 return encoder->protected_->state = FLAC__STREAM_ENCODER_MEMORY_ALLOCATION_ERROR;
 794                 }
 795                 encoder->private_->verify.input_fifo.tail = 0;
 796
 797                 /*
 798                  * Now set up a stream decoder for verification
 799                  */
 800                 encoder->private_->verify.decoder = FLAC__stream_decoder_new();
 801                 if(0 == encoder->private_->verify.decoder)
 802                         return encoder->protected_->state = FLAC__STREAM_ENCODER_VERIFY_DECODER_ERROR;
 803
 804                 FLAC__stream_decoder_set_read_callback(encoder->private_->verify.decoder, verify_read_callback_);
 805                 FLAC__stream_decoder_set_write_callback(encoder->private_->verify.decoder, verify_write_callback_);
 806                 FLAC__stream_decoder_set_metadata_callback(encoder->private_->verify.decoder, verify_metadata_callback_);
 807                 FLAC__stream_decoder_set_error_callback(encoder->private_->verify.decoder, verify_error_callback_);
 808                 FLAC__stream_decoder_set_client_data(encoder->private_->verify.decoder, encoder);
 809                 if(FLAC__stream_decoder_init(encoder->private_->verify.decoder) != FLAC__STREAM_DECODER_SEARCH_FOR_METADATA)
 810                         return encoder->protected_->state = FLAC__STREAM_ENCODER_VERIFY_DECODER_ERROR;
 811         }
 812         encoder->private_->verify.error_stats.absolute_sample = 0;
 813         encoder->private_->verify.error_stats.frame_number = 0;
 814         encoder->private_->verify.error_stats.channel = 0;
 815         encoder->private_->verify.error_stats.sample = 0;
 816         encoder->private_->verify.error_stats.expected = 0;
 817         encoder->private_->verify.error_stats.got = 0;
 818
 819         /*
 820          * write the stream header
 821          */
 822         if(encoder->protected_->verify)
 823                 encoder->private_->verify.state_hint = ENCODER_IN_MAGIC;
 824         if(!FLAC__bitbuffer_write_raw_uint32(encoder->private_->frame, FLAC__STREAM_SYNC, FLAC__STREAM_SYNC_LEN))
 825                 return encoder->protected_->state = FLAC__STREAM_ENCODER_FRAMING_ERROR;
 826         if(!write_bitbuffer_(encoder, 0)) {
 827                 /* the above function sets the state for us in case of an error */
 828                 return encoder->protected_->state;
 829         }
 830
 831         /*
 832          * write the STREAMINFO metadata block
 833          */
 834         if(encoder->protected_->verify)
 835                 encoder->private_->verify.state_hint = ENCODER_IN_METADATA;
 836         encoder->private_->metadata.type = FLAC__METADATA_TYPE_STREAMINFO;
 837         encoder->private_->metadata.is_last = false; /* we will have at a minimum a VORBIS_COMMENT afterwards */
 838         encoder->private_->metadata.length = FLAC__STREAM_METADATA_STREAMINFO_LENGTH;
 839         encoder->private_->metadata.data.stream_info.min_blocksize = encoder->protected_->blocksize; /* this encoder uses the same blocksize for the whole stream */
 840         encoder->private_->metadata.data.stream_info.max_blocksize = encoder->protected_->blocksize;
 841         encoder->private_->metadata.data.stream_info.min_framesize = 0; /* we don't know this yet; have to fill it in later */
 842         encoder->private_->metadata.data.stream_info.max_framesize = 0; /* we don't know this yet; have to fill it in later */
 843         encoder->private_->metadata.data.stream_info.sample_rate = encoder->protected_->sample_rate;
 844         encoder->private_->metadata.data.stream_info.channels = encoder->protected_->channels;
 845         encoder->private_->metadata.data.stream_info.bits_per_sample = encoder->protected_->bits_per_sample;
 846         encoder->private_->metadata.data.stream_info.total_samples = encoder->protected_->total_samples_estimate; /* we will replace this later with the real total */
 847         memset(encoder->private_->metadata.data.stream_info.md5sum, 0, 16); /* we don't know this yet; have to fill it in later */
 848         MD5Init(&encoder->private_->md5context);
 849         if(!FLAC__bitbuffer_clear(encoder->private_->frame))
 850                 return encoder->protected_->state = FLAC__STREAM_ENCODER_MEMORY_ALLOCATION_ERROR;
 851         if(!FLAC__add_metadata_block(&encoder->private_->metadata, encoder->private_->frame))
 852                 return encoder->protected_->state = FLAC__STREAM_ENCODER_FRAMING_ERROR;
 853         if(!write_bitbuffer_(encoder, 0)) {
 854                 /* the above function sets the state for us in case of an error */
 855                 return encoder->protected_->state;
 856         }
 857
 858         /*
 859          * Now that the STREAMINFO block is written, we can init this to an
 860          * absurdly-high value...
 861          */
 862         encoder->private_->metadata.data.stream_info.min_framesize = (1u << FLAC__STREAM_METADATA_STREAMINFO_MIN_FRAME_SIZE_LEN) - 1;
 863         /* ... and clear this to 0 */
 864         encoder->private_->metadata.data.stream_info.total_samples = 0;
 865
 866         /*
 867          * Check to see if the supplied metadata contains a VORBIS_COMMENT;
 868          * if not, we will write an empty one (FLAC__add_metadata_block()
 869          * automatically supplies the vendor string).
 870          */
 871         if(!metadata_has_vorbis_comment) {
 872                 FLAC__StreamMetadata vorbis_comment;
 873                 vorbis_comment.type = FLAC__METADATA_TYPE_VORBIS_COMMENT;
 874                 vorbis_comment.is_last = (encoder->protected_->num_metadata_blocks == 0);
 875                 vorbis_comment.length = 4 + 4; /* MAGIC NUMBER */
 876                 vorbis_comment.data.vorbis_comment.vendor_string.length = 0;
 877                 vorbis_comment.data.vorbis_comment.vendor_string.entry = 0;
 878                 vorbis_comment.data.vorbis_comment.num_comments = 0;
 879                 vorbis_comment.data.vorbis_comment.comments = 0;
 880                 if(!FLAC__bitbuffer_clear(encoder->private_->frame))
 881                         return encoder->protected_->state = FLAC__STREAM_ENCODER_MEMORY_ALLOCATION_ERROR;
 882                 if(!FLAC__add_metadata_block(&vorbis_comment, encoder->private_->frame))
 883                         return encoder->protected_->state = FLAC__STREAM_ENCODER_FRAMING_ERROR;
 884                 if(!write_bitbuffer_(encoder, 0)) {
 885                         /* the above function sets the state for us in case of an error */
 886                         return encoder->protected_->state;
 887                 }
 888         }
 889
 890         /*
 891          * write the user's metadata blocks
 892          */
 893         for(i = 0; i < encoder->protected_->num_metadata_blocks; i++) {
 894                 encoder->protected_->metadata[i]->is_last = (i == encoder->protected_->num_metadata_blocks - 1);
 895                 if(!FLAC__bitbuffer_clear(encoder->private_->frame))
 896                         return encoder->protected_->state = FLAC__STREAM_ENCODER_MEMORY_ALLOCATION_ERROR;
 897                 if(!FLAC__add_metadata_block(encoder->protected_->metadata[i], encoder->private_->frame))
 898                         return encoder->protected_->state = FLAC__STREAM_ENCODER_FRAMING_ERROR;
 899                 if(!write_bitbuffer_(encoder, 0)) {
 900                         /* the above function sets the state for us in case of an error */
 901                         return encoder->protected_->state;
 902                 }
 903         }
 904
 905         if(encoder->protected_->verify)
 906                 encoder->private_->verify.state_hint = ENCODER_IN_AUDIO;
 907
 908         return encoder->protected_->state;
 909 }
 910
 911 FLAC_API void FLAC__stream_encoder_finish(FLAC__StreamEncoder *encoder)
 912 {
 913         FLAC__ASSERT(0 != encoder);
 914
 915         if(encoder->protected_->state == FLAC__STREAM_ENCODER_UNINITIALIZED)
 916                 return;
 917
 918         if(encoder->protected_->state == FLAC__STREAM_ENCODER_OK && !encoder->private_->is_being_deleted) {
 919                 if(encoder->private_->current_sample_number != 0) {
 920                         encoder->protected_->blocksize = encoder->private_->current_sample_number;
 921                         process_frame_(encoder, true); /* true => is last frame */
 922                 }
 923         }
 924
 925         MD5Final(encoder->private_->metadata.data.stream_info.md5sum, &encoder->private_->md5context);
 926
 927         if(encoder->protected_->state == FLAC__STREAM_ENCODER_OK && !encoder->private_->is_being_deleted) {
 928                 encoder->private_->metadata_callback(encoder, &encoder->private_->metadata, encoder->private_->client_data);
 929         }
 930
 931         if(encoder->protected_->verify && 0 != encoder->private_->verify.decoder)
 932                 FLAC__stream_decoder_finish(encoder->private_->verify.decoder);
 933
 934         free_(encoder);
 935         set_defaults_(encoder);
 936
 937         encoder->protected_->state = FLAC__STREAM_ENCODER_UNINITIALIZED;
 938 }
 939
 940 FLAC_API FLAC__bool FLAC__stream_encoder_set_verify(FLAC__StreamEncoder *encoder, FLAC__bool value)
 941 {
 942         FLAC__ASSERT(0 != encoder);
 943         if(encoder->protected_->state != FLAC__STREAM_ENCODER_UNINITIALIZED)
 944                 return false;
 945         encoder->protected_->verify = value;
 946         return true;
 947 }
 948
 949 FLAC_API FLAC__bool FLAC__stream_encoder_set_streamable_subset(FLAC__StreamEncoder *encoder, FLAC__bool value)
 950 {
 951         FLAC__ASSERT(0 != encoder);
 952         if(encoder->protected_->state != FLAC__STREAM_ENCODER_UNINITIALIZED)
 953                 return false;
 954         encoder->protected_->streamable_subset = value;
 955         return true;
 956 }
 957
 958 FLAC_API FLAC__bool FLAC__stream_encoder_set_do_mid_side_stereo(FLAC__StreamEncoder *encoder, FLAC__bool value)
 959 {
 960         FLAC__ASSERT(0 != encoder);
 961         if(encoder->protected_->state != FLAC__STREAM_ENCODER_UNINITIALIZED)
 962                 return false;
 963         encoder->protected_->do_mid_side_stereo = value;
 964         return true;
 965 }
 966
 967 FLAC_API FLAC__bool FLAC__stream_encoder_set_loose_mid_side_stereo(FLAC__StreamEncoder *encoder, FLAC__bool value)
 968 {
 969         FLAC__ASSERT(0 != encoder);
 970         if(encoder->protected_->state != FLAC__STREAM_ENCODER_UNINITIALIZED)
 971                 return false;
 972         encoder->protected_->loose_mid_side_stereo = value;
 973         return true;
 974 }
 975
 976 FLAC_API FLAC__bool FLAC__stream_encoder_set_channels(FLAC__StreamEncoder *encoder, unsigned value)
 977 {
 978         FLAC__ASSERT(0 != encoder);
 979         if(encoder->protected_->state != FLAC__STREAM_ENCODER_UNINITIALIZED)
 980                 return false;
 981         encoder->protected_->channels = value;
 982         return true;
 983 }
 984
 985 FLAC_API FLAC__bool FLAC__stream_encoder_set_bits_per_sample(FLAC__StreamEncoder *encoder, unsigned value)
 986 {
 987         FLAC__ASSERT(0 != encoder);
 988         if(encoder->protected_->state != FLAC__STREAM_ENCODER_UNINITIALIZED)
 989                 return false;
 990         encoder->protected_->bits_per_sample = value;
 991         return true;
 992 }
 993
 994 FLAC_API FLAC__bool FLAC__stream_encoder_set_sample_rate(FLAC__StreamEncoder *encoder, unsigned value)
 995 {
 996         FLAC__ASSERT(0 != encoder);
 997         if(encoder->protected_->state != FLAC__STREAM_ENCODER_UNINITIALIZED)
 998                 return false;
 999         encoder->protected_->sample_rate = value;
1000         return true;
1001 }
1002
1003 FLAC_API FLAC__bool FLAC__stream_encoder_set_blocksize(FLAC__StreamEncoder *encoder, unsigned value)
1004 {
1005         FLAC__ASSERT(0 != encoder);
1006         if(encoder->protected_->state != FLAC__STREAM_ENCODER_UNINITIALIZED)
1007                 return false;
1008         encoder->protected_->blocksize = value;
1009         return true;
1010 }
1011
1012 FLAC_API FLAC__bool FLAC__stream_encoder_set_max_lpc_order(FLAC__StreamEncoder *encoder, unsigned value)
1013 {
1014         FLAC__ASSERT(0 != encoder);
1015         if(encoder->protected_->state != FLAC__STREAM_ENCODER_UNINITIALIZED)
1016                 return false;
1017         encoder->protected_->max_lpc_order = value;
1018         return true;
1019 }
1020
1021 FLAC_API FLAC__bool FLAC__stream_encoder_set_qlp_coeff_precision(FLAC__StreamEncoder *encoder, unsigned value)
1022 {
1023         FLAC__ASSERT(0 != encoder);
1024         if(encoder->protected_->state != FLAC__STREAM_ENCODER_UNINITIALIZED)
1025                 return false;
1026         encoder->protected_->qlp_coeff_precision = value;
1027         return true;
1028 }
1029
1030 FLAC_API FLAC__bool FLAC__stream_encoder_set_do_qlp_coeff_prec_search(FLAC__StreamEncoder *encoder, FLAC__bool value)
1031 {
1032         FLAC__ASSERT(0 != encoder);
1033         if(encoder->protected_->state != FLAC__STREAM_ENCODER_UNINITIALIZED)
1034                 return false;
1035         encoder->protected_->do_qlp_coeff_prec_search = value;
1036         return true;
1037 }
1038
1039 FLAC_API FLAC__bool FLAC__stream_encoder_set_do_escape_coding(FLAC__StreamEncoder *encoder, FLAC__bool value)
1040 {
1041         FLAC__ASSERT(0 != encoder);
1042         if(encoder->protected_->state != FLAC__STREAM_ENCODER_UNINITIALIZED)
1043                 return false;
1044 #if 0
1045         /*@@@ deprecated: */
1046         encoder->protected_->do_escape_coding = value;
1047 #else
1048         (void)value;
1049 #endif
1050         return true;
1051 }
1052
1053 FLAC_API FLAC__bool FLAC__stream_encoder_set_do_exhaustive_model_search(FLAC__StreamEncoder *encoder, FLAC__bool value)
1054 {
1055         FLAC__ASSERT(0 != encoder);
1056         if(encoder->protected_->state != FLAC__STREAM_ENCODER_UNINITIALIZED)
1057                 return false;
1058         encoder->protected_->do_exhaustive_model_search = value;
1059         return true;
1060 }
1061
1062 FLAC_API FLAC__bool FLAC__stream_encoder_set_min_residual_partition_order(FLAC__StreamEncoder *encoder, unsigned value)
1063 {
1064         FLAC__ASSERT(0 != encoder);
1065         if(encoder->protected_->state != FLAC__STREAM_ENCODER_UNINITIALIZED)
1066                 return false;
1067         encoder->protected_->min_residual_partition_order = value;
1068         return true;
1069 }
1070
1071 FLAC_API FLAC__bool FLAC__stream_encoder_set_max_residual_partition_order(FLAC__StreamEncoder *encoder, unsigned value)
1072 {
1073         FLAC__ASSERT(0 != encoder);
1074         if(encoder->protected_->state != FLAC__STREAM_ENCODER_UNINITIALIZED)
1075                 return false;
1076         encoder->protected_->max_residual_partition_order = value;
1077         return true;
1078 }
1079
1080 FLAC_API FLAC__bool FLAC__stream_encoder_set_rice_parameter_search_dist(FLAC__StreamEncoder *encoder, unsigned value)
1081 {
1082         FLAC__ASSERT(0 != encoder);
1083         if(encoder->protected_->state != FLAC__STREAM_ENCODER_UNINITIALIZED)
1084                 return false;
1085 #if 0
1086         /*@@@ deprecated: */
1087         encoder->protected_->rice_parameter_search_dist = value;
1088 #else
1089         (void)value;
1090 #endif
1091         return true;
1092 }
1093
1094 FLAC_API FLAC__bool FLAC__stream_encoder_set_total_samples_estimate(FLAC__StreamEncoder *encoder, FLAC__uint64 value)
1095 {
1096         FLAC__ASSERT(0 != encoder);
1097         if(encoder->protected_->state != FLAC__STREAM_ENCODER_UNINITIALIZED)
1098                 return false;
1099         encoder->protected_->total_samples_estimate = value;
1100         return true;
1101 }
1102
1103 FLAC_API FLAC__bool FLAC__stream_encoder_set_metadata(FLAC__StreamEncoder *encoder, FLAC__StreamMetadata **metadata, unsigned num_blocks)
1104 {
1105         FLAC__ASSERT(0 != encoder);
1106         if(encoder->protected_->state != FLAC__STREAM_ENCODER_UNINITIALIZED)
1107                 return false;
1108         encoder->protected_->metadata = metadata;
1109         encoder->protected_->num_metadata_blocks = num_blocks;
1110         return true;
1111 }
1112
1113 FLAC_API FLAC__bool FLAC__stream_encoder_set_write_callback(FLAC__StreamEncoder *encoder, FLAC__StreamEncoderWriteCallback value)
1114 {
1115         FLAC__ASSERT(0 != encoder);
1116         FLAC__ASSERT(0 != value);
1117         if(encoder->protected_->state != FLAC__STREAM_ENCODER_UNINITIALIZED)
1118                 return false;
1119         encoder->private_->write_callback = value;
1120         return true;
1121 }
1122
1123 FLAC_API FLAC__bool FLAC__stream_encoder_set_metadata_callback(FLAC__StreamEncoder *encoder, FLAC__StreamEncoderMetadataCallback value)
1124 {
1125         FLAC__ASSERT(0 != encoder);
1126         FLAC__ASSERT(0 != value);
1127         if(encoder->protected_->state != FLAC__STREAM_ENCODER_UNINITIALIZED)
1128                 return false;
1129         encoder->private_->metadata_callback = value;
1130         return true;
1131 }
1132
1133 FLAC_API FLAC__bool FLAC__stream_encoder_set_client_data(FLAC__StreamEncoder *encoder, void *value)
1134 {
1135         FLAC__ASSERT(0 != encoder);
1136         if(encoder->protected_->state != FLAC__STREAM_ENCODER_UNINITIALIZED)
1137                 return false;
1138         encoder->private_->client_data = value;
1139         return true;
1140 }
1141
1142 /*
1143  * These three functions are not static, but not publically exposed in
1144  * include/FLAC/ either.  They are used by the test suite.
1145  */
1146 FLAC_API FLAC__bool FLAC__stream_encoder_disable_constant_subframes(FLAC__StreamEncoder *encoder, FLAC__bool value)
1147 {
1148         FLAC__ASSERT(0 != encoder);
1149         if(encoder->protected_->state != FLAC__STREAM_ENCODER_UNINITIALIZED)
1150                 return false;
1151         encoder->private_->disable_constant_subframes = value;
1152         return true;
1153 }
1154
1155 FLAC_API FLAC__bool FLAC__stream_encoder_disable_fixed_subframes(FLAC__StreamEncoder *encoder, FLAC__bool value)
1156 {
1157         FLAC__ASSERT(0 != encoder);
1158         if(encoder->protected_->state != FLAC__STREAM_ENCODER_UNINITIALIZED)
1159                 return false;
1160         encoder->private_->disable_fixed_subframes = value;
1161         return true;
1162 }
1163
1164 FLAC_API FLAC__bool FLAC__stream_encoder_disable_verbatim_subframes(FLAC__StreamEncoder *encoder, FLAC__bool value)
1165 {
1166         FLAC__ASSERT(0 != encoder);
1167         if(encoder->protected_->state != FLAC__STREAM_ENCODER_UNINITIALIZED)
1168                 return false;
1169         encoder->private_->disable_verbatim_subframes = value;
1170         return true;
1171 }
1172
1173 FLAC_API FLAC__StreamEncoderState FLAC__stream_encoder_get_state(const FLAC__StreamEncoder *encoder)
1174 {
1175         FLAC__ASSERT(0 != encoder);
1176         return encoder->protected_->state;
1177 }
1178
1179 FLAC_API FLAC__StreamDecoderState FLAC__stream_encoder_get_verify_decoder_state(const FLAC__StreamEncoder *encoder)
1180 {
1181         FLAC__ASSERT(0 != encoder);
1182         if(encoder->protected_->verify)
1183                 return FLAC__stream_decoder_get_state(encoder->private_->verify.decoder);
1184         else
1185                 return FLAC__STREAM_DECODER_UNINITIALIZED;
1186 }
1187
1188 FLAC_API const char *FLAC__stream_encoder_get_resolved_state_string(const FLAC__StreamEncoder *encoder)
1189 {
1190         if(encoder->protected_->state != FLAC__STREAM_ENCODER_VERIFY_DECODER_ERROR)
1191                 return FLAC__StreamEncoderStateString[encoder->protected_->state];
1192         else
1193                 return FLAC__StreamDecoderStateString[FLAC__stream_decoder_get_state(encoder->private_->verify.decoder)];
1194 }
1195
1196 FLAC_API void FLAC__stream_encoder_get_verify_decoder_error_stats(const FLAC__StreamEncoder *encoder, FLAC__uint64 *absolute_sample, unsigned *frame_number, unsigned *channel, unsigned *sample, FLAC__int32 *expected, FLAC__int32 *got)
1197 {
1198         FLAC__ASSERT(0 != encoder);
1199         if(0 != absolute_sample)
1200                 *absolute_sample = encoder->private_->verify.error_stats.absolute_sample;
1201         if(0 != frame_number)
1202                 *frame_number = encoder->private_->verify.error_stats.frame_number;
1203         if(0 != channel)
1204                 *channel = encoder->private_->verify.error_stats.channel;
1205         if(0 != sample)
1206                 *sample = encoder->private_->verify.error_stats.sample;
1207         if(0 != expected)
1208                 *expected = encoder->private_->verify.error_stats.expected;
1209         if(0 != got)
1210                 *got = encoder->private_->verify.error_stats.got;
1211 }
1212
1213 FLAC_API FLAC__bool FLAC__stream_encoder_get_verify(const FLAC__StreamEncoder *encoder)
1214 {
1215         FLAC__ASSERT(0 != encoder);
1216         return encoder->protected_->verify;
1217 }
1218
1219 FLAC_API FLAC__bool FLAC__stream_encoder_get_streamable_subset(const FLAC__StreamEncoder *encoder)
1220 {
1221         FLAC__ASSERT(0 != encoder);
1222         return encoder->protected_->streamable_subset;
1223 }
1224
1225 FLAC_API FLAC__bool FLAC__stream_encoder_get_do_mid_side_stereo(const FLAC__StreamEncoder *encoder)
1226 {
1227         FLAC__ASSERT(0 != encoder);
1228         return encoder->protected_->do_mid_side_stereo;
1229 }
1230
1231 FLAC_API FLAC__bool FLAC__stream_encoder_get_loose_mid_side_stereo(const FLAC__StreamEncoder *encoder)
1232 {
1233         FLAC__ASSERT(0 != encoder);
1234         return encoder->protected_->loose_mid_side_stereo;
1235 }
1236
1237 FLAC_API unsigned FLAC__stream_encoder_get_channels(const FLAC__StreamEncoder *encoder)
1238 {
1239         FLAC__ASSERT(0 != encoder);
1240         return encoder->protected_->channels;
1241 }
1242
1243 FLAC_API unsigned FLAC__stream_encoder_get_bits_per_sample(const FLAC__StreamEncoder *encoder)
1244 {
1245         FLAC__ASSERT(0 != encoder);
1246         return encoder->protected_->bits_per_sample;
1247 }
1248
1249 FLAC_API unsigned FLAC__stream_encoder_get_sample_rate(const FLAC__StreamEncoder *encoder)
1250 {
1251         FLAC__ASSERT(0 != encoder);
1252         return encoder->protected_->sample_rate;
1253 }
1254
1255 FLAC_API unsigned FLAC__stream_encoder_get_blocksize(const FLAC__StreamEncoder *encoder)
1256 {
1257         FLAC__ASSERT(0 != encoder);
1258         return encoder->protected_->blocksize;
1259 }
1260
1261 FLAC_API unsigned FLAC__stream_encoder_get_max_lpc_order(const FLAC__StreamEncoder *encoder)
1262 {
1263         FLAC__ASSERT(0 != encoder);
1264         return encoder->protected_->max_lpc_order;
1265 }
1266
1267 FLAC_API unsigned FLAC__stream_encoder_get_qlp_coeff_precision(const FLAC__StreamEncoder *encoder)
1268 {
1269         FLAC__ASSERT(0 != encoder);
1270         return encoder->protected_->qlp_coeff_precision;
1271 }
1272
1273 FLAC_API FLAC__bool FLAC__stream_encoder_get_do_qlp_coeff_prec_search(const FLAC__StreamEncoder *encoder)
1274 {
1275         FLAC__ASSERT(0 != encoder);
1276         return encoder->protected_->do_qlp_coeff_prec_search;
1277 }
1278
1279 FLAC_API FLAC__bool FLAC__stream_encoder_get_do_escape_coding(const FLAC__StreamEncoder *encoder)
1280 {
1281         FLAC__ASSERT(0 != encoder);
1282         return encoder->protected_->do_escape_coding;
1283 }
1284
1285 FLAC_API FLAC__bool FLAC__stream_encoder_get_do_exhaustive_model_search(const FLAC__StreamEncoder *encoder)
1286 {
1287         FLAC__ASSERT(0 != encoder);
1288         return encoder->protected_->do_exhaustive_model_search;
1289 }
1290
1291 FLAC_API unsigned FLAC__stream_encoder_get_min_residual_partition_order(const FLAC__StreamEncoder *encoder)
1292 {
1293         FLAC__ASSERT(0 != encoder);
1294         return encoder->protected_->min_residual_partition_order;
1295 }
1296
1297 FLAC_API unsigned FLAC__stream_encoder_get_max_residual_partition_order(const FLAC__StreamEncoder *encoder)
1298 {
1299         FLAC__ASSERT(0 != encoder);
1300         return encoder->protected_->max_residual_partition_order;
1301 }
1302
1303 FLAC_API unsigned FLAC__stream_encoder_get_rice_parameter_search_dist(const FLAC__StreamEncoder *encoder)
1304 {
1305         FLAC__ASSERT(0 != encoder);
1306         return encoder->protected_->rice_parameter_search_dist;
1307 }
1308
1309 FLAC_API FLAC__uint64 FLAC__stream_encoder_get_total_samples_estimate(const FLAC__StreamEncoder *encoder)
1310 {
1311         FLAC__ASSERT(0 != encoder);
1312         return encoder->protected_->total_samples_estimate;
1313 }
1314
1315 FLAC_API FLAC__bool FLAC__stream_encoder_process(FLAC__StreamEncoder *encoder, const FLAC__int32 * const buffer[], unsigned samples)
1316 {
1317         unsigned i, j, channel;
1318         FLAC__int32 x, mid, side;
1319         const unsigned channels = encoder->protected_->channels, blocksize = encoder->protected_->blocksize;
1320
1321         FLAC__ASSERT(0 != encoder);
1322         FLAC__ASSERT(encoder->protected_->state == FLAC__STREAM_ENCODER_OK);
1323
1324         j = 0;
1325         if(encoder->protected_->do_mid_side_stereo && channels == 2) {
1326                 do {
1327                         if(encoder->protected_->verify)
1328                                 append_to_verify_fifo_(&encoder->private_->verify.input_fifo, buffer, j, channels, min(blocksize-encoder->private_->current_sample_number, samples-j));
1329
1330                         for(i = encoder->private_->current_sample_number; i < blocksize && j < samples; i++, j++) {
1331                                 x = mid = side = buffer[0][j];
1332                                 encoder->private_->integer_signal[0][i] = x;
1333                                 encoder->private_->real_signal[0][i] = (FLAC__real)x;
1334                                 x = buffer[1][j];
1335                                 encoder->private_->integer_signal[1][i] = x;
1336                                 encoder->private_->real_signal[1][i] = (FLAC__real)x;
1337                                 mid += x;
1338                                 side -= x;
1339                                 mid >>= 1; /* NOTE: not the same as 'mid = (buffer[0][j] + buffer[1][j]) / 2' ! */
1340                                 encoder->private_->integer_signal_mid_side[1][i] = side;
1341                                 encoder->private_->integer_signal_mid_side[0][i] = mid;
1342                                 encoder->private_->real_signal_mid_side[1][i] = (FLAC__real)side;
1343                                 encoder->private_->real_signal_mid_side[0][i] = (FLAC__real)mid;
1344                                 encoder->private_->current_sample_number++;
1345                         }
1346                         if(i == blocksize) {
1347                                 if(!process_frame_(encoder, false)) /* false => not last frame */
1348                                         return false;
1349                         }
1350                 } while(j < samples);
1351         }
1352         else {
1353                 do {
1354                         if(encoder->protected_->verify)
1355                                 append_to_verify_fifo_(&encoder->private_->verify.input_fifo, buffer, j, channels, min(blocksize-encoder->private_->current_sample_number, samples-j));
1356
1357                         for(i = encoder->private_->current_sample_number; i < blocksize && j < samples; i++, j++) {
1358                                 for(channel = 0; channel < channels; channel++) {
1359                                         x = buffer[channel][j];
1360                                         encoder->private_->integer_signal[channel][i] = x;
1361                                         encoder->private_->real_signal[channel][i] = (FLAC__real)x;
1362                                 }
1363                                 encoder->private_->current_sample_number++;
1364                         }
1365                         if(i == blocksize) {
1366                                 if(!process_frame_(encoder, false)) /* false => not last frame */
1367                                         return false;
1368                         }
1369                 } while(j < samples);
1370         }
1371
1372         return true;
1373 }
1374
1375 FLAC_API FLAC__bool FLAC__stream_encoder_process_interleaved(FLAC__StreamEncoder *encoder, const FLAC__int32 buffer[], unsigned samples)
1376 {
1377         unsigned i, j, k, channel;
1378         FLAC__int32 x, mid, side;
1379         const unsigned channels = encoder->protected_->channels, blocksize = encoder->protected_->blocksize;
1380
1381         FLAC__ASSERT(0 != encoder);
1382         FLAC__ASSERT(encoder->protected_->state == FLAC__STREAM_ENCODER_OK);
1383
1384         j = k = 0;
1385         if(encoder->protected_->do_mid_side_stereo && channels == 2) {
1386                 do {
1387                         if(encoder->protected_->verify)
1388                                 append_to_verify_fifo_interleaved_(&encoder->private_->verify.input_fifo, buffer, j, channels, min(blocksize-encoder->private_->current_sample_number, samples-j));
1389
1390                         for(i = encoder->private_->current_sample_number; i < blocksize && j < samples; i++, j++) {
1391                                 x = mid = side = buffer[k++];
1392                                 encoder->private_->integer_signal[0][i] = x;
1393                                 encoder->private_->real_signal[0][i] = (FLAC__real)x;
1394                                 x = buffer[k++];
1395                                 encoder->private_->integer_signal[1][i] = x;
1396                                 encoder->private_->real_signal[1][i] = (FLAC__real)x;
1397                                 mid += x;
1398                                 side -= x;
1399                                 mid >>= 1; /* NOTE: not the same as 'mid = (left + right) / 2' ! */
1400                                 encoder->private_->integer_signal_mid_side[1][i] = side;
1401                                 encoder->private_->integer_signal_mid_side[0][i] = mid;
1402                                 encoder->private_->real_signal_mid_side[1][i] = (FLAC__real)side;
1403                                 encoder->private_->real_signal_mid_side[0][i] = (FLAC__real)mid;
1404                                 encoder->private_->current_sample_number++;
1405                         }
1406                         if(i == blocksize) {
1407                                 if(!process_frame_(encoder, false)) /* false => not last frame */
1408                                         return false;
1409                         }
1410                 } while(j < samples);
1411         }
1412         else {
1413                 do {
1414                         if(encoder->protected_->verify)
1415                                 append_to_verify_fifo_interleaved_(&encoder->private_->verify.input_fifo, buffer, j, channels, min(blocksize-encoder->private_->current_sample_number, samples-j));
1416
1417                         for(i = encoder->private_->current_sample_number; i < blocksize && j < samples; i++, j++) {
1418                                 for(channel = 0; channel < channels; channel++) {
1419                                         x = buffer[k++];
1420                                         encoder->private_->integer_signal[channel][i] = x;
1421                                         encoder->private_->real_signal[channel][i] = (FLAC__real)x;
1422                                 }
1423                                 encoder->private_->current_sample_number++;
1424                         }
1425                         if(i == blocksize) {
1426                                 if(!process_frame_(encoder, false)) /* false => not last frame */
1427                                         return false;
1428                         }
1429                 } while(j < samples);
1430         }
1431
1432         return true;
1433 }
1434
1435 /***********************************************************************
1436  *
1437  * Private class methods
1438  *
1439  ***********************************************************************/
1440
1441 void set_defaults_(FLAC__StreamEncoder *encoder)
1442 {
1443         FLAC__ASSERT(0 != encoder);
1444
1445         encoder->protected_->verify = false;
1446         encoder->protected_->streamable_subset = true;
1447         encoder->protected_->do_mid_side_stereo = false;
1448         encoder->protected_->loose_mid_side_stereo = false;
1449         encoder->protected_->channels = 2;
1450         encoder->protected_->bits_per_sample = 16;
1451         encoder->protected_->sample_rate = 44100;
1452         encoder->protected_->blocksize = 1152;
1453         encoder->protected_->max_lpc_order = 0;
1454         encoder->protected_->qlp_coeff_precision = 0;
1455         encoder->protected_->do_qlp_coeff_prec_search = false;
1456         encoder->protected_->do_exhaustive_model_search = false;
1457         encoder->protected_->do_escape_coding = false;
1458         encoder->protected_->min_residual_partition_order = 0;
1459         encoder->protected_->max_residual_partition_order = 0;
1460         encoder->protected_->rice_parameter_search_dist = 0;
1461         encoder->protected_->total_samples_estimate = 0;
1462         encoder->protected_->metadata = 0;
1463         encoder->protected_->num_metadata_blocks = 0;
1464
1465         encoder->private_->disable_constant_subframes = false;
1466         encoder->private_->disable_fixed_subframes = false;
1467         encoder->private_->disable_verbatim_subframes = false;
1468         encoder->private_->write_callback = 0;
1469         encoder->private_->metadata_callback = 0;
1470         encoder->private_->client_data = 0;
1471 }
1472
1473 void free_(FLAC__StreamEncoder *encoder)
1474 {
1475         unsigned i, channel;
1476
1477         FLAC__ASSERT(0 != encoder);
1478         for(i = 0; i < encoder->protected_->channels; i++) {
1479                 if(0 != encoder->private_->integer_signal_unaligned[i]) {
1480                         free(encoder->private_->integer_signal_unaligned[i]);
1481                         encoder->private_->integer_signal_unaligned[i] = 0;
1482                 }
1483                 if(0 != encoder->private_->real_signal_unaligned[i]) {
1484                         free(encoder->private_->real_signal_unaligned[i]);
1485                         encoder->private_->real_signal_unaligned[i] = 0;
1486                 }
1487         }
1488         for(i = 0; i < 2; i++) {
1489                 if(0 != encoder->private_->integer_signal_mid_side_unaligned[i]) {
1490                         free(encoder->private_->integer_signal_mid_side_unaligned[i]);
1491                         encoder->private_->integer_signal_mid_side_unaligned[i] = 0;
1492                 }
1493                 if(0 != encoder->private_->real_signal_mid_side_unaligned[i]) {
1494                         free(encoder->private_->real_signal_mid_side_unaligned[i]);
1495                         encoder->private_->real_signal_mid_side_unaligned[i] = 0;
1496                 }
1497         }
1498         for(channel = 0; channel < encoder->protected_->channels; channel++) {
1499                 for(i = 0; i < 2; i++) {
1500                         if(0 != encoder->private_->residual_workspace_unaligned[channel][i]) {
1501                                 free(encoder->private_->residual_workspace_unaligned[channel][i]);
1502                                 encoder->private_->residual_workspace_unaligned[channel][i] = 0;
1503                         }
1504                 }
1505         }
1506         for(channel = 0; channel < 2; channel++) {
1507                 for(i = 0; i < 2; i++) {
1508                         if(0 != encoder->private_->residual_workspace_mid_side_unaligned[channel][i]) {
1509                                 free(encoder->private_->residual_workspace_mid_side_unaligned[channel][i]);
1510                                 encoder->private_->residual_workspace_mid_side_unaligned[channel][i] = 0;
1511                         }
1512                 }
1513         }
1514         if(0 != encoder->private_->abs_residual_unaligned) {
1515                 free(encoder->private_->abs_residual_unaligned);
1516                 encoder->private_->abs_residual_unaligned = 0;
1517         }
1518         if(0 != encoder->private_->abs_residual_partition_sums_unaligned) {
1519                 free(encoder->private_->abs_residual_partition_sums_unaligned);
1520                 encoder->private_->abs_residual_partition_sums_unaligned = 0;
1521         }
1522         if(0 != encoder->private_->raw_bits_per_partition_unaligned) {
1523                 free(encoder->private_->raw_bits_per_partition_unaligned);
1524                 encoder->private_->raw_bits_per_partition_unaligned = 0;
1525         }
1526         if(encoder->protected_->verify) {
1527                 for(i = 0; i < encoder->protected_->channels; i++) {
1528                         if(0 != encoder->private_->verify.input_fifo.data[i]) {
1529                                 free(encoder->private_->verify.input_fifo.data[i]);
1530                                 encoder->private_->verify.input_fifo.data[i] = 0;
1531                         }
1532                 }
1533         }
1534         FLAC__bitbuffer_free(encoder->private_->frame);
1535 }
1536
1537 FLAC__bool resize_buffers_(FLAC__StreamEncoder *encoder, unsigned new_size)
1538 {
1539         FLAC__bool ok;
1540         unsigned i, channel;
1541
1542         FLAC__ASSERT(new_size > 0);
1543         FLAC__ASSERT(encoder->protected_->state == FLAC__STREAM_ENCODER_OK);
1544         FLAC__ASSERT(encoder->private_->current_sample_number == 0);
1545
1546         /* To avoid excessive malloc'ing, we only grow the buffer; no shrinking. */
1547         if(new_size <= encoder->private_->input_capacity)
1548                 return true;
1549
1550         ok = true;
1551
1552         /* WATCHOUT: FLAC__lpc_compute_residual_from_qlp_coefficients_asm_ia32_mmx()
1553          * requires that the input arrays (in our case the integer signals)
1554          * have a buffer of up to 3 zeroes in front (at negative indices) for
1555          * alignment purposes; we use 4 to keep the data well-aligned.
1556          */
1557
1558         for(i = 0; ok && i < encoder->protected_->channels; i++) {
1559                 ok = ok && FLAC__memory_alloc_aligned_int32_array(new_size+4, &encoder->private_->integer_signal_unaligned[i], &encoder->private_->integer_signal[i]);
1560                 ok = ok && FLAC__memory_alloc_aligned_real_array(new_size, &encoder->private_->real_signal_unaligned[i], &encoder->private_->real_signal[i]);
1561                 memset(encoder->private_->integer_signal[i], 0, sizeof(FLAC__int32)*4);
1562                 encoder->private_->integer_signal[i] += 4;
1563         }
1564         for(i = 0; ok && i < 2; i++) {
1565                 ok = ok && FLAC__memory_alloc_aligned_int32_array(new_size+4, &encoder->private_->integer_signal_mid_side_unaligned[i], &encoder->private_->integer_signal_mid_side[i]);
1566                 ok = ok && FLAC__memory_alloc_aligned_real_array(new_size, &encoder->private_->real_signal_mid_side_unaligned[i], &encoder->private_->real_signal_mid_side[i]);
1567                 memset(encoder->private_->integer_signal_mid_side[i], 0, sizeof(FLAC__int32)*4);
1568                 encoder->private_->integer_signal_mid_side[i] += 4;
1569         }
1570         for(channel = 0; ok && channel < encoder->protected_->channels; channel++) {
1571                 for(i = 0; ok && i < 2; i++) {
1572                         ok = ok && FLAC__memory_alloc_aligned_int32_array(new_size, &encoder->private_->residual_workspace_unaligned[channel][i], &encoder->private_->residual_workspace[channel][i]);
1573                 }
1574         }
1575         for(channel = 0; ok && channel < 2; channel++) {
1576                 for(i = 0; ok && i < 2; i++) {
1577                         ok = ok && FLAC__memory_alloc_aligned_int32_array(new_size, &encoder->private_->residual_workspace_mid_side_unaligned[channel][i], &encoder->private_->residual_workspace_mid_side[channel][i]);
1578                 }
1579         }
1580         ok = ok && FLAC__memory_alloc_aligned_uint32_array(new_size, &encoder->private_->abs_residual_unaligned, &encoder->private_->abs_residual);
1581         if(encoder->private_->precompute_partition_sums || encoder->protected_->do_escape_coding) /* we require precompute_partition_sums if do_escape_coding because of their intertwined nature */
1582                 ok = ok && FLAC__memory_alloc_aligned_uint64_array(new_size * 2, &encoder->private_->abs_residual_partition_sums_unaligned, &encoder->private_->abs_residual_partition_sums);
1583         if(encoder->protected_->do_escape_coding)
1584                 ok = ok && FLAC__memory_alloc_aligned_unsigned_array(new_size * 2, &encoder->private_->raw_bits_per_partition_unaligned, &encoder->private_->raw_bits_per_partition);
1585
1586         if(ok)
1587                 encoder->private_->input_capacity = new_size;
1588         else
1589                 encoder->protected_->state = FLAC__STREAM_ENCODER_MEMORY_ALLOCATION_ERROR;
1590
1591         return ok;
1592 }
1593
1594 FLAC__bool write_bitbuffer_(FLAC__StreamEncoder *encoder, unsigned samples)
1595 {
1596         const FLAC__byte *buffer;
1597         unsigned bytes;
1598
1599         FLAC__ASSERT(FLAC__bitbuffer_is_byte_aligned(encoder->private_->frame));
1600
1601         FLAC__bitbuffer_get_buffer(encoder->private_->frame, &buffer, &bytes);
1602
1603         if(encoder->protected_->verify) {
1604                 encoder->private_->verify.output.data = buffer;
1605                 encoder->private_->verify.output.bytes = bytes;
1606                 if(encoder->private_->verify.state_hint == ENCODER_IN_MAGIC) {
1607                         encoder->private_->verify.needs_magic_hack = true;
1608                 }
1609                 else {
1610                         if(!FLAC__stream_decoder_process_single(encoder->private_->verify.decoder)) {
1611                                 FLAC__bitbuffer_release_buffer(encoder->private_->frame);
1612                                 if(encoder->protected_->state != FLAC__STREAM_ENCODER_VERIFY_MISMATCH_IN_AUDIO_DATA)
1613                                         encoder->protected_->state = FLAC__STREAM_ENCODER_VERIFY_DECODER_ERROR;
1614                                 return false;
1615                         }
1616                 }
1617         }
1618
1619         if(encoder->private_->write_callback(encoder, buffer, bytes, samples, encoder->private_->current_frame_number, encoder->private_->client_data) != FLAC__STREAM_ENCODER_WRITE_STATUS_OK) {
1620                 encoder->protected_->state = FLAC__STREAM_ENCODER_FATAL_ERROR_WHILE_WRITING;
1621                 return false;
1622         }
1623
1624         FLAC__bitbuffer_release_buffer(encoder->private_->frame);
1625
1626         if(samples > 0) {
1627                 encoder->private_->metadata.data.stream_info.min_framesize = min(bytes, encoder->private_->metadata.data.stream_info.min_framesize);
1628                 encoder->private_->metadata.data.stream_info.max_framesize = max(bytes, encoder->private_->metadata.data.stream_info.max_framesize);
1629         }
1630
1631         return true;
1632 }
1633
1634 FLAC__bool process_frame_(FLAC__StreamEncoder *encoder, FLAC__bool is_last_frame)
1635 {
1636         FLAC__ASSERT(encoder->protected_->state == FLAC__STREAM_ENCODER_OK);
1637
1638         /*
1639          * Accumulate raw signal to the MD5 signature
1640          */
1641         if(!FLAC__MD5Accumulate(&encoder->private_->md5context, (const FLAC__int32 * const *)encoder->private_->integer_signal, encoder->protected_->channels, encoder->protected_->blocksize, (encoder->protected_->bits_per_sample+7) / 8)) {
1642                 encoder->protected_->state = FLAC__STREAM_ENCODER_MEMORY_ALLOCATION_ERROR;
1643                 return false;
1644         }
1645
1646         /*
1647          * Process the frame header and subframes into the frame bitbuffer
1648          */
1649         if(!process_subframes_(encoder, is_last_frame)) {
1650                 /* the above function sets the state for us in case of an error */
1651                 return false;
1652         }
1653
1654         /*
1655          * Zero-pad the frame to a byte_boundary
1656          */
1657         if(!FLAC__bitbuffer_zero_pad_to_byte_boundary(encoder->private_->frame)) {
1658                 encoder->protected_->state = FLAC__STREAM_ENCODER_MEMORY_ALLOCATION_ERROR;
1659                 return false;
1660         }
1661
1662         /*
1663          * CRC-16 the whole thing
1664          */
1665         FLAC__ASSERT(FLAC__bitbuffer_is_byte_aligned(encoder->private_->frame));
1666         FLAC__bitbuffer_write_raw_uint32(encoder->private_->frame, FLAC__bitbuffer_get_write_crc16(encoder->private_->frame), FLAC__FRAME_FOOTER_CRC_LEN);
1667
1668         /*
1669          * Write it
1670          */
1671         if(!write_bitbuffer_(encoder, encoder->protected_->blocksize)) {
1672                 /* the above function sets the state for us in case of an error */
1673                 return false;
1674         }
1675
1676         /*
1677          * Get ready for the next frame
1678          */
1679         encoder->private_->current_sample_number = 0;
1680         encoder->private_->current_frame_number++;
1681         encoder->private_->metadata.data.stream_info.total_samples += (FLAC__uint64)encoder->protected_->blocksize;
1682
1683         return true;
1684 }
1685
1686 FLAC__bool process_subframes_(FLAC__StreamEncoder *encoder, FLAC__bool is_last_frame)
1687 {
1688         FLAC__FrameHeader frame_header;
1689         unsigned channel, min_partition_order = encoder->protected_->min_residual_partition_order, max_partition_order;
1690         FLAC__bool do_independent, do_mid_side, precompute_partition_sums;
1691
1692         /*
1693          * Calculate the min,max Rice partition orders
1694          */
1695         if(is_last_frame) {
1696                 max_partition_order = 0;
1697         }
1698         else {
1699                 max_partition_order = FLAC__format_get_max_rice_partition_order_from_blocksize(encoder->protected_->blocksize);
1700                 max_partition_order = min(max_partition_order, encoder->protected_->max_residual_partition_order);
1701         }
1702         min_partition_order = min(min_partition_order, max_partition_order);
1703
1704         precompute_partition_sums = encoder->private_->precompute_partition_sums && ((max_partition_order > min_partition_order) || encoder->protected_->do_escape_coding);
1705
1706         /*
1707          * Setup the frame
1708          */
1709         if(!FLAC__bitbuffer_clear(encoder->private_->frame)) {
1710                 encoder->protected_->state = FLAC__STREAM_ENCODER_MEMORY_ALLOCATION_ERROR;
1711                 return false;
1712         }
1713         frame_header.blocksize = encoder->protected_->blocksize;
1714         frame_header.sample_rate = encoder->protected_->sample_rate;
1715         frame_header.channels = encoder->protected_->channels;
1716         frame_header.channel_assignment = FLAC__CHANNEL_ASSIGNMENT_INDEPENDENT; /* the default unless the encoder determines otherwise */
1717         frame_header.bits_per_sample = encoder->protected_->bits_per_sample;
1718         frame_header.number_type = FLAC__FRAME_NUMBER_TYPE_FRAME_NUMBER;
1719         frame_header.number.frame_number = encoder->private_->current_frame_number;
1720
1721         /*
1722          * Figure out what channel assignments to try
1723          */
1724         if(encoder->protected_->do_mid_side_stereo) {
1725                 if(encoder->protected_->loose_mid_side_stereo) {
1726                         if(encoder->private_->loose_mid_side_stereo_frame_count == 0) {
1727                                 do_independent = true;
1728                                 do_mid_side = true;
1729                         }
1730                         else {
1731                                 do_independent = (encoder->private_->last_channel_assignment == FLAC__CHANNEL_ASSIGNMENT_INDEPENDENT);
1732                                 do_mid_side = !do_independent;
1733                         }
1734                 }
1735                 else {
1736                         do_independent = true;
1737                         do_mid_side = true;
1738                 }
1739         }
1740         else {
1741                 do_independent = true;
1742                 do_mid_side = false;
1743         }
1744
1745         FLAC__ASSERT(do_independent || do_mid_side);
1746
1747         /*
1748          * Check for wasted bits; set effective bps for each subframe
1749          */
1750         if(do_independent) {
1751                 for(channel = 0; channel < encoder->protected_->channels; channel++) {
1752                         const unsigned w = get_wasted_bits_(encoder->private_->integer_signal[channel], encoder->protected_->blocksize);
1753                         encoder->private_->subframe_workspace[channel][0].wasted_bits = encoder->private_->subframe_workspace[channel][1].wasted_bits = w;
1754                         encoder->private_->subframe_bps[channel] = encoder->protected_->bits_per_sample - w;
1755                 }
1756         }
1757         if(do_mid_side) {
1758                 FLAC__ASSERT(encoder->protected_->channels == 2);
1759                 for(channel = 0; channel < 2; channel++) {
1760                         const unsigned w = get_wasted_bits_(encoder->private_->integer_signal_mid_side[channel], encoder->protected_->blocksize);
1761                         encoder->private_->subframe_workspace_mid_side[channel][0].wasted_bits = encoder->private_->subframe_workspace_mid_side[channel][1].wasted_bits = w;
1762                         encoder->private_->subframe_bps_mid_side[channel] = encoder->protected_->bits_per_sample - w + (channel==0? 0:1);
1763                 }
1764         }
1765
1766         /*
1767          * First do a normal encoding pass of each independent channel
1768          */
1769         if(do_independent) {
1770                 for(channel = 0; channel < encoder->protected_->channels; channel++) {
1771                         if(!
1772                                 process_subframe_(
1773                                         encoder,
1774                                         min_partition_order,
1775                                         max_partition_order,
1776                                         precompute_partition_sums,
1777                                         &frame_header,
1778                                         encoder->private_->subframe_bps[channel],
1779                                         encoder->private_->integer_signal[channel],
1780                                         encoder->private_->real_signal[channel],
1781                                         encoder->private_->subframe_workspace_ptr[channel],
1782                                         encoder->private_->partitioned_rice_contents_workspace_ptr[channel],
1783                                         encoder->private_->residual_workspace[channel],
1784                                         encoder->private_->best_subframe+channel,
1785                                         encoder->private_->best_subframe_bits+channel
1786                                 )
1787                         )
1788                                 return false;
1789                 }
1790         }
1791
1792         /*
1793          * Now do mid and side channels if requested
1794          */
1795         if(do_mid_side) {
1796                 FLAC__ASSERT(encoder->protected_->channels == 2);
1797
1798                 for(channel = 0; channel < 2; channel++) {
1799                         if(!
1800                                 process_subframe_(
1801                                         encoder,
1802                                         min_partition_order,
1803                                         max_partition_order,
1804                                         precompute_partition_sums,
1805                                         &frame_header,
1806                                         encoder->private_->subframe_bps_mid_side[channel],
1807                                         encoder->private_->integer_signal_mid_side[channel],
1808                                         encoder->private_->real_signal_mid_side[channel],
1809                                         encoder->private_->subframe_workspace_ptr_mid_side[channel],
1810                                         encoder->private_->partitioned_rice_contents_workspace_ptr_mid_side[channel],
1811                                         encoder->private_->residual_workspace_mid_side[channel],
1812                                         encoder->private_->best_subframe_mid_side+channel,
1813                                         encoder->private_->best_subframe_bits_mid_side+channel
1814                                 )
1815                         )
1816                                 return false;
1817                 }
1818         }
1819
1820         /*
1821          * Compose the frame bitbuffer
1822          */
1823         if(do_mid_side) {
1824                 unsigned left_bps = 0, right_bps = 0; /* initialized only to prevent superfluous compiler warning */
1825                 FLAC__Subframe *left_subframe = 0, *right_subframe = 0; /* initialized only to prevent superfluous compiler warning */
1826                 FLAC__ChannelAssignment channel_assignment;
1827
1828                 FLAC__ASSERT(encoder->protected_->channels == 2);
1829
1830                 if(encoder->protected_->loose_mid_side_stereo && encoder->private_->loose_mid_side_stereo_frame_count > 0) {
1831                         channel_assignment = (encoder->private_->last_channel_assignment == FLAC__CHANNEL_ASSIGNMENT_INDEPENDENT? FLAC__CHANNEL_ASSIGNMENT_INDEPENDENT : FLAC__CHANNEL_ASSIGNMENT_MID_SIDE);
1832                 }
1833                 else {
1834                         unsigned bits[4]; /* WATCHOUT - indexed by FLAC__ChannelAssignment */
1835                         unsigned min_bits;
1836                         FLAC__ChannelAssignment ca;
1837
1838                         FLAC__ASSERT(do_independent && do_mid_side);
1839
1840                         /* We have to figure out which channel assignent results in the smallest frame */
1841                         bits[FLAC__CHANNEL_ASSIGNMENT_INDEPENDENT] = encoder->private_->best_subframe_bits         [0] + encoder->private_->best_subframe_bits         [1];
1842                         bits[FLAC__CHANNEL_ASSIGNMENT_LEFT_SIDE  ] = encoder->private_->best_subframe_bits         [0] + encoder->private_->best_subframe_bits_mid_side[1];
1843                         bits[FLAC__CHANNEL_ASSIGNMENT_RIGHT_SIDE ] = encoder->private_->best_subframe_bits         [1] + encoder->private_->best_subframe_bits_mid_side[1];
1844                         bits[FLAC__CHANNEL_ASSIGNMENT_MID_SIDE   ] = encoder->private_->best_subframe_bits_mid_side[0] + encoder->private_->best_subframe_bits_mid_side[1];
1845
1846                         for(channel_assignment = (FLAC__ChannelAssignment)0, min_bits = bits[0], ca = (FLAC__ChannelAssignment)1; (int)ca <= 3; ca = (FLAC__ChannelAssignment)((int)ca + 1)) {
1847                                 if(bits[ca] < min_bits) {
1848                                         min_bits = bits[ca];
1849                                         channel_assignment = ca;
1850                                 }
1851                         }
1852                 }
1853
1854                 frame_header.channel_assignment = channel_assignment;
1855
1856                 if(!FLAC__frame_add_header(&frame_header, encoder->protected_->streamable_subset, is_last_frame, encoder->private_->frame)) {
1857                         encoder->protected_->state = FLAC__STREAM_ENCODER_FRAMING_ERROR;
1858                         return false;
1859                 }
1860
1861                 switch(channel_assignment) {
1862                         case FLAC__CHANNEL_ASSIGNMENT_INDEPENDENT:
1863                                 left_subframe  = &encoder->private_->subframe_workspace         [0][encoder->private_->best_subframe         [0]];
1864                                 right_subframe = &encoder->private_->subframe_workspace         [1][encoder->private_->best_subframe         [1]];
1865                                 break;
1866                         case FLAC__CHANNEL_ASSIGNMENT_LEFT_SIDE:
1867                                 left_subframe  = &encoder->private_->subframe_workspace         [0][encoder->private_->best_subframe         [0]];
1868                                 right_subframe = &encoder->private_->subframe_workspace_mid_side[1][encoder->private_->best_subframe_mid_side[1]];
1869                                 break;
1870                         case FLAC__CHANNEL_ASSIGNMENT_RIGHT_SIDE:
1871                                 left_subframe  = &encoder->private_->subframe_workspace_mid_side[1][encoder->private_->best_subframe_mid_side[1]];
1872                                 right_subframe = &encoder->private_->subframe_workspace         [1][encoder->private_->best_subframe         [1]];
1873                                 break;
1874                         case FLAC__CHANNEL_ASSIGNMENT_MID_SIDE:
1875                                 left_subframe  = &encoder->private_->subframe_workspace_mid_side[0][encoder->private_->best_subframe_mid_side[0]];
1876                                 right_subframe = &encoder->private_->subframe_workspace_mid_side[1][encoder->private_->best_subframe_mid_side[1]];
1877                                 break;
1878                         default:
1879                                 FLAC__ASSERT(0);
1880                 }
1881
1882                 switch(channel_assignment) {
1883                         case FLAC__CHANNEL_ASSIGNMENT_INDEPENDENT:
1884                                 left_bps  = encoder->private_->subframe_bps         [0];
1885                                 right_bps = encoder->private_->subframe_bps         [1];
1886                                 break;
1887                         case FLAC__CHANNEL_ASSIGNMENT_LEFT_SIDE:
1888                                 left_bps  = encoder->private_->subframe_bps         [0];
1889                                 right_bps = encoder->private_->subframe_bps_mid_side[1];
1890                                 break;
1891                         case FLAC__CHANNEL_ASSIGNMENT_RIGHT_SIDE:
1892                                 left_bps  = encoder->private_->subframe_bps_mid_side[1];
1893                                 right_bps = encoder->private_->subframe_bps         [1];
1894                                 break;
1895                         case FLAC__CHANNEL_ASSIGNMENT_MID_SIDE:
1896                                 left_bps  = encoder->private_->subframe_bps_mid_side[0];
1897                                 right_bps = encoder->private_->subframe_bps_mid_side[1];
1898                                 break;
1899                         default:
1900                                 FLAC__ASSERT(0);
1901                 }
1902
1903                 /* note that encoder_add_subframe_ sets the state for us in case of an error */
1904                 if(!add_subframe_(encoder, &frame_header, left_bps , left_subframe , encoder->private_->frame))
1905                         return false;
1906                 if(!add_subframe_(encoder, &frame_header, right_bps, right_subframe, encoder->private_->frame))
1907                         return false;
1908         }
1909         else {
1910                 if(!FLAC__frame_add_header(&frame_header, encoder->protected_->streamable_subset, is_last_frame, encoder->private_->frame)) {
1911                         encoder->protected_->state = FLAC__STREAM_ENCODER_FRAMING_ERROR;
1912                         return false;
1913                 }
1914
1915                 for(channel = 0; channel < encoder->protected_->channels; channel++) {
1916                         if(!add_subframe_(encoder, &frame_header, encoder->private_->subframe_bps[channel], &encoder->private_->subframe_workspace[channel][encoder->private_->best_subframe[channel]], encoder->private_->frame)) {
1917                                 /* the above function sets the state for us in case of an error */
1918                                 return false;
1919                         }
1920                 }
1921         }
1922
1923         if(encoder->protected_->loose_mid_side_stereo) {
1924                 encoder->private_->loose_mid_side_stereo_frame_count++;
1925                 if(encoder->private_->loose_mid_side_stereo_frame_count >= encoder->private_->loose_mid_side_stereo_frames)
1926                         encoder->private_->loose_mid_side_stereo_frame_count = 0;
1927         }
1928
1929         encoder->private_->last_channel_assignment = frame_header.channel_assignment;
1930
1931         return true;
1932 }
1933
1934 FLAC__bool process_subframe_(
1935         FLAC__StreamEncoder *encoder,
1936         unsigned min_partition_order,
1937         unsigned max_partition_order,
1938         FLAC__bool precompute_partition_sums,
1939         const FLAC__FrameHeader *frame_header,
1940         unsigned subframe_bps,
1941         const FLAC__int32 integer_signal[],
1942         const FLAC__real real_signal[],
1943         FLAC__Subframe *subframe[2],
1944         FLAC__EntropyCodingMethod_PartitionedRiceContents *partitioned_rice_contents[2],
1945         FLAC__int32 *residual[2],
1946         unsigned *best_subframe,
1947         unsigned *best_bits
1948 )
1949 {
1950         FLAC__real fixed_residual_bits_per_sample[FLAC__MAX_FIXED_ORDER+1];
1951         FLAC__real lpc_residual_bits_per_sample;
1952         FLAC__real autoc[FLAC__MAX_LPC_ORDER+1]; /* WATCHOUT: the size is important even though encoder->protected_->max_lpc_order might be less; some asm routines need all the space */
1953         FLAC__real lpc_error[FLAC__MAX_LPC_ORDER];
1954         unsigned min_lpc_order, max_lpc_order, lpc_order;
1955         unsigned min_fixed_order, max_fixed_order, guess_fixed_order, fixed_order;
1956         unsigned min_qlp_coeff_precision, max_qlp_coeff_precision, qlp_coeff_precision;
1957         unsigned rice_parameter;
1958         unsigned _candidate_bits, _best_bits;
1959         unsigned _best_subframe;
1960
1961         /* verbatim subframe is the baseline against which we measure other compressed subframes */
1962         _best_subframe = 0;
1963         if(encoder->private_->disable_verbatim_subframes && frame_header->blocksize >= FLAC__MAX_FIXED_ORDER)
1964                 _best_bits = UINT_MAX;
1965         else
1966                 _best_bits = evaluate_verbatim_subframe_(integer_signal, frame_header->blocksize, subframe_bps, subframe[_best_subframe]);
1967
1968         if(frame_header->blocksize >= FLAC__MAX_FIXED_ORDER) {
1969                 unsigned signal_is_constant = false;
1970                 guess_fixed_order = encoder->private_->local_fixed_compute_best_predictor(integer_signal+FLAC__MAX_FIXED_ORDER, frame_header->blocksize-FLAC__MAX_FIXED_ORDER, fixed_residual_bits_per_sample);
1971                 /* check for constant subframe */
1972                 if(!encoder->private_->disable_constant_subframes && fixed_residual_bits_per_sample[1] == 0.0) {
1973                         /* the above means integer_signal+FLAC__MAX_FIXED_ORDER is constant, now we just have to check the warmup samples */
1974                         unsigned i;
1975                         signal_is_constant = true;
1976                         for(i = 1; i <= FLAC__MAX_FIXED_ORDER; i++) {
1977                                 if(integer_signal[0] != integer_signal[i]) {
1978                                         signal_is_constant = false;
1979                                         break;
1980                                 }
1981                         }
1982                 }
1983                 if(signal_is_constant) {
1984                         _candidate_bits = evaluate_constant_subframe_(integer_signal[0], subframe_bps, subframe[!_best_subframe]);
1985                         if(_candidate_bits < _best_bits) {
1986                                 _best_subframe = !_best_subframe;
1987                                 _best_bits = _candidate_bits;
1988                         }
1989                 }
1990                 else {
1991                         if(!encoder->private_->disable_fixed_subframes || (encoder->protected_->max_lpc_order == 0 && _best_bits == UINT_MAX)) {
1992                                 /* encode fixed */
1993                                 if(encoder->protected_->do_exhaustive_model_search) {
1994                                         min_fixed_order = 0;
1995                                         max_fixed_order = FLAC__MAX_FIXED_ORDER;
1996                                 }
1997                                 else {
1998                                         min_fixed_order = max_fixed_order = guess_fixed_order;
1999                                 }
2000                                 for(fixed_order = min_fixed_order; fixed_order <= max_fixed_order; fixed_order++) {
2001                                         if(fixed_residual_bits_per_sample[fixed_order] >= (FLAC__real)subframe_bps)
2002                                                 continue; /* don't even try */
2003                                         rice_parameter = (fixed_residual_bits_per_sample[fixed_order] > 0.0)? (unsigned)(fixed_residual_bits_per_sample[fixed_order]+0.5) : 0; /* 0.5 is for rounding */
2004 #ifndef FLAC__SYMMETRIC_RICE
2005                                         rice_parameter++; /* to account for the signed->unsigned conversion during rice coding */
2006 #endif
2007                                         if(rice_parameter >= FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE_ESCAPE_PARAMETER) {
2008 #ifdef DEBUG_VERBOSE
2009                                                 fprintf(stderr, "clipping rice_parameter (%u -> %u) @0\n", rice_parameter, FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE_ESCAPE_PARAMETER - 1);
2010 #endif
2011                                                 rice_parameter = FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE_ESCAPE_PARAMETER - 1;
2012                                         }
2013                                         _candidate_bits =
2014                                                 evaluate_fixed_subframe_(
2015                                                         encoder,
2016                                                         integer_signal,
2017                                                         residual[!_best_subframe],
2018                                                         encoder->private_->abs_residual,
2019                                                         encoder->private_->abs_residual_partition_sums,
2020                                                         encoder->private_->raw_bits_per_partition,
2021                                                         frame_header->blocksize,
2022                                                         subframe_bps,
2023                                                         fixed_order,
2024                                                         rice_parameter,
2025                                                         min_partition_order,
2026                                                         max_partition_order,
2027                                                         precompute_partition_sums,
2028                                                         encoder->protected_->do_escape_coding,
2029                                                         encoder->protected_->rice_parameter_search_dist,
2030                                                         subframe[!_best_subframe],
2031                                                         partitioned_rice_contents[!_best_subframe]
2032                                                 );
2033                                         if(_candidate_bits < _best_bits) {
2034                                                 _best_subframe = !_best_subframe;
2035                                                 _best_bits = _candidate_bits;
2036                                         }
2037                                 }
2038                         }
2039
2040                         /* encode lpc */
2041                         if(encoder->protected_->max_lpc_order > 0) {
2042                                 if(encoder->protected_->max_lpc_order >= frame_header->blocksize)
2043                                         max_lpc_order = frame_header->blocksize-1;
2044                                 else
2045                                         max_lpc_order = encoder->protected_->max_lpc_order;
2046                                 if(max_lpc_order > 0) {
2047                                         encoder->private_->local_lpc_compute_autocorrelation(real_signal, frame_header->blocksize, max_lpc_order+1, autoc);
2048                                         /* if autoc[0] == 0.0, the signal is constant and we usually won't get here, but it can happen */
2049                                         if(autoc[0] != 0.0) {
2050                                                 FLAC__lpc_compute_lp_coefficients(autoc, max_lpc_order, encoder->private_->lp_coeff, lpc_error);
2051                                                 if(encoder->protected_->do_exhaustive_model_search) {
2052                                                         min_lpc_order = 1;
2053                                                 }
2054                                                 else {
2055                                                         unsigned guess_lpc_order = FLAC__lpc_compute_best_order(lpc_error, max_lpc_order, frame_header->blocksize, subframe_bps);
2056                                                         min_lpc_order = max_lpc_order = guess_lpc_order;
2057                                                 }
2058                                                 for(lpc_order = min_lpc_order; lpc_order <= max_lpc_order; lpc_order++) {
2059                                                         lpc_residual_bits_per_sample = FLAC__lpc_compute_expected_bits_per_residual_sample(lpc_error[lpc_order-1], frame_header->blocksize-lpc_order);
2060                                                         if(lpc_residual_bits_per_sample >= (FLAC__real)subframe_bps)
2061                                                                 continue; /* don't even try */
2062                                                         rice_parameter = (lpc_residual_bits_per_sample > 0.0)? (unsigned)(lpc_residual_bits_per_sample+0.5) : 0; /* 0.5 is for rounding */
2063 #ifndef FLAC__SYMMETRIC_RICE
2064                                                         rice_parameter++; /* to account for the signed->unsigned conversion during rice coding */
2065 #endif
2066                                                         if(rice_parameter >= FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE_ESCAPE_PARAMETER) {
2067 #ifdef DEBUG_VERBOSE
2068                                                                 fprintf(stderr, "clipping rice_parameter (%u -> %u) @1\n", rice_parameter, FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE_ESCAPE_PARAMETER - 1);
2069 #endif
2070                                                                 rice_parameter = FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE_ESCAPE_PARAMETER - 1;
2071                                                         }
2072                                                         if(encoder->protected_->do_qlp_coeff_prec_search) {
2073                                                                 min_qlp_coeff_precision = FLAC__MIN_QLP_COEFF_PRECISION;
2074                                                                 /* ensure a 32-bit datapath throughout for 16bps or less */
2075                                                                 if(subframe_bps <= 16)
2076                                                                         max_qlp_coeff_precision = min(32 - subframe_bps - lpc_order, FLAC__MAX_QLP_COEFF_PRECISION);
2077                                                                 else
2078                                                                         max_qlp_coeff_precision = FLAC__MAX_QLP_COEFF_PRECISION;
2079                                                         }
2080                                                         else {
2081                                                                 min_qlp_coeff_precision = max_qlp_coeff_precision = encoder->protected_->qlp_coeff_precision;
2082                                                         }
2083                                                         for(qlp_coeff_precision = min_qlp_coeff_precision; qlp_coeff_precision <= max_qlp_coeff_precision; qlp_coeff_precision++) {
2084                                                                 _candidate_bits =
2085                                                                         evaluate_lpc_subframe_(
2086                                                                                 encoder,
2087                                                                                 integer_signal,
2088                                                                                 residual[!_best_subframe],
2089                                                                                 encoder->private_->abs_residual,
2090                                                                                 encoder->private_->abs_residual_partition_sums,
2091                                                                                 encoder->private_->raw_bits_per_partition,
2092                                                                                 encoder->private_->lp_coeff[lpc_order-1],
2093                                                                                 frame_header->blocksize,
2094                                                                                 subframe_bps,
2095                                                                                 lpc_order,
2096                                                                                 qlp_coeff_precision,
2097                                                                                 rice_parameter,
2098                                                                                 min_partition_order,
2099                                                                                 max_partition_order,
2100                                                                                 precompute_partition_sums,
2101                                                                                 encoder->protected_->do_escape_coding,
2102                                                                                 encoder->protected_->rice_parameter_search_dist,
2103                                                                                 subframe[!_best_subframe],
2104                                                                                 partitioned_rice_contents[!_best_subframe]
2105                                                                         );
2106                                                                 if(_candidate_bits > 0) { /* if == 0, there was a problem quantizing the lpcoeffs */
2107                                                                         if(_candidate_bits < _best_bits) {
2108                                                                                 _best_subframe = !_best_subframe;
2109                                                                                 _best_bits = _candidate_bits;
2110                                                                         }
2111                                                                 }
2112                                                         }
2113                                                 }
2114                                         }
2115                                 }
2116                         }
2117                 }
2118         }
2119
2120         /* under rare circumstances this can happen when all but lpc subframe types are disabled: */
2121         if(_best_bits == UINT_MAX) {
2122                 FLAC__ASSERT(_best_subframe == 0);
2123                 _best_bits = evaluate_verbatim_subframe_(integer_signal, frame_header->blocksize, subframe_bps, subframe[_best_subframe]);
2124         }
2125
2126         *best_subframe = _best_subframe;
2127         *best_bits = _best_bits;
2128
2129         return true;
2130 }
2131
2132 FLAC__bool add_subframe_(
2133         FLAC__StreamEncoder *encoder,
2134         const FLAC__FrameHeader *frame_header,
2135         unsigned subframe_bps,
2136         const FLAC__Subframe *subframe,
2137         FLAC__BitBuffer *frame
2138 )
2139 {
2140         switch(subframe->type) {
2141                 case FLAC__SUBFRAME_TYPE_CONSTANT:
2142                         if(!FLAC__subframe_add_constant(&(subframe->data.constant), subframe_bps, subframe->wasted_bits, frame)) {
2143                                 encoder->protected_->state = FLAC__STREAM_ENCODER_FATAL_ERROR_WHILE_ENCODING;
2144                                 return false;
2145                         }
2146                         break;
2147                 case FLAC__SUBFRAME_TYPE_FIXED:
2148                         if(!FLAC__subframe_add_fixed(&(subframe->data.fixed), frame_header->blocksize - subframe->data.fixed.order, subframe_bps, subframe->wasted_bits, frame)) {
2149                                 encoder->protected_->state = FLAC__STREAM_ENCODER_FATAL_ERROR_WHILE_ENCODING;
2150                                 return false;
2151                         }
2152                         break;
2153                 case FLAC__SUBFRAME_TYPE_LPC:
2154                         if(!FLAC__subframe_add_lpc(&(subframe->data.lpc), frame_header->blocksize - subframe->data.lpc.order, subframe_bps, subframe->wasted_bits, frame)) {
2155                                 encoder->protected_->state = FLAC__STREAM_ENCODER_FATAL_ERROR_WHILE_ENCODING;
2156                                 return false;
2157                         }
2158                         break;
2159                 case FLAC__SUBFRAME_TYPE_VERBATIM:
2160                         if(!FLAC__subframe_add_verbatim(&(subframe->data.verbatim), frame_header->blocksize, subframe_bps, subframe->wasted_bits, frame)) {
2161                                 encoder->protected_->state = FLAC__STREAM_ENCODER_FATAL_ERROR_WHILE_ENCODING;
2162                                 return false;
2163                         }
2164                         break;
2165                 default:
2166                         FLAC__ASSERT(0);
2167         }
2168
2169         return true;
2170 }
2171
2172 unsigned evaluate_constant_subframe_(
2173         const FLAC__int32 signal,
2174         unsigned subframe_bps,
2175         FLAC__Subframe *subframe
2176 )
2177 {
2178         subframe->type = FLAC__SUBFRAME_TYPE_CONSTANT;
2179         subframe->data.constant.value = signal;
2180
2181         return FLAC__SUBFRAME_ZERO_PAD_LEN + FLAC__SUBFRAME_TYPE_LEN + FLAC__SUBFRAME_WASTED_BITS_FLAG_LEN + subframe_bps;
2182 }
2183
2184 unsigned evaluate_fixed_subframe_(
2185         FLAC__StreamEncoder *encoder,
2186         const FLAC__int32 signal[],
2187         FLAC__int32 residual[],
2188         FLAC__uint32 abs_residual[],
2189         FLAC__uint64 abs_residual_partition_sums[],
2190         unsigned raw_bits_per_partition[],
2191         unsigned blocksize,
2192         unsigned subframe_bps,
2193         unsigned order,
2194         unsigned rice_parameter,
2195         unsigned min_partition_order,
2196         unsigned max_partition_order,
2197         FLAC__bool precompute_partition_sums,
2198         FLAC__bool do_escape_coding,
2199         unsigned rice_parameter_search_dist,
2200         FLAC__Subframe *subframe,
2201         FLAC__EntropyCodingMethod_PartitionedRiceContents *partitioned_rice_contents
2202 )
2203 {
2204         unsigned i, residual_bits;
2205         const unsigned residual_samples = blocksize - order;
2206
2207         FLAC__fixed_compute_residual(signal+order, residual_samples, order, residual);
2208
2209         subframe->type = FLAC__SUBFRAME_TYPE_FIXED;
2210
2211         subframe->data.fixed.entropy_coding_method.type = FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE;
2212         subframe->data.fixed.entropy_coding_method.data.partitioned_rice.contents = partitioned_rice_contents;
2213         subframe->data.fixed.residual = residual;
2214
2215         residual_bits =
2216                 find_best_partition_order_(
2217                         encoder->private_,
2218                         residual,
2219                         abs_residual,
2220                         abs_residual_partition_sums,
2221                         raw_bits_per_partition,
2222                         residual_samples,
2223                         order,
2224                         rice_parameter,
2225                         min_partition_order,
2226                         max_partition_order,
2227                         precompute_partition_sums,
2228                         do_escape_coding,
2229                         rice_parameter_search_dist,
2230                         &subframe->data.fixed.entropy_coding_method.data.partitioned_rice
2231                 );
2232
2233         subframe->data.fixed.order = order;
2234         for(i = 0; i < order; i++)
2235                 subframe->data.fixed.warmup[i] = signal[i];
2236
2237         return FLAC__SUBFRAME_ZERO_PAD_LEN + FLAC__SUBFRAME_TYPE_LEN + FLAC__SUBFRAME_WASTED_BITS_FLAG_LEN + (order * subframe_bps) + residual_bits;
2238 }
2239
2240 unsigned evaluate_lpc_subframe_(
2241         FLAC__StreamEncoder *encoder,
2242         const FLAC__int32 signal[],
2243         FLAC__int32 residual[],
2244         FLAC__uint32 abs_residual[],
2245         FLAC__uint64 abs_residual_partition_sums[],
2246         unsigned raw_bits_per_partition[],
2247         const FLAC__real lp_coeff[],
2248         unsigned blocksize,
2249         unsigned subframe_bps,
2250         unsigned order,
2251         unsigned qlp_coeff_precision,
2252         unsigned rice_parameter,
2253         unsigned min_partition_order,
2254         unsigned max_partition_order,
2255         FLAC__bool precompute_partition_sums,
2256         FLAC__bool do_escape_coding,
2257         unsigned rice_parameter_search_dist,
2258         FLAC__Subframe *subframe,
2259         FLAC__EntropyCodingMethod_PartitionedRiceContents *partitioned_rice_contents
2260 )
2261 {
2262         FLAC__int32 qlp_coeff[FLAC__MAX_LPC_ORDER];
2263         unsigned i, residual_bits;
2264         int quantization, ret;
2265         const unsigned residual_samples = blocksize - order;
2266
2267         /* try to keep qlp coeff precision such that only 32-bit math is required for decode of <=16bps streams */
2268         if(subframe_bps <= 16) {
2269                 FLAC__ASSERT(order > 0);
2270                 FLAC__ASSERT(order <= FLAC__MAX_LPC_ORDER);
2271                 qlp_coeff_precision = min(qlp_coeff_precision, 32 - subframe_bps - FLAC__bitmath_ilog2(order));
2272         }
2273
2274         ret = FLAC__lpc_quantize_coefficients(lp_coeff, order, qlp_coeff_precision, qlp_coeff, &quantization);
2275         if(ret != 0)
2276                 return 0; /* this is a hack to indicate to the caller that we can't do lp at this order on this subframe */
2277
2278         if(subframe_bps + qlp_coeff_precision + FLAC__bitmath_ilog2(order) <= 32)
2279                 if(subframe_bps <= 16 && qlp_coeff_precision <= 16)
2280                         encoder->private_->local_lpc_compute_residual_from_qlp_coefficients_16bit(signal+order, residual_samples, qlp_coeff, order, quantization, residual);
2281                 else
2282                         encoder->private_->local_lpc_compute_residual_from_qlp_coefficients(signal+order, residual_samples, qlp_coeff, order, quantization, residual);
2283         else
2284                 encoder->private_->local_lpc_compute_residual_from_qlp_coefficients_64bit(signal+order, residual_samples, qlp_coeff, order, quantization, residual);
2285
2286         subframe->type = FLAC__SUBFRAME_TYPE_LPC;
2287
2288         subframe->data.lpc.entropy_coding_method.type = FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE;
2289         subframe->data.lpc.entropy_coding_method.data.partitioned_rice.contents = partitioned_rice_contents;
2290         subframe->data.lpc.residual = residual;
2291
2292         residual_bits =
2293                 find_best_partition_order_(
2294                         encoder->private_,
2295                         residual,
2296                         abs_residual,
2297                         abs_residual_partition_sums,
2298                         raw_bits_per_partition,
2299                         residual_samples,
2300                         order,
2301                         rice_parameter,
2302                         min_partition_order,
2303                         max_partition_order,
2304                         precompute_partition_sums,
2305                         do_escape_coding,
2306                         rice_parameter_search_dist,
2307                         &subframe->data.fixed.entropy_coding_method.data.partitioned_rice
2308                 );
2309
2310         subframe->data.lpc.order = order;
2311         subframe->data.lpc.qlp_coeff_precision = qlp_coeff_precision;
2312         subframe->data.lpc.quantization_level = quantization;
2313         memcpy(subframe->data.lpc.qlp_coeff, qlp_coeff, sizeof(FLAC__int32)*FLAC__MAX_LPC_ORDER);
2314         for(i = 0; i < order; i++)
2315                 subframe->data.lpc.warmup[i] = signal[i];
2316
2317         return FLAC__SUBFRAME_ZERO_PAD_LEN + FLAC__SUBFRAME_TYPE_LEN + FLAC__SUBFRAME_WASTED_BITS_FLAG_LEN + FLAC__SUBFRAME_LPC_QLP_COEFF_PRECISION_LEN + FLAC__SUBFRAME_LPC_QLP_SHIFT_LEN + (order * (qlp_coeff_precision + subframe_bps)) + residual_bits;
2318 }
2319
2320 unsigned evaluate_verbatim_subframe_(
2321         const FLAC__int32 signal[],
2322         unsigned blocksize,
2323         unsigned subframe_bps,
2324         FLAC__Subframe *subframe
2325 )
2326 {
2327         subframe->type = FLAC__SUBFRAME_TYPE_VERBATIM;
2328
2329         subframe->data.verbatim.data = signal;
2330
2331         return FLAC__SUBFRAME_ZERO_PAD_LEN + FLAC__SUBFRAME_TYPE_LEN + FLAC__SUBFRAME_WASTED_BITS_FLAG_LEN + (blocksize * subframe_bps);
2332 }
2333
2334 unsigned find_best_partition_order_(
2335         FLAC__StreamEncoderPrivate *private_,
2336         const FLAC__int32 residual[],
2337         FLAC__uint32 abs_residual[],
2338         FLAC__uint64 abs_residual_partition_sums[],
2339         unsigned raw_bits_per_partition[],
2340         unsigned residual_samples,
2341         unsigned predictor_order,
2342         unsigned rice_parameter,
2343         unsigned min_partition_order,
2344         unsigned max_partition_order,
2345         FLAC__bool precompute_partition_sums,
2346         FLAC__bool do_escape_coding,
2347         unsigned rice_parameter_search_dist,
2348         FLAC__EntropyCodingMethod_PartitionedRice *best_partitioned_rice
2349 )
2350 {
2351         FLAC__int32 r;
2352         unsigned residual_bits, best_residual_bits = 0;
2353         unsigned residual_sample;
2354         unsigned best_parameters_index = 0;
2355         const unsigned blocksize = residual_samples + predictor_order;
2356
2357         /* compute abs(residual) for use later */
2358         for(residual_sample = 0; residual_sample < residual_samples; residual_sample++) {
2359                 r = residual[residual_sample];
2360                 abs_residual[residual_sample] = (FLAC__uint32)(r<0? -r : r);
2361         }
2362
2363         max_partition_order = FLAC__format_get_max_rice_partition_order_from_blocksize_limited_max_and_predictor_order(max_partition_order, blocksize, predictor_order);
2364         min_partition_order = min(min_partition_order, max_partition_order);
2365
2366         if(precompute_partition_sums) {
2367                 int partition_order;
2368                 unsigned sum;
2369
2370                 precompute_partition_info_sums_(abs_residual, abs_residual_partition_sums, residual_samples, predictor_order, min_partition_order, max_partition_order);
2371
2372                 if(do_escape_coding)
2373                         precompute_partition_info_escapes_(residual, raw_bits_per_partition, residual_samples, predictor_order, min_partition_order, max_partition_order);
2374
2375                 for(partition_order = (int)max_partition_order, sum = 0; partition_order >= (int)min_partition_order; partition_order--) {
2376 #ifdef DONT_ESTIMATE_RICE_BITS
2377                         if(!
2378                                 set_partitioned_rice_with_precompute_(
2379                                         residual,
2380                                         abs_residual_partition_sums+sum,
2381                                         raw_bits_per_partition+sum,
2382                                         residual_samples,
2383                                         predictor_order,
2384                                         rice_parameter,
2385                                         rice_parameter_search_dist,
2386                                         (unsigned)partition_order,
2387                                         do_escape_coding,
2388                                         &private_->partitioned_rice_contents_extra[!best_parameters_index],
2389                                         &residual_bits
2390                                 )
2391                         )
2392 #else
2393                         if(!
2394                                 set_partitioned_rice_with_precompute_(
2395                                         abs_residual,
2396                                         abs_residual_partition_sums+sum,
2397                                         raw_bits_per_partition+sum,
2398                                         residual_samples,
2399                                         predictor_order,
2400                                         rice_parameter,
2401                                         rice_parameter_search_dist,
2402                                         (unsigned)partition_order,
2403                                         do_escape_coding,
2404                                         &private_->partitioned_rice_contents_extra[!best_parameters_index],
2405                                         &residual_bits
2406                                 )
2407                         )
2408 #endif
2409                         {
2410                                 FLAC__ASSERT(best_residual_bits != 0);
2411                                 break;
2412                         }
2413                         sum += 1u << partition_order;
2414                         if(best_residual_bits == 0 || residual_bits < best_residual_bits) {
2415                                 best_residual_bits = residual_bits;
2416                                 best_parameters_index = !best_parameters_index;
2417                                 best_partitioned_rice->order = partition_order;
2418                         }
2419                 }
2420         }
2421         else {
2422                 unsigned partition_order;
2423                 for(partition_order = min_partition_order; partition_order <= max_partition_order; partition_order++) {
2424 #ifdef DONT_ESTIMATE_RICE_BITS
2425                         if(!
2426                                 set_partitioned_rice_(
2427                                         abs_residual,
2428                                         residual,
2429                                         residual_samples,
2430                                         predictor_order,
2431                                         rice_parameter,
2432                                         rice_parameter_search_dist,
2433                                         partition_order,
2434                                         &private_->partitioned_rice_contents_extra[!best_parameters_index],
2435                                         &residual_bits
2436                                 )
2437                         )
2438 #else
2439                         if(!
2440                                 set_partitioned_rice_(
2441                                         abs_residual,
2442                                         residual_samples,
2443                                         predictor_order,
2444                                         rice_parameter,
2445                                         rice_parameter_search_dist,
2446                                         partition_order,
2447                                         &private_->partitioned_rice_contents_extra[!best_parameters_index],
2448                                         &residual_bits
2449                                 )
2450                         )
2451 #endif
2452                         {
2453                                 FLAC__ASSERT(best_residual_bits != 0);
2454                                 break;
2455                         }
2456                         if(best_residual_bits == 0 || residual_bits < best_residual_bits) {
2457                                 best_residual_bits = residual_bits;
2458                                 best_parameters_index = !best_parameters_index;
2459                                 best_partitioned_rice->order = partition_order;
2460                         }
2461                 }
2462         }
2463
2464         /*
2465          * We are allowed to de-const the pointer based on our special knowledge;
2466          * it is const to the outside world.
2467          */
2468         {
2469                 FLAC__EntropyCodingMethod_PartitionedRiceContents* best_partitioned_rice_contents = (FLAC__EntropyCodingMethod_PartitionedRiceContents*)best_partitioned_rice->contents;
2470                 FLAC__format_entropy_coding_method_partitioned_rice_contents_ensure_size(best_partitioned_rice_contents, max(6, best_partitioned_rice->order));
2471                 memcpy(best_partitioned_rice_contents->parameters, private_->partitioned_rice_contents_extra[best_parameters_index].parameters, sizeof(unsigned)*(1<<(best_partitioned_rice->order)));
2472                 memcpy(best_partitioned_rice_contents->raw_bits, private_->partitioned_rice_contents_extra[best_parameters_index].raw_bits, sizeof(unsigned)*(1<<(best_partitioned_rice->order)));
2473         }
2474
2475         return best_residual_bits;
2476 }
2477
2478 void precompute_partition_info_sums_(
2479         const FLAC__uint32 abs_residual[],
2480         FLAC__uint64 abs_residual_partition_sums[],
2481         unsigned residual_samples,
2482         unsigned predictor_order,
2483         unsigned min_partition_order,
2484         unsigned max_partition_order
2485 )
2486 {
2487         int partition_order;
2488         unsigned from_partition, to_partition = 0;
2489         const unsigned blocksize = residual_samples + predictor_order;
2490
2491         /* first do max_partition_order */
2492         for(partition_order = (int)max_partition_order; partition_order >= 0; partition_order--) {
2493                 FLAC__uint64 abs_residual_partition_sum;
2494                 FLAC__uint32 abs_r;
2495                 unsigned partition, partition_sample, partition_samples, residual_sample;
2496                 const unsigned partitions = 1u << partition_order;
2497                 const unsigned default_partition_samples = blocksize >> partition_order;
2498
2499                 FLAC__ASSERT(default_partition_samples > predictor_order);
2500
2501                 for(partition = residual_sample = 0; partition < partitions; partition++) {
2502                         partition_samples = default_partition_samples;
2503                         if(partition == 0)
2504                                 partition_samples -= predictor_order;
2505                         abs_residual_partition_sum = 0;
2506                         for(partition_sample = 0; partition_sample < partition_samples; partition_sample++) {
2507                                 abs_r = abs_residual[residual_sample];
2508                                 abs_residual_partition_sum += abs_r;
2509                                 residual_sample++;
2510                         }
2511                         abs_residual_partition_sums[partition] = abs_residual_partition_sum;
2512                 }
2513                 to_partition = partitions;
2514                 break;
2515         }
2516
2517         /* now merge partitions for lower orders */
2518         for(from_partition = 0, --partition_order; partition_order >= (int)min_partition_order; partition_order--) {
2519                 FLAC__uint64 s;
2520                 unsigned i;
2521                 const unsigned partitions = 1u << partition_order;
2522                 for(i = 0; i < partitions; i++) {
2523                         s = abs_residual_partition_sums[from_partition];
2524                         from_partition++;
2525                         abs_residual_partition_sums[to_partition] = s + abs_residual_partition_sums[from_partition];
2526                         from_partition++;
2527                         to_partition++;
2528                 }
2529         }
2530 }
2531
2532 void precompute_partition_info_escapes_(
2533         const FLAC__int32 residual[],
2534         unsigned raw_bits_per_partition[],
2535         unsigned residual_samples,
2536         unsigned predictor_order,
2537         unsigned min_partition_order,
2538         unsigned max_partition_order
2539 )
2540 {
2541         int partition_order;
2542         unsigned from_partition, to_partition = 0;
2543         const unsigned blocksize = residual_samples + predictor_order;
2544
2545         /* first do max_partition_order */
2546         for(partition_order = (int)max_partition_order; partition_order >= 0; partition_order--) {
2547                 FLAC__int32 r, residual_partition_min, residual_partition_max;
2548                 unsigned silog2_min, silog2_max;
2549                 unsigned partition, partition_sample, partition_samples, residual_sample;
2550                 const unsigned partitions = 1u << partition_order;
2551                 const unsigned default_partition_samples = blocksize >> partition_order;
2552
2553                 FLAC__ASSERT(default_partition_samples > predictor_order);
2554
2555                 for(partition = residual_sample = 0; partition < partitions; partition++) {
2556                         partition_samples = default_partition_samples;
2557                         if(partition == 0)
2558                                 partition_samples -= predictor_order;
2559                         residual_partition_min = residual_partition_max = 0;
2560                         for(partition_sample = 0; partition_sample < partition_samples; partition_sample++) {
2561                                 r = residual[residual_sample];
2562                                 if(r < residual_partition_min)
2563                                         residual_partition_min = r;
2564                                 else if(r > residual_partition_max)
2565                                         residual_partition_max = r;
2566                                 residual_sample++;
2567                         }
2568                         silog2_min = FLAC__bitmath_silog2(residual_partition_min);
2569                         silog2_max = FLAC__bitmath_silog2(residual_partition_max);
2570                         raw_bits_per_partition[partition] = max(silog2_min, silog2_max);
2571                 }
2572                 to_partition = partitions;
2573                 break;
2574         }
2575
2576         /* now merge partitions for lower orders */
2577         for(from_partition = 0, --partition_order; partition_order >= (int)min_partition_order; partition_order--) {
2578                 unsigned m;
2579                 unsigned i;
2580                 const unsigned partitions = 1u << partition_order;
2581                 for(i = 0; i < partitions; i++) {
2582                         m = raw_bits_per_partition[from_partition];
2583                         from_partition++;
2584                         raw_bits_per_partition[to_partition] = max(m, raw_bits_per_partition[from_partition]);
2585                         from_partition++;
2586                         to_partition++;
2587                 }
2588         }
2589 }
2590
2591 #ifdef VARIABLE_RICE_BITS
2592 #undef VARIABLE_RICE_BITS
2593 #endif
2594 #ifndef DONT_ESTIMATE_RICE_BITS
2595 #define VARIABLE_RICE_BITS(value, parameter) ((value) >> (parameter))
2596 #endif
2597
2598 #ifdef DONT_ESTIMATE_RICE_BITS
2599 FLAC__bool set_partitioned_rice_(
2600         const FLAC__uint32 abs_residual[],
2601         const FLAC__int32 residual[],
2602         const unsigned residual_samples,
2603         const unsigned predictor_order,
2604         const unsigned suggested_rice_parameter,
2605         const unsigned rice_parameter_search_dist,
2606         const unsigned partition_order,
2607         FLAC__EntropyCodingMethod_PartitionedRiceContents *partitioned_rice_contents,
2608         unsigned *bits
2609 )
2610 #else
2611 FLAC__bool set_partitioned_rice_(
2612         const FLAC__uint32 abs_residual[],
2613         const unsigned residual_samples,
2614         const unsigned predictor_order,
2615         const unsigned suggested_rice_parameter,
2616         const unsigned rice_parameter_search_dist,
2617         const unsigned partition_order,
2618         FLAC__EntropyCodingMethod_PartitionedRiceContents *partitioned_rice_contents,
2619         unsigned *bits
2620 )
2621 #endif
2622 {
2623         unsigned rice_parameter, partition_bits;
2624 #ifndef NO_RICE_SEARCH
2625         unsigned best_partition_bits;
2626         unsigned min_rice_parameter, max_rice_parameter, best_rice_parameter = 0;
2627 #endif
2628         unsigned bits_ = FLAC__ENTROPY_CODING_METHOD_TYPE_LEN + FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE_ORDER_LEN;
2629         unsigned *parameters;
2630
2631         FLAC__ASSERT(suggested_rice_parameter < FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE_ESCAPE_PARAMETER);
2632
2633         FLAC__format_entropy_coding_method_partitioned_rice_contents_ensure_size(partitioned_rice_contents, max(6, partition_order));
2634         parameters = partitioned_rice_contents->parameters;
2635
2636         if(partition_order == 0) {
2637                 unsigned i;
2638
2639 #ifndef NO_RICE_SEARCH
2640                 if(rice_parameter_search_dist) {
2641                         if(suggested_rice_parameter < rice_parameter_search_dist)
2642                                 min_rice_parameter = 0;
2643                         else
2644                                 min_rice_parameter = suggested_rice_parameter - rice_parameter_search_dist;
2645                         max_rice_parameter = suggested_rice_parameter + rice_parameter_search_dist;
2646                         if(max_rice_parameter >= FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE_ESCAPE_PARAMETER) {
2647 #ifdef DEBUG_VERBOSE
2648                                 fprintf(stderr, "clipping rice_parameter (%u -> %u) @2\n", max_rice_parameter, FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE_ESCAPE_PARAMETER - 1);
2649 #endif
2650                                 max_rice_parameter = FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE_ESCAPE_PARAMETER - 1;
2651                         }
2652                 }
2653                 else
2654                         min_rice_parameter = max_rice_parameter = suggested_rice_parameter;
2655
2656                 best_partition_bits = 0xffffffff;
2657                 for(rice_parameter = min_rice_parameter; rice_parameter <= max_rice_parameter; rice_parameter++) {
2658 #endif
2659 #ifdef VARIABLE_RICE_BITS
2660 #ifdef FLAC__SYMMETRIC_RICE
2661                         partition_bits = (2+rice_parameter) * residual_samples;
2662 #else
2663                         const unsigned rice_parameter_estimate = rice_parameter-1;
2664                         partition_bits = (1+rice_parameter) * residual_samples;
2665 #endif
2666 #else
2667                         partition_bits = 0;
2668 #endif
2669                         partition_bits += FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE_PARAMETER_LEN;
2670                         for(i = 0; i < residual_samples; i++) {
2671 #ifdef VARIABLE_RICE_BITS
2672 #ifdef FLAC__SYMMETRIC_RICE
2673                                 partition_bits += VARIABLE_RICE_BITS(abs_residual[i], rice_parameter);
2674 #else
2675                                 partition_bits += VARIABLE_RICE_BITS(abs_residual[i], rice_parameter_estimate);
2676 #endif
2677 #else
2678                                 partition_bits += FLAC__bitbuffer_rice_bits(residual[i], rice_parameter); /* NOTE: we will need to pass in residual[] in addition to abs_residual[] */
2679 #endif
2680                         }
2681 #ifndef NO_RICE_SEARCH
2682                         if(partition_bits < best_partition_bits) {
2683                                 best_rice_parameter = rice_parameter;
2684                                 best_partition_bits = partition_bits;
2685                         }
2686                 }
2687 #endif
2688                 parameters[0] = best_rice_parameter;
2689                 bits_ += best_partition_bits;
2690         }
2691         else {
2692                 unsigned partition, residual_sample, save_residual_sample, partition_sample;
2693                 unsigned partition_samples;
2694                 FLAC__uint64 mean, k;
2695                 const unsigned partitions = 1u << partition_order;
2696                 for(partition = residual_sample = 0; partition < partitions; partition++) {
2697                         partition_samples = (residual_samples+predictor_order) >> partition_order;
2698                         if(partition == 0) {
2699                                 if(partition_samples <= predictor_order)
2700                                         return false;
2701                                 else
2702                                         partition_samples -= predictor_order;
2703                         }
2704                         mean = 0;
2705                         save_residual_sample = residual_sample;
2706                         for(partition_sample = 0; partition_sample < partition_samples; residual_sample++, partition_sample++)
2707                                 mean += abs_residual[residual_sample];
2708                         residual_sample = save_residual_sample;
2709 #ifdef FLAC__SYMMETRIC_RICE
2710                         mean += partition_samples >> 1; /* for rounding effect */
2711                         mean /= partition_samples;
2712
2713                         /* calc rice_parameter = floor(log2(mean)) */
2714                         rice_parameter = 0;
2715                         mean>>=1;
2716                         while(mean) {
2717                                 rice_parameter++;
2718                                 mean >>= 1;
2719                         }
2720 #else
2721                         /* calc rice_parameter ala LOCO-I */
2722                         for(rice_parameter = 0, k = partition_samples; k < mean; rice_parameter++, k <<= 1)
2723                                 ;
2724 #endif
2725                         if(rice_parameter >= FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE_ESCAPE_PARAMETER) {
2726 #ifdef DEBUG_VERBOSE
2727                                 fprintf(stderr, "clipping rice_parameter (%u -> %u) @3\n", rice_parameter, FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE_ESCAPE_PARAMETER - 1);
2728 #endif
2729                                 rice_parameter = FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE_ESCAPE_PARAMETER - 1;
2730                         }
2731
2732 #ifndef NO_RICE_SEARCH
2733                         if(rice_parameter_search_dist) {
2734                                 if(rice_parameter < rice_parameter_search_dist)
2735                                         min_rice_parameter = 0;
2736                                 else
2737                                         min_rice_parameter = rice_parameter - rice_parameter_search_dist;
2738                                 max_rice_parameter = rice_parameter + rice_parameter_search_dist;
2739                                 if(max_rice_parameter >= FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE_ESCAPE_PARAMETER) {
2740 #ifdef DEBUG_VERBOSE
2741                                         fprintf(stderr, "clipping rice_parameter (%u -> %u) @4\n", max_rice_parameter, FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE_ESCAPE_PARAMETER - 1);
2742 #endif
2743                                         max_rice_parameter = FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE_ESCAPE_PARAMETER - 1;
2744                                 }
2745                         }
2746                         else
2747                                 min_rice_parameter = max_rice_parameter = rice_parameter;
2748
2749                         best_partition_bits = 0xffffffff;
2750                         for(rice_parameter = min_rice_parameter; rice_parameter <= max_rice_parameter; rice_parameter++) {
2751 #endif
2752 #ifdef VARIABLE_RICE_BITS
2753 #ifdef FLAC__SYMMETRIC_RICE
2754                                 partition_bits = (2+rice_parameter) * partition_samples;
2755 #else
2756                                 const unsigned rice_parameter_estimate = rice_parameter-1;
2757                                 partition_bits = (1+rice_parameter) * partition_samples;
2758 #endif
2759 #else
2760                                 partition_bits = 0;
2761 #endif
2762                                 partition_bits += FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE_PARAMETER_LEN;
2763                                 save_residual_sample = residual_sample;
2764                                 for(partition_sample = 0; partition_sample < partition_samples; residual_sample++, partition_sample++) {
2765 #ifdef VARIABLE_RICE_BITS
2766 #ifdef FLAC__SYMMETRIC_RICE
2767                                         partition_bits += VARIABLE_RICE_BITS(abs_residual[residual_sample], rice_parameter);
2768 #else
2769                                         partition_bits += VARIABLE_RICE_BITS(abs_residual[residual_sample], rice_parameter_estimate);
2770 #endif
2771 #else
2772                                         partition_bits += FLAC__bitbuffer_rice_bits(residual[residual_sample], rice_parameter); /* NOTE: we will need to pass in residual[] in addition to abs_residual[] */
2773 #endif
2774                                 }
2775 #ifndef NO_RICE_SEARCH
2776                                 if(rice_parameter != max_rice_parameter)
2777                                         residual_sample = save_residual_sample;
2778                                 if(partition_bits < best_partition_bits) {
2779                                         best_rice_parameter = rice_parameter;
2780                                         best_partition_bits = partition_bits;
2781                                 }
2782                         }
2783 #endif
2784                         parameters[partition] = best_rice_parameter;
2785                         bits_ += best_partition_bits;
2786                 }
2787         }
2788
2789         *bits = bits_;
2790         return true;
2791 }
2792
2793 #ifdef DONT_ESTIMATE_RICE_BITS
2794 FLAC__bool set_partitioned_rice_with_precompute_(
2795         const FLAC__int32 residual[],
2796         const FLAC__uint64 abs_residual_partition_sums[],
2797         const unsigned raw_bits_per_partition[],
2798         const unsigned residual_samples,
2799         const unsigned predictor_order,
2800         const unsigned suggested_rice_parameter,
2801         const unsigned rice_parameter_search_dist,
2802         const unsigned partition_order,
2803         const FLAC__bool search_for_escapes,
2804         FLAC__EntropyCodingMethod_PartitionedRiceContents *partitioned_rice_contents,
2805         unsigned *bits
2806 )
2807 #else
2808 FLAC__bool set_partitioned_rice_with_precompute_(
2809         const FLAC__uint32 abs_residual[],
2810         const FLAC__uint64 abs_residual_partition_sums[],
2811         const unsigned raw_bits_per_partition[],
2812         const unsigned residual_samples,
2813         const unsigned predictor_order,
2814         const unsigned suggested_rice_parameter,
2815         const unsigned rice_parameter_search_dist,
2816         const unsigned partition_order,
2817         const FLAC__bool search_for_escapes,
2818         FLAC__EntropyCodingMethod_PartitionedRiceContents *partitioned_rice_contents,
2819         unsigned *bits
2820 )
2821 #endif
2822 {
2823         unsigned rice_parameter, partition_bits;
2824 #ifndef NO_RICE_SEARCH
2825         unsigned best_partition_bits;
2826         unsigned min_rice_parameter, max_rice_parameter, best_rice_parameter = 0;
2827 #endif
2828         unsigned flat_bits;
2829         unsigned bits_ = FLAC__ENTROPY_CODING_METHOD_TYPE_LEN + FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE_ORDER_LEN;
2830         unsigned *parameters, *raw_bits;
2831
2832         FLAC__ASSERT(suggested_rice_parameter < FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE_ESCAPE_PARAMETER);
2833
2834         FLAC__format_entropy_coding_method_partitioned_rice_contents_ensure_size(partitioned_rice_contents, max(6, partition_order));
2835         parameters = partitioned_rice_contents->parameters;
2836         raw_bits = partitioned_rice_contents->raw_bits;
2837
2838         if(partition_order == 0) {
2839                 unsigned i;
2840
2841 #ifndef NO_RICE_SEARCH
2842                 if(rice_parameter_search_dist) {
2843                         if(suggested_rice_parameter < rice_parameter_search_dist)
2844                                 min_rice_parameter = 0;
2845                         else
2846                                 min_rice_parameter = suggested_rice_parameter - rice_parameter_search_dist;
2847                         max_rice_parameter = suggested_rice_parameter + rice_parameter_search_dist;
2848                         if(max_rice_parameter >= FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE_ESCAPE_PARAMETER) {
2849 #ifdef DEBUG_VERBOSE
2850                                 fprintf(stderr, "clipping rice_parameter (%u -> %u) @5\n", max_rice_parameter, FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE_ESCAPE_PARAMETER - 1);
2851 #endif
2852                                 max_rice_parameter = FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE_ESCAPE_PARAMETER - 1;
2853                         }
2854                 }
2855                 else
2856                         min_rice_parameter = max_rice_parameter = suggested_rice_parameter;
2857
2858                 best_partition_bits = 0xffffffff;
2859                 for(rice_parameter = min_rice_parameter; rice_parameter <= max_rice_parameter; rice_parameter++) {
2860 #endif
2861 #ifdef VARIABLE_RICE_BITS
2862 #ifdef FLAC__SYMMETRIC_RICE
2863                         partition_bits = (2+rice_parameter) * residual_samples;
2864 #else
2865                         const unsigned rice_parameter_estimate = rice_parameter-1;
2866                         partition_bits = (1+rice_parameter) * residual_samples;
2867 #endif
2868 #else
2869                         partition_bits = 0;
2870 #endif
2871                         partition_bits += FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE_PARAMETER_LEN;
2872                         for(i = 0; i < residual_samples; i++) {
2873 #ifdef VARIABLE_RICE_BITS
2874 #ifdef FLAC__SYMMETRIC_RICE
2875                                 partition_bits += VARIABLE_RICE_BITS(abs_residual[i], rice_parameter);
2876 #else
2877                                 partition_bits += VARIABLE_RICE_BITS(abs_residual[i], rice_parameter_estimate);
2878 #endif
2879 #else
2880                                 partition_bits += FLAC__bitbuffer_rice_bits(residual[i], rice_parameter); /* NOTE: we will need to pass in residual[] instead of abs_residual[] */
2881 #endif
2882                         }
2883 #ifndef NO_RICE_SEARCH
2884                         if(partition_bits < best_partition_bits) {
2885                                 best_rice_parameter = rice_parameter;
2886                                 best_partition_bits = partition_bits;
2887                         }
2888                 }
2889 #endif
2890                 if(search_for_escapes) {
2891                         flat_bits = FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE_PARAMETER_LEN + FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE_RAW_LEN + raw_bits_per_partition[0] * residual_samples;
2892                         if(flat_bits <= best_partition_bits) {
2893                                 raw_bits[0] = raw_bits_per_partition[0];
2894                                 best_rice_parameter = FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE_ESCAPE_PARAMETER;
2895                                 best_partition_bits = flat_bits;
2896                         }
2897                 }
2898                 parameters[0] = best_rice_parameter;
2899                 bits_ += best_partition_bits;
2900         }
2901         else {
2902                 unsigned partition, residual_sample, save_residual_sample, partition_sample;
2903                 unsigned partition_samples;
2904                 FLAC__uint64 mean, k;
2905                 const unsigned partitions = 1u << partition_order;
2906                 for(partition = residual_sample = 0; partition < partitions; partition++) {
2907                         partition_samples = (residual_samples+predictor_order) >> partition_order;
2908                         if(partition == 0) {
2909                                 if(partition_samples <= predictor_order)
2910                                         return false;
2911                                 else
2912                                         partition_samples -= predictor_order;
2913                         }
2914                         mean = abs_residual_partition_sums[partition];
2915 #ifdef FLAC__SYMMETRIC_RICE
2916                         mean += partition_samples >> 1; /* for rounding effect */
2917                         mean /= partition_samples;
2918
2919                         /* calc rice_parameter = floor(log2(mean)) */
2920                         rice_parameter = 0;
2921                         mean>>=1;
2922                         while(mean) {
2923                                 rice_parameter++;
2924                                 mean >>= 1;
2925                         }
2926 #else
2927                         /* calc rice_parameter ala LOCO-I */
2928                         for(rice_parameter = 0, k = partition_samples; k < mean; rice_parameter++, k <<= 1)
2929                                 ;
2930 #endif
2931                         if(rice_parameter >= FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE_ESCAPE_PARAMETER) {
2932 #ifdef DEBUG_VERBOSE
2933                                 fprintf(stderr, "clipping rice_parameter (%u -> %u) @6\n", rice_parameter, FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE_ESCAPE_PARAMETER - 1);
2934 #endif
2935                                 rice_parameter = FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE_ESCAPE_PARAMETER - 1;
2936                         }
2937
2938 #ifndef NO_RICE_SEARCH
2939                         if(rice_parameter_search_dist) {
2940                                 if(rice_parameter < rice_parameter_search_dist)
2941                                         min_rice_parameter = 0;
2942                                 else
2943                                         min_rice_parameter = rice_parameter - rice_parameter_search_dist;
2944                                 max_rice_parameter = rice_parameter + rice_parameter_search_dist;
2945                                 if(max_rice_parameter >= FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE_ESCAPE_PARAMETER) {
2946 #ifdef DEBUG_VERBOSE
2947                                         fprintf(stderr, "clipping rice_parameter (%u -> %u) @7\n", max_rice_parameter, FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE_ESCAPE_PARAMETER - 1);
2948 #endif
2949                                         max_rice_parameter = FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE_ESCAPE_PARAMETER - 1;
2950                                 }
2951                         }
2952                         else
2953                                 min_rice_parameter = max_rice_parameter = rice_parameter;
2954
2955                         best_partition_bits = 0xffffffff;
2956                         for(rice_parameter = min_rice_parameter; rice_parameter <= max_rice_parameter; rice_parameter++) {
2957 #endif
2958 #ifdef VARIABLE_RICE_BITS
2959 #ifdef FLAC__SYMMETRIC_RICE
2960                                 partition_bits = (2+rice_parameter) * partition_samples;
2961 #else
2962                                 const unsigned rice_parameter_estimate = rice_parameter-1;
2963                                 partition_bits = (1+rice_parameter) * partition_samples;
2964 #endif
2965 #else
2966                                 partition_bits = 0;
2967 #endif
2968                                 partition_bits += FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE_PARAMETER_LEN;
2969                                 save_residual_sample = residual_sample;
2970                                 for(partition_sample = 0; partition_sample < partition_samples; residual_sample++, partition_sample++) {
2971 #ifdef VARIABLE_RICE_BITS
2972 #ifdef FLAC__SYMMETRIC_RICE
2973                                         partition_bits += VARIABLE_RICE_BITS(abs_residual[residual_sample], rice_parameter);
2974 #else
2975                                         partition_bits += VARIABLE_RICE_BITS(abs_residual[residual_sample], rice_parameter_estimate);
2976 #endif
2977 #else
2978                                         partition_bits += FLAC__bitbuffer_rice_bits(residual[residual_sample], rice_parameter); /* NOTE: we will need to pass in residual[] instead of abs_residual[] */
2979 #endif
2980                                 }
2981 #ifndef NO_RICE_SEARCH
2982                                 if(rice_parameter != max_rice_parameter)
2983                                         residual_sample = save_residual_sample;
2984                                 if(partition_bits < best_partition_bits) {
2985                                         best_rice_parameter = rice_parameter;
2986                                         best_partition_bits = partition_bits;
2987                                 }
2988                         }
2989 #endif
2990                         if(search_for_escapes) {
2991                                 flat_bits = FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE_PARAMETER_LEN + FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE_RAW_LEN + raw_bits_per_partition[partition] * partition_samples;
2992                                 if(flat_bits <= best_partition_bits) {
2993                                         raw_bits[partition] = raw_bits_per_partition[partition];
2994                                         best_rice_parameter = FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE_ESCAPE_PARAMETER;
2995                                         best_partition_bits = flat_bits;
2996                                 }
2997                         }
2998                         parameters[partition] = best_rice_parameter;
2999                         bits_ += best_partition_bits;
3000                 }
3001         }
3002
3003         *bits = bits_;
3004         return true;
3005 }
3006
3007 unsigned get_wasted_bits_(FLAC__int32 signal[], unsigned samples)
3008 {
3009         unsigned i, shift;
3010         FLAC__int32 x = 0;
3011
3012         for(i = 0; i < samples && !(x&1); i++)
3013                 x |= signal[i];
3014
3015         if(x == 0) {
3016                 shift = 0;
3017         }
3018         else {
3019                 for(shift = 0; !(x&1); shift++)
3020                         x >>= 1;
3021         }
3022
3023         if(shift > 0) {
3024                 for(i = 0; i < samples; i++)
3025                          signal[i] >>= shift;
3026         }
3027
3028         return shift;
3029 }
3030
3031 void append_to_verify_fifo_(verify_input_fifo *fifo, const FLAC__int32 * const input[], unsigned input_offset, unsigned channels, unsigned wide_samples)
3032 {
3033         unsigned channel;
3034
3035         for(channel = 0; channel < channels; channel++)
3036                 memcpy(&fifo->data[channel][fifo->tail], &input[channel][input_offset], sizeof(FLAC__int32) * wide_samples);
3037
3038         fifo->tail += wide_samples;
3039
3040         FLAC__ASSERT(fifo->tail <= fifo->size);
3041 }
3042
3043 void append_to_verify_fifo_interleaved_(verify_input_fifo *fifo, const FLAC__int32 input[], unsigned input_offset, unsigned channels, unsigned wide_samples)
3044 {
3045         unsigned channel;
3046         unsigned sample, wide_sample;
3047         unsigned tail = fifo->tail;
3048
3049         sample = input_offset * channels;
3050         for(wide_sample = 0; wide_sample < wide_samples; wide_sample++) {
3051                 for(channel = 0; channel < channels; channel++)
3052                         fifo->data[channel][tail] = input[sample++];
3053                 tail++;
3054         }
3055         fifo->tail = tail;
3056
3057         FLAC__ASSERT(fifo->tail <= fifo->size);
3058 }
3059
3060 FLAC__StreamDecoderReadStatus verify_read_callback_(const FLAC__StreamDecoder *decoder, FLAC__byte buffer[], unsigned *bytes, void *client_data)
3061 {
3062         FLAC__StreamEncoder *encoder = (FLAC__StreamEncoder*)client_data;
3063         const unsigned encoded_bytes = encoder->private_->verify.output.bytes;
3064         (void)decoder;
3065
3066         if(encoder->private_->verify.needs_magic_hack) {
3067                 FLAC__ASSERT(*bytes >= FLAC__STREAM_SYNC_LENGTH);
3068                 *bytes = FLAC__STREAM_SYNC_LENGTH;
3069                 memcpy(buffer, FLAC__STREAM_SYNC_STRING, *bytes);
3070                 encoder->private_->verify.needs_magic_hack = false;
3071         }
3072         else {
3073                 if(encoded_bytes == 0) {
3074                         /*
3075                          * If we get here, a FIFO underflow has occurred,
3076                          * which means there is a bug somewhere.
3077                          */
3078                         FLAC__ASSERT(0);
3079                         return FLAC__STREAM_DECODER_READ_STATUS_ABORT;
3080                 }
3081                 else if(encoded_bytes < *bytes)
3082                         *bytes = encoded_bytes;
3083                 memcpy(buffer, encoder->private_->verify.output.data, *bytes);
3084                 encoder->private_->verify.output.data += *bytes;
3085                 encoder->private_->verify.output.bytes -= *bytes;
3086         }
3087
3088         return FLAC__STREAM_DECODER_READ_STATUS_CONTINUE;
3089 }
3090
3091 FLAC__StreamDecoderWriteStatus verify_write_callback_(const FLAC__StreamDecoder *decoder, const FLAC__Frame *frame, const FLAC__int32 * const buffer[], void *client_data)
3092 {
3093         FLAC__StreamEncoder *encoder = (FLAC__StreamEncoder *)client_data;
3094         unsigned channel;
3095         const unsigned channels = FLAC__stream_decoder_get_channels(decoder);
3096         const unsigned blocksize = frame->header.blocksize;
3097         const unsigned bytes_per_block = sizeof(FLAC__int32) * blocksize;
3098
3099         for(channel = 0; channel < channels; channel++) {
3100                 if(0 != memcmp(buffer[channel], encoder->private_->verify.input_fifo.data[channel], bytes_per_block)) {
3101                         unsigned i, sample = 0;
3102                         FLAC__int32 expect = 0, got = 0;
3103
3104                         for(i = 0; i < blocksize; i++) {
3105                                 if(buffer[channel][i] != encoder->private_->verify.input_fifo.data[channel][i]) {
3106                                         sample = i;
3107                                         expect = (FLAC__int32)encoder->private_->verify.input_fifo.data[channel][i];
3108                                         got = (FLAC__int32)buffer[channel][i];
3109                                         break;
3110                                 }
3111                         }
3112                         FLAC__ASSERT(i < blocksize);
3113                         FLAC__ASSERT(frame->header.number_type == FLAC__FRAME_NUMBER_TYPE_SAMPLE_NUMBER);
3114                         encoder->private_->verify.error_stats.absolute_sample = frame->header.number.sample_number + sample;
3115                         encoder->private_->verify.error_stats.frame_number = (unsigned)(frame->header.number.sample_number / blocksize);
3116                         encoder->private_->verify.error_stats.channel = channel;
3117                         encoder->private_->verify.error_stats.sample = sample;
3118                         encoder->private_->verify.error_stats.expected = expect;
3119                         encoder->private_->verify.error_stats.got = got;
3120                         encoder->protected_->state = FLAC__STREAM_ENCODER_VERIFY_MISMATCH_IN_AUDIO_DATA;
3121                         return FLAC__STREAM_DECODER_WRITE_STATUS_ABORT;
3122                 }
3123         }
3124         /* dequeue the frame from the fifo */
3125         for(channel = 0; channel < channels; channel++) {
3126                 memmove(&encoder->private_->verify.input_fifo.data[channel][0], &encoder->private_->verify.input_fifo.data[channel][blocksize], encoder->private_->verify.input_fifo.tail - blocksize);
3127         }
3128         encoder->private_->verify.input_fifo.tail -= blocksize;
3129         return FLAC__STREAM_DECODER_WRITE_STATUS_CONTINUE;
3130 }
3131
3132 void verify_metadata_callback_(const FLAC__StreamDecoder *decoder, const FLAC__StreamMetadata *metadata, void *client_data)
3133 {
3134         (void)decoder, (void)metadata, (void)client_data;
3135 }
3136
3137 void verify_error_callback_(const FLAC__StreamDecoder *decoder, FLAC__StreamDecoderErrorStatus status, void *client_data)
3138 {
3139         FLAC__StreamEncoder *encoder = (FLAC__StreamEncoder*)client_data;
3140         (void)decoder, (void)status;
3141         encoder->protected_->state = FLAC__STREAM_ENCODER_VERIFY_DECODER_ERROR;
3142 }