src/libFLAC/stream_encoder.c

   1 /* libFLAC - Free Lossless Audio Codec library
   2  * Copyright (C) 2000,2001,2002,2003,2004,2005,2006  Josh Coalson
   3  *
   4  * Redistribution and use in source and binary forms, with or without
   5  * modification, are permitted provided that the following conditions
   6  * are met:
   7  *
   8  * - Redistributions of source code must retain the above copyright
   9  * notice, this list of conditions and the following disclaimer.
  10  *
  11  * - Redistributions in binary form must reproduce the above copyright
  12  * notice, this list of conditions and the following disclaimer in the
  13  * documentation and/or other materials provided with the distribution.
  14  *
  15  * - Neither the name of the Xiph.org Foundation nor the names of its
  16  * contributors may be used to endorse or promote products derived from
  17  * this software without specific prior written permission.
  18  *
  19  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
  20  * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
  21  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
  22  * A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR
  23  * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
  24  * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
  25  * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
  26  * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
  27  * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
  28  * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
  29  * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  30  */
  31
  32 #if HAVE_CONFIG_H
  33 #  include <config.h>
  34 #endif
  35
  36 #if defined _MSC_VER || defined __MINGW32__
  37 #include <io.h> /* for _setmode() */
  38 #include <fcntl.h> /* for _O_BINARY */
  39 #endif
  40 #if defined __CYGWIN__ || defined __EMX__
  41 #include <io.h> /* for setmode(), O_BINARY */
  42 #include <fcntl.h> /* for _O_BINARY */
  43 #endif
  44 #include <limits.h>
  45 #include <stdio.h>
  46 #include <stdlib.h> /* for malloc() */
  47 #include <string.h> /* for memcpy() */
  48 #include <sys/types.h> /* for off_t */
  49 #if defined _MSC_VER || defined __MINGW32__
  50 #if _MSC_VER <= 1200 /* @@@ [2G limit] */
  51 #define fseeko fseek
  52 #define ftello ftell
  53 #endif
  54 #endif
  55 #include "FLAC/assert.h"
  56 #include "FLAC/stream_decoder.h"
  57 #include "protected/stream_encoder.h"
  58 #include "private/bitbuffer.h"
  59 #include "private/bitmath.h"
  60 #include "private/crc.h"
  61 #include "private/cpu.h"
  62 #include "private/fixed.h"
  63 #include "private/format.h"
  64 #include "private/lpc.h"
  65 #include "private/md5.h"
  66 #include "private/memory.h"
  67 #ifdef FLAC__HAS_OGG
  68 #include "private/ogg_helper.h"
  69 #endif
  70 #include "private/stream_encoder_framing.h"
  71 #include "private/window.h"
  72
  73 #ifdef min
  74 #undef min
  75 #endif
  76 #define min(x,y) ((x)<(y)?(x):(y))
  77
  78 #ifdef max
  79 #undef max
  80 #endif
  81 #define max(x,y) ((x)>(y)?(x):(y))
  82
  83 typedef struct {
  84         FLAC__int32 *data[FLAC__MAX_CHANNELS];
  85         unsigned size; /* of each data[] in samples */
  86         unsigned tail;
  87 } verify_input_fifo;
  88
  89 typedef struct {
  90         const FLAC__byte *data;
  91         unsigned capacity;
  92         unsigned bytes;
  93 } verify_output;
  94
  95 typedef enum {
  96         ENCODER_IN_MAGIC = 0,
  97         ENCODER_IN_METADATA = 1,
  98         ENCODER_IN_AUDIO = 2
  99 } EncoderStateHint;
 100
 101 static struct CompressionLevels {
 102         FLAC__bool do_mid_side_stereo;
 103         FLAC__bool loose_mid_side_stereo;
 104         const char *apodization;
 105         unsigned max_lpc_order;
 106         unsigned qlp_coeff_precision;
 107         FLAC__bool do_qlp_coeff_prec_search;
 108         FLAC__bool do_escape_coding;
 109         FLAC__bool do_exhaustive_model_search;
 110         unsigned min_residual_partition_order;
 111         unsigned max_residual_partition_order;
 112         unsigned rice_parameter_search_dist;
 113 } compression_levels_[] = {
 114         { false, false, "tukey(0.5)",  0, 0, false, false, false, 2, 2, 0 },
 115         { true , true , "tukey(0.5)",  0, 0, false, false, false, 2, 2, 0 },
 116         { true , false, "tukey(0.5)",  0, 0, false, false, false, 0, 3, 0 },
 117         { false, false, "tukey(0.5)",  6, 0, false, false, false, 3, 3, 0 },
 118         { true , true , "tukey(0.5)",  8, 0, false, false, false, 3, 3, 0 },
 119         { true , false, "tukey(0.5)",  8, 0, false, false, false, 3, 3, 0 },
 120         { true , false, "tukey(0.5)",  8, 0, false, false, false, 0, 4, 0 },
 121         { true , false, "tukey(0.5)",  8, 0, false, false, true , 0, 6, 0 },
 122         { true , false, "tukey(0.5)", 12, 0, false, false, true , 0, 6, 0 }
 123 };
 124
 125
 126 /***********************************************************************
 127  *
 128  * Private class method prototypes
 129  *
 130  ***********************************************************************/
 131
 132 static void set_defaults_(FLAC__StreamEncoder *encoder);
 133 static void free_(FLAC__StreamEncoder *encoder);
 134 static FLAC__bool resize_buffers_(FLAC__StreamEncoder *encoder, unsigned new_blocksize);
 135 static FLAC__bool write_bitbuffer_(FLAC__StreamEncoder *encoder, unsigned samples);
 136 static FLAC__StreamEncoderWriteStatus write_frame_(FLAC__StreamEncoder *encoder, const FLAC__byte buffer[], size_t bytes, unsigned samples);
 137 static void update_metadata_(const FLAC__StreamEncoder *encoder);
 138 #if FLAC__HAS_OGG
 139 static void update_ogg_metadata_(FLAC__StreamEncoder *encoder);
 140 #endif
 141 static FLAC__bool process_frame_(FLAC__StreamEncoder *encoder, FLAC__bool is_fractional_block);
 142 static FLAC__bool process_subframes_(FLAC__StreamEncoder *encoder, FLAC__bool is_fractional_block);
 143
 144 static FLAC__bool process_subframe_(
 145         FLAC__StreamEncoder *encoder,
 146         unsigned min_partition_order,
 147         unsigned max_partition_order,
 148         FLAC__bool precompute_partition_sums,
 149         const FLAC__FrameHeader *frame_header,
 150         unsigned subframe_bps,
 151         const FLAC__int32 integer_signal[],
 152 #ifndef FLAC__INTEGER_ONLY_LIBRARY
 153         const FLAC__real real_signal[],
 154 #endif
 155         FLAC__Subframe *subframe[2],
 156         FLAC__EntropyCodingMethod_PartitionedRiceContents *partitioned_rice_contents[2],
 157         FLAC__int32 *residual[2],
 158         unsigned *best_subframe,
 159         unsigned *best_bits
 160 );
 161
 162 static FLAC__bool add_subframe_(
 163         FLAC__StreamEncoder *encoder,
 164         const FLAC__FrameHeader *frame_header,
 165         unsigned subframe_bps,
 166         const FLAC__Subframe *subframe,
 167         FLAC__BitBuffer *frame
 168 );
 169
 170 static unsigned evaluate_constant_subframe_(
 171         const FLAC__int32 signal,
 172         unsigned subframe_bps,
 173         FLAC__Subframe *subframe
 174 );
 175
 176 static unsigned evaluate_fixed_subframe_(
 177         FLAC__StreamEncoder *encoder,
 178         const FLAC__int32 signal[],
 179         FLAC__int32 residual[],
 180         FLAC__uint32 abs_residual[],
 181         FLAC__uint64 abs_residual_partition_sums[],
 182         unsigned raw_bits_per_partition[],
 183         unsigned blocksize,
 184         unsigned subframe_bps,
 185         unsigned order,
 186         unsigned rice_parameter,
 187         unsigned min_partition_order,
 188         unsigned max_partition_order,
 189         FLAC__bool precompute_partition_sums,
 190         FLAC__bool do_escape_coding,
 191         unsigned rice_parameter_search_dist,
 192         FLAC__Subframe *subframe,
 193         FLAC__EntropyCodingMethod_PartitionedRiceContents *partitioned_rice_contents
 194 );
 195
 196 #ifndef FLAC__INTEGER_ONLY_LIBRARY
 197 static unsigned evaluate_lpc_subframe_(
 198         FLAC__StreamEncoder *encoder,
 199         const FLAC__int32 signal[],
 200         FLAC__int32 residual[],
 201         FLAC__uint32 abs_residual[],
 202         FLAC__uint64 abs_residual_partition_sums[],
 203         unsigned raw_bits_per_partition[],
 204         const FLAC__real lp_coeff[],
 205         unsigned blocksize,
 206         unsigned subframe_bps,
 207         unsigned order,
 208         unsigned qlp_coeff_precision,
 209         unsigned rice_parameter,
 210         unsigned min_partition_order,
 211         unsigned max_partition_order,
 212         FLAC__bool precompute_partition_sums,
 213         FLAC__bool do_escape_coding,
 214         unsigned rice_parameter_search_dist,
 215         FLAC__Subframe *subframe,
 216         FLAC__EntropyCodingMethod_PartitionedRiceContents *partitioned_rice_contents
 217 );
 218 #endif
 219
 220 static unsigned evaluate_verbatim_subframe_(
 221         const FLAC__int32 signal[],
 222         unsigned blocksize,
 223         unsigned subframe_bps,
 224         FLAC__Subframe *subframe
 225 );
 226
 227 static unsigned find_best_partition_order_(
 228         struct FLAC__StreamEncoderPrivate *private_,
 229         const FLAC__int32 residual[],
 230         FLAC__uint32 abs_residual[],
 231         FLAC__uint64 abs_residual_partition_sums[],
 232         unsigned raw_bits_per_partition[],
 233         unsigned residual_samples,
 234         unsigned predictor_order,
 235         unsigned rice_parameter,
 236         unsigned min_partition_order,
 237         unsigned max_partition_order,
 238         FLAC__bool precompute_partition_sums,
 239         FLAC__bool do_escape_coding,
 240         unsigned rice_parameter_search_dist,
 241         FLAC__EntropyCodingMethod_PartitionedRice *best_partitioned_rice
 242 );
 243
 244 static void precompute_partition_info_sums_(
 245         const FLAC__uint32 abs_residual[],
 246         FLAC__uint64 abs_residual_partition_sums[],
 247         unsigned residual_samples,
 248         unsigned predictor_order,
 249         unsigned min_partition_order,
 250         unsigned max_partition_order
 251 );
 252
 253 static void precompute_partition_info_escapes_(
 254         const FLAC__int32 residual[],
 255         unsigned raw_bits_per_partition[],
 256         unsigned residual_samples,
 257         unsigned predictor_order,
 258         unsigned min_partition_order,
 259         unsigned max_partition_order
 260 );
 261
 262 #ifdef DONT_ESTIMATE_RICE_BITS
 263 static FLAC__bool set_partitioned_rice_(
 264         const FLAC__uint32 abs_residual[],
 265         const FLAC__int32 residual[],
 266         const unsigned residual_samples,
 267         const unsigned predictor_order,
 268         const unsigned suggested_rice_parameter,
 269         const unsigned rice_parameter_search_dist,
 270         const unsigned partition_order,
 271         FLAC__EntropyCodingMethod_PartitionedRiceContents *partitioned_rice_contents,
 272         unsigned *bits
 273 );
 274
 275 static FLAC__bool set_partitioned_rice_with_precompute_(
 276         const FLAC__int32 residual[],
 277         const FLAC__uint64 abs_residual_partition_sums[],
 278         const unsigned raw_bits_per_partition[],
 279         const unsigned residual_samples,
 280         const unsigned predictor_order,
 281         const unsigned suggested_rice_parameter,
 282         const unsigned rice_parameter_search_dist,
 283         const unsigned partition_order,
 284         const FLAC__bool search_for_escapes,
 285         FLAC__EntropyCodingMethod_PartitionedRiceContents *partitioned_rice_contents,
 286         unsigned *bits
 287 );
 288 #else
 289 static FLAC__bool set_partitioned_rice_(
 290         const FLAC__uint32 abs_residual[],
 291         const unsigned residual_samples,
 292         const unsigned predictor_order,
 293         const unsigned suggested_rice_parameter,
 294         const unsigned rice_parameter_search_dist,
 295         const unsigned partition_order,
 296         FLAC__EntropyCodingMethod_PartitionedRiceContents *partitioned_rice_contents,
 297         unsigned *bits
 298 );
 299
 300 static FLAC__bool set_partitioned_rice_with_precompute_(
 301         const FLAC__uint32 abs_residual[],
 302         const FLAC__uint64 abs_residual_partition_sums[],
 303         const unsigned raw_bits_per_partition[],
 304         const unsigned residual_samples,
 305         const unsigned predictor_order,
 306         const unsigned suggested_rice_parameter,
 307         const unsigned rice_parameter_search_dist,
 308         const unsigned partition_order,
 309         const FLAC__bool search_for_escapes,
 310         FLAC__EntropyCodingMethod_PartitionedRiceContents *partitioned_rice_contents,
 311         unsigned *bits
 312 );
 313 #endif
 314
 315 static unsigned get_wasted_bits_(FLAC__int32 signal[], unsigned samples);
 316
 317 /* verify-related routines: */
 318 static void append_to_verify_fifo_(
 319         verify_input_fifo *fifo,
 320         const FLAC__int32 * const input[],
 321         unsigned input_offset,
 322         unsigned channels,
 323         unsigned wide_samples
 324 );
 325
 326 static void append_to_verify_fifo_interleaved_(
 327         verify_input_fifo *fifo,
 328         const FLAC__int32 input[],
 329         unsigned input_offset,
 330         unsigned channels,
 331         unsigned wide_samples
 332 );
 333
 334 static FLAC__StreamDecoderReadStatus verify_read_callback_(const FLAC__StreamDecoder *decoder, FLAC__byte buffer[], size_t *bytes, void *client_data);
 335 static FLAC__StreamDecoderWriteStatus verify_write_callback_(const FLAC__StreamDecoder *decoder, const FLAC__Frame *frame, const FLAC__int32 * const buffer[], void *client_data);
 336 static void verify_metadata_callback_(const FLAC__StreamDecoder *decoder, const FLAC__StreamMetadata *metadata, void *client_data);
 337 static void verify_error_callback_(const FLAC__StreamDecoder *decoder, FLAC__StreamDecoderErrorStatus status, void *client_data);
 338
 339 static FLAC__StreamEncoderReadStatus file_read_callback_(const FLAC__StreamEncoder *encoder, FLAC__byte buffer[], size_t *bytes, void *client_data);
 340 static FLAC__StreamEncoderSeekStatus file_seek_callback_(const FLAC__StreamEncoder *encoder, FLAC__uint64 absolute_byte_offset, void *client_data);
 341 static FLAC__StreamEncoderTellStatus file_tell_callback_(const FLAC__StreamEncoder *encoder, FLAC__uint64 *absolute_byte_offset, void *client_data);
 342 static FLAC__StreamEncoderWriteStatus file_write_callback_(const FLAC__StreamEncoder *encoder, const FLAC__byte buffer[], size_t bytes, unsigned samples, unsigned current_frame, void *client_data);
 343 static FILE *get_binary_stdout_();
 344
 345
 346 /***********************************************************************
 347  *
 348  * Private class data
 349  *
 350  ***********************************************************************/
 351
 352 typedef struct FLAC__StreamEncoderPrivate {
 353         unsigned input_capacity;                          /* current size (in samples) of the signal and residual buffers */
 354         FLAC__int32 *integer_signal[FLAC__MAX_CHANNELS];  /* the integer version of the input signal */
 355         FLAC__int32 *integer_signal_mid_side[2];          /* the integer version of the mid-side input signal (stereo only) */
 356 #ifndef FLAC__INTEGER_ONLY_LIBRARY
 357         FLAC__real *real_signal[FLAC__MAX_CHANNELS];      /* the floating-point version of the input signal */
 358         FLAC__real *real_signal_mid_side[2];              /* the floating-point version of the mid-side input signal (stereo only) */
 359         FLAC__real *window[FLAC__MAX_APODIZATION_FUNCTIONS]; /* the pre-computed floating-point window for each apodization function */
 360         FLAC__real *windowed_signal;                      /* the real_signal[] * current window[] */
 361 #endif
 362         unsigned subframe_bps[FLAC__MAX_CHANNELS];        /* the effective bits per sample of the input signal (stream bps - wasted bits) */
 363         unsigned subframe_bps_mid_side[2];                /* the effective bits per sample of the mid-side input signal (stream bps - wasted bits + 0/1) */
 364         FLAC__int32 *residual_workspace[FLAC__MAX_CHANNELS][2]; /* each channel has a candidate and best workspace where the subframe residual signals will be stored */
 365         FLAC__int32 *residual_workspace_mid_side[2][2];
 366         FLAC__Subframe subframe_workspace[FLAC__MAX_CHANNELS][2];
 367         FLAC__Subframe subframe_workspace_mid_side[2][2];
 368         FLAC__Subframe *subframe_workspace_ptr[FLAC__MAX_CHANNELS][2];
 369         FLAC__Subframe *subframe_workspace_ptr_mid_side[2][2];
 370         FLAC__EntropyCodingMethod_PartitionedRiceContents partitioned_rice_contents_workspace[FLAC__MAX_CHANNELS][2];
 371         FLAC__EntropyCodingMethod_PartitionedRiceContents partitioned_rice_contents_workspace_mid_side[FLAC__MAX_CHANNELS][2];
 372         FLAC__EntropyCodingMethod_PartitionedRiceContents *partitioned_rice_contents_workspace_ptr[FLAC__MAX_CHANNELS][2];
 373         FLAC__EntropyCodingMethod_PartitionedRiceContents *partitioned_rice_contents_workspace_ptr_mid_side[FLAC__MAX_CHANNELS][2];
 374         unsigned best_subframe[FLAC__MAX_CHANNELS];       /* index into the above workspaces */
 375         unsigned best_subframe_mid_side[2];
 376         unsigned best_subframe_bits[FLAC__MAX_CHANNELS];  /* size in bits of the best subframe for each channel */
 377         unsigned best_subframe_bits_mid_side[2];
 378         FLAC__uint32 *abs_residual;                       /* workspace where abs(candidate residual) is stored */
 379         FLAC__uint64 *abs_residual_partition_sums;        /* workspace where the sum of abs(candidate residual) for each partition is stored */
 380         unsigned *raw_bits_per_partition;                 /* workspace where the sum of silog2(candidate residual) for each partition is stored */
 381         FLAC__BitBuffer *frame;                           /* the current frame being worked on */
 382         unsigned loose_mid_side_stereo_frames;            /* rounded number of frames the encoder will use before trying both independent and mid/side frames again */
 383         unsigned loose_mid_side_stereo_frame_count;       /* number of frames using the current channel assignment */
 384         FLAC__ChannelAssignment last_channel_assignment;
 385         FLAC__StreamMetadata streaminfo;                  /* scratchpad for STREAMINFO as it is built */
 386         FLAC__StreamMetadata_SeekTable *seek_table;       /* pointer into encoder->protected_->metadata_ where the seek table is */
 387         unsigned current_sample_number;
 388         unsigned current_frame_number;
 389         struct FLAC__MD5Context md5context;
 390         FLAC__CPUInfo cpuinfo;
 391 #ifndef FLAC__INTEGER_ONLY_LIBRARY
 392         unsigned (*local_fixed_compute_best_predictor)(const FLAC__int32 data[], unsigned data_len, FLAC__float residual_bits_per_sample[FLAC__MAX_FIXED_ORDER+1]);
 393 #else
 394         unsigned (*local_fixed_compute_best_predictor)(const FLAC__int32 data[], unsigned data_len, FLAC__fixedpoint residual_bits_per_sample[FLAC__MAX_FIXED_ORDER+1]);
 395 #endif
 396 #ifndef FLAC__INTEGER_ONLY_LIBRARY
 397         void (*local_lpc_compute_autocorrelation)(const FLAC__real data[], unsigned data_len, unsigned lag, FLAC__real autoc[]);
 398         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[]);
 399         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[]);
 400         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[]);
 401 #endif
 402         FLAC__bool use_wide_by_block;          /* use slow 64-bit versions of some functions because of the block size */
 403         FLAC__bool use_wide_by_partition;      /* use slow 64-bit versions of some functions because of the min partition order and blocksize */
 404         FLAC__bool use_wide_by_order;          /* use slow 64-bit versions of some functions because of the lpc order */
 405         FLAC__bool precompute_partition_sums;  /* our initial guess as to whether precomputing the partitions sums will be a speed improvement */
 406         FLAC__bool disable_constant_subframes;
 407         FLAC__bool disable_fixed_subframes;
 408         FLAC__bool disable_verbatim_subframes;
 409 #if FLAC__HAS_OGG
 410         FLAC__bool is_ogg;
 411 #endif
 412         FLAC__StreamEncoderReadCallback read_callback; /* currently only needed for Ogg FLAC */
 413         FLAC__StreamEncoderSeekCallback seek_callback;
 414         FLAC__StreamEncoderTellCallback tell_callback;
 415         FLAC__StreamEncoderWriteCallback write_callback;
 416         FLAC__StreamEncoderMetadataCallback metadata_callback;
 417         FLAC__StreamEncoderProgressCallback progress_callback;
 418         void *client_data;
 419         unsigned first_seekpoint_to_check;
 420         FILE *file;                            /* only used when encoding to a file */
 421         FLAC__uint64 bytes_written;
 422         FLAC__uint64 samples_written;
 423         unsigned frames_written;
 424         unsigned total_frames_estimate;
 425         /* unaligned (original) pointers to allocated data */
 426         FLAC__int32 *integer_signal_unaligned[FLAC__MAX_CHANNELS];
 427         FLAC__int32 *integer_signal_mid_side_unaligned[2];
 428 #ifndef FLAC__INTEGER_ONLY_LIBRARY
 429         FLAC__real *real_signal_unaligned[FLAC__MAX_CHANNELS];
 430         FLAC__real *real_signal_mid_side_unaligned[2];
 431         FLAC__real *window_unaligned[FLAC__MAX_APODIZATION_FUNCTIONS];
 432         FLAC__real *windowed_signal_unaligned;
 433 #endif
 434         FLAC__int32 *residual_workspace_unaligned[FLAC__MAX_CHANNELS][2];
 435         FLAC__int32 *residual_workspace_mid_side_unaligned[2][2];
 436         FLAC__uint32 *abs_residual_unaligned;
 437         FLAC__uint64 *abs_residual_partition_sums_unaligned;
 438         unsigned *raw_bits_per_partition_unaligned;
 439         /*
 440          * These fields have been moved here from private function local
 441          * declarations merely to save stack space during encoding.
 442          */
 443 #ifndef FLAC__INTEGER_ONLY_LIBRARY
 444         FLAC__real lp_coeff[FLAC__MAX_LPC_ORDER][FLAC__MAX_LPC_ORDER]; /* from process_subframe_() */
 445 #endif
 446         FLAC__EntropyCodingMethod_PartitionedRiceContents partitioned_rice_contents_extra[2]; /* from find_best_partition_order_() */
 447         /*
 448          * The data for the verify section
 449          */
 450         struct {
 451                 FLAC__StreamDecoder *decoder;
 452                 EncoderStateHint state_hint;
 453                 FLAC__bool needs_magic_hack;
 454                 verify_input_fifo input_fifo;
 455                 verify_output output;
 456                 struct {
 457                         FLAC__uint64 absolute_sample;
 458                         unsigned frame_number;
 459                         unsigned channel;
 460                         unsigned sample;
 461                         FLAC__int32 expected;
 462                         FLAC__int32 got;
 463                 } error_stats;
 464         } verify;
 465         FLAC__bool is_being_deleted; /* if true, call to ..._finish() from ..._delete() will not call the callbacks */
 466 } FLAC__StreamEncoderPrivate;
 467
 468 /***********************************************************************
 469  *
 470  * Public static class data
 471  *
 472  ***********************************************************************/
 473
 474 FLAC_API const char * const FLAC__StreamEncoderStateString[] = {
 475         "FLAC__STREAM_ENCODER_OK",
 476         "FLAC__STREAM_ENCODER_UNINITIALIZED",
 477         "FLAC__STREAM_ENCODER_OGG_ERROR",
 478         "FLAC__STREAM_ENCODER_VERIFY_DECODER_ERROR",
 479         "FLAC__STREAM_ENCODER_VERIFY_MISMATCH_IN_AUDIO_DATA",
 480         "FLAC__STREAM_ENCODER_CLIENT_ERROR",
 481         "FLAC__STREAM_ENCODER_IO_ERROR",
 482         "FLAC__STREAM_ENCODER_FRAMING_ERROR",
 483         "FLAC__STREAM_ENCODER_MEMORY_ALLOCATION_ERROR"
 484 };
 485
 486 FLAC_API const char * const FLAC__StreamEncoderInitStatusString[] = {
 487         "FLAC__STREAM_ENCODER_INIT_STATUS_OK",
 488         "FLAC__STREAM_ENCODER_INIT_STATUS_ENCODER_ERROR",
 489         "FLAC__STREAM_ENCODER_INIT_STATUS_UNSUPPORTED_CONTAINER",
 490         "FLAC__STREAM_ENCODER_INIT_STATUS_INVALID_CALLBACKS",
 491         "FLAC__STREAM_ENCODER_INIT_STATUS_INVALID_NUMBER_OF_CHANNELS",
 492         "FLAC__STREAM_ENCODER_INIT_STATUS_INVALID_BITS_PER_SAMPLE",
 493         "FLAC__STREAM_ENCODER_INIT_STATUS_INVALID_SAMPLE_RATE",
 494         "FLAC__STREAM_ENCODER_INIT_STATUS_INVALID_BLOCK_SIZE",
 495         "FLAC__STREAM_ENCODER_INIT_STATUS_INVALID_MAX_LPC_ORDER",
 496         "FLAC__STREAM_ENCODER_INIT_STATUS_INVALID_QLP_COEFF_PRECISION",
 497         "FLAC__STREAM_ENCODER_INIT_STATUS_BLOCK_SIZE_TOO_SMALL_FOR_LPC_ORDER",
 498         "FLAC__STREAM_ENCODER_INIT_STATUS_NOT_STREAMABLE",
 499         "FLAC__STREAM_ENCODER_INIT_STATUS_INVALID_METADATA",
 500         "FLAC__STREAM_ENCODER_INIT_STATUS_ALREADY_INITIALIZED"
 501 };
 502
 503 FLAC_API const char * const FLAC__treamEncoderReadStatusString[] = {
 504         "FLAC__STREAM_ENCODER_READ_STATUS_CONTINUE",
 505         "FLAC__STREAM_ENCODER_READ_STATUS_END_OF_STREAM",
 506         "FLAC__STREAM_ENCODER_READ_STATUS_ABORT",
 507         "FLAC__STREAM_ENCODER_READ_STATUS_UNSUPPORTED"
 508 };
 509
 510 FLAC_API const char * const FLAC__StreamEncoderWriteStatusString[] = {
 511         "FLAC__STREAM_ENCODER_WRITE_STATUS_OK",
 512         "FLAC__STREAM_ENCODER_WRITE_STATUS_FATAL_ERROR"
 513 };
 514
 515 FLAC_API const char * const FLAC__StreamEncoderSeekStatusString[] = {
 516         "FLAC__STREAM_ENCODER_SEEK_STATUS_OK",
 517         "FLAC__STREAM_ENCODER_SEEK_STATUS_ERROR",
 518         "FLAC__STREAM_ENCODER_SEEK_STATUS_UNSUPPORTED"
 519 };
 520
 521 FLAC_API const char * const FLAC__StreamEncoderTellStatusString[] = {
 522         "FLAC__STREAM_ENCODER_TELL_STATUS_OK",
 523         "FLAC__STREAM_ENCODER_TELL_STATUS_ERROR",
 524         "FLAC__STREAM_ENCODER_TELL_STATUS_UNSUPPORTED"
 525 };
 526
 527 /***********************************************************************
 528  *
 529  * Class constructor/destructor
 530  *
 531  */
 532 FLAC_API FLAC__StreamEncoder *FLAC__stream_encoder_new()
 533 {
 534         FLAC__StreamEncoder *encoder;
 535         unsigned i;
 536
 537         FLAC__ASSERT(sizeof(int) >= 4); /* we want to die right away if this is not true */
 538
 539         encoder = (FLAC__StreamEncoder*)calloc(1, sizeof(FLAC__StreamEncoder));
 540         if(encoder == 0) {
 541                 return 0;
 542         }
 543
 544         encoder->protected_ = (FLAC__StreamEncoderProtected*)calloc(1, sizeof(FLAC__StreamEncoderProtected));
 545         if(encoder->protected_ == 0) {
 546                 free(encoder);
 547                 return 0;
 548         }
 549
 550         encoder->private_ = (FLAC__StreamEncoderPrivate*)calloc(1, sizeof(FLAC__StreamEncoderPrivate));
 551         if(encoder->private_ == 0) {
 552                 free(encoder->protected_);
 553                 free(encoder);
 554                 return 0;
 555         }
 556
 557         encoder->private_->frame = FLAC__bitbuffer_new();
 558         if(encoder->private_->frame == 0) {
 559                 free(encoder->private_);
 560                 free(encoder->protected_);
 561                 free(encoder);
 562                 return 0;
 563         }
 564
 565         encoder->private_->file = 0;
 566
 567         set_defaults_(encoder);
 568
 569         encoder->private_->is_being_deleted = false;
 570
 571         for(i = 0; i < FLAC__MAX_CHANNELS; i++) {
 572                 encoder->private_->subframe_workspace_ptr[i][0] = &encoder->private_->subframe_workspace[i][0];
 573                 encoder->private_->subframe_workspace_ptr[i][1] = &encoder->private_->subframe_workspace[i][1];
 574         }
 575         for(i = 0; i < 2; i++) {
 576                 encoder->private_->subframe_workspace_ptr_mid_side[i][0] = &encoder->private_->subframe_workspace_mid_side[i][0];
 577                 encoder->private_->subframe_workspace_ptr_mid_side[i][1] = &encoder->private_->subframe_workspace_mid_side[i][1];
 578         }
 579         for(i = 0; i < FLAC__MAX_CHANNELS; i++) {
 580                 encoder->private_->partitioned_rice_contents_workspace_ptr[i][0] = &encoder->private_->partitioned_rice_contents_workspace[i][0];
 581                 encoder->private_->partitioned_rice_contents_workspace_ptr[i][1] = &encoder->private_->partitioned_rice_contents_workspace[i][1];
 582         }
 583         for(i = 0; i < 2; i++) {
 584                 encoder->private_->partitioned_rice_contents_workspace_ptr_mid_side[i][0] = &encoder->private_->partitioned_rice_contents_workspace_mid_side[i][0];
 585                 encoder->private_->partitioned_rice_contents_workspace_ptr_mid_side[i][1] = &encoder->private_->partitioned_rice_contents_workspace_mid_side[i][1];
 586         }
 587
 588         for(i = 0; i < FLAC__MAX_CHANNELS; i++) {
 589                 FLAC__format_entropy_coding_method_partitioned_rice_contents_init(&encoder->private_->partitioned_rice_contents_workspace[i][0]);
 590                 FLAC__format_entropy_coding_method_partitioned_rice_contents_init(&encoder->private_->partitioned_rice_contents_workspace[i][1]);
 591         }
 592         for(i = 0; i < 2; i++) {
 593                 FLAC__format_entropy_coding_method_partitioned_rice_contents_init(&encoder->private_->partitioned_rice_contents_workspace_mid_side[i][0]);
 594                 FLAC__format_entropy_coding_method_partitioned_rice_contents_init(&encoder->private_->partitioned_rice_contents_workspace_mid_side[i][1]);
 595         }
 596         for(i = 0; i < 2; i++)
 597                 FLAC__format_entropy_coding_method_partitioned_rice_contents_init(&encoder->private_->partitioned_rice_contents_extra[i]);
 598
 599         encoder->protected_->state = FLAC__STREAM_ENCODER_UNINITIALIZED;
 600
 601         return encoder;
 602 }
 603
 604 FLAC_API void FLAC__stream_encoder_delete(FLAC__StreamEncoder *encoder)
 605 {
 606         unsigned i;
 607
 608         FLAC__ASSERT(0 != encoder);
 609         FLAC__ASSERT(0 != encoder->protected_);
 610         FLAC__ASSERT(0 != encoder->private_);
 611         FLAC__ASSERT(0 != encoder->private_->frame);
 612
 613         encoder->private_->is_being_deleted = true;
 614
 615         FLAC__stream_encoder_finish(encoder);
 616
 617         if(0 != encoder->private_->verify.decoder)
 618                 FLAC__stream_decoder_delete(encoder->private_->verify.decoder);
 619
 620         for(i = 0; i < FLAC__MAX_CHANNELS; i++) {
 621                 FLAC__format_entropy_coding_method_partitioned_rice_contents_clear(&encoder->private_->partitioned_rice_contents_workspace[i][0]);
 622                 FLAC__format_entropy_coding_method_partitioned_rice_contents_clear(&encoder->private_->partitioned_rice_contents_workspace[i][1]);
 623         }
 624         for(i = 0; i < 2; i++) {
 625                 FLAC__format_entropy_coding_method_partitioned_rice_contents_clear(&encoder->private_->partitioned_rice_contents_workspace_mid_side[i][0]);
 626                 FLAC__format_entropy_coding_method_partitioned_rice_contents_clear(&encoder->private_->partitioned_rice_contents_workspace_mid_side[i][1]);
 627         }
 628         for(i = 0; i < 2; i++)
 629                 FLAC__format_entropy_coding_method_partitioned_rice_contents_clear(&encoder->private_->partitioned_rice_contents_extra[i]);
 630
 631         FLAC__bitbuffer_delete(encoder->private_->frame);
 632         free(encoder->private_);
 633         free(encoder->protected_);
 634         free(encoder);
 635 }
 636
 637 /***********************************************************************
 638  *
 639  * Public class methods
 640  *
 641  ***********************************************************************/
 642
 643 static FLAC__StreamEncoderInitStatus init_stream_internal_(
 644         FLAC__StreamEncoder *encoder,
 645         FLAC__StreamEncoderReadCallback read_callback,
 646         FLAC__StreamEncoderWriteCallback write_callback,
 647         FLAC__StreamEncoderSeekCallback seek_callback,
 648         FLAC__StreamEncoderTellCallback tell_callback,
 649         FLAC__StreamEncoderMetadataCallback metadata_callback,
 650         void *client_data,
 651         FLAC__bool is_ogg
 652 )
 653 {
 654         unsigned i;
 655         FLAC__bool metadata_has_seektable, metadata_has_vorbis_comment, metadata_picture_has_type1, metadata_picture_has_type2;
 656
 657         FLAC__ASSERT(0 != encoder);
 658
 659         if(encoder->protected_->state != FLAC__STREAM_ENCODER_UNINITIALIZED)
 660                 return FLAC__STREAM_ENCODER_INIT_STATUS_ALREADY_INITIALIZED;
 661
 662 #ifndef FLAC__HAS_OGG
 663         if(is_ogg)
 664                 return FLAC__STREAM_ENCODER_INIT_STATUS_UNSUPPORTED_CONTAINER;
 665 #endif
 666
 667         if(0 == write_callback || (seek_callback && 0 == tell_callback))
 668                 return FLAC__STREAM_ENCODER_INIT_STATUS_INVALID_CALLBACKS;
 669
 670         if(encoder->protected_->channels == 0 || encoder->protected_->channels > FLAC__MAX_CHANNELS)
 671                 return FLAC__STREAM_ENCODER_INIT_STATUS_INVALID_NUMBER_OF_CHANNELS;
 672
 673         if(encoder->protected_->channels != 2) {
 674                 encoder->protected_->do_mid_side_stereo = false;
 675                 encoder->protected_->loose_mid_side_stereo = false;
 676         }
 677         else if(!encoder->protected_->do_mid_side_stereo)
 678                 encoder->protected_->loose_mid_side_stereo = false;
 679
 680         if(encoder->protected_->bits_per_sample >= 32)
 681                 encoder->protected_->do_mid_side_stereo = false; /* since we currenty do 32-bit math, the side channel would have 33 bps and overflow */
 682
 683         if(encoder->protected_->bits_per_sample < FLAC__MIN_BITS_PER_SAMPLE || encoder->protected_->bits_per_sample > FLAC__REFERENCE_CODEC_MAX_BITS_PER_SAMPLE)
 684                 return FLAC__STREAM_ENCODER_INIT_STATUS_INVALID_BITS_PER_SAMPLE;
 685
 686         if(!FLAC__format_sample_rate_is_valid(encoder->protected_->sample_rate))
 687                 return FLAC__STREAM_ENCODER_INIT_STATUS_INVALID_SAMPLE_RATE;
 688
 689         if(encoder->protected_->blocksize == 0) {
 690                 if(encoder->protected_->max_lpc_order == 0)
 691                         encoder->protected_->blocksize = 1152;
 692                 else
 693                         encoder->protected_->blocksize = 4608;
 694         }
 695
 696         if(encoder->protected_->blocksize < FLAC__MIN_BLOCK_SIZE || encoder->protected_->blocksize > FLAC__MAX_BLOCK_SIZE)
 697                 return FLAC__STREAM_ENCODER_INIT_STATUS_INVALID_BLOCK_SIZE;
 698
 699         if(encoder->protected_->max_lpc_order > FLAC__MAX_LPC_ORDER)
 700                 return FLAC__STREAM_ENCODER_INIT_STATUS_INVALID_MAX_LPC_ORDER;
 701
 702         if(encoder->protected_->blocksize < encoder->protected_->max_lpc_order)
 703                 return FLAC__STREAM_ENCODER_INIT_STATUS_BLOCK_SIZE_TOO_SMALL_FOR_LPC_ORDER;
 704
 705         if(encoder->protected_->qlp_coeff_precision == 0) {
 706                 if(encoder->protected_->bits_per_sample < 16) {
 707                         /* @@@ need some data about how to set this here w.r.t. blocksize and sample rate */
 708                         /* @@@ until then we'll make a guess */
 709                         encoder->protected_->qlp_coeff_precision = max(FLAC__MIN_QLP_COEFF_PRECISION, 2 + encoder->protected_->bits_per_sample / 2);
 710                 }
 711                 else if(encoder->protected_->bits_per_sample == 16) {
 712                         if(encoder->protected_->blocksize <= 192)
 713                                 encoder->protected_->qlp_coeff_precision = 7;
 714                         else if(encoder->protected_->blocksize <= 384)
 715                                 encoder->protected_->qlp_coeff_precision = 8;
 716                         else if(encoder->protected_->blocksize <= 576)
 717                                 encoder->protected_->qlp_coeff_precision = 9;
 718                         else if(encoder->protected_->blocksize <= 1152)
 719                                 encoder->protected_->qlp_coeff_precision = 10;
 720                         else if(encoder->protected_->blocksize <= 2304)
 721                                 encoder->protected_->qlp_coeff_precision = 11;
 722                         else if(encoder->protected_->blocksize <= 4608)
 723                                 encoder->protected_->qlp_coeff_precision = 12;
 724                         else
 725                                 encoder->protected_->qlp_coeff_precision = 13;
 726                 }
 727                 else {
 728                         if(encoder->protected_->blocksize <= 384)
 729                                 encoder->protected_->qlp_coeff_precision = FLAC__MAX_QLP_COEFF_PRECISION-2;
 730                         else if(encoder->protected_->blocksize <= 1152)
 731                                 encoder->protected_->qlp_coeff_precision = FLAC__MAX_QLP_COEFF_PRECISION-1;
 732                         else
 733                                 encoder->protected_->qlp_coeff_precision = FLAC__MAX_QLP_COEFF_PRECISION;
 734                 }
 735                 FLAC__ASSERT(encoder->protected_->qlp_coeff_precision <= FLAC__MAX_QLP_COEFF_PRECISION);
 736         }
 737         else if(encoder->protected_->qlp_coeff_precision < FLAC__MIN_QLP_COEFF_PRECISION || encoder->protected_->qlp_coeff_precision > FLAC__MAX_QLP_COEFF_PRECISION)
 738                 return FLAC__STREAM_ENCODER_INIT_STATUS_INVALID_QLP_COEFF_PRECISION;
 739
 740         if(encoder->protected_->streamable_subset) {
 741                 if(
 742                         encoder->protected_->blocksize != 192 &&
 743                         encoder->protected_->blocksize != 576 &&
 744                         encoder->protected_->blocksize != 1152 &&
 745                         encoder->protected_->blocksize != 2304 &&
 746                         encoder->protected_->blocksize != 4608 &&
 747                         encoder->protected_->blocksize != 256 &&
 748                         encoder->protected_->blocksize != 512 &&
 749                         encoder->protected_->blocksize != 1024 &&
 750                         encoder->protected_->blocksize != 2048 &&
 751                         encoder->protected_->blocksize != 4096 &&
 752                         encoder->protected_->blocksize != 8192 &&
 753                         encoder->protected_->blocksize != 16384
 754                 )
 755                         return FLAC__STREAM_ENCODER_INIT_STATUS_NOT_STREAMABLE;
 756                 if(
 757                         encoder->protected_->sample_rate != 8000 &&
 758                         encoder->protected_->sample_rate != 16000 &&
 759                         encoder->protected_->sample_rate != 22050 &&
 760                         encoder->protected_->sample_rate != 24000 &&
 761                         encoder->protected_->sample_rate != 32000 &&
 762                         encoder->protected_->sample_rate != 44100 &&
 763                         encoder->protected_->sample_rate != 48000 &&
 764                         encoder->protected_->sample_rate != 96000
 765                 )
 766                         return FLAC__STREAM_ENCODER_INIT_STATUS_NOT_STREAMABLE;
 767                 if(
 768                         encoder->protected_->bits_per_sample != 8 &&
 769                         encoder->protected_->bits_per_sample != 12 &&
 770                         encoder->protected_->bits_per_sample != 16 &&
 771                         encoder->protected_->bits_per_sample != 20 &&
 772                         encoder->protected_->bits_per_sample != 24
 773                 )
 774                         return FLAC__STREAM_ENCODER_INIT_STATUS_NOT_STREAMABLE;
 775                 if(encoder->protected_->max_residual_partition_order > FLAC__SUBSET_MAX_RICE_PARTITION_ORDER)
 776                         return FLAC__STREAM_ENCODER_INIT_STATUS_NOT_STREAMABLE;
 777                 if(
 778                         encoder->protected_->sample_rate <= 48000 &&
 779                         (
 780                                 encoder->protected_->blocksize > FLAC__SUBSET_MAX_BLOCK_SIZE_48000HZ ||
 781                                 encoder->protected_->max_lpc_order > FLAC__SUBSET_MAX_LPC_ORDER_48000HZ
 782                         )
 783                 ) {
 784                         return FLAC__STREAM_ENCODER_INIT_STATUS_NOT_STREAMABLE;
 785                 }
 786         }
 787
 788         if(encoder->protected_->max_residual_partition_order >= (1u << FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE_ORDER_LEN))
 789                 encoder->protected_->max_residual_partition_order = (1u << FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE_ORDER_LEN) - 1;
 790         if(encoder->protected_->min_residual_partition_order >= encoder->protected_->max_residual_partition_order)
 791                 encoder->protected_->min_residual_partition_order = encoder->protected_->max_residual_partition_order;
 792
 793 #if FLAC__HAS_OGG
 794         /* reorder metadata if necessary to ensure that any VORBIS_COMMENT is the first, according to the mapping spec */
 795         if(is_ogg && 0 != encoder->protected_->metadata && encoder->protected_->num_metadata_blocks > 1) {
 796                 unsigned i;
 797                 for(i = 1; i < encoder->protected_->num_metadata_blocks; i++) {
 798                         if(0 != encoder->protected_->metadata[i] && encoder->protected_->metadata[i]->type == FLAC__METADATA_TYPE_VORBIS_COMMENT) {
 799                                 FLAC__StreamMetadata *vc = encoder->protected_->metadata[i];
 800                                 for( ; i > 0; i--)
 801                                         encoder->protected_->metadata[i] = encoder->protected_->metadata[i-1];
 802                                 encoder->protected_->metadata[0] = vc;
 803                                 break;
 804                         }
 805                 }
 806         }
 807 #endif
 808         /* keep track of any SEEKTABLE block */
 809         if(0 != encoder->protected_->metadata && encoder->protected_->num_metadata_blocks > 0) {
 810                 unsigned i;
 811                 for(i = 0; i < encoder->protected_->num_metadata_blocks; i++) {
 812                         if(0 != encoder->protected_->metadata[i] && encoder->protected_->metadata[i]->type == FLAC__METADATA_TYPE_SEEKTABLE) {
 813                                 encoder->private_->seek_table = &encoder->protected_->metadata[i]->data.seek_table;
 814                                 break; /* take only the first one */
 815                         }
 816                 }
 817         }
 818
 819         /* validate metadata */
 820         if(0 == encoder->protected_->metadata && encoder->protected_->num_metadata_blocks > 0)
 821                 return FLAC__STREAM_ENCODER_INIT_STATUS_INVALID_METADATA;
 822         metadata_has_seektable = false;
 823         metadata_has_vorbis_comment = false;
 824         metadata_picture_has_type1 = false;
 825         metadata_picture_has_type2 = false;
 826         for(i = 0; i < encoder->protected_->num_metadata_blocks; i++) {
 827                 const FLAC__StreamMetadata *m = encoder->protected_->metadata[i];
 828                 if(m->type == FLAC__METADATA_TYPE_STREAMINFO)
 829                         return FLAC__STREAM_ENCODER_INIT_STATUS_INVALID_METADATA;
 830                 else if(m->type == FLAC__METADATA_TYPE_SEEKTABLE) {
 831                         if(metadata_has_seektable) /* only one is allowed */
 832                                 return FLAC__STREAM_ENCODER_INIT_STATUS_INVALID_METADATA;
 833                         metadata_has_seektable = true;
 834                         if(!FLAC__format_seektable_is_legal(&m->data.seek_table))
 835                                 return FLAC__STREAM_ENCODER_INIT_STATUS_INVALID_METADATA;
 836                 }
 837                 else if(m->type == FLAC__METADATA_TYPE_VORBIS_COMMENT) {
 838                         if(metadata_has_vorbis_comment) /* only one is allowed */
 839                                 return FLAC__STREAM_ENCODER_INIT_STATUS_INVALID_METADATA;
 840                         metadata_has_vorbis_comment = true;
 841                 }
 842                 else if(m->type == FLAC__METADATA_TYPE_CUESHEET) {
 843                         if(!FLAC__format_cuesheet_is_legal(&m->data.cue_sheet, m->data.cue_sheet.is_cd, /*violation=*/0))
 844                                 return FLAC__STREAM_ENCODER_INIT_STATUS_INVALID_METADATA;
 845                 }
 846                 else if(m->type == FLAC__METADATA_TYPE_PICTURE) {
 847                         if(!FLAC__format_picture_is_legal(&m->data.picture, /*violation=*/0))
 848                                 return FLAC__STREAM_ENCODER_INIT_STATUS_INVALID_METADATA;
 849                         if(m->data.picture.type == FLAC__STREAM_METADATA_PICTURE_TYPE_FILE_ICON_STANDARD) {
 850                                 if(metadata_picture_has_type1) /* there should only be 1 per stream */
 851                                         return FLAC__STREAM_ENCODER_INIT_STATUS_INVALID_METADATA;
 852                                 metadata_picture_has_type1 = true;
 853                                 /* standard icon must be 32x32 pixel PNG */
 854                                 if(
 855                                         m->data.picture.type == FLAC__STREAM_METADATA_PICTURE_TYPE_FILE_ICON_STANDARD &&
 856                                         (
 857                                                 (strcmp(m->data.picture.mime_type, "image/png") && strcmp(m->data.picture.mime_type, "-->")) ||
 858                                                 m->data.picture.width != 32 ||
 859                                                 m->data.picture.height != 32
 860                                         )
 861                                 )
 862                                         return FLAC__STREAM_ENCODER_INIT_STATUS_INVALID_METADATA;
 863                         }
 864                         else if(m->data.picture.type == FLAC__STREAM_METADATA_PICTURE_TYPE_FILE_ICON) {
 865                                 if(metadata_picture_has_type2) /* there should only be 1 per stream */
 866                                         return FLAC__STREAM_ENCODER_INIT_STATUS_INVALID_METADATA;
 867                                 metadata_picture_has_type2 = true;
 868                         }
 869                 }
 870         }
 871
 872         encoder->private_->input_capacity = 0;
 873         for(i = 0; i < encoder->protected_->channels; i++) {
 874                 encoder->private_->integer_signal_unaligned[i] = encoder->private_->integer_signal[i] = 0;
 875 #ifndef FLAC__INTEGER_ONLY_LIBRARY
 876                 encoder->private_->real_signal_unaligned[i] = encoder->private_->real_signal[i] = 0;
 877 #endif
 878         }
 879         for(i = 0; i < 2; i++) {
 880                 encoder->private_->integer_signal_mid_side_unaligned[i] = encoder->private_->integer_signal_mid_side[i] = 0;
 881 #ifndef FLAC__INTEGER_ONLY_LIBRARY
 882                 encoder->private_->real_signal_mid_side_unaligned[i] = encoder->private_->real_signal_mid_side[i] = 0;
 883 #endif
 884         }
 885 #ifndef FLAC__INTEGER_ONLY_LIBRARY
 886         for(i = 0; i < encoder->protected_->num_apodizations; i++)
 887                 encoder->private_->window_unaligned[i] = encoder->private_->window[i] = 0;
 888         encoder->private_->windowed_signal_unaligned = encoder->private_->windowed_signal = 0;
 889 #endif
 890         for(i = 0; i < encoder->protected_->channels; i++) {
 891                 encoder->private_->residual_workspace_unaligned[i][0] = encoder->private_->residual_workspace[i][0] = 0;
 892                 encoder->private_->residual_workspace_unaligned[i][1] = encoder->private_->residual_workspace[i][1] = 0;
 893                 encoder->private_->best_subframe[i] = 0;
 894         }
 895         for(i = 0; i < 2; i++) {
 896                 encoder->private_->residual_workspace_mid_side_unaligned[i][0] = encoder->private_->residual_workspace_mid_side[i][0] = 0;
 897                 encoder->private_->residual_workspace_mid_side_unaligned[i][1] = encoder->private_->residual_workspace_mid_side[i][1] = 0;
 898                 encoder->private_->best_subframe_mid_side[i] = 0;
 899         }
 900         encoder->private_->abs_residual_unaligned = encoder->private_->abs_residual = 0;
 901         encoder->private_->abs_residual_partition_sums_unaligned = encoder->private_->abs_residual_partition_sums = 0;
 902         encoder->private_->raw_bits_per_partition_unaligned = encoder->private_->raw_bits_per_partition = 0;
 903 #ifndef FLAC__INTEGER_ONLY_LIBRARY
 904         encoder->private_->loose_mid_side_stereo_frames = (unsigned)((FLAC__double)encoder->protected_->sample_rate * 0.4 / (FLAC__double)encoder->protected_->blocksize + 0.5);
 905 #else
 906         /* 26214 is the approximate fixed-point equivalent to 0.4 (0.4 * 2^16) */
 907         /* sample rate can be up to 655350 Hz, and thus use 20 bits, so we do the multiply&divide by hand */
 908         FLAC__ASSERT(FLAC__MAX_SAMPLE_RATE <= 655350);
 909         FLAC__ASSERT(FLAC__MAX_BLOCK_SIZE <= 65535);
 910         FLAC__ASSERT(encoder->protected_->sample_rate <= 655350);
 911         FLAC__ASSERT(encoder->protected_->blocksize <= 65535);
 912         encoder->private_->loose_mid_side_stereo_frames = (unsigned)FLAC__fixedpoint_trunc((((FLAC__uint64)(encoder->protected_->sample_rate) * (FLAC__uint64)(26214)) << 16) / (encoder->protected_->blocksize<<16) + FLAC__FP_ONE_HALF);
 913 #endif
 914         if(encoder->private_->loose_mid_side_stereo_frames == 0)
 915                 encoder->private_->loose_mid_side_stereo_frames = 1;
 916         encoder->private_->loose_mid_side_stereo_frame_count = 0;
 917         encoder->private_->current_sample_number = 0;
 918         encoder->private_->current_frame_number = 0;
 919
 920         encoder->private_->use_wide_by_block = (encoder->protected_->bits_per_sample + FLAC__bitmath_ilog2(encoder->protected_->blocksize)+1 > 30);
 921         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? */
 922         encoder->private_->use_wide_by_partition = (false); /*@@@ need to set this */
 923
 924         /*
 925          * get the CPU info and set the function pointers
 926          */
 927         FLAC__cpu_info(&encoder->private_->cpuinfo);
 928         /* first default to the non-asm routines */
 929 #ifndef FLAC__INTEGER_ONLY_LIBRARY
 930         encoder->private_->local_lpc_compute_autocorrelation = FLAC__lpc_compute_autocorrelation;
 931 #endif
 932         encoder->private_->local_fixed_compute_best_predictor = FLAC__fixed_compute_best_predictor;
 933 #ifndef FLAC__INTEGER_ONLY_LIBRARY
 934         encoder->private_->local_lpc_compute_residual_from_qlp_coefficients = FLAC__lpc_compute_residual_from_qlp_coefficients;
 935         encoder->private_->local_lpc_compute_residual_from_qlp_coefficients_64bit = FLAC__lpc_compute_residual_from_qlp_coefficients_wide;
 936         encoder->private_->local_lpc_compute_residual_from_qlp_coefficients_16bit = FLAC__lpc_compute_residual_from_qlp_coefficients;
 937 #endif
 938         /* now override with asm where appropriate */
 939 #ifndef FLAC__INTEGER_ONLY_LIBRARY
 940 # ifndef FLAC__NO_ASM
 941         if(encoder->private_->cpuinfo.use_asm) {
 942 #  ifdef FLAC__CPU_IA32
 943                 FLAC__ASSERT(encoder->private_->cpuinfo.type == FLAC__CPUINFO_TYPE_IA32);
 944 #   ifdef FLAC__HAS_NASM
 945 #    ifdef FLAC__SSE_OS
 946                 if(encoder->private_->cpuinfo.data.ia32.sse) {
 947                         if(encoder->protected_->max_lpc_order < 4)
 948                                 encoder->private_->local_lpc_compute_autocorrelation = FLAC__lpc_compute_autocorrelation_asm_ia32_sse_lag_4;
 949                         else if(encoder->protected_->max_lpc_order < 8)
 950                                 encoder->private_->local_lpc_compute_autocorrelation = FLAC__lpc_compute_autocorrelation_asm_ia32_sse_lag_8;
 951                         else if(encoder->protected_->max_lpc_order < 12)
 952                                 encoder->private_->local_lpc_compute_autocorrelation = FLAC__lpc_compute_autocorrelation_asm_ia32_sse_lag_12;
 953                         else
 954                                 encoder->private_->local_lpc_compute_autocorrelation = FLAC__lpc_compute_autocorrelation_asm_ia32;
 955                 }
 956                 else
 957 #    endif /* FLAC__SSE_OS */
 958                 if(encoder->private_->cpuinfo.data.ia32._3dnow)
 959                         encoder->private_->local_lpc_compute_autocorrelation = FLAC__lpc_compute_autocorrelation_asm_ia32_3dnow;
 960                 else
 961                         encoder->private_->local_lpc_compute_autocorrelation = FLAC__lpc_compute_autocorrelation_asm_ia32;
 962                 if(encoder->private_->cpuinfo.data.ia32.mmx) {
 963                         encoder->private_->local_lpc_compute_residual_from_qlp_coefficients = FLAC__lpc_compute_residual_from_qlp_coefficients_asm_ia32;
 964                         encoder->private_->local_lpc_compute_residual_from_qlp_coefficients_16bit = FLAC__lpc_compute_residual_from_qlp_coefficients_asm_ia32_mmx;
 965                 }
 966                 else {
 967                         encoder->private_->local_lpc_compute_residual_from_qlp_coefficients = FLAC__lpc_compute_residual_from_qlp_coefficients_asm_ia32;
 968                         encoder->private_->local_lpc_compute_residual_from_qlp_coefficients_16bit = FLAC__lpc_compute_residual_from_qlp_coefficients_asm_ia32;
 969                 }
 970                 if(encoder->private_->cpuinfo.data.ia32.mmx && encoder->private_->cpuinfo.data.ia32.cmov)
 971                         encoder->private_->local_fixed_compute_best_predictor = FLAC__fixed_compute_best_predictor_asm_ia32_mmx_cmov;
 972 #   endif /* FLAC__HAS_NASM */
 973 #  endif /* FLAC__CPU_IA32 */
 974         }
 975 # endif /* !FLAC__NO_ASM */
 976 #endif /* !FLAC__INTEGER_ONLY_LIBRARY */
 977         /* finally override based on wide-ness if necessary */
 978         if(encoder->private_->use_wide_by_block) {
 979                 encoder->private_->local_fixed_compute_best_predictor = FLAC__fixed_compute_best_predictor_wide;
 980         }
 981
 982         /* we require precompute_partition_sums if do_escape_coding because of their intertwined nature */
 983         encoder->private_->precompute_partition_sums = (encoder->protected_->max_residual_partition_order > encoder->protected_->min_residual_partition_order) || encoder->protected_->do_escape_coding;
 984
 985         /* set state to OK; from here on, errors are fatal and we'll override the state then */
 986         encoder->protected_->state = FLAC__STREAM_ENCODER_OK;
 987
 988 #if FLAC__HAS_OGG
 989         encoder->private_->is_ogg = is_ogg;
 990         if(is_ogg && !FLAC__ogg_encoder_aspect_init(&encoder->protected_->ogg_encoder_aspect)) {
 991                 encoder->protected_->state = FLAC__STREAM_ENCODER_OGG_ERROR;
 992                 return FLAC__STREAM_ENCODER_INIT_STATUS_ENCODER_ERROR;
 993         }
 994 #endif
 995
 996         encoder->private_->read_callback = read_callback;
 997         encoder->private_->write_callback = write_callback;
 998         encoder->private_->seek_callback = seek_callback;
 999         encoder->private_->tell_callback = tell_callback;
1000         encoder->private_->metadata_callback = metadata_callback;
1001         encoder->private_->client_data = client_data;
1002
1003         if(!resize_buffers_(encoder, encoder->protected_->blocksize)) {
1004                 /* the above function sets the state for us in case of an error */
1005                 return FLAC__STREAM_ENCODER_INIT_STATUS_ENCODER_ERROR;
1006         }
1007
1008         if(!FLAC__bitbuffer_init(encoder->private_->frame)) {
1009                 encoder->protected_->state = FLAC__STREAM_ENCODER_MEMORY_ALLOCATION_ERROR;
1010                 return FLAC__STREAM_ENCODER_INIT_STATUS_ENCODER_ERROR;
1011         }
1012
1013         /*
1014          * Set up the verify stuff if necessary
1015          */
1016         if(encoder->protected_->verify) {
1017                 /*
1018                  * First, set up the fifo which will hold the
1019                  * original signal to compare against
1020                  */
1021                 encoder->private_->verify.input_fifo.size = encoder->protected_->blocksize;
1022                 for(i = 0; i < encoder->protected_->channels; i++) {
1023                         if(0 == (encoder->private_->verify.input_fifo.data[i] = (FLAC__int32*)malloc(sizeof(FLAC__int32) * encoder->private_->verify.input_fifo.size))) {
1024                                 encoder->protected_->state = FLAC__STREAM_ENCODER_MEMORY_ALLOCATION_ERROR;
1025                                 return FLAC__STREAM_ENCODER_INIT_STATUS_ENCODER_ERROR;
1026                         }
1027                 }
1028                 encoder->private_->verify.input_fifo.tail = 0;
1029
1030                 /*
1031                  * Now set up a stream decoder for verification
1032                  */
1033                 encoder->private_->verify.decoder = FLAC__stream_decoder_new();
1034                 if(0 == encoder->private_->verify.decoder) {
1035                         encoder->protected_->state = FLAC__STREAM_ENCODER_VERIFY_DECODER_ERROR;
1036                         return FLAC__STREAM_ENCODER_INIT_STATUS_ENCODER_ERROR;
1037                 }
1038
1039                 if(FLAC__stream_decoder_init_stream(encoder->private_->verify.decoder, verify_read_callback_, /*seek_callback=*/0, /*tell_callback=*/0, /*length_callback=*/0, /*eof_callback=*/0, verify_write_callback_, verify_metadata_callback_, verify_error_callback_, /*client_data=*/encoder) != FLAC__STREAM_DECODER_INIT_STATUS_OK) {
1040                         encoder->protected_->state = FLAC__STREAM_ENCODER_VERIFY_DECODER_ERROR;
1041                         return FLAC__STREAM_ENCODER_INIT_STATUS_ENCODER_ERROR;
1042                 }
1043         }
1044         encoder->private_->verify.error_stats.absolute_sample = 0;
1045         encoder->private_->verify.error_stats.frame_number = 0;
1046         encoder->private_->verify.error_stats.channel = 0;
1047         encoder->private_->verify.error_stats.sample = 0;
1048         encoder->private_->verify.error_stats.expected = 0;
1049         encoder->private_->verify.error_stats.got = 0;
1050
1051         /*
1052          * These must be done before we write any metadata, because that
1053          * calls the write_callback, which uses these values.
1054          */
1055         encoder->private_->first_seekpoint_to_check = 0;
1056         encoder->private_->samples_written = 0;
1057         encoder->protected_->streaminfo_offset = 0;
1058         encoder->protected_->seektable_offset = 0;
1059         encoder->protected_->audio_offset = 0;
1060
1061         /*
1062          * write the stream header
1063          */
1064         if(encoder->protected_->verify)
1065                 encoder->private_->verify.state_hint = ENCODER_IN_MAGIC;
1066         if(!FLAC__bitbuffer_write_raw_uint32(encoder->private_->frame, FLAC__STREAM_SYNC, FLAC__STREAM_SYNC_LEN)) {
1067                 encoder->protected_->state = FLAC__STREAM_ENCODER_FRAMING_ERROR;
1068                 return FLAC__STREAM_ENCODER_INIT_STATUS_ENCODER_ERROR;
1069         }
1070         if(!write_bitbuffer_(encoder, 0)) {
1071                 /* the above function sets the state for us in case of an error */
1072                 return FLAC__STREAM_ENCODER_INIT_STATUS_ENCODER_ERROR;
1073         }
1074
1075         /*
1076          * write the STREAMINFO metadata block
1077          */
1078         if(encoder->protected_->verify)
1079                 encoder->private_->verify.state_hint = ENCODER_IN_METADATA;
1080         encoder->private_->streaminfo.type = FLAC__METADATA_TYPE_STREAMINFO;
1081         encoder->private_->streaminfo.is_last = false; /* we will have at a minimum a VORBIS_COMMENT afterwards */
1082         encoder->private_->streaminfo.length = FLAC__STREAM_METADATA_STREAMINFO_LENGTH;
1083         encoder->private_->streaminfo.data.stream_info.min_blocksize = encoder->protected_->blocksize; /* this encoder uses the same blocksize for the whole stream */
1084         encoder->private_->streaminfo.data.stream_info.max_blocksize = encoder->protected_->blocksize;
1085         encoder->private_->streaminfo.data.stream_info.min_framesize = 0; /* we don't know this yet; have to fill it in later */
1086         encoder->private_->streaminfo.data.stream_info.max_framesize = 0; /* we don't know this yet; have to fill it in later */
1087         encoder->private_->streaminfo.data.stream_info.sample_rate = encoder->protected_->sample_rate;
1088         encoder->private_->streaminfo.data.stream_info.channels = encoder->protected_->channels;
1089         encoder->private_->streaminfo.data.stream_info.bits_per_sample = encoder->protected_->bits_per_sample;
1090         encoder->private_->streaminfo.data.stream_info.total_samples = encoder->protected_->total_samples_estimate; /* we will replace this later with the real total */
1091         memset(encoder->private_->streaminfo.data.stream_info.md5sum, 0, 16); /* we don't know this yet; have to fill it in later */
1092         FLAC__MD5Init(&encoder->private_->md5context);
1093         if(!FLAC__bitbuffer_clear(encoder->private_->frame)) {
1094                 encoder->protected_->state = FLAC__STREAM_ENCODER_MEMORY_ALLOCATION_ERROR;
1095                 return FLAC__STREAM_ENCODER_INIT_STATUS_ENCODER_ERROR;
1096         }
1097         if(!FLAC__add_metadata_block(&encoder->private_->streaminfo, encoder->private_->frame)) {
1098                 encoder->protected_->state = FLAC__STREAM_ENCODER_FRAMING_ERROR;
1099                 return FLAC__STREAM_ENCODER_INIT_STATUS_ENCODER_ERROR;
1100         }
1101         if(!write_bitbuffer_(encoder, 0)) {
1102                 /* the above function sets the state for us in case of an error */
1103                 return FLAC__STREAM_ENCODER_INIT_STATUS_ENCODER_ERROR;
1104         }
1105
1106         /*
1107          * Now that the STREAMINFO block is written, we can init this to an
1108          * absurdly-high value...
1109          */
1110         encoder->private_->streaminfo.data.stream_info.min_framesize = (1u << FLAC__STREAM_METADATA_STREAMINFO_MIN_FRAME_SIZE_LEN) - 1;
1111         /* ... and clear this to 0 */
1112         encoder->private_->streaminfo.data.stream_info.total_samples = 0;
1113
1114         /*
1115          * Check to see if the supplied metadata contains a VORBIS_COMMENT;
1116          * if not, we will write an empty one (FLAC__add_metadata_block()
1117          * automatically supplies the vendor string).
1118          *
1119          * WATCHOUT: the Ogg FLAC mapping requires us to write this block after
1120          * the STREAMINFO.  (In the case that metadata_has_vorbis_comment is
1121          * true it will have already insured that the metadata list is properly
1122          * ordered.)
1123          */
1124         if(!metadata_has_vorbis_comment) {
1125                 FLAC__StreamMetadata vorbis_comment;
1126                 vorbis_comment.type = FLAC__METADATA_TYPE_VORBIS_COMMENT;
1127                 vorbis_comment.is_last = (encoder->protected_->num_metadata_blocks == 0);
1128                 vorbis_comment.length = 4 + 4; /* MAGIC NUMBER */
1129                 vorbis_comment.data.vorbis_comment.vendor_string.length = 0;
1130                 vorbis_comment.data.vorbis_comment.vendor_string.entry = 0;
1131                 vorbis_comment.data.vorbis_comment.num_comments = 0;
1132                 vorbis_comment.data.vorbis_comment.comments = 0;
1133                 if(!FLAC__bitbuffer_clear(encoder->private_->frame)) {
1134                         encoder->protected_->state = FLAC__STREAM_ENCODER_MEMORY_ALLOCATION_ERROR;
1135                         return FLAC__STREAM_ENCODER_INIT_STATUS_ENCODER_ERROR;
1136                 }
1137                 if(!FLAC__add_metadata_block(&vorbis_comment, encoder->private_->frame)) {
1138                         encoder->protected_->state = FLAC__STREAM_ENCODER_FRAMING_ERROR;
1139                         return FLAC__STREAM_ENCODER_INIT_STATUS_ENCODER_ERROR;
1140                 }
1141                 if(!write_bitbuffer_(encoder, 0)) {
1142                         /* the above function sets the state for us in case of an error */
1143                         return FLAC__STREAM_ENCODER_INIT_STATUS_ENCODER_ERROR;
1144                 }
1145         }
1146
1147         /*
1148          * write the user's metadata blocks
1149          */
1150         for(i = 0; i < encoder->protected_->num_metadata_blocks; i++) {
1151                 encoder->protected_->metadata[i]->is_last = (i == encoder->protected_->num_metadata_blocks - 1);
1152                 if(!FLAC__bitbuffer_clear(encoder->private_->frame)) {
1153                         encoder->protected_->state = FLAC__STREAM_ENCODER_MEMORY_ALLOCATION_ERROR;
1154                         return FLAC__STREAM_ENCODER_INIT_STATUS_ENCODER_ERROR;
1155                 }
1156                 if(!FLAC__add_metadata_block(encoder->protected_->metadata[i], encoder->private_->frame)) {
1157                         encoder->protected_->state = FLAC__STREAM_ENCODER_FRAMING_ERROR;
1158                         return FLAC__STREAM_ENCODER_INIT_STATUS_ENCODER_ERROR;
1159                 }
1160                 if(!write_bitbuffer_(encoder, 0)) {
1161                         /* the above function sets the state for us in case of an error */
1162                         return FLAC__STREAM_ENCODER_INIT_STATUS_ENCODER_ERROR;
1163                 }
1164         }
1165
1166         /* now that all the metadata is written, we save the stream offset */
1167         if(encoder->private_->tell_callback && encoder->private_->tell_callback(encoder, &encoder->protected_->audio_offset, encoder->private_->client_data) == FLAC__STREAM_ENCODER_TELL_STATUS_ERROR) { /* FLAC__STREAM_ENCODER_TELL_STATUS_UNSUPPORTED just means we didn't get the offset; no error */
1168                 encoder->protected_->state = FLAC__STREAM_ENCODER_CLIENT_ERROR;
1169                 return FLAC__STREAM_ENCODER_INIT_STATUS_ENCODER_ERROR;
1170         }
1171
1172         if(encoder->protected_->verify)
1173                 encoder->private_->verify.state_hint = ENCODER_IN_AUDIO;
1174
1175         return FLAC__STREAM_ENCODER_INIT_STATUS_OK;
1176 }
1177
1178 FLAC_API FLAC__StreamEncoderInitStatus FLAC__stream_encoder_init_stream(
1179         FLAC__StreamEncoder *encoder,
1180         FLAC__StreamEncoderWriteCallback write_callback,
1181         FLAC__StreamEncoderSeekCallback seek_callback,
1182         FLAC__StreamEncoderTellCallback tell_callback,
1183         FLAC__StreamEncoderMetadataCallback metadata_callback,
1184         void *client_data
1185 )
1186 {
1187         return init_stream_internal_(
1188                 encoder,
1189                 /*read_callback=*/0,
1190                 write_callback,
1191                 seek_callback,
1192                 tell_callback,
1193                 metadata_callback,
1194                 client_data,
1195                 /*is_ogg=*/false
1196         );
1197 }
1198
1199 FLAC_API FLAC__StreamEncoderInitStatus FLAC__stream_encoder_init_ogg_stream(
1200         FLAC__StreamEncoder *encoder,
1201         FLAC__StreamEncoderReadCallback read_callback,
1202         FLAC__StreamEncoderWriteCallback write_callback,
1203         FLAC__StreamEncoderSeekCallback seek_callback,
1204         FLAC__StreamEncoderTellCallback tell_callback,
1205         FLAC__StreamEncoderMetadataCallback metadata_callback,
1206         void *client_data
1207 )
1208 {
1209         return init_stream_internal_(
1210                 encoder,
1211                 read_callback,
1212                 write_callback,
1213                 seek_callback,
1214                 tell_callback,
1215                 metadata_callback,
1216                 client_data,
1217                 /*is_ogg=*/true
1218         );
1219 }
1220
1221 static FLAC__StreamEncoderInitStatus init_FILE_internal_(
1222         FLAC__StreamEncoder *encoder,
1223         FILE *file,
1224         FLAC__StreamEncoderProgressCallback progress_callback,
1225         void *client_data,
1226         FLAC__bool is_ogg
1227 )
1228 {
1229         FLAC__StreamEncoderInitStatus init_status;
1230
1231         FLAC__ASSERT(0 != encoder);
1232         FLAC__ASSERT(0 != file);
1233
1234         if(encoder->protected_->state != FLAC__STREAM_ENCODER_UNINITIALIZED)
1235                 return FLAC__STREAM_ENCODER_INIT_STATUS_ALREADY_INITIALIZED;
1236
1237         /* double protection */
1238         if(file == 0) {
1239                 encoder->protected_->state = FLAC__STREAM_ENCODER_IO_ERROR;
1240                 return FLAC__STREAM_ENCODER_INIT_STATUS_ENCODER_ERROR;
1241         }
1242
1243         /*
1244          * To make sure that our file does not go unclosed after an error, we
1245          * must assign the FILE pointer before any further error can occur in
1246          * this routine.
1247          */
1248         if(file == stdout)
1249                 file = get_binary_stdout_(); /* just to be safe */
1250
1251         encoder->private_->file = file;
1252
1253         encoder->private_->progress_callback = progress_callback;
1254         encoder->private_->bytes_written = 0;
1255         encoder->private_->samples_written = 0;
1256         encoder->private_->frames_written = 0;
1257
1258         init_status = init_stream_internal_(
1259                 encoder,
1260                 is_ogg? file_read_callback_ : 0,
1261                 file_write_callback_,
1262                 file_seek_callback_,
1263                 file_tell_callback_,
1264                 /*metadata_callback=*/0,
1265                 client_data,
1266                 is_ogg
1267         );
1268         if(init_status != FLAC__STREAM_ENCODER_INIT_STATUS_OK) {
1269                 /* the above function sets the state for us in case of an error */
1270                 return init_status;
1271         }
1272
1273         {
1274                 unsigned blocksize = FLAC__stream_encoder_get_blocksize(encoder);
1275
1276                 FLAC__ASSERT(blocksize != 0);
1277                 encoder->private_->total_frames_estimate = (unsigned)((FLAC__stream_encoder_get_total_samples_estimate(encoder) + blocksize - 1) / blocksize);
1278         }
1279
1280         return init_status;
1281 }
1282
1283 FLAC_API FLAC__StreamEncoderInitStatus FLAC__stream_encoder_init_FILE(
1284         FLAC__StreamEncoder *encoder,
1285         FILE *file,
1286         FLAC__StreamEncoderProgressCallback progress_callback,
1287         void *client_data
1288 )
1289 {
1290         return init_FILE_internal_(encoder, file, progress_callback, client_data, /*is_ogg=*/false);
1291 }
1292
1293 FLAC_API FLAC__StreamEncoderInitStatus FLAC__stream_encoder_init_ogg_FILE(
1294         FLAC__StreamEncoder *encoder,
1295         FILE *file,
1296         FLAC__StreamEncoderProgressCallback progress_callback,
1297         void *client_data
1298 )
1299 {
1300         return init_FILE_internal_(encoder, file, progress_callback, client_data, /*is_ogg=*/true);
1301 }
1302
1303 static FLAC__StreamEncoderInitStatus init_file_internal_(
1304         FLAC__StreamEncoder *encoder,
1305         const char *filename,
1306         FLAC__StreamEncoderProgressCallback progress_callback,
1307         void *client_data,
1308         FLAC__bool is_ogg
1309 )
1310 {
1311         FILE *file;
1312
1313         FLAC__ASSERT(0 != encoder);
1314
1315         /*
1316          * To make sure that our file does not go unclosed after an error, we
1317          * have to do the same entrance checks here that are later performed
1318          * in FLAC__stream_encoder_init_FILE() before the FILE* is assigned.
1319          */
1320         if(encoder->protected_->state != FLAC__STREAM_ENCODER_UNINITIALIZED)
1321                 return FLAC__STREAM_ENCODER_INIT_STATUS_ALREADY_INITIALIZED;
1322
1323         file = filename? fopen(filename, "w+b") : stdout;
1324
1325         if(file == 0) {
1326                 encoder->protected_->state = FLAC__STREAM_ENCODER_IO_ERROR;
1327                 return FLAC__STREAM_ENCODER_INIT_STATUS_ENCODER_ERROR;
1328         }
1329
1330         return init_FILE_internal_(encoder, file, progress_callback, client_data, is_ogg);
1331 }
1332
1333 FLAC_API FLAC__StreamEncoderInitStatus FLAC__stream_encoder_init_file(
1334         FLAC__StreamEncoder *encoder,
1335         const char *filename,
1336         FLAC__StreamEncoderProgressCallback progress_callback,
1337         void *client_data
1338 )
1339 {
1340         return init_file_internal_(encoder, filename, progress_callback, client_data, /*is_ogg=*/false);
1341 }
1342
1343 FLAC_API FLAC__StreamEncoderInitStatus FLAC__stream_encoder_init_ogg_file(
1344         FLAC__StreamEncoder *encoder,
1345         const char *filename,
1346         FLAC__StreamEncoderProgressCallback progress_callback,
1347         void *client_data
1348 )
1349 {
1350         return init_file_internal_(encoder, filename, progress_callback, client_data, /*is_ogg=*/true);
1351 }
1352
1353 FLAC_API void FLAC__stream_encoder_finish(FLAC__StreamEncoder *encoder)
1354 {
1355         FLAC__ASSERT(0 != encoder);
1356         FLAC__ASSERT(0 != encoder->private_);
1357         FLAC__ASSERT(0 != encoder->protected_);
1358
1359         if(encoder->protected_->state == FLAC__STREAM_ENCODER_UNINITIALIZED)
1360                 return;
1361
1362         if(encoder->protected_->state == FLAC__STREAM_ENCODER_OK && !encoder->private_->is_being_deleted) {
1363                 if(encoder->private_->current_sample_number != 0) {
1364                         encoder->protected_->blocksize = encoder->private_->current_sample_number;
1365                         process_frame_(encoder, /*is_fractional_block=*/true);
1366                 }
1367         }
1368
1369         FLAC__MD5Final(encoder->private_->streaminfo.data.stream_info.md5sum, &encoder->private_->md5context);
1370
1371         if(encoder->protected_->state == FLAC__STREAM_ENCODER_OK && !encoder->private_->is_being_deleted) {
1372                 if(encoder->private_->seek_callback) {
1373 #if FLAC__HAS_OGG
1374                         if(encoder->private_->is_ogg)
1375                                 update_ogg_metadata_(encoder);
1376                         else
1377 #endif
1378                         update_metadata_(encoder);
1379                 }
1380                 if(encoder->private_->metadata_callback)
1381                         encoder->private_->metadata_callback(encoder, &encoder->private_->streaminfo, encoder->private_->client_data);
1382         }
1383
1384         if(encoder->protected_->verify && 0 != encoder->private_->verify.decoder)
1385                 FLAC__stream_decoder_finish(encoder->private_->verify.decoder);
1386
1387         if(0 != encoder->private_->file) {
1388                 if(encoder->private_->file != stdout)
1389                         fclose(encoder->private_->file);
1390                 encoder->private_->file = 0;
1391         }
1392
1393 #if FLAC__HAS_OGG
1394         if(encoder->private_->is_ogg)
1395                 FLAC__ogg_encoder_aspect_finish(&encoder->protected_->ogg_encoder_aspect);
1396 #endif
1397
1398         free_(encoder);
1399         set_defaults_(encoder);
1400
1401         encoder->protected_->state = FLAC__STREAM_ENCODER_UNINITIALIZED;
1402 }
1403
1404 FLAC_API FLAC__bool FLAC__stream_encoder_set_ogg_serial_number(FLAC__StreamEncoder *encoder, long value)
1405 {
1406         FLAC__ASSERT(0 != encoder);
1407         FLAC__ASSERT(0 != encoder->private_);
1408         FLAC__ASSERT(0 != encoder->protected_);
1409         if(encoder->protected_->state != FLAC__STREAM_ENCODER_UNINITIALIZED)
1410                 return false;
1411 #ifdef FLAC__HAS_OGG
1412         /* can't check encoder->private_->is_ogg since that's not set until init time */
1413         FLAC__ogg_encoder_aspect_set_serial_number(&encoder->protected_->ogg_encoder_aspect, value);
1414         return true;
1415 #else
1416         (void)value;
1417         return false;
1418 #endif
1419 }
1420
1421 FLAC_API FLAC__bool FLAC__stream_encoder_set_verify(FLAC__StreamEncoder *encoder, FLAC__bool value)
1422 {
1423         FLAC__ASSERT(0 != encoder);
1424         FLAC__ASSERT(0 != encoder->private_);
1425         FLAC__ASSERT(0 != encoder->protected_);
1426         if(encoder->protected_->state != FLAC__STREAM_ENCODER_UNINITIALIZED)
1427                 return false;
1428 #ifndef FLAC__MANDATORY_VERIFY_WHILE_ENCODING
1429         encoder->protected_->verify = value;
1430 #endif
1431         return true;
1432 }
1433
1434 FLAC_API FLAC__bool FLAC__stream_encoder_set_streamable_subset(FLAC__StreamEncoder *encoder, FLAC__bool value)
1435 {
1436         FLAC__ASSERT(0 != encoder);
1437         FLAC__ASSERT(0 != encoder->private_);
1438         FLAC__ASSERT(0 != encoder->protected_);
1439         if(encoder->protected_->state != FLAC__STREAM_ENCODER_UNINITIALIZED)
1440                 return false;
1441         encoder->protected_->streamable_subset = value;
1442         return true;
1443 }
1444
1445 FLAC_API FLAC__bool FLAC__stream_encoder_set_channels(FLAC__StreamEncoder *encoder, unsigned value)
1446 {
1447         FLAC__ASSERT(0 != encoder);
1448         FLAC__ASSERT(0 != encoder->private_);
1449         FLAC__ASSERT(0 != encoder->protected_);
1450         if(encoder->protected_->state != FLAC__STREAM_ENCODER_UNINITIALIZED)
1451                 return false;
1452         encoder->protected_->channels = value;
1453         return true;
1454 }
1455
1456 FLAC_API FLAC__bool FLAC__stream_encoder_set_bits_per_sample(FLAC__StreamEncoder *encoder, unsigned value)
1457 {
1458         FLAC__ASSERT(0 != encoder);
1459         FLAC__ASSERT(0 != encoder->private_);
1460         FLAC__ASSERT(0 != encoder->protected_);
1461         if(encoder->protected_->state != FLAC__STREAM_ENCODER_UNINITIALIZED)
1462                 return false;
1463         encoder->protected_->bits_per_sample = value;
1464         return true;
1465 }
1466
1467 FLAC_API FLAC__bool FLAC__stream_encoder_set_sample_rate(FLAC__StreamEncoder *encoder, unsigned value)
1468 {
1469         FLAC__ASSERT(0 != encoder);
1470         FLAC__ASSERT(0 != encoder->private_);
1471         FLAC__ASSERT(0 != encoder->protected_);
1472         if(encoder->protected_->state != FLAC__STREAM_ENCODER_UNINITIALIZED)
1473                 return false;
1474         encoder->protected_->sample_rate = value;
1475         return true;
1476 }
1477
1478 FLAC_API FLAC__bool FLAC__stream_encoder_set_compression_level(FLAC__StreamEncoder *encoder, unsigned value)
1479 {
1480         FLAC__bool ok = true;
1481         FLAC__ASSERT(0 != encoder);
1482         FLAC__ASSERT(0 != encoder->private_);
1483         FLAC__ASSERT(0 != encoder->protected_);
1484         if(encoder->protected_->state != FLAC__STREAM_ENCODER_UNINITIALIZED)
1485                 return false;
1486         if(value >= sizeof(compression_levels_)/sizeof(compression_levels_[0]))
1487                 value = sizeof(compression_levels_)/sizeof(compression_levels_[0]) - 1;
1488         ok &= FLAC__stream_encoder_set_do_mid_side_stereo          (encoder, compression_levels_[value].do_mid_side_stereo);
1489         ok &= FLAC__stream_encoder_set_loose_mid_side_stereo       (encoder, compression_levels_[value].loose_mid_side_stereo);
1490         ok &= FLAC__stream_encoder_set_apodization                 (encoder, compression_levels_[value].apodization);
1491         ok &= FLAC__stream_encoder_set_max_lpc_order               (encoder, compression_levels_[value].max_lpc_order);
1492         ok &= FLAC__stream_encoder_set_qlp_coeff_precision         (encoder, compression_levels_[value].qlp_coeff_precision);
1493         ok &= FLAC__stream_encoder_set_do_qlp_coeff_prec_search    (encoder, compression_levels_[value].do_qlp_coeff_prec_search);
1494         ok &= FLAC__stream_encoder_set_do_escape_coding            (encoder, compression_levels_[value].do_escape_coding);
1495         ok &= FLAC__stream_encoder_set_do_exhaustive_model_search  (encoder, compression_levels_[value].do_exhaustive_model_search);
1496         ok &= FLAC__stream_encoder_set_min_residual_partition_order(encoder, compression_levels_[value].min_residual_partition_order);
1497         ok &= FLAC__stream_encoder_set_max_residual_partition_order(encoder, compression_levels_[value].max_residual_partition_order);
1498         ok &= FLAC__stream_encoder_set_rice_parameter_search_dist  (encoder, compression_levels_[value].rice_parameter_search_dist);
1499         return ok;
1500 }
1501
1502 FLAC_API FLAC__bool FLAC__stream_encoder_set_blocksize(FLAC__StreamEncoder *encoder, unsigned value)
1503 {
1504         FLAC__ASSERT(0 != encoder);
1505         FLAC__ASSERT(0 != encoder->private_);
1506         FLAC__ASSERT(0 != encoder->protected_);
1507         if(encoder->protected_->state != FLAC__STREAM_ENCODER_UNINITIALIZED)
1508                 return false;
1509         encoder->protected_->blocksize = value;
1510         return true;
1511 }
1512
1513 FLAC_API FLAC__bool FLAC__stream_encoder_set_do_mid_side_stereo(FLAC__StreamEncoder *encoder, FLAC__bool value)
1514 {
1515         FLAC__ASSERT(0 != encoder);
1516         FLAC__ASSERT(0 != encoder->private_);
1517         FLAC__ASSERT(0 != encoder->protected_);
1518         if(encoder->protected_->state != FLAC__STREAM_ENCODER_UNINITIALIZED)
1519                 return false;
1520         encoder->protected_->do_mid_side_stereo = value;
1521         return true;
1522 }
1523
1524 FLAC_API FLAC__bool FLAC__stream_encoder_set_loose_mid_side_stereo(FLAC__StreamEncoder *encoder, FLAC__bool value)
1525 {
1526         FLAC__ASSERT(0 != encoder);
1527         FLAC__ASSERT(0 != encoder->private_);
1528         FLAC__ASSERT(0 != encoder->protected_);
1529         if(encoder->protected_->state != FLAC__STREAM_ENCODER_UNINITIALIZED)
1530                 return false;
1531         encoder->protected_->loose_mid_side_stereo = value;
1532         return true;
1533 }
1534
1535 FLAC_API FLAC__bool FLAC__stream_encoder_set_apodization(FLAC__StreamEncoder *encoder, const char *specification)
1536 {
1537         FLAC__ASSERT(0 != encoder);
1538         FLAC__ASSERT(0 != encoder->private_);
1539         FLAC__ASSERT(0 != encoder->protected_);
1540         FLAC__ASSERT(0 != specification);
1541         if(encoder->protected_->state != FLAC__STREAM_ENCODER_UNINITIALIZED)
1542                 return false;
1543 #ifdef FLAC__INTEGER_ONLY_LIBRARY
1544         (void)specification; /* silently ignore since we haven't integerized; will always use a rectangular window */
1545 #else
1546         encoder->protected_->num_apodizations = 0;
1547         while(1) {
1548                 const char *s = strchr(specification, ';');
1549                 const size_t n = s? (size_t)(s - specification) : strlen(specification);
1550                 if     (n==8  && 0 == strncmp("bartlett"     , specification, n))
1551                         encoder->protected_->apodizations[encoder->protected_->num_apodizations++].type = FLAC__APODIZATION_BARTLETT;
1552                 else if(n==13 && 0 == strncmp("bartlett_hann", specification, n))
1553                         encoder->protected_->apodizations[encoder->protected_->num_apodizations++].type = FLAC__APODIZATION_BARTLETT_HANN;
1554                 else if(n==8  && 0 == strncmp("blackman"     , specification, n))
1555                         encoder->protected_->apodizations[encoder->protected_->num_apodizations++].type = FLAC__APODIZATION_BLACKMAN;
1556                 else if(n==26 && 0 == strncmp("blackman_harris_4term_92db", specification, n))
1557                         encoder->protected_->apodizations[encoder->protected_->num_apodizations++].type = FLAC__APODIZATION_BLACKMAN_HARRIS_4TERM_92DB_SIDELOBE;
1558                 else if(n==6  && 0 == strncmp("connes"       , specification, n))
1559                         encoder->protected_->apodizations[encoder->protected_->num_apodizations++].type = FLAC__APODIZATION_CONNES;
1560                 else if(n==7  && 0 == strncmp("flattop"      , specification, n))
1561                         encoder->protected_->apodizations[encoder->protected_->num_apodizations++].type = FLAC__APODIZATION_FLATTOP;
1562                 else if(n>7   && 0 == strncmp("gauss("       , specification, 6)) {
1563                         FLAC__real stddev = (FLAC__real)strtod(specification+6, 0);
1564                         if (stddev > 0.0 && stddev <= 0.5) {
1565                                 encoder->protected_->apodizations[encoder->protected_->num_apodizations].parameters.gauss.stddev = stddev;
1566                                 encoder->protected_->apodizations[encoder->protected_->num_apodizations++].type = FLAC__APODIZATION_GAUSS;
1567                         }
1568                 }
1569                 else if(n==7  && 0 == strncmp("hamming"      , specification, n))
1570                         encoder->protected_->apodizations[encoder->protected_->num_apodizations++].type = FLAC__APODIZATION_HAMMING;
1571                 else if(n==4  && 0 == strncmp("hann"         , specification, n))
1572                         encoder->protected_->apodizations[encoder->protected_->num_apodizations++].type = FLAC__APODIZATION_HANN;
1573                 else if(n==13 && 0 == strncmp("kaiser_bessel", specification, n))
1574                         encoder->protected_->apodizations[encoder->protected_->num_apodizations++].type = FLAC__APODIZATION_KAISER_BESSEL;
1575                 else if(n==7  && 0 == strncmp("nuttall"      , specification, n))
1576                         encoder->protected_->apodizations[encoder->protected_->num_apodizations++].type = FLAC__APODIZATION_NUTTALL;
1577                 else if(n==9  && 0 == strncmp("rectangle"    , specification, n))
1578                         encoder->protected_->apodizations[encoder->protected_->num_apodizations++].type = FLAC__APODIZATION_RECTANGLE;
1579                 else if(n==8  && 0 == strncmp("triangle"     , specification, n))
1580                         encoder->protected_->apodizations[encoder->protected_->num_apodizations++].type = FLAC__APODIZATION_TRIANGLE;
1581                 else if(n>7   && 0 == strncmp("tukey("       , specification, 6)) {
1582                         FLAC__real p = (FLAC__real)strtod(specification+6, 0);
1583                         if (p >= 0.0 && p <= 1.0) {
1584                                 encoder->protected_->apodizations[encoder->protected_->num_apodizations].parameters.tukey.p = p;
1585                                 encoder->protected_->apodizations[encoder->protected_->num_apodizations++].type = FLAC__APODIZATION_TUKEY;
1586                         }
1587                 }
1588                 else if(n==5  && 0 == strncmp("welch"        , specification, n))
1589                         encoder->protected_->apodizations[encoder->protected_->num_apodizations++].type = FLAC__APODIZATION_WELCH;
1590                 if (encoder->protected_->num_apodizations == 32)
1591                         break;
1592                 if (s)
1593                         specification = s+1;
1594                 else
1595                         break;
1596         }
1597         if(encoder->protected_->num_apodizations == 0) {
1598                 encoder->protected_->num_apodizations = 1;
1599                 encoder->protected_->apodizations[0].type = FLAC__APODIZATION_TUKEY;
1600                 encoder->protected_->apodizations[0].parameters.tukey.p = 0.5;
1601         }
1602 #endif
1603         return true;
1604 }
1605
1606 FLAC_API FLAC__bool FLAC__stream_encoder_set_max_lpc_order(FLAC__StreamEncoder *encoder, unsigned value)
1607 {
1608         FLAC__ASSERT(0 != encoder);
1609         FLAC__ASSERT(0 != encoder->private_);
1610         FLAC__ASSERT(0 != encoder->protected_);
1611         if(encoder->protected_->state != FLAC__STREAM_ENCODER_UNINITIALIZED)
1612                 return false;
1613         encoder->protected_->max_lpc_order = value;
1614         return true;
1615 }
1616
1617 FLAC_API FLAC__bool FLAC__stream_encoder_set_qlp_coeff_precision(FLAC__StreamEncoder *encoder, unsigned value)
1618 {
1619         FLAC__ASSERT(0 != encoder);
1620         FLAC__ASSERT(0 != encoder->private_);
1621         FLAC__ASSERT(0 != encoder->protected_);
1622         if(encoder->protected_->state != FLAC__STREAM_ENCODER_UNINITIALIZED)
1623                 return false;
1624         encoder->protected_->qlp_coeff_precision = value;
1625         return true;
1626 }
1627
1628 FLAC_API FLAC__bool FLAC__stream_encoder_set_do_qlp_coeff_prec_search(FLAC__StreamEncoder *encoder, FLAC__bool value)
1629 {
1630         FLAC__ASSERT(0 != encoder);
1631         FLAC__ASSERT(0 != encoder->private_);
1632         FLAC__ASSERT(0 != encoder->protected_);
1633         if(encoder->protected_->state != FLAC__STREAM_ENCODER_UNINITIALIZED)
1634                 return false;
1635         encoder->protected_->do_qlp_coeff_prec_search = value;
1636         return true;
1637 }
1638
1639 FLAC_API FLAC__bool FLAC__stream_encoder_set_do_escape_coding(FLAC__StreamEncoder *encoder, FLAC__bool value)
1640 {
1641         FLAC__ASSERT(0 != encoder);
1642         FLAC__ASSERT(0 != encoder->private_);
1643         FLAC__ASSERT(0 != encoder->protected_);
1644         if(encoder->protected_->state != FLAC__STREAM_ENCODER_UNINITIALIZED)
1645                 return false;
1646 #if 0
1647         /*@@@ deprecated: */
1648         encoder->protected_->do_escape_coding = value;
1649 #else
1650         (void)value;
1651 #endif
1652         return true;
1653 }
1654
1655 FLAC_API FLAC__bool FLAC__stream_encoder_set_do_exhaustive_model_search(FLAC__StreamEncoder *encoder, FLAC__bool value)
1656 {
1657         FLAC__ASSERT(0 != encoder);
1658         FLAC__ASSERT(0 != encoder->private_);
1659         FLAC__ASSERT(0 != encoder->protected_);
1660         if(encoder->protected_->state != FLAC__STREAM_ENCODER_UNINITIALIZED)
1661                 return false;
1662         encoder->protected_->do_exhaustive_model_search = value;
1663         return true;
1664 }
1665
1666 FLAC_API FLAC__bool FLAC__stream_encoder_set_min_residual_partition_order(FLAC__StreamEncoder *encoder, unsigned value)
1667 {
1668         FLAC__ASSERT(0 != encoder);
1669         FLAC__ASSERT(0 != encoder->private_);
1670         FLAC__ASSERT(0 != encoder->protected_);
1671         if(encoder->protected_->state != FLAC__STREAM_ENCODER_UNINITIALIZED)
1672                 return false;
1673         encoder->protected_->min_residual_partition_order = value;
1674         return true;
1675 }
1676
1677 FLAC_API FLAC__bool FLAC__stream_encoder_set_max_residual_partition_order(FLAC__StreamEncoder *encoder, unsigned value)
1678 {
1679         FLAC__ASSERT(0 != encoder);
1680         FLAC__ASSERT(0 != encoder->private_);
1681         FLAC__ASSERT(0 != encoder->protected_);
1682         if(encoder->protected_->state != FLAC__STREAM_ENCODER_UNINITIALIZED)
1683                 return false;
1684         encoder->protected_->max_residual_partition_order = value;
1685         return true;
1686 }
1687
1688 FLAC_API FLAC__bool FLAC__stream_encoder_set_rice_parameter_search_dist(FLAC__StreamEncoder *encoder, unsigned value)
1689 {
1690         FLAC__ASSERT(0 != encoder);
1691         FLAC__ASSERT(0 != encoder->private_);
1692         FLAC__ASSERT(0 != encoder->protected_);
1693         if(encoder->protected_->state != FLAC__STREAM_ENCODER_UNINITIALIZED)
1694                 return false;
1695 #if 0
1696         /*@@@ deprecated: */
1697         encoder->protected_->rice_parameter_search_dist = value;
1698 #else
1699         (void)value;
1700 #endif
1701         return true;
1702 }
1703
1704 FLAC_API FLAC__bool FLAC__stream_encoder_set_total_samples_estimate(FLAC__StreamEncoder *encoder, FLAC__uint64 value)
1705 {
1706         FLAC__ASSERT(0 != encoder);
1707         FLAC__ASSERT(0 != encoder->private_);
1708         FLAC__ASSERT(0 != encoder->protected_);
1709         if(encoder->protected_->state != FLAC__STREAM_ENCODER_UNINITIALIZED)
1710                 return false;
1711         encoder->protected_->total_samples_estimate = value;
1712         return true;
1713 }
1714
1715 FLAC_API FLAC__bool FLAC__stream_encoder_set_metadata(FLAC__StreamEncoder *encoder, FLAC__StreamMetadata **metadata, unsigned num_blocks)
1716 {
1717         FLAC__ASSERT(0 != encoder);
1718         FLAC__ASSERT(0 != encoder->private_);
1719         FLAC__ASSERT(0 != encoder->protected_);
1720         if(encoder->protected_->state != FLAC__STREAM_ENCODER_UNINITIALIZED)
1721                 return false;
1722         encoder->protected_->metadata = metadata;
1723         encoder->protected_->num_metadata_blocks = num_blocks;
1724 #if FLAC__HAS_OGG
1725         if(!FLAC__ogg_encoder_aspect_set_num_metadata(&encoder->protected_->ogg_encoder_aspect, num_blocks))
1726                 return false;
1727 #endif
1728         return true;
1729 }
1730
1731 /*
1732  * These three functions are not static, but not publically exposed in
1733  * include/FLAC/ either.  They are used by the test suite.
1734  */
1735 FLAC_API FLAC__bool FLAC__stream_encoder_disable_constant_subframes(FLAC__StreamEncoder *encoder, FLAC__bool value)
1736 {
1737         FLAC__ASSERT(0 != encoder);
1738         FLAC__ASSERT(0 != encoder->private_);
1739         FLAC__ASSERT(0 != encoder->protected_);
1740         if(encoder->protected_->state != FLAC__STREAM_ENCODER_UNINITIALIZED)
1741                 return false;
1742         encoder->private_->disable_constant_subframes = value;
1743         return true;
1744 }
1745
1746 FLAC_API FLAC__bool FLAC__stream_encoder_disable_fixed_subframes(FLAC__StreamEncoder *encoder, FLAC__bool value)
1747 {
1748         FLAC__ASSERT(0 != encoder);
1749         FLAC__ASSERT(0 != encoder->private_);
1750         FLAC__ASSERT(0 != encoder->protected_);
1751         if(encoder->protected_->state != FLAC__STREAM_ENCODER_UNINITIALIZED)
1752                 return false;
1753         encoder->private_->disable_fixed_subframes = value;
1754         return true;
1755 }
1756
1757 FLAC_API FLAC__bool FLAC__stream_encoder_disable_verbatim_subframes(FLAC__StreamEncoder *encoder, FLAC__bool value)
1758 {
1759         FLAC__ASSERT(0 != encoder);
1760         FLAC__ASSERT(0 != encoder->private_);
1761         FLAC__ASSERT(0 != encoder->protected_);
1762         if(encoder->protected_->state != FLAC__STREAM_ENCODER_UNINITIALIZED)
1763                 return false;
1764         encoder->private_->disable_verbatim_subframes = value;
1765         return true;
1766 }
1767
1768 FLAC_API FLAC__StreamEncoderState FLAC__stream_encoder_get_state(const FLAC__StreamEncoder *encoder)
1769 {
1770         FLAC__ASSERT(0 != encoder);
1771         FLAC__ASSERT(0 != encoder->private_);
1772         FLAC__ASSERT(0 != encoder->protected_);
1773         return encoder->protected_->state;
1774 }
1775
1776 FLAC_API FLAC__StreamDecoderState FLAC__stream_encoder_get_verify_decoder_state(const FLAC__StreamEncoder *encoder)
1777 {
1778         FLAC__ASSERT(0 != encoder);
1779         FLAC__ASSERT(0 != encoder->private_);
1780         FLAC__ASSERT(0 != encoder->protected_);
1781         if(encoder->protected_->verify)
1782                 return FLAC__stream_decoder_get_state(encoder->private_->verify.decoder);
1783         else
1784                 return FLAC__STREAM_DECODER_UNINITIALIZED;
1785 }
1786
1787 FLAC_API const char *FLAC__stream_encoder_get_resolved_state_string(const FLAC__StreamEncoder *encoder)
1788 {
1789         FLAC__ASSERT(0 != encoder);
1790         FLAC__ASSERT(0 != encoder->private_);
1791         FLAC__ASSERT(0 != encoder->protected_);
1792         if(encoder->protected_->state != FLAC__STREAM_ENCODER_VERIFY_DECODER_ERROR)
1793                 return FLAC__StreamEncoderStateString[encoder->protected_->state];
1794         else
1795                 return FLAC__stream_decoder_get_resolved_state_string(encoder->private_->verify.decoder);
1796 }
1797
1798 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)
1799 {
1800         FLAC__ASSERT(0 != encoder);
1801         FLAC__ASSERT(0 != encoder->private_);
1802         FLAC__ASSERT(0 != encoder->protected_);
1803         if(0 != absolute_sample)
1804                 *absolute_sample = encoder->private_->verify.error_stats.absolute_sample;
1805         if(0 != frame_number)
1806                 *frame_number = encoder->private_->verify.error_stats.frame_number;
1807         if(0 != channel)
1808                 *channel = encoder->private_->verify.error_stats.channel;
1809         if(0 != sample)
1810                 *sample = encoder->private_->verify.error_stats.sample;
1811         if(0 != expected)
1812                 *expected = encoder->private_->verify.error_stats.expected;
1813         if(0 != got)
1814                 *got = encoder->private_->verify.error_stats.got;
1815 }
1816
1817 FLAC_API FLAC__bool FLAC__stream_encoder_get_verify(const FLAC__StreamEncoder *encoder)
1818 {
1819         FLAC__ASSERT(0 != encoder);
1820         FLAC__ASSERT(0 != encoder->private_);
1821         FLAC__ASSERT(0 != encoder->protected_);
1822         return encoder->protected_->verify;
1823 }
1824
1825 FLAC_API FLAC__bool FLAC__stream_encoder_get_streamable_subset(const FLAC__StreamEncoder *encoder)
1826 {
1827         FLAC__ASSERT(0 != encoder);
1828         FLAC__ASSERT(0 != encoder->private_);
1829         FLAC__ASSERT(0 != encoder->protected_);
1830         return encoder->protected_->streamable_subset;
1831 }
1832
1833 FLAC_API unsigned FLAC__stream_encoder_get_channels(const FLAC__StreamEncoder *encoder)
1834 {
1835         FLAC__ASSERT(0 != encoder);
1836         FLAC__ASSERT(0 != encoder->private_);
1837         FLAC__ASSERT(0 != encoder->protected_);
1838         return encoder->protected_->channels;
1839 }
1840
1841 FLAC_API unsigned FLAC__stream_encoder_get_bits_per_sample(const FLAC__StreamEncoder *encoder)
1842 {
1843         FLAC__ASSERT(0 != encoder);
1844         FLAC__ASSERT(0 != encoder->private_);
1845         FLAC__ASSERT(0 != encoder->protected_);
1846         return encoder->protected_->bits_per_sample;
1847 }
1848
1849 FLAC_API unsigned FLAC__stream_encoder_get_sample_rate(const FLAC__StreamEncoder *encoder)
1850 {
1851         FLAC__ASSERT(0 != encoder);
1852         FLAC__ASSERT(0 != encoder->private_);
1853         FLAC__ASSERT(0 != encoder->protected_);
1854         return encoder->protected_->sample_rate;
1855 }
1856
1857 FLAC_API unsigned FLAC__stream_encoder_get_blocksize(const FLAC__StreamEncoder *encoder)
1858 {
1859         FLAC__ASSERT(0 != encoder);
1860         FLAC__ASSERT(0 != encoder->private_);
1861         FLAC__ASSERT(0 != encoder->protected_);
1862         return encoder->protected_->blocksize;
1863 }
1864
1865 FLAC_API FLAC__bool FLAC__stream_encoder_get_do_mid_side_stereo(const FLAC__StreamEncoder *encoder)
1866 {
1867         FLAC__ASSERT(0 != encoder);
1868         FLAC__ASSERT(0 != encoder->private_);
1869         FLAC__ASSERT(0 != encoder->protected_);
1870         return encoder->protected_->do_mid_side_stereo;
1871 }
1872
1873 FLAC_API FLAC__bool FLAC__stream_encoder_get_loose_mid_side_stereo(const FLAC__StreamEncoder *encoder)
1874 {
1875         FLAC__ASSERT(0 != encoder);
1876         FLAC__ASSERT(0 != encoder->private_);
1877         FLAC__ASSERT(0 != encoder->protected_);
1878         return encoder->protected_->loose_mid_side_stereo;
1879 }
1880
1881 FLAC_API unsigned FLAC__stream_encoder_get_max_lpc_order(const FLAC__StreamEncoder *encoder)
1882 {
1883         FLAC__ASSERT(0 != encoder);
1884         FLAC__ASSERT(0 != encoder->private_);
1885         FLAC__ASSERT(0 != encoder->protected_);
1886         return encoder->protected_->max_lpc_order;
1887 }
1888
1889 FLAC_API unsigned FLAC__stream_encoder_get_qlp_coeff_precision(const FLAC__StreamEncoder *encoder)
1890 {
1891         FLAC__ASSERT(0 != encoder);
1892         FLAC__ASSERT(0 != encoder->private_);
1893         FLAC__ASSERT(0 != encoder->protected_);
1894         return encoder->protected_->qlp_coeff_precision;
1895 }
1896
1897 FLAC_API FLAC__bool FLAC__stream_encoder_get_do_qlp_coeff_prec_search(const FLAC__StreamEncoder *encoder)
1898 {
1899         FLAC__ASSERT(0 != encoder);
1900         FLAC__ASSERT(0 != encoder->private_);
1901         FLAC__ASSERT(0 != encoder->protected_);
1902         return encoder->protected_->do_qlp_coeff_prec_search;
1903 }
1904
1905 FLAC_API FLAC__bool FLAC__stream_encoder_get_do_escape_coding(const FLAC__StreamEncoder *encoder)
1906 {
1907         FLAC__ASSERT(0 != encoder);
1908         FLAC__ASSERT(0 != encoder->private_);
1909         FLAC__ASSERT(0 != encoder->protected_);
1910         return encoder->protected_->do_escape_coding;
1911 }
1912
1913 FLAC_API FLAC__bool FLAC__stream_encoder_get_do_exhaustive_model_search(const FLAC__StreamEncoder *encoder)
1914 {
1915         FLAC__ASSERT(0 != encoder);
1916         FLAC__ASSERT(0 != encoder->private_);
1917         FLAC__ASSERT(0 != encoder->protected_);
1918         return encoder->protected_->do_exhaustive_model_search;
1919 }
1920
1921 FLAC_API unsigned FLAC__stream_encoder_get_min_residual_partition_order(const FLAC__StreamEncoder *encoder)
1922 {
1923         FLAC__ASSERT(0 != encoder);
1924         FLAC__ASSERT(0 != encoder->private_);
1925         FLAC__ASSERT(0 != encoder->protected_);
1926         return encoder->protected_->min_residual_partition_order;
1927 }
1928
1929 FLAC_API unsigned FLAC__stream_encoder_get_max_residual_partition_order(const FLAC__StreamEncoder *encoder)
1930 {
1931         FLAC__ASSERT(0 != encoder);
1932         FLAC__ASSERT(0 != encoder->private_);
1933         FLAC__ASSERT(0 != encoder->protected_);
1934         return encoder->protected_->max_residual_partition_order;
1935 }
1936
1937 FLAC_API unsigned FLAC__stream_encoder_get_rice_parameter_search_dist(const FLAC__StreamEncoder *encoder)
1938 {
1939         FLAC__ASSERT(0 != encoder);
1940         FLAC__ASSERT(0 != encoder->private_);
1941         FLAC__ASSERT(0 != encoder->protected_);
1942         return encoder->protected_->rice_parameter_search_dist;
1943 }
1944
1945 FLAC_API FLAC__uint64 FLAC__stream_encoder_get_total_samples_estimate(const FLAC__StreamEncoder *encoder)
1946 {
1947         FLAC__ASSERT(0 != encoder);
1948         FLAC__ASSERT(0 != encoder->private_);
1949         FLAC__ASSERT(0 != encoder->protected_);
1950         return encoder->protected_->total_samples_estimate;
1951 }
1952
1953 FLAC_API FLAC__bool FLAC__stream_encoder_process(FLAC__StreamEncoder *encoder, const FLAC__int32 * const buffer[], unsigned samples)
1954 {
1955         unsigned i, j, channel;
1956         FLAC__int32 x, mid, side;
1957         const unsigned channels = encoder->protected_->channels, blocksize = encoder->protected_->blocksize;
1958
1959         FLAC__ASSERT(0 != encoder);
1960         FLAC__ASSERT(0 != encoder->private_);
1961         FLAC__ASSERT(0 != encoder->protected_);
1962         FLAC__ASSERT(encoder->protected_->state == FLAC__STREAM_ENCODER_OK);
1963
1964         j = 0;
1965         /*
1966          * we have several flavors of the same basic loop, optimized for
1967          * different conditions:
1968          */
1969         if(encoder->protected_->max_lpc_order > 0) {
1970                 if(encoder->protected_->do_mid_side_stereo && channels == 2) {
1971                         /*
1972                          * stereo coding: unroll channel loop
1973                          * with LPC: calculate floating point version of signal
1974                          */
1975                         do {
1976                                 if(encoder->protected_->verify)
1977                                         append_to_verify_fifo_(&encoder->private_->verify.input_fifo, buffer, j, channels, min(blocksize-encoder->private_->current_sample_number, samples-j));
1978
1979                                 for(i = encoder->private_->current_sample_number; i < blocksize && j < samples; i++, j++) {
1980                                         x = mid = side = buffer[0][j];
1981                                         encoder->private_->integer_signal[0][i] = x;
1982 #ifndef FLAC__INTEGER_ONLY_LIBRARY
1983                                         encoder->private_->real_signal[0][i] = (FLAC__real)x;
1984 #endif
1985                                         x = buffer[1][j];
1986                                         encoder->private_->integer_signal[1][i] = x;
1987 #ifndef FLAC__INTEGER_ONLY_LIBRARY
1988                                         encoder->private_->real_signal[1][i] = (FLAC__real)x;
1989 #endif
1990                                         mid += x;
1991                                         side -= x;
1992                                         mid >>= 1; /* NOTE: not the same as 'mid = (buffer[0][j] + buffer[1][j]) / 2' ! */
1993                                         encoder->private_->integer_signal_mid_side[1][i] = side;
1994                                         encoder->private_->integer_signal_mid_side[0][i] = mid;
1995 #ifndef FLAC__INTEGER_ONLY_LIBRARY
1996                                         encoder->private_->real_signal_mid_side[1][i] = (FLAC__real)side;
1997                                         encoder->private_->real_signal_mid_side[0][i] = (FLAC__real)mid;
1998 #endif
1999                                         encoder->private_->current_sample_number++;
2000                                 }
2001                                 if(i == blocksize) {
2002                                         if(!process_frame_(encoder, /*is_fractional_block=*/false))
2003                                                 return false;
2004                                 }
2005                         } while(j < samples);
2006                 }
2007                 else {
2008                         /*
2009                          * independent channel coding: buffer each channel in inner loop
2010                          * with LPC: calculate floating point version of signal
2011                          */
2012                         do {
2013                                 if(encoder->protected_->verify)
2014                                         append_to_verify_fifo_(&encoder->private_->verify.input_fifo, buffer, j, channels, min(blocksize-encoder->private_->current_sample_number, samples-j));
2015
2016                                 for(i = encoder->private_->current_sample_number; i < blocksize && j < samples; i++, j++) {
2017                                         for(channel = 0; channel < channels; channel++) {
2018                                                 x = buffer[channel][j];
2019                                                 encoder->private_->integer_signal[channel][i] = x;
2020 #ifndef FLAC__INTEGER_ONLY_LIBRARY
2021                                                 encoder->private_->real_signal[channel][i] = (FLAC__real)x;
2022 #endif
2023                                         }
2024                                         encoder->private_->current_sample_number++;
2025                                 }
2026                                 if(i == blocksize) {
2027                                         if(!process_frame_(encoder, /*is_fractional_block=*/false))
2028                                                 return false;
2029                                 }
2030                         } while(j < samples);
2031                 }
2032         }
2033         else {
2034                 if(encoder->protected_->do_mid_side_stereo && channels == 2) {
2035                         /*
2036                          * stereo coding: unroll channel loop
2037                          * without LPC: no need to calculate floating point version of signal
2038                          */
2039                         do {
2040                                 if(encoder->protected_->verify)
2041                                         append_to_verify_fifo_(&encoder->private_->verify.input_fifo, buffer, j, channels, min(blocksize-encoder->private_->current_sample_number, samples-j));
2042
2043                                 for(i = encoder->private_->current_sample_number; i < blocksize && j < samples; i++, j++) {
2044                                         encoder->private_->integer_signal[0][i] = mid = side = buffer[0][j];
2045                                         x = buffer[1][j];
2046                                         encoder->private_->integer_signal[1][i] = x;
2047                                         mid += x;
2048                                         side -= x;
2049                                         mid >>= 1; /* NOTE: not the same as 'mid = (buffer[0][j] + buffer[1][j]) / 2' ! */
2050                                         encoder->private_->integer_signal_mid_side[1][i] = side;
2051                                         encoder->private_->integer_signal_mid_side[0][i] = mid;
2052                                         encoder->private_->current_sample_number++;
2053                                 }
2054                                 if(i == blocksize) {
2055                                         if(!process_frame_(encoder, /*is_fractional_block=*/false))
2056                                                 return false;
2057                                 }
2058                         } while(j < samples);
2059                 }
2060                 else {
2061                         /*
2062                          * independent channel coding: buffer each channel in inner loop
2063                          * without LPC: no need to calculate floating point version of signal
2064                          */
2065                         do {
2066                                 if(encoder->protected_->verify)
2067                                         append_to_verify_fifo_(&encoder->private_->verify.input_fifo, buffer, j, channels, min(blocksize-encoder->private_->current_sample_number, samples-j));
2068
2069                                 for(i = encoder->private_->current_sample_number; i < blocksize && j < samples; i++, j++) {
2070                                         for(channel = 0; channel < channels; channel++)
2071                                                 encoder->private_->integer_signal[channel][i] = buffer[channel][j];
2072                                         encoder->private_->current_sample_number++;
2073                                 }
2074                                 if(i == blocksize) {
2075                                         if(!process_frame_(encoder, /*is_fractional_block=*/false))
2076                                                 return false;
2077                                 }
2078                         } while(j < samples);
2079                 }
2080         }
2081
2082         return true;
2083 }
2084
2085 FLAC_API FLAC__bool FLAC__stream_encoder_process_interleaved(FLAC__StreamEncoder *encoder, const FLAC__int32 buffer[], unsigned samples)
2086 {
2087         unsigned i, j, k, channel;
2088         FLAC__int32 x, mid, side;
2089         const unsigned channels = encoder->protected_->channels, blocksize = encoder->protected_->blocksize;
2090
2091         FLAC__ASSERT(0 != encoder);
2092         FLAC__ASSERT(0 != encoder->private_);
2093         FLAC__ASSERT(0 != encoder->protected_);
2094         FLAC__ASSERT(encoder->protected_->state == FLAC__STREAM_ENCODER_OK);
2095
2096         j = k = 0;
2097         /*
2098          * we have several flavors of the same basic loop, optimized for
2099          * different conditions:
2100          */
2101         if(encoder->protected_->max_lpc_order > 0) {
2102                 if(encoder->protected_->do_mid_side_stereo && channels == 2) {
2103                         /*
2104                          * stereo coding: unroll channel loop
2105                          * with LPC: calculate floating point version of signal
2106                          */
2107                         do {
2108                                 if(encoder->protected_->verify)
2109                                         append_to_verify_fifo_interleaved_(&encoder->private_->verify.input_fifo, buffer, j, channels, min(blocksize-encoder->private_->current_sample_number, samples-j));
2110
2111                                 for(i = encoder->private_->current_sample_number; i < blocksize && j < samples; i++, j++) {
2112                                         x = mid = side = buffer[k++];
2113                                         encoder->private_->integer_signal[0][i] = x;
2114 #ifndef FLAC__INTEGER_ONLY_LIBRARY
2115                                         encoder->private_->real_signal[0][i] = (FLAC__real)x;
2116 #endif
2117                                         x = buffer[k++];
2118                                         encoder->private_->integer_signal[1][i] = x;
2119 #ifndef FLAC__INTEGER_ONLY_LIBRARY
2120                                         encoder->private_->real_signal[1][i] = (FLAC__real)x;
2121 #endif
2122                                         mid += x;
2123                                         side -= x;
2124                                         mid >>= 1; /* NOTE: not the same as 'mid = (left + right) / 2' ! */
2125                                         encoder->private_->integer_signal_mid_side[1][i] = side;
2126                                         encoder->private_->integer_signal_mid_side[0][i] = mid;
2127 #ifndef FLAC__INTEGER_ONLY_LIBRARY
2128                                         encoder->private_->real_signal_mid_side[1][i] = (FLAC__real)side;
2129                                         encoder->private_->real_signal_mid_side[0][i] = (FLAC__real)mid;
2130 #endif
2131                                         encoder->private_->current_sample_number++;
2132                                 }
2133                                 if(i == blocksize) {
2134                                         if(!process_frame_(encoder, /*is_fractional_block=*/false))
2135                                                 return false;
2136                                 }
2137                         } while(j < samples);
2138                 }
2139                 else {
2140                         /*
2141                          * independent channel coding: buffer each channel in inner loop
2142                          * with LPC: calculate floating point version of signal
2143                          */
2144                         do {
2145                                 if(encoder->protected_->verify)
2146                                         append_to_verify_fifo_interleaved_(&encoder->private_->verify.input_fifo, buffer, j, channels, min(blocksize-encoder->private_->current_sample_number, samples-j));
2147
2148                                 for(i = encoder->private_->current_sample_number; i < blocksize && j < samples; i++, j++) {
2149                                         for(channel = 0; channel < channels; channel++) {
2150                                                 x = buffer[k++];
2151                                                 encoder->private_->integer_signal[channel][i] = x;
2152 #ifndef FLAC__INTEGER_ONLY_LIBRARY
2153                                                 encoder->private_->real_signal[channel][i] = (FLAC__real)x;
2154 #endif
2155                                         }
2156                                         encoder->private_->current_sample_number++;
2157                                 }
2158                                 if(i == blocksize) {
2159                                         if(!process_frame_(encoder, /*is_fractional_block=*/false))
2160                                                 return false;
2161                                 }
2162                         } while(j < samples);
2163                 }
2164         }
2165         else {
2166                 if(encoder->protected_->do_mid_side_stereo && channels == 2) {
2167                         /*
2168                          * stereo coding: unroll channel loop
2169                          * without LPC: no need to calculate floating point version of signal
2170                          */
2171                         do {
2172                                 if(encoder->protected_->verify)
2173                                         append_to_verify_fifo_interleaved_(&encoder->private_->verify.input_fifo, buffer, j, channels, min(blocksize-encoder->private_->current_sample_number, samples-j));
2174
2175                                 for(i = encoder->private_->current_sample_number; i < blocksize && j < samples; i++, j++) {
2176                                         encoder->private_->integer_signal[0][i] = mid = side = buffer[k++];
2177                                         x = buffer[k++];
2178                                         encoder->private_->integer_signal[1][i] = x;
2179                                         mid += x;
2180                                         side -= x;
2181                                         mid >>= 1; /* NOTE: not the same as 'mid = (left + right) / 2' ! */
2182                                         encoder->private_->integer_signal_mid_side[1][i] = side;
2183                                         encoder->private_->integer_signal_mid_side[0][i] = mid;
2184                                         encoder->private_->current_sample_number++;
2185                                 }
2186                                 if(i == blocksize) {
2187                                         if(!process_frame_(encoder, /*is_fractional_block=*/false))
2188                                                 return false;
2189                                 }
2190                         } while(j < samples);
2191                 }
2192                 else {
2193                         /*
2194                          * independent channel coding: buffer each channel in inner loop
2195                          * without LPC: no need to calculate floating point version of signal
2196                          */
2197                         do {
2198                                 if(encoder->protected_->verify)
2199                                         append_to_verify_fifo_interleaved_(&encoder->private_->verify.input_fifo, buffer, j, channels, min(blocksize-encoder->private_->current_sample_number, samples-j));
2200
2201                                 for(i = encoder->private_->current_sample_number; i < blocksize && j < samples; i++, j++) {
2202                                         for(channel = 0; channel < channels; channel++)
2203                                                 encoder->private_->integer_signal[channel][i] = buffer[k++];
2204                                         encoder->private_->current_sample_number++;
2205                                 }
2206                                 if(i == blocksize) {
2207                                         if(!process_frame_(encoder, /*is_fractional_block=*/false))
2208                                                 return false;
2209                                 }
2210                         } while(j < samples);
2211                 }
2212         }
2213
2214         return true;
2215 }
2216
2217 /***********************************************************************
2218  *
2219  * Private class methods
2220  *
2221  ***********************************************************************/
2222
2223 void set_defaults_(FLAC__StreamEncoder *encoder)
2224 {
2225         FLAC__ASSERT(0 != encoder);
2226
2227 #ifdef FLAC__MANDATORY_VERIFY_WHILE_ENCODING
2228         encoder->protected_->verify = true;
2229 #else
2230         encoder->protected_->verify = false;
2231 #endif
2232         encoder->protected_->streamable_subset = true;
2233         encoder->protected_->do_mid_side_stereo = false;
2234         encoder->protected_->loose_mid_side_stereo = false;
2235         encoder->protected_->channels = 2;
2236         encoder->protected_->bits_per_sample = 16;
2237         encoder->protected_->sample_rate = 44100;
2238         encoder->protected_->blocksize = 0;
2239 #ifndef FLAC__INTEGER_ONLY_LIBRARY
2240         encoder->protected_->num_apodizations = 1;
2241         encoder->protected_->apodizations[0].type = FLAC__APODIZATION_TUKEY;
2242         encoder->protected_->apodizations[0].parameters.tukey.p = 0.5;
2243 #endif
2244         encoder->protected_->max_lpc_order = 0;
2245         encoder->protected_->qlp_coeff_precision = 0;
2246         encoder->protected_->do_qlp_coeff_prec_search = false;
2247         encoder->protected_->do_exhaustive_model_search = false;
2248         encoder->protected_->do_escape_coding = false;
2249         encoder->protected_->min_residual_partition_order = 0;
2250         encoder->protected_->max_residual_partition_order = 0;
2251         encoder->protected_->rice_parameter_search_dist = 0;
2252         encoder->protected_->total_samples_estimate = 0;
2253         encoder->protected_->metadata = 0;
2254         encoder->protected_->num_metadata_blocks = 0;
2255
2256         encoder->private_->seek_table = 0;
2257         encoder->private_->disable_constant_subframes = false;
2258         encoder->private_->disable_fixed_subframes = false;
2259         encoder->private_->disable_verbatim_subframes = false;
2260 #if FLAC__HAS_OGG
2261         encoder->private_->is_ogg = false;
2262 #endif
2263         encoder->private_->read_callback = 0;
2264         encoder->private_->write_callback = 0;
2265         encoder->private_->seek_callback = 0;
2266         encoder->private_->tell_callback = 0;
2267         encoder->private_->metadata_callback = 0;
2268         encoder->private_->progress_callback = 0;
2269         encoder->private_->client_data = 0;
2270
2271 #if FLAC__HAS_OGG
2272         FLAC__ogg_encoder_aspect_set_defaults(&encoder->protected_->ogg_encoder_aspect);
2273 #endif
2274 }
2275
2276 void free_(FLAC__StreamEncoder *encoder)
2277 {
2278         unsigned i, channel;
2279
2280         FLAC__ASSERT(0 != encoder);
2281         for(i = 0; i < encoder->protected_->channels; i++) {
2282                 if(0 != encoder->private_->integer_signal_unaligned[i]) {
2283                         free(encoder->private_->integer_signal_unaligned[i]);
2284                         encoder->private_->integer_signal_unaligned[i] = 0;
2285                 }
2286 #ifndef FLAC__INTEGER_ONLY_LIBRARY
2287                 if(0 != encoder->private_->real_signal_unaligned[i]) {
2288                         free(encoder->private_->real_signal_unaligned[i]);
2289                         encoder->private_->real_signal_unaligned[i] = 0;
2290                 }
2291 #endif
2292         }
2293         for(i = 0; i < 2; i++) {
2294                 if(0 != encoder->private_->integer_signal_mid_side_unaligned[i]) {
2295                         free(encoder->private_->integer_signal_mid_side_unaligned[i]);
2296                         encoder->private_->integer_signal_mid_side_unaligned[i] = 0;
2297                 }
2298 #ifndef FLAC__INTEGER_ONLY_LIBRARY
2299                 if(0 != encoder->private_->real_signal_mid_side_unaligned[i]) {
2300                         free(encoder->private_->real_signal_mid_side_unaligned[i]);
2301                         encoder->private_->real_signal_mid_side_unaligned[i] = 0;
2302                 }
2303 #endif
2304         }
2305 #ifndef FLAC__INTEGER_ONLY_LIBRARY
2306         for(i = 0; i < encoder->protected_->num_apodizations; i++) {
2307                 if(0 != encoder->private_->window_unaligned[i]) {
2308                         free(encoder->private_->window_unaligned[i]);
2309                         encoder->private_->window_unaligned[i] = 0;
2310                 }
2311         }
2312         if(0 != encoder->private_->windowed_signal_unaligned) {
2313                 free(encoder->private_->windowed_signal_unaligned);
2314                 encoder->private_->windowed_signal_unaligned = 0;
2315         }
2316 #endif
2317         for(channel = 0; channel < encoder->protected_->channels; channel++) {
2318                 for(i = 0; i < 2; i++) {
2319                         if(0 != encoder->private_->residual_workspace_unaligned[channel][i]) {
2320                                 free(encoder->private_->residual_workspace_unaligned[channel][i]);
2321                                 encoder->private_->residual_workspace_unaligned[channel][i] = 0;
2322                         }
2323                 }
2324         }
2325         for(channel = 0; channel < 2; channel++) {
2326                 for(i = 0; i < 2; i++) {
2327                         if(0 != encoder->private_->residual_workspace_mid_side_unaligned[channel][i]) {
2328                                 free(encoder->private_->residual_workspace_mid_side_unaligned[channel][i]);
2329                                 encoder->private_->residual_workspace_mid_side_unaligned[channel][i] = 0;
2330                         }
2331                 }
2332         }
2333         if(0 != encoder->private_->abs_residual_unaligned) {
2334                 free(encoder->private_->abs_residual_unaligned);
2335                 encoder->private_->abs_residual_unaligned = 0;
2336         }
2337         if(0 != encoder->private_->abs_residual_partition_sums_unaligned) {
2338                 free(encoder->private_->abs_residual_partition_sums_unaligned);
2339                 encoder->private_->abs_residual_partition_sums_unaligned = 0;
2340         }
2341         if(0 != encoder->private_->raw_bits_per_partition_unaligned) {
2342                 free(encoder->private_->raw_bits_per_partition_unaligned);
2343                 encoder->private_->raw_bits_per_partition_unaligned = 0;
2344         }
2345         if(encoder->protected_->verify) {
2346                 for(i = 0; i < encoder->protected_->channels; i++) {
2347                         if(0 != encoder->private_->verify.input_fifo.data[i]) {
2348                                 free(encoder->private_->verify.input_fifo.data[i]);
2349                                 encoder->private_->verify.input_fifo.data[i] = 0;
2350                         }
2351                 }
2352         }
2353         FLAC__bitbuffer_free(encoder->private_->frame);
2354 }
2355
2356 FLAC__bool resize_buffers_(FLAC__StreamEncoder *encoder, unsigned new_blocksize)
2357 {
2358         FLAC__bool ok;
2359         unsigned i, channel;
2360
2361         FLAC__ASSERT(new_blocksize > 0);
2362         FLAC__ASSERT(encoder->protected_->state == FLAC__STREAM_ENCODER_OK);
2363         FLAC__ASSERT(encoder->private_->current_sample_number == 0);
2364
2365         /* To avoid excessive malloc'ing, we only grow the buffer; no shrinking. */
2366         if(new_blocksize <= encoder->private_->input_capacity)
2367                 return true;
2368
2369         ok = true;
2370
2371         /* WATCHOUT: FLAC__lpc_compute_residual_from_qlp_coefficients_asm_ia32_mmx()
2372          * requires that the input arrays (in our case the integer signals)
2373          * have a buffer of up to 3 zeroes in front (at negative indices) for
2374          * alignment purposes; we use 4 in front to keep the data well-aligned.
2375          */
2376
2377         for(i = 0; ok && i < encoder->protected_->channels; i++) {
2378                 ok = ok && FLAC__memory_alloc_aligned_int32_array(new_blocksize+4, &encoder->private_->integer_signal_unaligned[i], &encoder->private_->integer_signal[i]);
2379                 memset(encoder->private_->integer_signal[i], 0, sizeof(FLAC__int32)*4);
2380                 encoder->private_->integer_signal[i] += 4;
2381 #ifndef FLAC__INTEGER_ONLY_LIBRARY
2382                 if(encoder->protected_->max_lpc_order > 0)
2383                         ok = ok && FLAC__memory_alloc_aligned_real_array(new_blocksize, &encoder->private_->real_signal_unaligned[i], &encoder->private_->real_signal[i]);
2384 #endif
2385         }
2386         for(i = 0; ok && i < 2; i++) {
2387                 ok = ok && FLAC__memory_alloc_aligned_int32_array(new_blocksize+4, &encoder->private_->integer_signal_mid_side_unaligned[i], &encoder->private_->integer_signal_mid_side[i]);
2388                 memset(encoder->private_->integer_signal_mid_side[i], 0, sizeof(FLAC__int32)*4);
2389                 encoder->private_->integer_signal_mid_side[i] += 4;
2390 #ifndef FLAC__INTEGER_ONLY_LIBRARY
2391                 if(encoder->protected_->max_lpc_order > 0)
2392                         ok = ok && FLAC__memory_alloc_aligned_real_array(new_blocksize, &encoder->private_->real_signal_mid_side_unaligned[i], &encoder->private_->real_signal_mid_side[i]);
2393 #endif
2394         }
2395 #ifndef FLAC__INTEGER_ONLY_LIBRARY
2396         if(ok && encoder->protected_->max_lpc_order > 0) {
2397                 for(i = 0; ok && i < encoder->protected_->num_apodizations; i++)
2398                         ok = ok && FLAC__memory_alloc_aligned_real_array(new_blocksize, &encoder->private_->window_unaligned[i], &encoder->private_->window[i]);
2399                 ok = ok && FLAC__memory_alloc_aligned_real_array(new_blocksize, &encoder->private_->windowed_signal_unaligned, &encoder->private_->windowed_signal);
2400         }
2401 #endif
2402         for(channel = 0; ok && channel < encoder->protected_->channels; channel++) {
2403                 for(i = 0; ok && i < 2; i++) {
2404                         ok = ok && FLAC__memory_alloc_aligned_int32_array(new_blocksize, &encoder->private_->residual_workspace_unaligned[channel][i], &encoder->private_->residual_workspace[channel][i]);
2405                 }
2406         }
2407         for(channel = 0; ok && channel < 2; channel++) {
2408                 for(i = 0; ok && i < 2; i++) {
2409                         ok = ok && FLAC__memory_alloc_aligned_int32_array(new_blocksize, &encoder->private_->residual_workspace_mid_side_unaligned[channel][i], &encoder->private_->residual_workspace_mid_side[channel][i]);
2410                 }
2411         }
2412         ok = ok && FLAC__memory_alloc_aligned_uint32_array(new_blocksize, &encoder->private_->abs_residual_unaligned, &encoder->private_->abs_residual);
2413         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 */
2414                 ok = ok && FLAC__memory_alloc_aligned_uint64_array(new_blocksize * 2, &encoder->private_->abs_residual_partition_sums_unaligned, &encoder->private_->abs_residual_partition_sums);
2415         if(encoder->protected_->do_escape_coding)
2416                 ok = ok && FLAC__memory_alloc_aligned_unsigned_array(new_blocksize * 2, &encoder->private_->raw_bits_per_partition_unaligned, &encoder->private_->raw_bits_per_partition);
2417
2418         /* now adjust the windows if the blocksize has changed */
2419 #ifndef FLAC__INTEGER_ONLY_LIBRARY
2420         if(ok && new_blocksize != encoder->private_->input_capacity && encoder->protected_->max_lpc_order > 0) {
2421                 for(i = 0; ok && i < encoder->protected_->num_apodizations; i++) {
2422                         switch(encoder->protected_->apodizations[i].type) {
2423                                 case FLAC__APODIZATION_BARTLETT:
2424                                         FLAC__window_bartlett(encoder->private_->window[i], new_blocksize);
2425                                         break;
2426                                 case FLAC__APODIZATION_BARTLETT_HANN:
2427                                         FLAC__window_bartlett_hann(encoder->private_->window[i], new_blocksize);
2428                                         break;
2429                                 case FLAC__APODIZATION_BLACKMAN:
2430                                         FLAC__window_blackman(encoder->private_->window[i], new_blocksize);
2431                                         break;
2432                                 case FLAC__APODIZATION_BLACKMAN_HARRIS_4TERM_92DB_SIDELOBE:
2433                                         FLAC__window_blackman_harris_4term_92db_sidelobe(encoder->private_->window[i], new_blocksize);
2434                                         break;
2435                                 case FLAC__APODIZATION_CONNES:
2436                                         FLAC__window_connes(encoder->private_->window[i], new_blocksize);
2437                                         break;
2438                                 case FLAC__APODIZATION_FLATTOP:
2439                                         FLAC__window_flattop(encoder->private_->window[i], new_blocksize);
2440                                         break;
2441                                 case FLAC__APODIZATION_GAUSS:
2442                                         FLAC__window_gauss(encoder->private_->window[i], new_blocksize, encoder->protected_->apodizations[i].parameters.gauss.stddev);
2443                                         break;
2444                                 case FLAC__APODIZATION_HAMMING:
2445                                         FLAC__window_hamming(encoder->private_->window[i], new_blocksize);
2446                                         break;
2447                                 case FLAC__APODIZATION_HANN:
2448                                         FLAC__window_hann(encoder->private_->window[i], new_blocksize);
2449                                         break;
2450                                 case FLAC__APODIZATION_KAISER_BESSEL:
2451                                         FLAC__window_kaiser_bessel(encoder->private_->window[i], new_blocksize);
2452                                         break;
2453                                 case FLAC__APODIZATION_NUTTALL:
2454                                         FLAC__window_nuttall(encoder->private_->window[i], new_blocksize);
2455                                         break;
2456                                 case FLAC__APODIZATION_RECTANGLE:
2457                                         FLAC__window_rectangle(encoder->private_->window[i], new_blocksize);
2458                                         break;
2459                                 case FLAC__APODIZATION_TRIANGLE:
2460                                         FLAC__window_triangle(encoder->private_->window[i], new_blocksize);
2461                                         break;
2462                                 case FLAC__APODIZATION_TUKEY:
2463                                         FLAC__window_tukey(encoder->private_->window[i], new_blocksize, encoder->protected_->apodizations[i].parameters.tukey.p);
2464                                         break;
2465                                 case FLAC__APODIZATION_WELCH:
2466                                         FLAC__window_welch(encoder->private_->window[i], new_blocksize);
2467                                         break;
2468                                 default:
2469                                         FLAC__ASSERT(0);
2470                                         /* double protection */
2471                                         FLAC__window_hann(encoder->private_->window[i], new_blocksize);
2472                                         break;
2473                         }
2474                 }
2475         }
2476 #endif
2477
2478         if(ok)
2479                 encoder->private_->input_capacity = new_blocksize;
2480         else
2481                 encoder->protected_->state = FLAC__STREAM_ENCODER_MEMORY_ALLOCATION_ERROR;
2482
2483         return ok;
2484 }
2485
2486 FLAC__bool write_bitbuffer_(FLAC__StreamEncoder *encoder, unsigned samples)
2487 {
2488         const FLAC__byte *buffer;
2489         size_t bytes;
2490
2491         FLAC__ASSERT(FLAC__bitbuffer_is_byte_aligned(encoder->private_->frame));
2492
2493         FLAC__bitbuffer_get_buffer(encoder->private_->frame, &buffer, &bytes);
2494
2495         if(encoder->protected_->verify) {
2496                 encoder->private_->verify.output.data = buffer;
2497                 encoder->private_->verify.output.bytes = bytes;
2498                 if(encoder->private_->verify.state_hint == ENCODER_IN_MAGIC) {
2499                         encoder->private_->verify.needs_magic_hack = true;
2500                 }
2501                 else {
2502                         if(!FLAC__stream_decoder_process_single(encoder->private_->verify.decoder)) {
2503                                 FLAC__bitbuffer_release_buffer(encoder->private_->frame);
2504                                 if(encoder->protected_->state != FLAC__STREAM_ENCODER_VERIFY_MISMATCH_IN_AUDIO_DATA)
2505                                         encoder->protected_->state = FLAC__STREAM_ENCODER_VERIFY_DECODER_ERROR;
2506                                 return false;
2507                         }
2508                 }
2509         }
2510
2511         if(write_frame_(encoder, buffer, bytes, samples) != FLAC__STREAM_ENCODER_WRITE_STATUS_OK) {
2512                 FLAC__bitbuffer_release_buffer(encoder->private_->frame);
2513                 encoder->protected_->state = FLAC__STREAM_ENCODER_CLIENT_ERROR;
2514                 return false;
2515         }
2516
2517         FLAC__bitbuffer_release_buffer(encoder->private_->frame);
2518
2519         if(samples > 0) {
2520                 encoder->private_->streaminfo.data.stream_info.min_framesize = min(bytes, encoder->private_->streaminfo.data.stream_info.min_framesize);
2521                 encoder->private_->streaminfo.data.stream_info.max_framesize = max(bytes, encoder->private_->streaminfo.data.stream_info.max_framesize);
2522         }
2523
2524         return true;
2525 }
2526
2527 FLAC__StreamEncoderWriteStatus write_frame_(FLAC__StreamEncoder *encoder, const FLAC__byte buffer[], size_t bytes, unsigned samples)
2528 {
2529         FLAC__StreamEncoderWriteStatus status;
2530         FLAC__uint64 output_position = 0;
2531
2532         /* FLAC__STREAM_ENCODER_TELL_STATUS_UNSUPPORTED just means we didn't get the offset; no error */
2533         if(encoder->private_->tell_callback && encoder->private_->tell_callback(encoder, &output_position, encoder->private_->client_data) == FLAC__STREAM_ENCODER_TELL_STATUS_ERROR) {
2534                 encoder->protected_->state = FLAC__STREAM_ENCODER_CLIENT_ERROR;
2535                 return FLAC__STREAM_ENCODER_WRITE_STATUS_FATAL_ERROR;
2536         }
2537
2538         /*
2539          * Watch for the STREAMINFO block and first SEEKTABLE block to go by and store their offsets.
2540          */
2541         if(samples == 0) {
2542                 FLAC__MetadataType type = (buffer[0] & 0x7f);
2543                 if(type == FLAC__METADATA_TYPE_STREAMINFO)
2544                         encoder->protected_->streaminfo_offset = output_position;
2545                 else if(type == FLAC__METADATA_TYPE_SEEKTABLE && encoder->protected_->seektable_offset == 0)
2546                         encoder->protected_->seektable_offset = output_position;
2547         }
2548
2549         /*
2550          * Mark the current seek point if hit (if audio_offset == 0 that
2551          * means we're still writing metadata and haven't hit the first
2552          * frame yet)
2553          */
2554         if(0 != encoder->private_->seek_table && encoder->protected_->audio_offset > 0 && encoder->private_->seek_table->num_points > 0) {
2555                 const unsigned blocksize = FLAC__stream_encoder_get_blocksize(encoder);
2556                 const FLAC__uint64 frame_first_sample = encoder->private_->samples_written;
2557                 const FLAC__uint64 frame_last_sample = frame_first_sample + (FLAC__uint64)blocksize - 1;
2558                 FLAC__uint64 test_sample;
2559                 unsigned i;
2560                 for(i = encoder->private_->first_seekpoint_to_check; i < encoder->private_->seek_table->num_points; i++) {
2561                         test_sample = encoder->private_->seek_table->points[i].sample_number;
2562                         if(test_sample > frame_last_sample) {
2563                                 break;
2564                         }
2565                         else if(test_sample >= frame_first_sample) {
2566                                 encoder->private_->seek_table->points[i].sample_number = frame_first_sample;
2567                                 encoder->private_->seek_table->points[i].stream_offset = output_position - encoder->protected_->audio_offset;
2568                                 encoder->private_->seek_table->points[i].frame_samples = blocksize;
2569                                 encoder->private_->first_seekpoint_to_check++;
2570                                 /* DO NOT: "break;" and here's why:
2571                                  * The seektable template may contain more than one target
2572                                  * sample for any given frame; we will keep looping, generating
2573                                  * duplicate seekpoints for them, and we'll clean it up later,
2574                                  * just before writing the seektable back to the metadata.
2575                                  */
2576                         }
2577                         else {
2578                                 encoder->private_->first_seekpoint_to_check++;
2579                         }
2580                 }
2581         }
2582
2583 #if FLAC__HAS_OGG
2584         if(encoder->private_->is_ogg) {
2585                 status = FLAC__ogg_encoder_aspect_write_callback_wrapper(
2586                         &encoder->protected_->ogg_encoder_aspect,
2587                         FLAC__stream_encoder_get_total_samples_estimate(encoder),
2588                         buffer,
2589                         bytes,
2590                         samples,
2591                         encoder->private_->current_frame_number,
2592                         (FLAC__OggEncoderAspectWriteCallbackProxy)encoder->private_->write_callback,
2593                         encoder,
2594                         encoder->private_->client_data
2595                 );
2596         }
2597         else
2598 #endif
2599         status = encoder->private_->write_callback(encoder, buffer, bytes, samples, encoder->private_->current_frame_number, encoder->private_->client_data);
2600
2601         if(status == FLAC__STREAM_ENCODER_WRITE_STATUS_OK) {
2602                 encoder->private_->bytes_written += bytes;
2603                 encoder->private_->samples_written += samples;
2604                 /* we keep a high watermark on the number of frames written because
2605                  * when the encoder goes back to write metadata, 'current_frame'
2606                  * will drop back to 0.
2607                  */
2608                 encoder->private_->frames_written = max(encoder->private_->frames_written, encoder->private_->current_frame_number+1);
2609         }
2610         else
2611                 encoder->protected_->state = FLAC__STREAM_ENCODER_CLIENT_ERROR;
2612
2613         return status;
2614 }
2615
2616 /* Gets called when the encoding process has finished so that we can update the STREAMINFO and SEEKTABLE blocks.  */
2617 void update_metadata_(const FLAC__StreamEncoder *encoder)
2618 {
2619         FLAC__byte b[max(6, FLAC__STREAM_METADATA_SEEKPOINT_LENGTH)];
2620         const FLAC__StreamMetadata *metadata = &encoder->private_->streaminfo;
2621         const FLAC__uint64 samples = metadata->data.stream_info.total_samples;
2622         const unsigned min_framesize = metadata->data.stream_info.min_framesize;
2623         const unsigned max_framesize = metadata->data.stream_info.max_framesize;
2624         const unsigned bps = metadata->data.stream_info.bits_per_sample;
2625         FLAC__StreamEncoderSeekStatus seek_status;
2626
2627         FLAC__ASSERT(metadata->type == FLAC__METADATA_TYPE_STREAMINFO);
2628
2629         /* All this is based on intimate knowledge of the stream header
2630          * layout, but a change to the header format that would break this
2631          * would also break all streams encoded in the previous format.
2632          */
2633
2634         /*
2635          * Write MD5 signature
2636          */
2637         {
2638                 const unsigned md5_offset =
2639                         FLAC__STREAM_METADATA_HEADER_LENGTH +
2640                         (
2641                                 FLAC__STREAM_METADATA_STREAMINFO_MIN_BLOCK_SIZE_LEN +
2642                                 FLAC__STREAM_METADATA_STREAMINFO_MAX_BLOCK_SIZE_LEN +
2643                                 FLAC__STREAM_METADATA_STREAMINFO_MIN_FRAME_SIZE_LEN +
2644                                 FLAC__STREAM_METADATA_STREAMINFO_MAX_FRAME_SIZE_LEN +
2645                                 FLAC__STREAM_METADATA_STREAMINFO_SAMPLE_RATE_LEN +
2646                                 FLAC__STREAM_METADATA_STREAMINFO_CHANNELS_LEN +
2647                                 FLAC__STREAM_METADATA_STREAMINFO_BITS_PER_SAMPLE_LEN +
2648                                 FLAC__STREAM_METADATA_STREAMINFO_TOTAL_SAMPLES_LEN
2649                         ) / 8;
2650
2651                 if((seek_status = encoder->private_->seek_callback(encoder, encoder->protected_->streaminfo_offset + md5_offset, encoder->private_->client_data)) != FLAC__STREAM_ENCODER_SEEK_STATUS_OK) {
2652                         if(seek_status == FLAC__STREAM_ENCODER_SEEK_STATUS_ERROR)
2653                                 encoder->protected_->state = FLAC__STREAM_ENCODER_CLIENT_ERROR;
2654                         return;
2655                 }
2656                 if(encoder->private_->write_callback(encoder, metadata->data.stream_info.md5sum, 16, 0, 0, encoder->private_->client_data) != FLAC__STREAM_ENCODER_WRITE_STATUS_OK) {
2657                         encoder->protected_->state = FLAC__STREAM_ENCODER_CLIENT_ERROR;
2658                         return;
2659                 }
2660         }
2661
2662         /*
2663          * Write total samples
2664          */
2665         {
2666                 const unsigned total_samples_byte_offset =
2667                         FLAC__STREAM_METADATA_HEADER_LENGTH +
2668                         (
2669                                 FLAC__STREAM_METADATA_STREAMINFO_MIN_BLOCK_SIZE_LEN +
2670                                 FLAC__STREAM_METADATA_STREAMINFO_MAX_BLOCK_SIZE_LEN +
2671                                 FLAC__STREAM_METADATA_STREAMINFO_MIN_FRAME_SIZE_LEN +
2672                                 FLAC__STREAM_METADATA_STREAMINFO_MAX_FRAME_SIZE_LEN +
2673                                 FLAC__STREAM_METADATA_STREAMINFO_SAMPLE_RATE_LEN +
2674                                 FLAC__STREAM_METADATA_STREAMINFO_CHANNELS_LEN +
2675                                 FLAC__STREAM_METADATA_STREAMINFO_BITS_PER_SAMPLE_LEN
2676                                 - 4
2677                         ) / 8;
2678
2679                 b[0] = ((FLAC__byte)(bps-1) << 4) | (FLAC__byte)((samples >> 32) & 0x0F);
2680                 b[1] = (FLAC__byte)((samples >> 24) & 0xFF);
2681                 b[2] = (FLAC__byte)((samples >> 16) & 0xFF);
2682                 b[3] = (FLAC__byte)((samples >> 8) & 0xFF);
2683                 b[4] = (FLAC__byte)(samples & 0xFF);
2684                 if((seek_status = encoder->private_->seek_callback(encoder, encoder->protected_->streaminfo_offset + total_samples_byte_offset, encoder->private_->client_data)) != FLAC__STREAM_ENCODER_SEEK_STATUS_OK) {
2685                         if(seek_status == FLAC__STREAM_ENCODER_SEEK_STATUS_ERROR)
2686                                 encoder->protected_->state = FLAC__STREAM_ENCODER_CLIENT_ERROR;
2687                         return;
2688                 }
2689                 if(encoder->private_->write_callback(encoder, b, 5, 0, 0, encoder->private_->client_data) != FLAC__STREAM_ENCODER_WRITE_STATUS_OK) {
2690                         encoder->protected_->state = FLAC__STREAM_ENCODER_CLIENT_ERROR;
2691                         return;
2692                 }
2693         }
2694
2695         /*
2696          * Write min/max framesize
2697          */
2698         {
2699                 const unsigned min_framesize_offset =
2700                         FLAC__STREAM_METADATA_HEADER_LENGTH +
2701                         (
2702                                 FLAC__STREAM_METADATA_STREAMINFO_MIN_BLOCK_SIZE_LEN +
2703                                 FLAC__STREAM_METADATA_STREAMINFO_MAX_BLOCK_SIZE_LEN
2704                         ) / 8;
2705
2706                 b[0] = (FLAC__byte)((min_framesize >> 16) & 0xFF);
2707                 b[1] = (FLAC__byte)((min_framesize >> 8) & 0xFF);
2708                 b[2] = (FLAC__byte)(min_framesize & 0xFF);
2709                 b[3] = (FLAC__byte)((max_framesize >> 16) & 0xFF);
2710                 b[4] = (FLAC__byte)((max_framesize >> 8) & 0xFF);
2711                 b[5] = (FLAC__byte)(max_framesize & 0xFF);
2712                 if((seek_status = encoder->private_->seek_callback(encoder, encoder->protected_->streaminfo_offset + min_framesize_offset, encoder->private_->client_data)) != FLAC__STREAM_ENCODER_SEEK_STATUS_OK) {
2713                         if(seek_status == FLAC__STREAM_ENCODER_SEEK_STATUS_ERROR)
2714                                 encoder->protected_->state = FLAC__STREAM_ENCODER_CLIENT_ERROR;
2715                         return;
2716                 }
2717                 if(encoder->private_->write_callback(encoder, b, 6, 0, 0, encoder->private_->client_data) != FLAC__STREAM_ENCODER_WRITE_STATUS_OK) {
2718                         encoder->protected_->state = FLAC__STREAM_ENCODER_CLIENT_ERROR;
2719                         return;
2720                 }
2721         }
2722
2723         /*
2724          * Write seektable
2725          */
2726         if(0 != encoder->private_->seek_table && encoder->private_->seek_table->num_points > 0 && encoder->protected_->seektable_offset > 0) {
2727                 unsigned i;
2728
2729                 FLAC__format_seektable_sort(encoder->private_->seek_table);
2730
2731                 FLAC__ASSERT(FLAC__format_seektable_is_legal(encoder->private_->seek_table));
2732
2733                 if((seek_status = encoder->private_->seek_callback(encoder, encoder->protected_->seektable_offset + FLAC__STREAM_METADATA_HEADER_LENGTH, encoder->private_->client_data)) != FLAC__STREAM_ENCODER_SEEK_STATUS_OK) {
2734                         if(seek_status == FLAC__STREAM_ENCODER_SEEK_STATUS_ERROR)
2735                                 encoder->protected_->state = FLAC__STREAM_ENCODER_CLIENT_ERROR;
2736                         return;
2737                 }
2738
2739                 for(i = 0; i < encoder->private_->seek_table->num_points; i++) {
2740                         FLAC__uint64 xx;
2741                         unsigned x;
2742                         xx = encoder->private_->seek_table->points[i].sample_number;
2743                         b[7] = (FLAC__byte)xx; xx >>= 8;
2744                         b[6] = (FLAC__byte)xx; xx >>= 8;
2745                         b[5] = (FLAC__byte)xx; xx >>= 8;
2746                         b[4] = (FLAC__byte)xx; xx >>= 8;
2747                         b[3] = (FLAC__byte)xx; xx >>= 8;
2748                         b[2] = (FLAC__byte)xx; xx >>= 8;
2749                         b[1] = (FLAC__byte)xx; xx >>= 8;
2750                         b[0] = (FLAC__byte)xx; xx >>= 8;
2751                         xx = encoder->private_->seek_table->points[i].stream_offset;
2752                         b[15] = (FLAC__byte)xx; xx >>= 8;
2753                         b[14] = (FLAC__byte)xx; xx >>= 8;
2754                         b[13] = (FLAC__byte)xx; xx >>= 8;
2755                         b[12] = (FLAC__byte)xx; xx >>= 8;
2756                         b[11] = (FLAC__byte)xx; xx >>= 8;
2757                         b[10] = (FLAC__byte)xx; xx >>= 8;
2758                         b[9] = (FLAC__byte)xx; xx >>= 8;
2759                         b[8] = (FLAC__byte)xx; xx >>= 8;
2760                         x = encoder->private_->seek_table->points[i].frame_samples;
2761                         b[17] = (FLAC__byte)x; x >>= 8;
2762                         b[16] = (FLAC__byte)x; x >>= 8;
2763                         if(encoder->private_->write_callback(encoder, b, 18, 0, 0, encoder->private_->client_data) != FLAC__STREAM_ENCODER_WRITE_STATUS_OK) {
2764                                 encoder->protected_->state = FLAC__STREAM_ENCODER_CLIENT_ERROR;
2765                                 return;
2766                         }
2767                 }
2768         }
2769 }
2770
2771 #if FLAC__HAS_OGG
2772 /* Gets called when the encoding process has finished so that we can update the STREAMINFO and SEEKTABLE blocks.  */
2773 void update_ogg_metadata_(FLAC__StreamEncoder *encoder)
2774 {
2775         FLAC__byte b[max(6, FLAC__STREAM_METADATA_SEEKPOINT_LENGTH)];
2776         const FLAC__StreamMetadata *metadata = &encoder->private_->streaminfo;
2777         const FLAC__uint64 samples = metadata->data.stream_info.total_samples;
2778         const unsigned min_framesize = metadata->data.stream_info.min_framesize;
2779         const unsigned max_framesize = metadata->data.stream_info.max_framesize;
2780         ogg_page page;
2781
2782         FLAC__ASSERT(metadata->type == FLAC__METADATA_TYPE_STREAMINFO);
2783
2784         /* All this is based on intimate knowledge of the stream header
2785          * layout, but a change to the header format that would break this
2786          * would also break all streams encoded in the previous format.
2787          */
2788
2789         /**
2790          ** Write STREAMINFO stats
2791          **/
2792         simple_ogg_page__init(&page);
2793         if(!simple_ogg_page__get_at(encoder, encoder->protected_->streaminfo_offset, &page, encoder->private_->seek_callback, encoder->private_->read_callback, encoder->private_->client_data)) {
2794                 simple_ogg_page__clear(&page);
2795                 return; /* state already set */
2796         }
2797
2798         /*
2799          * Write MD5 signature
2800          */
2801         {
2802                 const unsigned md5_offset =
2803                         FLAC__STREAM_METADATA_HEADER_LENGTH +
2804                         (
2805                                 FLAC__STREAM_METADATA_STREAMINFO_MIN_BLOCK_SIZE_LEN +
2806                                 FLAC__STREAM_METADATA_STREAMINFO_MAX_BLOCK_SIZE_LEN +
2807                                 FLAC__STREAM_METADATA_STREAMINFO_MIN_FRAME_SIZE_LEN +
2808                                 FLAC__STREAM_METADATA_STREAMINFO_MAX_FRAME_SIZE_LEN +
2809                                 FLAC__STREAM_METADATA_STREAMINFO_SAMPLE_RATE_LEN +
2810                                 FLAC__STREAM_METADATA_STREAMINFO_CHANNELS_LEN +
2811                                 FLAC__STREAM_METADATA_STREAMINFO_BITS_PER_SAMPLE_LEN +
2812                                 FLAC__STREAM_METADATA_STREAMINFO_TOTAL_SAMPLES_LEN
2813                         ) / 8;
2814
2815                 if(md5_offset + 16 > (unsigned)page.body_len) {
2816                         encoder->protected_->state = FLAC__STREAM_ENCODER_OGG_ERROR;
2817                         simple_ogg_page__clear(&page);
2818                         return;
2819                 }
2820                 memcpy(page.body + md5_offset, metadata->data.stream_info.md5sum, 16);
2821         }
2822
2823         /*
2824          * Write total samples
2825          */
2826         {
2827                 const unsigned total_samples_byte_offset =
2828                         FLAC__STREAM_METADATA_HEADER_LENGTH +
2829                         (
2830                                 FLAC__STREAM_METADATA_STREAMINFO_MIN_BLOCK_SIZE_LEN +
2831                                 FLAC__STREAM_METADATA_STREAMINFO_MAX_BLOCK_SIZE_LEN +
2832                                 FLAC__STREAM_METADATA_STREAMINFO_MIN_FRAME_SIZE_LEN +
2833                                 FLAC__STREAM_METADATA_STREAMINFO_MAX_FRAME_SIZE_LEN +
2834                                 FLAC__STREAM_METADATA_STREAMINFO_SAMPLE_RATE_LEN +
2835                                 FLAC__STREAM_METADATA_STREAMINFO_CHANNELS_LEN +
2836                                 FLAC__STREAM_METADATA_STREAMINFO_BITS_PER_SAMPLE_LEN
2837                                 - 4
2838                         ) / 8;
2839
2840                 if(total_samples_byte_offset + 5 > (unsigned)page.body_len) {
2841                         encoder->protected_->state = FLAC__STREAM_ENCODER_OGG_ERROR;
2842                         simple_ogg_page__clear(&page);
2843                         return;
2844                 }
2845                 b[0] = (FLAC__byte)page.body[total_samples_byte_offset] & 0xF0;
2846                 b[0] |= (FLAC__byte)((samples >> 32) & 0x0F);
2847                 b[1] = (FLAC__byte)((samples >> 24) & 0xFF);
2848                 b[2] = (FLAC__byte)((samples >> 16) & 0xFF);
2849                 b[3] = (FLAC__byte)((samples >> 8) & 0xFF);
2850                 b[4] = (FLAC__byte)(samples & 0xFF);
2851                 memcpy(page.body + total_samples_byte_offset, b, 5);
2852         }
2853
2854         /*
2855          * Write min/max framesize
2856          */
2857         {
2858                 const unsigned min_framesize_offset =
2859                         FLAC__STREAM_METADATA_HEADER_LENGTH +
2860                         (
2861                                 FLAC__STREAM_METADATA_STREAMINFO_MIN_BLOCK_SIZE_LEN +
2862                                 FLAC__STREAM_METADATA_STREAMINFO_MAX_BLOCK_SIZE_LEN
2863                         ) / 8;
2864
2865                 if(min_framesize_offset + 6 > (unsigned)page.body_len) {
2866                         encoder->protected_->state = FLAC__STREAM_ENCODER_OGG_ERROR;
2867                         simple_ogg_page__clear(&page);
2868                         return;
2869                 }
2870                 b[0] = (FLAC__byte)((min_framesize >> 16) & 0xFF);
2871                 b[1] = (FLAC__byte)((min_framesize >> 8) & 0xFF);
2872                 b[2] = (FLAC__byte)(min_framesize & 0xFF);
2873                 b[3] = (FLAC__byte)((max_framesize >> 16) & 0xFF);
2874                 b[4] = (FLAC__byte)((max_framesize >> 8) & 0xFF);
2875                 b[5] = (FLAC__byte)(max_framesize & 0xFF);
2876                 memcpy(page.body + min_framesize_offset, b, 6);
2877         }
2878         if(!simple_ogg_page__set_at(encoder, encoder->protected_->streaminfo_offset, &page, encoder->private_->seek_callback, encoder->private_->write_callback, encoder->private_->client_data)) {
2879                 simple_ogg_page__clear(&page);
2880                 return; /* state already set */
2881         }
2882         simple_ogg_page__clear(&page);
2883
2884         /*
2885          * Write seektable
2886          */
2887         if(0 != encoder->private_->seek_table && encoder->private_->seek_table->num_points > 0 && encoder->protected_->seektable_offset > 0) {
2888                 unsigned i;
2889                 FLAC__byte *p;
2890
2891                 FLAC__format_seektable_sort(encoder->private_->seek_table);
2892
2893                 FLAC__ASSERT(FLAC__format_seektable_is_legal(encoder->private_->seek_table));
2894
2895                 simple_ogg_page__init(&page);
2896                 if(!simple_ogg_page__get_at(encoder, encoder->protected_->seektable_offset, &page, encoder->private_->seek_callback, encoder->private_->read_callback, encoder->private_->client_data)) {
2897                         simple_ogg_page__clear(&page);
2898                         return; /* state already set */
2899                 }
2900
2901                 if(FLAC__STREAM_METADATA_HEADER_LENGTH + (18*encoder->private_->seek_table->num_points) > (unsigned)page.body_len) {
2902                         encoder->protected_->state = FLAC__STREAM_ENCODER_OGG_ERROR;
2903                         simple_ogg_page__clear(&page);
2904                         return;
2905                 }
2906
2907                 for(i = 0, p = page.body + FLAC__STREAM_METADATA_HEADER_LENGTH; i < encoder->private_->seek_table->num_points; i++, p += 18) {
2908                         FLAC__uint64 xx;
2909                         unsigned x;
2910                         xx = encoder->private_->seek_table->points[i].sample_number;
2911                         b[7] = (FLAC__byte)xx; xx >>= 8;
2912                         b[6] = (FLAC__byte)xx; xx >>= 8;
2913                         b[5] = (FLAC__byte)xx; xx >>= 8;
2914                         b[4] = (FLAC__byte)xx; xx >>= 8;
2915                         b[3] = (FLAC__byte)xx; xx >>= 8;
2916                         b[2] = (FLAC__byte)xx; xx >>= 8;
2917                         b[1] = (FLAC__byte)xx; xx >>= 8;
2918                         b[0] = (FLAC__byte)xx; xx >>= 8;
2919                         xx = encoder->private_->seek_table->points[i].stream_offset;
2920                         b[15] = (FLAC__byte)xx; xx >>= 8;
2921                         b[14] = (FLAC__byte)xx; xx >>= 8;
2922                         b[13] = (FLAC__byte)xx; xx >>= 8;
2923                         b[12] = (FLAC__byte)xx; xx >>= 8;
2924                         b[11] = (FLAC__byte)xx; xx >>= 8;
2925                         b[10] = (FLAC__byte)xx; xx >>= 8;
2926                         b[9] = (FLAC__byte)xx; xx >>= 8;
2927                         b[8] = (FLAC__byte)xx; xx >>= 8;
2928                         x = encoder->private_->seek_table->points[i].frame_samples;
2929                         b[17] = (FLAC__byte)x; x >>= 8;
2930                         b[16] = (FLAC__byte)x; x >>= 8;
2931                         if(encoder->private_->write_callback(encoder, b, 18, 0, 0, encoder->private_->client_data) != FLAC__STREAM_ENCODER_WRITE_STATUS_OK) {
2932                                 encoder->protected_->state = FLAC__STREAM_ENCODER_CLIENT_ERROR;
2933                                 simple_ogg_page__clear(&page);
2934                                 return;
2935                         }
2936                         memcpy(p, b, 18);
2937                 }
2938
2939                 if(!simple_ogg_page__set_at(encoder, encoder->protected_->seektable_offset, &page, encoder->private_->seek_callback, encoder->private_->write_callback, encoder->private_->client_data)) {
2940                         simple_ogg_page__clear(&page);
2941                         return; /* state already set */
2942                 }
2943                 simple_ogg_page__clear(&page);
2944         }
2945 }
2946 #endif
2947
2948 FLAC__bool process_frame_(FLAC__StreamEncoder *encoder, FLAC__bool is_fractional_block)
2949 {
2950         FLAC__ASSERT(encoder->protected_->state == FLAC__STREAM_ENCODER_OK);
2951
2952         /*
2953          * Accumulate raw signal to the MD5 signature
2954          */
2955         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)) {
2956                 encoder->protected_->state = FLAC__STREAM_ENCODER_MEMORY_ALLOCATION_ERROR;
2957                 return false;
2958         }
2959
2960         /*
2961          * Process the frame header and subframes into the frame bitbuffer
2962          */
2963         if(!process_subframes_(encoder, is_fractional_block)) {
2964                 /* the above function sets the state for us in case of an error */
2965                 return false;
2966         }
2967
2968         /*
2969          * Zero-pad the frame to a byte_boundary
2970          */
2971         if(!FLAC__bitbuffer_zero_pad_to_byte_boundary(encoder->private_->frame)) {
2972                 encoder->protected_->state = FLAC__STREAM_ENCODER_MEMORY_ALLOCATION_ERROR;
2973                 return false;
2974         }
2975
2976         /*
2977          * CRC-16 the whole thing
2978          */
2979         FLAC__ASSERT(FLAC__bitbuffer_is_byte_aligned(encoder->private_->frame));
2980         FLAC__bitbuffer_write_raw_uint32(encoder->private_->frame, FLAC__bitbuffer_get_write_crc16(encoder->private_->frame), FLAC__FRAME_FOOTER_CRC_LEN);
2981
2982         /*
2983          * Write it
2984          */
2985         if(!write_bitbuffer_(encoder, encoder->protected_->blocksize)) {
2986                 /* the above function sets the state for us in case of an error */
2987                 return false;
2988         }
2989
2990         /*
2991          * Get ready for the next frame
2992          */
2993         encoder->private_->current_sample_number = 0;
2994         encoder->private_->current_frame_number++;
2995         encoder->private_->streaminfo.data.stream_info.total_samples += (FLAC__uint64)encoder->protected_->blocksize;
2996
2997         return true;
2998 }
2999
3000 FLAC__bool process_subframes_(FLAC__StreamEncoder *encoder, FLAC__bool is_fractional_block)
3001 {
3002         FLAC__FrameHeader frame_header;
3003         unsigned channel, min_partition_order = encoder->protected_->min_residual_partition_order, max_partition_order;
3004         FLAC__bool do_independent, do_mid_side, precompute_partition_sums;
3005
3006         /*
3007          * Calculate the min,max Rice partition orders
3008          */
3009         if(is_fractional_block) {
3010                 max_partition_order = 0;
3011         }
3012         else {
3013                 max_partition_order = FLAC__format_get_max_rice_partition_order_from_blocksize(encoder->protected_->blocksize);
3014                 max_partition_order = min(max_partition_order, encoder->protected_->max_residual_partition_order);
3015         }
3016         min_partition_order = min(min_partition_order, max_partition_order);
3017
3018         precompute_partition_sums = encoder->private_->precompute_partition_sums && ((max_partition_order > min_partition_order) || encoder->protected_->do_escape_coding);
3019
3020         /*
3021          * Setup the frame
3022          */
3023         if(!FLAC__bitbuffer_clear(encoder->private_->frame)) {
3024                 encoder->protected_->state = FLAC__STREAM_ENCODER_MEMORY_ALLOCATION_ERROR;
3025                 return false;
3026         }
3027         frame_header.blocksize = encoder->protected_->blocksize;
3028         frame_header.sample_rate = encoder->protected_->sample_rate;
3029         frame_header.channels = encoder->protected_->channels;
3030         frame_header.channel_assignment = FLAC__CHANNEL_ASSIGNMENT_INDEPENDENT; /* the default unless the encoder determines otherwise */
3031         frame_header.bits_per_sample = encoder->protected_->bits_per_sample;
3032         frame_header.number_type = FLAC__FRAME_NUMBER_TYPE_FRAME_NUMBER;
3033         frame_header.number.frame_number = encoder->private_->current_frame_number;
3034
3035         /*
3036          * Figure out what channel assignments to try
3037          */
3038         if(encoder->protected_->do_mid_side_stereo) {
3039                 if(encoder->protected_->loose_mid_side_stereo) {
3040                         if(encoder->private_->loose_mid_side_stereo_frame_count == 0) {
3041                                 do_independent = true;
3042                                 do_mid_side = true;
3043                         }
3044                         else {
3045                                 do_independent = (encoder->private_->last_channel_assignment == FLAC__CHANNEL_ASSIGNMENT_INDEPENDENT);
3046                                 do_mid_side = !do_independent;
3047                         }
3048                 }
3049                 else {
3050                         do_independent = true;
3051                         do_mid_side = true;
3052                 }
3053         }
3054         else {
3055                 do_independent = true;
3056                 do_mid_side = false;
3057         }
3058
3059         FLAC__ASSERT(do_independent || do_mid_side);
3060
3061         /*
3062          * Check for wasted bits; set effective bps for each subframe
3063          */
3064         if(do_independent) {
3065                 for(channel = 0; channel < encoder->protected_->channels; channel++) {
3066                         const unsigned w = get_wasted_bits_(encoder->private_->integer_signal[channel], encoder->protected_->blocksize);
3067                         encoder->private_->subframe_workspace[channel][0].wasted_bits = encoder->private_->subframe_workspace[channel][1].wasted_bits = w;
3068                         encoder->private_->subframe_bps[channel] = encoder->protected_->bits_per_sample - w;
3069                 }
3070         }
3071         if(do_mid_side) {
3072                 FLAC__ASSERT(encoder->protected_->channels == 2);
3073                 for(channel = 0; channel < 2; channel++) {
3074                         const unsigned w = get_wasted_bits_(encoder->private_->integer_signal_mid_side[channel], encoder->protected_->blocksize);
3075                         encoder->private_->subframe_workspace_mid_side[channel][0].wasted_bits = encoder->private_->subframe_workspace_mid_side[channel][1].wasted_bits = w;
3076                         encoder->private_->subframe_bps_mid_side[channel] = encoder->protected_->bits_per_sample - w + (channel==0? 0:1);
3077                 }
3078         }
3079
3080         /*
3081          * First do a normal encoding pass of each independent channel
3082          */
3083         if(do_independent) {
3084                 for(channel = 0; channel < encoder->protected_->channels; channel++) {
3085                         if(!
3086                                 process_subframe_(
3087                                         encoder,
3088                                         min_partition_order,
3089                                         max_partition_order,
3090                                         precompute_partition_sums,
3091                                         &frame_header,
3092                                         encoder->private_->subframe_bps[channel],
3093                                         encoder->private_->integer_signal[channel],
3094 #ifndef FLAC__INTEGER_ONLY_LIBRARY
3095                                         encoder->private_->real_signal[channel],
3096 #endif
3097                                         encoder->private_->subframe_workspace_ptr[channel],
3098                                         encoder->private_->partitioned_rice_contents_workspace_ptr[channel],
3099                                         encoder->private_->residual_workspace[channel],
3100                                         encoder->private_->best_subframe+channel,
3101                                         encoder->private_->best_subframe_bits+channel
3102                                 )
3103                         )
3104                                 return false;
3105                 }
3106         }
3107
3108         /*
3109          * Now do mid and side channels if requested
3110          */
3111         if(do_mid_side) {
3112                 FLAC__ASSERT(encoder->protected_->channels == 2);
3113
3114                 for(channel = 0; channel < 2; channel++) {
3115                         if(!
3116                                 process_subframe_(
3117                                         encoder,
3118                                         min_partition_order,
3119                                         max_partition_order,
3120                                         precompute_partition_sums,
3121                                         &frame_header,
3122                                         encoder->private_->subframe_bps_mid_side[channel],
3123                                         encoder->private_->integer_signal_mid_side[channel],
3124 #ifndef FLAC__INTEGER_ONLY_LIBRARY
3125                                         encoder->private_->real_signal_mid_side[channel],
3126 #endif
3127                                         encoder->private_->subframe_workspace_ptr_mid_side[channel],
3128                                         encoder->private_->partitioned_rice_contents_workspace_ptr_mid_side[channel],
3129                                         encoder->private_->residual_workspace_mid_side[channel],
3130                                         encoder->private_->best_subframe_mid_side+channel,
3131                                         encoder->private_->best_subframe_bits_mid_side+channel
3132                                 )
3133                         )
3134                                 return false;
3135                 }
3136         }
3137
3138         /*
3139          * Compose the frame bitbuffer
3140          */
3141         if(do_mid_side) {
3142                 unsigned left_bps = 0, right_bps = 0; /* initialized only to prevent superfluous compiler warning */
3143                 FLAC__Subframe *left_subframe = 0, *right_subframe = 0; /* initialized only to prevent superfluous compiler warning */
3144                 FLAC__ChannelAssignment channel_assignment;
3145
3146                 FLAC__ASSERT(encoder->protected_->channels == 2);
3147
3148                 if(encoder->protected_->loose_mid_side_stereo && encoder->private_->loose_mid_side_stereo_frame_count > 0) {
3149                         channel_assignment = (encoder->private_->last_channel_assignment == FLAC__CHANNEL_ASSIGNMENT_INDEPENDENT? FLAC__CHANNEL_ASSIGNMENT_INDEPENDENT : FLAC__CHANNEL_ASSIGNMENT_MID_SIDE);
3150                 }
3151                 else {
3152                         unsigned bits[4]; /* WATCHOUT - indexed by FLAC__ChannelAssignment */
3153                         unsigned min_bits;
3154                         FLAC__ChannelAssignment ca;
3155
3156                         FLAC__ASSERT(do_independent && do_mid_side);
3157
3158                         /* We have to figure out which channel assignent results in the smallest frame */
3159                         bits[FLAC__CHANNEL_ASSIGNMENT_INDEPENDENT] = encoder->private_->best_subframe_bits         [0] + encoder->private_->best_subframe_bits         [1];
3160                         bits[FLAC__CHANNEL_ASSIGNMENT_LEFT_SIDE  ] = encoder->private_->best_subframe_bits         [0] + encoder->private_->best_subframe_bits_mid_side[1];
3161                         bits[FLAC__CHANNEL_ASSIGNMENT_RIGHT_SIDE ] = encoder->private_->best_subframe_bits         [1] + encoder->private_->best_subframe_bits_mid_side[1];
3162                         bits[FLAC__CHANNEL_ASSIGNMENT_MID_SIDE   ] = encoder->private_->best_subframe_bits_mid_side[0] + encoder->private_->best_subframe_bits_mid_side[1];
3163
3164                         for(channel_assignment = (FLAC__ChannelAssignment)0, min_bits = bits[0], ca = (FLAC__ChannelAssignment)1; (int)ca <= 3; ca = (FLAC__ChannelAssignment)((int)ca + 1)) {
3165                                 if(bits[ca] < min_bits) {
3166                                         min_bits = bits[ca];
3167                                         channel_assignment = ca;
3168                                 }
3169                         }
3170                 }
3171
3172                 frame_header.channel_assignment = channel_assignment;
3173
3174                 if(!FLAC__frame_add_header(&frame_header, encoder->private_->frame)) {
3175                         encoder->protected_->state = FLAC__STREAM_ENCODER_FRAMING_ERROR;
3176                         return false;
3177                 }
3178
3179                 switch(channel_assignment) {
3180                         case FLAC__CHANNEL_ASSIGNMENT_INDEPENDENT:
3181                                 left_subframe  = &encoder->private_->subframe_workspace         [0][encoder->private_->best_subframe         [0]];
3182                                 right_subframe = &encoder->private_->subframe_workspace         [1][encoder->private_->best_subframe         [1]];
3183                                 break;
3184                         case FLAC__CHANNEL_ASSIGNMENT_LEFT_SIDE:
3185                                 left_subframe  = &encoder->private_->subframe_workspace         [0][encoder->private_->best_subframe         [0]];
3186                                 right_subframe = &encoder->private_->subframe_workspace_mid_side[1][encoder->private_->best_subframe_mid_side[1]];
3187                                 break;
3188                         case FLAC__CHANNEL_ASSIGNMENT_RIGHT_SIDE:
3189                                 left_subframe  = &encoder->private_->subframe_workspace_mid_side[1][encoder->private_->best_subframe_mid_side[1]];
3190                                 right_subframe = &encoder->private_->subframe_workspace         [1][encoder->private_->best_subframe         [1]];
3191                                 break;
3192                         case FLAC__CHANNEL_ASSIGNMENT_MID_SIDE:
3193                                 left_subframe  = &encoder->private_->subframe_workspace_mid_side[0][encoder->private_->best_subframe_mid_side[0]];
3194                                 right_subframe = &encoder->private_->subframe_workspace_mid_side[1][encoder->private_->best_subframe_mid_side[1]];
3195                                 break;
3196                         default:
3197                                 FLAC__ASSERT(0);
3198                 }
3199
3200                 switch(channel_assignment) {
3201                         case FLAC__CHANNEL_ASSIGNMENT_INDEPENDENT:
3202                                 left_bps  = encoder->private_->subframe_bps         [0];
3203                                 right_bps = encoder->private_->subframe_bps         [1];
3204                                 break;
3205                         case FLAC__CHANNEL_ASSIGNMENT_LEFT_SIDE:
3206                                 left_bps  = encoder->private_->subframe_bps         [0];
3207                                 right_bps = encoder->private_->subframe_bps_mid_side[1];
3208                                 break;
3209                         case FLAC__CHANNEL_ASSIGNMENT_RIGHT_SIDE:
3210                                 left_bps  = encoder->private_->subframe_bps_mid_side[1];
3211                                 right_bps = encoder->private_->subframe_bps         [1];
3212                                 break;
3213                         case FLAC__CHANNEL_ASSIGNMENT_MID_SIDE:
3214                                 left_bps  = encoder->private_->subframe_bps_mid_side[0];
3215                                 right_bps = encoder->private_->subframe_bps_mid_side[1];
3216                                 break;
3217                         default:
3218                                 FLAC__ASSERT(0);
3219                 }
3220
3221                 /* note that encoder_add_subframe_ sets the state for us in case of an error */
3222                 if(!add_subframe_(encoder, &frame_header, left_bps , left_subframe , encoder->private_->frame))
3223                         return false;
3224                 if(!add_subframe_(encoder, &frame_header, right_bps, right_subframe, encoder->private_->frame))
3225                         return false;
3226         }
3227         else {
3228                 if(!FLAC__frame_add_header(&frame_header, encoder->private_->frame)) {
3229                         encoder->protected_->state = FLAC__STREAM_ENCODER_FRAMING_ERROR;
3230                         return false;
3231                 }
3232
3233                 for(channel = 0; channel < encoder->protected_->channels; channel++) {
3234                         if(!add_subframe_(encoder, &frame_header, encoder->private_->subframe_bps[channel], &encoder->private_->subframe_workspace[channel][encoder->private_->best_subframe[channel]], encoder->private_->frame)) {
3235                                 /* the above function sets the state for us in case of an error */
3236                                 return false;
3237                         }
3238                 }
3239         }
3240
3241         if(encoder->protected_->loose_mid_side_stereo) {
3242                 encoder->private_->loose_mid_side_stereo_frame_count++;
3243                 if(encoder->private_->loose_mid_side_stereo_frame_count >= encoder->private_->loose_mid_side_stereo_frames)
3244                         encoder->private_->loose_mid_side_stereo_frame_count = 0;
3245         }
3246
3247         encoder->private_->last_channel_assignment = frame_header.channel_assignment;
3248
3249         return true;
3250 }
3251
3252 FLAC__bool process_subframe_(
3253         FLAC__StreamEncoder *encoder,
3254         unsigned min_partition_order,
3255         unsigned max_partition_order,
3256         FLAC__bool precompute_partition_sums,
3257         const FLAC__FrameHeader *frame_header,
3258         unsigned subframe_bps,
3259         const FLAC__int32 integer_signal[],
3260 #ifndef FLAC__INTEGER_ONLY_LIBRARY
3261         const FLAC__real real_signal[],
3262 #endif
3263         FLAC__Subframe *subframe[2],
3264         FLAC__EntropyCodingMethod_PartitionedRiceContents *partitioned_rice_contents[2],
3265         FLAC__int32 *residual[2],
3266         unsigned *best_subframe,
3267         unsigned *best_bits
3268 )
3269 {
3270 #ifndef FLAC__INTEGER_ONLY_LIBRARY
3271         FLAC__float fixed_residual_bits_per_sample[FLAC__MAX_FIXED_ORDER+1];
3272 #else
3273         FLAC__fixedpoint fixed_residual_bits_per_sample[FLAC__MAX_FIXED_ORDER+1];
3274 #endif
3275 #ifndef FLAC__INTEGER_ONLY_LIBRARY
3276         FLAC__double lpc_residual_bits_per_sample;
3277         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 */
3278         FLAC__double lpc_error[FLAC__MAX_LPC_ORDER];
3279         unsigned min_lpc_order, max_lpc_order, lpc_order;
3280         unsigned min_qlp_coeff_precision, max_qlp_coeff_precision, qlp_coeff_precision;
3281 #endif
3282         unsigned min_fixed_order, max_fixed_order, guess_fixed_order, fixed_order;
3283         unsigned rice_parameter;
3284         unsigned _candidate_bits, _best_bits;
3285         unsigned _best_subframe;
3286
3287         /* verbatim subframe is the baseline against which we measure other compressed subframes */
3288         _best_subframe = 0;
3289         if(encoder->private_->disable_verbatim_subframes && frame_header->blocksize >= FLAC__MAX_FIXED_ORDER)
3290                 _best_bits = UINT_MAX;
3291         else
3292                 _best_bits = evaluate_verbatim_subframe_(integer_signal, frame_header->blocksize, subframe_bps, subframe[_best_subframe]);
3293
3294         if(frame_header->blocksize >= FLAC__MAX_FIXED_ORDER) {
3295                 unsigned signal_is_constant = false;
3296                 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);
3297                 /* check for constant subframe */
3298                 if(
3299                         !encoder->private_->disable_constant_subframes &&
3300 #ifndef FLAC__INTEGER_ONLY_LIBRARY
3301                         fixed_residual_bits_per_sample[1] == 0.0
3302 #else
3303                         fixed_residual_bits_per_sample[1] == FLAC__FP_ZERO
3304 #endif
3305                 ) {
3306                         /* the above means it's possible all samples are the same value; now double-check it: */
3307                         unsigned i;
3308                         signal_is_constant = true;
3309                         for(i = 1; i < frame_header->blocksize; i++) {
3310                                 if(integer_signal[0] != integer_signal[i]) {
3311                                         signal_is_constant = false;
3312                                         break;
3313                                 }
3314                         }
3315                 }
3316                 if(signal_is_constant) {
3317                         _candidate_bits = evaluate_constant_subframe_(integer_signal[0], subframe_bps, subframe[!_best_subframe]);
3318                         if(_candidate_bits < _best_bits) {
3319                                 _best_subframe = !_best_subframe;
3320                                 _best_bits = _candidate_bits;
3321                         }
3322                 }
3323                 else {
3324                         if(!encoder->private_->disable_fixed_subframes || (encoder->protected_->max_lpc_order == 0 && _best_bits == UINT_MAX)) {
3325                                 /* encode fixed */
3326                                 if(encoder->protected_->do_exhaustive_model_search) {
3327                                         min_fixed_order = 0;
3328                                         max_fixed_order = FLAC__MAX_FIXED_ORDER;
3329                                 }
3330                                 else {
3331                                         min_fixed_order = max_fixed_order = guess_fixed_order;
3332                                 }
3333                                 for(fixed_order = min_fixed_order; fixed_order <= max_fixed_order; fixed_order++) {
3334 #ifndef FLAC__INTEGER_ONLY_LIBRARY
3335                                         if(fixed_residual_bits_per_sample[fixed_order] >= (FLAC__float)subframe_bps)
3336                                                 continue; /* don't even try */
3337                                         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 */
3338 #else
3339                                         if(FLAC__fixedpoint_trunc(fixed_residual_bits_per_sample[fixed_order]) >= (int)subframe_bps)
3340                                                 continue; /* don't even try */
3341                                         rice_parameter = (fixed_residual_bits_per_sample[fixed_order] > FLAC__FP_ZERO)? (unsigned)FLAC__fixedpoint_trunc(fixed_residual_bits_per_sample[fixed_order]+FLAC__FP_ONE_HALF) : 0; /* 0.5 is for rounding */
3342 #endif
3343                                         rice_parameter++; /* to account for the signed->unsigned conversion during rice coding */
3344                                         if(rice_parameter >= FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE_ESCAPE_PARAMETER) {
3345 #ifdef DEBUG_VERBOSE
3346                                                 fprintf(stderr, "clipping rice_parameter (%u -> %u) @0\n", rice_parameter, FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE_ESCAPE_PARAMETER - 1);
3347 #endif
3348                                                 rice_parameter = FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE_ESCAPE_PARAMETER - 1;
3349                                         }
3350                                         _candidate_bits =
3351                                                 evaluate_fixed_subframe_(
3352                                                         encoder,
3353                                                         integer_signal,
3354                                                         residual[!_best_subframe],
3355                                                         encoder->private_->abs_residual,
3356                                                         encoder->private_->abs_residual_partition_sums,
3357                                                         encoder->private_->raw_bits_per_partition,
3358                                                         frame_header->blocksize,
3359                                                         subframe_bps,
3360                                                         fixed_order,
3361                                                         rice_parameter,
3362                                                         min_partition_order,
3363                                                         max_partition_order,
3364                                                         precompute_partition_sums,
3365                                                         encoder->protected_->do_escape_coding,
3366                                                         encoder->protected_->rice_parameter_search_dist,
3367                                                         subframe[!_best_subframe],
3368                                                         partitioned_rice_contents[!_best_subframe]
3369                                                 );
3370                                         if(_candidate_bits < _best_bits) {
3371                                                 _best_subframe = !_best_subframe;
3372                                                 _best_bits = _candidate_bits;
3373                                         }
3374                                 }
3375                         }
3376
3377 #ifndef FLAC__INTEGER_ONLY_LIBRARY
3378                         /* encode lpc */
3379                         if(encoder->protected_->max_lpc_order > 0) {
3380                                 if(encoder->protected_->max_lpc_order >= frame_header->blocksize)
3381                                         max_lpc_order = frame_header->blocksize-1;
3382                                 else
3383                                         max_lpc_order = encoder->protected_->max_lpc_order;
3384                                 if(max_lpc_order > 0) {
3385                                         unsigned a;
3386                                         for (a = 0; a < encoder->protected_->num_apodizations; a++) {
3387                                                 FLAC__lpc_window_data(real_signal, encoder->private_->window[a], encoder->private_->windowed_signal, frame_header->blocksize);
3388                                                 encoder->private_->local_lpc_compute_autocorrelation(encoder->private_->windowed_signal, frame_header->blocksize, max_lpc_order+1, autoc);
3389                                                 /* if autoc[0] == 0.0, the signal is constant and we usually won't get here, but it can happen */
3390                                                 if(autoc[0] != 0.0) {
3391                                                         FLAC__lpc_compute_lp_coefficients(autoc, max_lpc_order, encoder->private_->lp_coeff, lpc_error);
3392                                                         if(encoder->protected_->do_exhaustive_model_search) {
3393                                                                 min_lpc_order = 1;
3394                                                         }
3395                                                         else {
3396                                                                 const unsigned guess_lpc_order =
3397                                                                         FLAC__lpc_compute_best_order(
3398                                                                                 lpc_error,
3399                                                                                 max_lpc_order,
3400                                                                                 frame_header->blocksize,
3401                                                                                 subframe_bps + (
3402                                                                                         encoder->protected_->do_qlp_coeff_prec_search?
3403                                                                                                 FLAC__MIN_QLP_COEFF_PRECISION : /* have to guess; use the min possible size to avoid accidentally favoring lower orders */
3404                                                                                                 encoder->protected_->qlp_coeff_precision
3405                                                                                 )
3406                                                                         );
3407                                                                 min_lpc_order = max_lpc_order = guess_lpc_order;
3408                                                         }
3409                                                         for(lpc_order = min_lpc_order; lpc_order <= max_lpc_order; lpc_order++) {
3410                                                                 lpc_residual_bits_per_sample = FLAC__lpc_compute_expected_bits_per_residual_sample(lpc_error[lpc_order-1], frame_header->blocksize-lpc_order);
3411                                                                 if(lpc_residual_bits_per_sample >= (FLAC__double)subframe_bps)
3412                                                                         continue; /* don't even try */
3413                                                                 rice_parameter = (lpc_residual_bits_per_sample > 0.0)? (unsigned)(lpc_residual_bits_per_sample+0.5) : 0; /* 0.5 is for rounding */
3414                                                                 rice_parameter++; /* to account for the signed->unsigned conversion during rice coding */
3415                                                                 if(rice_parameter >= FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE_ESCAPE_PARAMETER) {
3416 #ifdef DEBUG_VERBOSE
3417                                                                         fprintf(stderr, "clipping rice_parameter (%u -> %u) @1\n", rice_parameter, FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE_ESCAPE_PARAMETER - 1);
3418 #endif
3419                                                                         rice_parameter = FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE_ESCAPE_PARAMETER - 1;
3420                                                                 }
3421                                                                 if(encoder->protected_->do_qlp_coeff_prec_search) {
3422                                                                         min_qlp_coeff_precision = FLAC__MIN_QLP_COEFF_PRECISION;
3423                                                                         /* try to ensure a 32-bit datapath throughout for 16bps(+1bps for side channel) or less */
3424                                                                         if(subframe_bps <= 17) {
3425                                                                                 max_qlp_coeff_precision = min(32 - subframe_bps - lpc_order, FLAC__MAX_QLP_COEFF_PRECISION);
3426                                                                                 max_qlp_coeff_precision = max(max_qlp_coeff_precision, min_qlp_coeff_precision);
3427                                                                         }
3428                                                                         else
3429                                                                                 max_qlp_coeff_precision = FLAC__MAX_QLP_COEFF_PRECISION;
3430                                                                 }
3431                                                                 else {
3432                                                                         min_qlp_coeff_precision = max_qlp_coeff_precision = encoder->protected_->qlp_coeff_precision;
3433                                                                 }
3434                                                                 for(qlp_coeff_precision = min_qlp_coeff_precision; qlp_coeff_precision <= max_qlp_coeff_precision; qlp_coeff_precision++) {
3435                                                                         _candidate_bits =
3436                                                                                 evaluate_lpc_subframe_(
3437                                                                                         encoder,
3438                                                                                         integer_signal,
3439                                                                                         residual[!_best_subframe],
3440                                                                                         encoder->private_->abs_residual,
3441                                                                                         encoder->private_->abs_residual_partition_sums,
3442                                                                                         encoder->private_->raw_bits_per_partition,
3443                                                                                         encoder->private_->lp_coeff[lpc_order-1],
3444                                                                                         frame_header->blocksize,
3445                                                                                         subframe_bps,
3446                                                                                         lpc_order,
3447                                                                                         qlp_coeff_precision,
3448                                                                                         rice_parameter,
3449                                                                                         min_partition_order,
3450                                                                                         max_partition_order,
3451                                                                                         precompute_partition_sums,
3452                                                                                         encoder->protected_->do_escape_coding,
3453                                                                                         encoder->protected_->rice_parameter_search_dist,
3454                                                                                         subframe[!_best_subframe],
3455                                                                                         partitioned_rice_contents[!_best_subframe]
3456                                                                                 );
3457                                                                         if(_candidate_bits > 0) { /* if == 0, there was a problem quantizing the lpcoeffs */
3458                                                                                 if(_candidate_bits < _best_bits) {
3459                                                                                         _best_subframe = !_best_subframe;
3460                                                                                         _best_bits = _candidate_bits;
3461                                                                                 }
3462                                                                         }
3463                                                                 }
3464                                                         }
3465                                                 }
3466                                         }
3467                                 }
3468                         }
3469 #endif /* !defined FLAC__INTEGER_ONLY_LIBRARY */
3470                 }
3471         }
3472
3473         /* under rare circumstances this can happen when all but lpc subframe types are disabled: */
3474         if(_best_bits == UINT_MAX) {
3475                 FLAC__ASSERT(_best_subframe == 0);
3476                 _best_bits = evaluate_verbatim_subframe_(integer_signal, frame_header->blocksize, subframe_bps, subframe[_best_subframe]);
3477         }
3478
3479         *best_subframe = _best_subframe;
3480         *best_bits = _best_bits;
3481
3482         return true;
3483 }
3484
3485 FLAC__bool add_subframe_(
3486         FLAC__StreamEncoder *encoder,
3487         const FLAC__FrameHeader *frame_header,
3488         unsigned subframe_bps,
3489         const FLAC__Subframe *subframe,
3490         FLAC__BitBuffer *frame
3491 )
3492 {
3493         switch(subframe->type) {
3494                 case FLAC__SUBFRAME_TYPE_CONSTANT:
3495                         if(!FLAC__subframe_add_constant(&(subframe->data.constant), subframe_bps, subframe->wasted_bits, frame)) {
3496                                 encoder->protected_->state = FLAC__STREAM_ENCODER_FRAMING_ERROR;
3497                                 return false;
3498                         }
3499                         break;
3500                 case FLAC__SUBFRAME_TYPE_FIXED:
3501                         if(!FLAC__subframe_add_fixed(&(subframe->data.fixed), frame_header->blocksize - subframe->data.fixed.order, subframe_bps, subframe->wasted_bits, frame)) {
3502                                 encoder->protected_->state = FLAC__STREAM_ENCODER_FRAMING_ERROR;
3503                                 return false;
3504                         }
3505                         break;
3506                 case FLAC__SUBFRAME_TYPE_LPC:
3507                         if(!FLAC__subframe_add_lpc(&(subframe->data.lpc), frame_header->blocksize - subframe->data.lpc.order, subframe_bps, subframe->wasted_bits, frame)) {
3508                                 encoder->protected_->state = FLAC__STREAM_ENCODER_FRAMING_ERROR;
3509                                 return false;
3510                         }
3511                         break;
3512                 case FLAC__SUBFRAME_TYPE_VERBATIM:
3513                         if(!FLAC__subframe_add_verbatim(&(subframe->data.verbatim), frame_header->blocksize, subframe_bps, subframe->wasted_bits, frame)) {
3514                                 encoder->protected_->state = FLAC__STREAM_ENCODER_FRAMING_ERROR;
3515                                 return false;
3516                         }
3517                         break;
3518                 default:
3519                         FLAC__ASSERT(0);
3520         }
3521
3522         return true;
3523 }
3524
3525 unsigned evaluate_constant_subframe_(
3526         const FLAC__int32 signal,
3527         unsigned subframe_bps,
3528         FLAC__Subframe *subframe
3529 )
3530 {
3531         subframe->type = FLAC__SUBFRAME_TYPE_CONSTANT;
3532         subframe->data.constant.value = signal;
3533
3534         return FLAC__SUBFRAME_ZERO_PAD_LEN + FLAC__SUBFRAME_TYPE_LEN + FLAC__SUBFRAME_WASTED_BITS_FLAG_LEN + subframe_bps;
3535 }
3536
3537 unsigned evaluate_fixed_subframe_(
3538         FLAC__StreamEncoder *encoder,
3539         const FLAC__int32 signal[],
3540         FLAC__int32 residual[],
3541         FLAC__uint32 abs_residual[],
3542         FLAC__uint64 abs_residual_partition_sums[],
3543         unsigned raw_bits_per_partition[],
3544         unsigned blocksize,
3545         unsigned subframe_bps,
3546         unsigned order,
3547         unsigned rice_parameter,
3548         unsigned min_partition_order,
3549         unsigned max_partition_order,
3550         FLAC__bool precompute_partition_sums,
3551         FLAC__bool do_escape_coding,
3552         unsigned rice_parameter_search_dist,
3553         FLAC__Subframe *subframe,
3554         FLAC__EntropyCodingMethod_PartitionedRiceContents *partitioned_rice_contents
3555 )
3556 {
3557         unsigned i, residual_bits;
3558         const unsigned residual_samples = blocksize - order;
3559
3560         FLAC__fixed_compute_residual(signal+order, residual_samples, order, residual);
3561
3562         subframe->type = FLAC__SUBFRAME_TYPE_FIXED;
3563
3564         subframe->data.fixed.entropy_coding_method.type = FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE;
3565         subframe->data.fixed.entropy_coding_method.data.partitioned_rice.contents = partitioned_rice_contents;
3566         subframe->data.fixed.residual = residual;
3567
3568         residual_bits =
3569                 find_best_partition_order_(
3570                         encoder->private_,
3571                         residual,
3572                         abs_residual,
3573                         abs_residual_partition_sums,
3574                         raw_bits_per_partition,
3575                         residual_samples,
3576                         order,
3577                         rice_parameter,
3578                         min_partition_order,
3579                         max_partition_order,
3580                         precompute_partition_sums,
3581                         do_escape_coding,
3582                         rice_parameter_search_dist,
3583                         &subframe->data.fixed.entropy_coding_method.data.partitioned_rice
3584                 );
3585
3586         subframe->data.fixed.order = order;
3587         for(i = 0; i < order; i++)
3588                 subframe->data.fixed.warmup[i] = signal[i];
3589
3590         return FLAC__SUBFRAME_ZERO_PAD_LEN + FLAC__SUBFRAME_TYPE_LEN + FLAC__SUBFRAME_WASTED_BITS_FLAG_LEN + (order * subframe_bps) + residual_bits;
3591 }
3592
3593 #ifndef FLAC__INTEGER_ONLY_LIBRARY
3594 unsigned evaluate_lpc_subframe_(
3595         FLAC__StreamEncoder *encoder,
3596         const FLAC__int32 signal[],
3597         FLAC__int32 residual[],
3598         FLAC__uint32 abs_residual[],
3599         FLAC__uint64 abs_residual_partition_sums[],
3600         unsigned raw_bits_per_partition[],
3601         const FLAC__real lp_coeff[],
3602         unsigned blocksize,
3603         unsigned subframe_bps,
3604         unsigned order,
3605         unsigned qlp_coeff_precision,
3606         unsigned rice_parameter,
3607         unsigned min_partition_order,
3608         unsigned max_partition_order,
3609         FLAC__bool precompute_partition_sums,
3610         FLAC__bool do_escape_coding,
3611         unsigned rice_parameter_search_dist,
3612         FLAC__Subframe *subframe,
3613         FLAC__EntropyCodingMethod_PartitionedRiceContents *partitioned_rice_contents
3614 )
3615 {
3616         FLAC__int32 qlp_coeff[FLAC__MAX_LPC_ORDER];
3617         unsigned i, residual_bits;
3618         int quantization, ret;
3619         const unsigned residual_samples = blocksize - order;
3620
3621         /* try to keep qlp coeff precision such that only 32-bit math is required for decode of <=16bps streams */
3622         if(subframe_bps <= 16) {
3623                 FLAC__ASSERT(order > 0);
3624                 FLAC__ASSERT(order <= FLAC__MAX_LPC_ORDER);
3625                 qlp_coeff_precision = min(qlp_coeff_precision, 32 - subframe_bps - FLAC__bitmath_ilog2(order));
3626         }
3627
3628         ret = FLAC__lpc_quantize_coefficients(lp_coeff, order, qlp_coeff_precision, qlp_coeff, &quantization);
3629         if(ret != 0)
3630                 return 0; /* this is a hack to indicate to the caller that we can't do lp at this order on this subframe */
3631
3632         if(subframe_bps + qlp_coeff_precision + FLAC__bitmath_ilog2(order) <= 32)
3633                 if(subframe_bps <= 16 && qlp_coeff_precision <= 16)
3634                         encoder->private_->local_lpc_compute_residual_from_qlp_coefficients_16bit(signal+order, residual_samples, qlp_coeff, order, quantization, residual);
3635                 else
3636                         encoder->private_->local_lpc_compute_residual_from_qlp_coefficients(signal+order, residual_samples, qlp_coeff, order, quantization, residual);
3637         else
3638                 encoder->private_->local_lpc_compute_residual_from_qlp_coefficients_64bit(signal+order, residual_samples, qlp_coeff, order, quantization, residual);
3639
3640         subframe->type = FLAC__SUBFRAME_TYPE_LPC;
3641
3642         subframe->data.lpc.entropy_coding_method.type = FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE;
3643         subframe->data.lpc.entropy_coding_method.data.partitioned_rice.contents = partitioned_rice_contents;
3644         subframe->data.lpc.residual = residual;
3645
3646         residual_bits =
3647                 find_best_partition_order_(
3648                         encoder->private_,
3649                         residual,
3650                         abs_residual,
3651                         abs_residual_partition_sums,
3652                         raw_bits_per_partition,
3653                         residual_samples,
3654                         order,
3655                         rice_parameter,
3656                         min_partition_order,
3657                         max_partition_order,
3658                         precompute_partition_sums,
3659                         do_escape_coding,
3660                         rice_parameter_search_dist,
3661                         &subframe->data.fixed.entropy_coding_method.data.partitioned_rice
3662                 );
3663
3664         subframe->data.lpc.order = order;
3665         subframe->data.lpc.qlp_coeff_precision = qlp_coeff_precision;
3666         subframe->data.lpc.quantization_level = quantization;
3667         memcpy(subframe->data.lpc.qlp_coeff, qlp_coeff, sizeof(FLAC__int32)*FLAC__MAX_LPC_ORDER);
3668         for(i = 0; i < order; i++)
3669                 subframe->data.lpc.warmup[i] = signal[i];
3670
3671         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;
3672 }
3673 #endif
3674
3675 unsigned evaluate_verbatim_subframe_(
3676         const FLAC__int32 signal[],
3677         unsigned blocksize,
3678         unsigned subframe_bps,
3679         FLAC__Subframe *subframe
3680 )
3681 {
3682         subframe->type = FLAC__SUBFRAME_TYPE_VERBATIM;
3683
3684         subframe->data.verbatim.data = signal;
3685
3686         return FLAC__SUBFRAME_ZERO_PAD_LEN + FLAC__SUBFRAME_TYPE_LEN + FLAC__SUBFRAME_WASTED_BITS_FLAG_LEN + (blocksize * subframe_bps);
3687 }
3688
3689 unsigned find_best_partition_order_(
3690         FLAC__StreamEncoderPrivate *private_,
3691         const FLAC__int32 residual[],
3692         FLAC__uint32 abs_residual[],
3693         FLAC__uint64 abs_residual_partition_sums[],
3694         unsigned raw_bits_per_partition[],
3695         unsigned residual_samples,
3696         unsigned predictor_order,
3697         unsigned rice_parameter,
3698         unsigned min_partition_order,
3699         unsigned max_partition_order,
3700         FLAC__bool precompute_partition_sums,
3701         FLAC__bool do_escape_coding,
3702         unsigned rice_parameter_search_dist,
3703         FLAC__EntropyCodingMethod_PartitionedRice *best_partitioned_rice
3704 )
3705 {
3706         FLAC__int32 r;
3707         unsigned residual_bits, best_residual_bits = 0;
3708         unsigned residual_sample;
3709         unsigned best_parameters_index = 0;
3710         const unsigned blocksize = residual_samples + predictor_order;
3711
3712         /* compute abs(residual) for use later */
3713         for(residual_sample = 0; residual_sample < residual_samples; residual_sample++) {
3714                 r = residual[residual_sample];
3715                 abs_residual[residual_sample] = (FLAC__uint32)(r<0? -r : r);
3716         }
3717
3718         max_partition_order = FLAC__format_get_max_rice_partition_order_from_blocksize_limited_max_and_predictor_order(max_partition_order, blocksize, predictor_order);
3719         min_partition_order = min(min_partition_order, max_partition_order);
3720
3721         if(precompute_partition_sums) {
3722                 int partition_order;
3723                 unsigned sum;
3724
3725                 precompute_partition_info_sums_(abs_residual, abs_residual_partition_sums, residual_samples, predictor_order, min_partition_order, max_partition_order);
3726
3727                 if(do_escape_coding)
3728                         precompute_partition_info_escapes_(residual, raw_bits_per_partition, residual_samples, predictor_order, min_partition_order, max_partition_order);
3729
3730                 for(partition_order = (int)max_partition_order, sum = 0; partition_order >= (int)min_partition_order; partition_order--) {
3731 #ifdef DONT_ESTIMATE_RICE_BITS
3732                         if(!
3733                                 set_partitioned_rice_with_precompute_(
3734                                         residual,
3735                                         abs_residual_partition_sums+sum,
3736                                         raw_bits_per_partition+sum,
3737                                         residual_samples,
3738                                         predictor_order,
3739                                         rice_parameter,
3740                                         rice_parameter_search_dist,
3741                                         (unsigned)partition_order,
3742                                         do_escape_coding,
3743                                         &private_->partitioned_rice_contents_extra[!best_parameters_index],
3744                                         &residual_bits
3745                                 )
3746                         )
3747 #else
3748                         if(!
3749                                 set_partitioned_rice_with_precompute_(
3750                                         abs_residual,
3751                                         abs_residual_partition_sums+sum,
3752                                         raw_bits_per_partition+sum,
3753                                         residual_samples,
3754                                         predictor_order,
3755                                         rice_parameter,
3756                                         rice_parameter_search_dist,
3757                                         (unsigned)partition_order,
3758                                         do_escape_coding,
3759                                         &private_->partitioned_rice_contents_extra[!best_parameters_index],
3760                                         &residual_bits
3761                                 )
3762                         )
3763 #endif
3764                         {
3765                                 FLAC__ASSERT(best_residual_bits != 0);
3766                                 break;
3767                         }
3768                         sum += 1u << partition_order;
3769                         if(best_residual_bits == 0 || residual_bits < best_residual_bits) {
3770                                 best_residual_bits = residual_bits;
3771                                 best_parameters_index = !best_parameters_index;
3772                                 best_partitioned_rice->order = partition_order;
3773                         }
3774                 }
3775         }
3776         else {
3777                 unsigned partition_order;
3778                 for(partition_order = min_partition_order; partition_order <= max_partition_order; partition_order++) {
3779 #ifdef DONT_ESTIMATE_RICE_BITS
3780                         if(!
3781                                 set_partitioned_rice_(
3782                                         abs_residual,
3783                                         residual,
3784                                         residual_samples,
3785                                         predictor_order,
3786                                         rice_parameter,
3787                                         rice_parameter_search_dist,
3788                                         partition_order,
3789                                         &private_->partitioned_rice_contents_extra[!best_parameters_index],
3790                                         &residual_bits
3791                                 )
3792                         )
3793 #else
3794                         if(!
3795                                 set_partitioned_rice_(
3796                                         abs_residual,
3797                                         residual_samples,
3798                                         predictor_order,
3799                                         rice_parameter,
3800                                         rice_parameter_search_dist,
3801                                         partition_order,
3802                                         &private_->partitioned_rice_contents_extra[!best_parameters_index],
3803                                         &residual_bits
3804                                 )
3805                         )
3806 #endif
3807                         {
3808                                 FLAC__ASSERT(best_residual_bits != 0);
3809                                 break;
3810                         }
3811                         if(best_residual_bits == 0 || residual_bits < best_residual_bits) {
3812                                 best_residual_bits = residual_bits;
3813                                 best_parameters_index = !best_parameters_index;
3814                                 best_partitioned_rice->order = partition_order;
3815                         }
3816                 }
3817         }
3818
3819         /*
3820          * We are allowed to de-const the pointer based on our special knowledge;
3821          * it is const to the outside world.
3822          */
3823         {
3824                 FLAC__EntropyCodingMethod_PartitionedRiceContents* best_partitioned_rice_contents = (FLAC__EntropyCodingMethod_PartitionedRiceContents*)best_partitioned_rice->contents;
3825                 FLAC__format_entropy_coding_method_partitioned_rice_contents_ensure_size(best_partitioned_rice_contents, max(6, best_partitioned_rice->order));
3826                 memcpy(best_partitioned_rice_contents->parameters, private_->partitioned_rice_contents_extra[best_parameters_index].parameters, sizeof(unsigned)*(1<<(best_partitioned_rice->order)));
3827                 memcpy(best_partitioned_rice_contents->raw_bits, private_->partitioned_rice_contents_extra[best_parameters_index].raw_bits, sizeof(unsigned)*(1<<(best_partitioned_rice->order)));
3828         }
3829
3830         return best_residual_bits;
3831 }
3832
3833 void precompute_partition_info_sums_(
3834         const FLAC__uint32 abs_residual[],
3835         FLAC__uint64 abs_residual_partition_sums[],
3836         unsigned residual_samples,
3837         unsigned predictor_order,
3838         unsigned min_partition_order,
3839         unsigned max_partition_order
3840 )
3841 {
3842         int partition_order;
3843         unsigned from_partition, to_partition = 0;
3844         const unsigned blocksize = residual_samples + predictor_order;
3845
3846         /* first do max_partition_order */
3847         for(partition_order = (int)max_partition_order; partition_order >= 0; partition_order--) {
3848                 FLAC__uint64 abs_residual_partition_sum;
3849                 FLAC__uint32 abs_r;
3850                 unsigned partition, partition_sample, partition_samples, residual_sample;
3851                 const unsigned partitions = 1u << partition_order;
3852                 const unsigned default_partition_samples = blocksize >> partition_order;
3853
3854                 FLAC__ASSERT(default_partition_samples > predictor_order);
3855
3856                 for(partition = residual_sample = 0; partition < partitions; partition++) {
3857                         partition_samples = default_partition_samples;
3858                         if(partition == 0)
3859                                 partition_samples -= predictor_order;
3860                         abs_residual_partition_sum = 0;
3861                         for(partition_sample = 0; partition_sample < partition_samples; partition_sample++) {
3862                                 abs_r = abs_residual[residual_sample];
3863                                 abs_residual_partition_sum += abs_r;
3864                                 residual_sample++;
3865                         }
3866                         abs_residual_partition_sums[partition] = abs_residual_partition_sum;
3867                 }
3868                 to_partition = partitions;
3869                 break;
3870         }
3871
3872         /* now merge partitions for lower orders */
3873         for(from_partition = 0, --partition_order; partition_order >= (int)min_partition_order; partition_order--) {
3874                 FLAC__uint64 s;
3875                 unsigned i;
3876                 const unsigned partitions = 1u << partition_order;
3877                 for(i = 0; i < partitions; i++) {
3878                         s = abs_residual_partition_sums[from_partition];
3879                         from_partition++;
3880                         abs_residual_partition_sums[to_partition] = s + abs_residual_partition_sums[from_partition];
3881                         from_partition++;
3882                         to_partition++;
3883                 }
3884         }
3885 }
3886
3887 void precompute_partition_info_escapes_(
3888         const FLAC__int32 residual[],
3889         unsigned raw_bits_per_partition[],
3890         unsigned residual_samples,
3891         unsigned predictor_order,
3892         unsigned min_partition_order,
3893         unsigned max_partition_order
3894 )
3895 {
3896         int partition_order;
3897         unsigned from_partition, to_partition = 0;
3898         const unsigned blocksize = residual_samples + predictor_order;
3899
3900         /* first do max_partition_order */
3901         for(partition_order = (int)max_partition_order; partition_order >= 0; partition_order--) {
3902                 FLAC__int32 r, residual_partition_min, residual_partition_max;
3903                 unsigned silog2_min, silog2_max;
3904                 unsigned partition, partition_sample, partition_samples, residual_sample;
3905                 const unsigned partitions = 1u << partition_order;
3906                 const unsigned default_partition_samples = blocksize >> partition_order;
3907
3908                 FLAC__ASSERT(default_partition_samples > predictor_order);
3909
3910                 for(partition = residual_sample = 0; partition < partitions; partition++) {
3911                         partition_samples = default_partition_samples;
3912                         if(partition == 0)
3913                                 partition_samples -= predictor_order;
3914                         residual_partition_min = residual_partition_max = 0;
3915                         for(partition_sample = 0; partition_sample < partition_samples; partition_sample++) {
3916                                 r = residual[residual_sample];
3917                                 if(r < residual_partition_min)
3918                                         residual_partition_min = r;
3919                                 else if(r > residual_partition_max)
3920                                         residual_partition_max = r;
3921                                 residual_sample++;
3922                         }
3923                         silog2_min = FLAC__bitmath_silog2(residual_partition_min);
3924                         silog2_max = FLAC__bitmath_silog2(residual_partition_max);
3925                         raw_bits_per_partition[partition] = max(silog2_min, silog2_max);
3926                 }
3927                 to_partition = partitions;
3928                 break; /*@@@ yuck, should remove the 'for' loop instead */
3929         }
3930
3931         /* now merge partitions for lower orders */
3932         for(from_partition = 0, --partition_order; partition_order >= (int)min_partition_order; partition_order--) {
3933                 unsigned m;
3934                 unsigned i;
3935                 const unsigned partitions = 1u << partition_order;
3936                 for(i = 0; i < partitions; i++) {
3937                         m = raw_bits_per_partition[from_partition];
3938                         from_partition++;
3939                         raw_bits_per_partition[to_partition] = max(m, raw_bits_per_partition[from_partition]);
3940                         from_partition++;
3941                         to_partition++;
3942                 }
3943         }
3944 }
3945
3946 #ifdef VARIABLE_RICE_BITS
3947 #undef VARIABLE_RICE_BITS
3948 #endif
3949 #ifndef DONT_ESTIMATE_RICE_BITS
3950 #define VARIABLE_RICE_BITS(value, parameter) ((value) >> (parameter))
3951 #endif
3952
3953 #ifdef DONT_ESTIMATE_RICE_BITS
3954 FLAC__bool set_partitioned_rice_(
3955         const FLAC__uint32 abs_residual[],
3956         const FLAC__int32 residual[],
3957         const unsigned residual_samples,
3958         const unsigned predictor_order,
3959         const unsigned suggested_rice_parameter,
3960         const unsigned rice_parameter_search_dist,
3961         const unsigned partition_order,
3962         FLAC__EntropyCodingMethod_PartitionedRiceContents *partitioned_rice_contents,
3963         unsigned *bits
3964 )
3965 #else
3966 FLAC__bool set_partitioned_rice_(
3967         const FLAC__uint32 abs_residual[],
3968         const unsigned residual_samples,
3969         const unsigned predictor_order,
3970         const unsigned suggested_rice_parameter,
3971         const unsigned rice_parameter_search_dist,
3972         const unsigned partition_order,
3973         FLAC__EntropyCodingMethod_PartitionedRiceContents *partitioned_rice_contents,
3974         unsigned *bits
3975 )
3976 #endif
3977 {
3978         unsigned rice_parameter, partition_bits;
3979 #ifndef NO_RICE_SEARCH
3980         unsigned best_partition_bits;
3981         unsigned min_rice_parameter, max_rice_parameter, best_rice_parameter = 0;
3982 #endif
3983         unsigned bits_ = FLAC__ENTROPY_CODING_METHOD_TYPE_LEN + FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE_ORDER_LEN;
3984         unsigned *parameters;
3985
3986         FLAC__ASSERT(suggested_rice_parameter < FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE_ESCAPE_PARAMETER);
3987
3988         FLAC__format_entropy_coding_method_partitioned_rice_contents_ensure_size(partitioned_rice_contents, max(6, partition_order));
3989         parameters = partitioned_rice_contents->parameters;
3990
3991         if(partition_order == 0) {
3992                 unsigned i;
3993
3994 #ifndef NO_RICE_SEARCH
3995                 if(rice_parameter_search_dist) {
3996                         if(suggested_rice_parameter < rice_parameter_search_dist)
3997                                 min_rice_parameter = 0;
3998                         else
3999                                 min_rice_parameter = suggested_rice_parameter - rice_parameter_search_dist;
4000                         max_rice_parameter = suggested_rice_parameter + rice_parameter_search_dist;
4001                         if(max_rice_parameter >= FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE_ESCAPE_PARAMETER) {
4002 #ifdef DEBUG_VERBOSE
4003                                 fprintf(stderr, "clipping rice_parameter (%u -> %u) @2\n", max_rice_parameter, FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE_ESCAPE_PARAMETER - 1);
4004 #endif
4005                                 max_rice_parameter = FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE_ESCAPE_PARAMETER - 1;
4006                         }
4007                 }
4008                 else
4009                         min_rice_parameter = max_rice_parameter = suggested_rice_parameter;
4010
4011                 best_partition_bits = 0xffffffff;
4012                 for(rice_parameter = min_rice_parameter; rice_parameter <= max_rice_parameter; rice_parameter++) {
4013 #endif
4014 #ifdef VARIABLE_RICE_BITS
4015                         const unsigned rice_parameter_estimate = rice_parameter-1;
4016                         partition_bits = (1+rice_parameter) * residual_samples;
4017 #else
4018                         partition_bits = 0;
4019 #endif
4020                         partition_bits += FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE_PARAMETER_LEN;
4021                         for(i = 0; i < residual_samples; i++) {
4022 #ifdef VARIABLE_RICE_BITS
4023                                 partition_bits += VARIABLE_RICE_BITS(abs_residual[i], rice_parameter_estimate);
4024 #else
4025                                 partition_bits += FLAC__bitbuffer_rice_bits(residual[i], rice_parameter); /* NOTE: we will need to pass in residual[] in addition to abs_residual[] */
4026 #endif
4027                         }
4028 #ifndef NO_RICE_SEARCH
4029                         if(partition_bits < best_partition_bits) {
4030                                 best_rice_parameter = rice_parameter;
4031                                 best_partition_bits = partition_bits;
4032                         }
4033                 }
4034 #endif
4035                 parameters[0] = best_rice_parameter;
4036                 bits_ += best_partition_bits;
4037         }
4038         else {
4039                 unsigned partition, residual_sample, save_residual_sample, partition_sample;
4040                 unsigned partition_samples;
4041                 FLAC__uint64 mean, k;
4042                 const unsigned partitions = 1u << partition_order;
4043                 for(partition = residual_sample = 0; partition < partitions; partition++) {
4044                         partition_samples = (residual_samples+predictor_order) >> partition_order;
4045                         if(partition == 0) {
4046                                 if(partition_samples <= predictor_order)
4047                                         return false;
4048                                 else
4049                                         partition_samples -= predictor_order;
4050                         }
4051                         mean = 0;
4052                         save_residual_sample = residual_sample;
4053                         for(partition_sample = 0; partition_sample < partition_samples; residual_sample++, partition_sample++)
4054                                 mean += abs_residual[residual_sample];
4055                         residual_sample = save_residual_sample;
4056                         /* we are basically calculating the size in bits of the
4057                          * average residual magnitude in the partition:
4058                          *   rice_parameter = floor(log2(mean/partition_samples))
4059                          * 'mean' is not a good name for the variable, it is
4060                          * actually the sum of magnitudes of all residual values
4061                          * in the partition, so the actual mean is
4062                          * mean/partition_samples
4063                          */
4064                         for(rice_parameter = 0, k = partition_samples; k < mean; rice_parameter++, k <<= 1)
4065                                 ;
4066                         if(rice_parameter >= FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE_ESCAPE_PARAMETER) {
4067 #ifdef DEBUG_VERBOSE
4068                                 fprintf(stderr, "clipping rice_parameter (%u -> %u) @3\n", rice_parameter, FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE_ESCAPE_PARAMETER - 1);
4069 #endif
4070                                 rice_parameter = FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE_ESCAPE_PARAMETER - 1;
4071                         }
4072
4073 #ifndef NO_RICE_SEARCH
4074                         if(rice_parameter_search_dist) {
4075                                 if(rice_parameter < rice_parameter_search_dist)
4076                                         min_rice_parameter = 0;
4077                                 else
4078                                         min_rice_parameter = rice_parameter - rice_parameter_search_dist;
4079                                 max_rice_parameter = rice_parameter + rice_parameter_search_dist;
4080                                 if(max_rice_parameter >= FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE_ESCAPE_PARAMETER) {
4081 #ifdef DEBUG_VERBOSE
4082                                         fprintf(stderr, "clipping rice_parameter (%u -> %u) @4\n", max_rice_parameter, FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE_ESCAPE_PARAMETER - 1);
4083 #endif
4084                                         max_rice_parameter = FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE_ESCAPE_PARAMETER - 1;
4085                                 }
4086                         }
4087                         else
4088                                 min_rice_parameter = max_rice_parameter = rice_parameter;
4089
4090                         best_partition_bits = 0xffffffff;
4091                         for(rice_parameter = min_rice_parameter; rice_parameter <= max_rice_parameter; rice_parameter++) {
4092 #endif
4093 #ifdef VARIABLE_RICE_BITS
4094                                 const unsigned rice_parameter_estimate = rice_parameter-1;
4095                                 partition_bits = (1+rice_parameter) * partition_samples;
4096 #else
4097                                 partition_bits = 0;
4098 #endif
4099                                 partition_bits += FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE_PARAMETER_LEN;
4100                                 save_residual_sample = residual_sample;
4101                                 for(partition_sample = 0; partition_sample < partition_samples; residual_sample++, partition_sample++) {
4102 #ifdef VARIABLE_RICE_BITS
4103                                         partition_bits += VARIABLE_RICE_BITS(abs_residual[residual_sample], rice_parameter_estimate);
4104 #else
4105                                         partition_bits += FLAC__bitbuffer_rice_bits(residual[residual_sample], rice_parameter); /* NOTE: we will need to pass in residual[] in addition to abs_residual[] */
4106 #endif
4107                                 }
4108 #ifndef NO_RICE_SEARCH
4109                                 if(rice_parameter != max_rice_parameter)
4110                                         residual_sample = save_residual_sample;
4111                                 if(partition_bits < best_partition_bits) {
4112                                         best_rice_parameter = rice_parameter;
4113                                         best_partition_bits = partition_bits;
4114                                 }
4115                         }
4116 #endif
4117                         parameters[partition] = best_rice_parameter;
4118                         bits_ += best_partition_bits;
4119                 }
4120         }
4121
4122         *bits = bits_;
4123         return true;
4124 }
4125
4126 #ifdef DONT_ESTIMATE_RICE_BITS
4127 FLAC__bool set_partitioned_rice_with_precompute_(
4128         const FLAC__int32 residual[],
4129         const FLAC__uint64 abs_residual_partition_sums[],
4130         const unsigned raw_bits_per_partition[],
4131         const unsigned residual_samples,
4132         const unsigned predictor_order,
4133         const unsigned suggested_rice_parameter,
4134         const unsigned rice_parameter_search_dist,
4135         const unsigned partition_order,
4136         const FLAC__bool search_for_escapes,
4137         FLAC__EntropyCodingMethod_PartitionedRiceContents *partitioned_rice_contents,
4138         unsigned *bits
4139 )
4140 #else
4141 FLAC__bool set_partitioned_rice_with_precompute_(
4142         const FLAC__uint32 abs_residual[],
4143         const FLAC__uint64 abs_residual_partition_sums[],
4144         const unsigned raw_bits_per_partition[],
4145         const unsigned residual_samples,
4146         const unsigned predictor_order,
4147         const unsigned suggested_rice_parameter,
4148         const unsigned rice_parameter_search_dist,
4149         const unsigned partition_order,
4150         const FLAC__bool search_for_escapes,
4151         FLAC__EntropyCodingMethod_PartitionedRiceContents *partitioned_rice_contents,
4152         unsigned *bits
4153 )
4154 #endif
4155 {
4156         unsigned rice_parameter, partition_bits;
4157 #ifndef NO_RICE_SEARCH
4158         unsigned best_partition_bits;
4159         unsigned min_rice_parameter, max_rice_parameter, best_rice_parameter = 0;
4160 #endif
4161         unsigned flat_bits;
4162         unsigned bits_ = FLAC__ENTROPY_CODING_METHOD_TYPE_LEN + FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE_ORDER_LEN;
4163         unsigned *parameters, *raw_bits;
4164
4165         FLAC__ASSERT(suggested_rice_parameter < FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE_ESCAPE_PARAMETER);
4166
4167         FLAC__format_entropy_coding_method_partitioned_rice_contents_ensure_size(partitioned_rice_contents, max(6, partition_order));
4168         parameters = partitioned_rice_contents->parameters;
4169         raw_bits = partitioned_rice_contents->raw_bits;
4170
4171         if(partition_order == 0) {
4172                 unsigned i;
4173
4174 #ifndef NO_RICE_SEARCH
4175                 if(rice_parameter_search_dist) {
4176                         if(suggested_rice_parameter < rice_parameter_search_dist)
4177                                 min_rice_parameter = 0;
4178                         else
4179                                 min_rice_parameter = suggested_rice_parameter - rice_parameter_search_dist;
4180                         max_rice_parameter = suggested_rice_parameter + rice_parameter_search_dist;
4181                         if(max_rice_parameter >= FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE_ESCAPE_PARAMETER) {
4182 #ifdef DEBUG_VERBOSE
4183                                 fprintf(stderr, "clipping rice_parameter (%u -> %u) @5\n", max_rice_parameter, FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE_ESCAPE_PARAMETER - 1);
4184 #endif
4185                                 max_rice_parameter = FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE_ESCAPE_PARAMETER - 1;
4186                         }
4187                 }
4188                 else
4189                         min_rice_parameter = max_rice_parameter = suggested_rice_parameter;
4190
4191                 best_partition_bits = 0xffffffff;
4192                 for(rice_parameter = min_rice_parameter; rice_parameter <= max_rice_parameter; rice_parameter++) {
4193 #endif
4194 #ifdef VARIABLE_RICE_BITS
4195                         const unsigned rice_parameter_estimate = rice_parameter-1;
4196                         partition_bits = (1+rice_parameter) * residual_samples;
4197 #else
4198                         partition_bits = 0;
4199 #endif
4200                         partition_bits += FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE_PARAMETER_LEN;
4201                         for(i = 0; i < residual_samples; i++) {
4202 #ifdef VARIABLE_RICE_BITS
4203                                 partition_bits += VARIABLE_RICE_BITS(abs_residual[i], rice_parameter_estimate);
4204 #else
4205                                 partition_bits += FLAC__bitbuffer_rice_bits(residual[i], rice_parameter); /* NOTE: we will need to pass in residual[] instead of abs_residual[] */
4206 #endif
4207                         }
4208 #ifndef NO_RICE_SEARCH
4209                         if(partition_bits < best_partition_bits) {
4210                                 best_rice_parameter = rice_parameter;
4211                                 best_partition_bits = partition_bits;
4212                         }
4213                 }
4214 #endif
4215                 if(search_for_escapes) {
4216                         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;
4217                         if(flat_bits <= best_partition_bits) {
4218                                 raw_bits[0] = raw_bits_per_partition[0];
4219                                 best_rice_parameter = FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE_ESCAPE_PARAMETER;
4220                                 best_partition_bits = flat_bits;
4221                         }
4222                 }
4223                 parameters[0] = best_rice_parameter;
4224                 bits_ += best_partition_bits;
4225         }
4226         else {
4227                 unsigned partition, residual_sample, save_residual_sample, partition_sample;
4228                 unsigned partition_samples;
4229                 FLAC__uint64 mean, k;
4230                 const unsigned partitions = 1u << partition_order;
4231                 for(partition = residual_sample = 0; partition < partitions; partition++) {
4232                         partition_samples = (residual_samples+predictor_order) >> partition_order;
4233                         if(partition == 0) {
4234                                 if(partition_samples <= predictor_order)
4235                                         return false;
4236                                 else
4237                                         partition_samples -= predictor_order;
4238                         }
4239                         mean = abs_residual_partition_sums[partition];
4240                         /* we are basically calculating the size in bits of the
4241                          * average residual magnitude in the partition:
4242                          *   rice_parameter = floor(log2(mean/partition_samples))
4243                          * 'mean' is not a good name for the variable, it is
4244                          * actually the sum of magnitudes of all residual values
4245                          * in the partition, so the actual mean is
4246                          * mean/partition_samples
4247                          */
4248                         for(rice_parameter = 0, k = partition_samples; k < mean; rice_parameter++, k <<= 1)
4249                                 ;
4250                         if(rice_parameter >= FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE_ESCAPE_PARAMETER) {
4251 #ifdef DEBUG_VERBOSE
4252                                 fprintf(stderr, "clipping rice_parameter (%u -> %u) @6\n", rice_parameter, FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE_ESCAPE_PARAMETER - 1);
4253 #endif
4254                                 rice_parameter = FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE_ESCAPE_PARAMETER - 1;
4255                         }
4256
4257 #ifndef NO_RICE_SEARCH
4258                         if(rice_parameter_search_dist) {
4259                                 if(rice_parameter < rice_parameter_search_dist)
4260                                         min_rice_parameter = 0;
4261                                 else
4262                                         min_rice_parameter = rice_parameter - rice_parameter_search_dist;
4263                                 max_rice_parameter = rice_parameter + rice_parameter_search_dist;
4264                                 if(max_rice_parameter >= FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE_ESCAPE_PARAMETER) {
4265 #ifdef DEBUG_VERBOSE
4266                                         fprintf(stderr, "clipping rice_parameter (%u -> %u) @7\n", max_rice_parameter, FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE_ESCAPE_PARAMETER - 1);
4267 #endif
4268                                         max_rice_parameter = FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE_ESCAPE_PARAMETER - 1;
4269                                 }
4270                         }
4271                         else
4272                                 min_rice_parameter = max_rice_parameter = rice_parameter;
4273
4274                         best_partition_bits = 0xffffffff;
4275                         for(rice_parameter = min_rice_parameter; rice_parameter <= max_rice_parameter; rice_parameter++) {
4276 #endif
4277 #ifdef VARIABLE_RICE_BITS
4278                                 const unsigned rice_parameter_estimate = rice_parameter-1;
4279                                 partition_bits = (1+rice_parameter) * partition_samples;
4280 #else
4281                                 partition_bits = 0;
4282 #endif
4283                                 partition_bits += FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE_PARAMETER_LEN;
4284                                 save_residual_sample = residual_sample;
4285                                 for(partition_sample = 0; partition_sample < partition_samples; residual_sample++, partition_sample++) {
4286 #ifdef VARIABLE_RICE_BITS
4287                                         partition_bits += VARIABLE_RICE_BITS(abs_residual[residual_sample], rice_parameter_estimate);
4288 #else
4289                                         partition_bits += FLAC__bitbuffer_rice_bits(residual[residual_sample], rice_parameter); /* NOTE: we will need to pass in residual[] instead of abs_residual[] */
4290 #endif
4291                                 }
4292 #ifndef NO_RICE_SEARCH
4293                                 if(rice_parameter != max_rice_parameter)
4294                                         residual_sample = save_residual_sample;
4295                                 if(partition_bits < best_partition_bits) {
4296                                         best_rice_parameter = rice_parameter;
4297                                         best_partition_bits = partition_bits;
4298                                 }
4299                         }
4300 #endif
4301                         if(search_for_escapes) {
4302                                 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;
4303                                 if(flat_bits <= best_partition_bits) {
4304                                         raw_bits[partition] = raw_bits_per_partition[partition];
4305                                         best_rice_parameter = FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE_ESCAPE_PARAMETER;
4306                                         best_partition_bits = flat_bits;
4307                                 }
4308                         }
4309                         parameters[partition] = best_rice_parameter;
4310                         bits_ += best_partition_bits;
4311                 }
4312         }
4313
4314         *bits = bits_;
4315         return true;
4316 }
4317
4318 unsigned get_wasted_bits_(FLAC__int32 signal[], unsigned samples)
4319 {
4320         unsigned i, shift;
4321         FLAC__int32 x = 0;
4322
4323         for(i = 0; i < samples && !(x&1); i++)
4324                 x |= signal[i];
4325
4326         if(x == 0) {
4327                 shift = 0;
4328         }
4329         else {
4330                 for(shift = 0; !(x&1); shift++)
4331                         x >>= 1;
4332         }
4333
4334         if(shift > 0) {
4335                 for(i = 0; i < samples; i++)
4336                          signal[i] >>= shift;
4337         }
4338
4339         return shift;
4340 }
4341
4342 void append_to_verify_fifo_(verify_input_fifo *fifo, const FLAC__int32 * const input[], unsigned input_offset, unsigned channels, unsigned wide_samples)
4343 {
4344         unsigned channel;
4345
4346         for(channel = 0; channel < channels; channel++)
4347                 memcpy(&fifo->data[channel][fifo->tail], &input[channel][input_offset], sizeof(FLAC__int32) * wide_samples);
4348
4349         fifo->tail += wide_samples;
4350
4351         FLAC__ASSERT(fifo->tail <= fifo->size);
4352 }
4353
4354 void append_to_verify_fifo_interleaved_(verify_input_fifo *fifo, const FLAC__int32 input[], unsigned input_offset, unsigned channels, unsigned wide_samples)
4355 {
4356         unsigned channel;
4357         unsigned sample, wide_sample;
4358         unsigned tail = fifo->tail;
4359
4360         sample = input_offset * channels;
4361         for(wide_sample = 0; wide_sample < wide_samples; wide_sample++) {
4362                 for(channel = 0; channel < channels; channel++)
4363                         fifo->data[channel][tail] = input[sample++];
4364                 tail++;
4365         }
4366         fifo->tail = tail;
4367
4368         FLAC__ASSERT(fifo->tail <= fifo->size);
4369 }
4370
4371 FLAC__StreamDecoderReadStatus verify_read_callback_(const FLAC__StreamDecoder *decoder, FLAC__byte buffer[], size_t *bytes, void *client_data)
4372 {
4373         FLAC__StreamEncoder *encoder = (FLAC__StreamEncoder*)client_data;
4374         const size_t encoded_bytes = encoder->private_->verify.output.bytes;
4375         (void)decoder;
4376
4377         if(encoder->private_->verify.needs_magic_hack) {
4378                 FLAC__ASSERT(*bytes >= FLAC__STREAM_SYNC_LENGTH);
4379                 *bytes = FLAC__STREAM_SYNC_LENGTH;
4380                 memcpy(buffer, FLAC__STREAM_SYNC_STRING, *bytes);
4381                 encoder->private_->verify.needs_magic_hack = false;
4382         }
4383         else {
4384                 if(encoded_bytes == 0) {
4385                         /*
4386                          * If we get here, a FIFO underflow has occurred,
4387                          * which means there is a bug somewhere.
4388                          */
4389                         FLAC__ASSERT(0);
4390                         return FLAC__STREAM_DECODER_READ_STATUS_ABORT;
4391                 }
4392                 else if(encoded_bytes < *bytes)
4393                         *bytes = encoded_bytes;
4394                 memcpy(buffer, encoder->private_->verify.output.data, *bytes);
4395                 encoder->private_->verify.output.data += *bytes;
4396                 encoder->private_->verify.output.bytes -= *bytes;
4397         }
4398
4399         return FLAC__STREAM_DECODER_READ_STATUS_CONTINUE;
4400 }
4401
4402 FLAC__StreamDecoderWriteStatus verify_write_callback_(const FLAC__StreamDecoder *decoder, const FLAC__Frame *frame, const FLAC__int32 * const buffer[], void *client_data)
4403 {
4404         FLAC__StreamEncoder *encoder = (FLAC__StreamEncoder *)client_data;
4405         unsigned channel;
4406         const unsigned channels = FLAC__stream_decoder_get_channels(decoder);
4407         const unsigned blocksize = frame->header.blocksize;
4408         const unsigned bytes_per_block = sizeof(FLAC__int32) * blocksize;
4409
4410         for(channel = 0; channel < channels; channel++) {
4411                 if(0 != memcmp(buffer[channel], encoder->private_->verify.input_fifo.data[channel], bytes_per_block)) {
4412                         unsigned i, sample = 0;
4413                         FLAC__int32 expect = 0, got = 0;
4414
4415                         for(i = 0; i < blocksize; i++) {
4416                                 if(buffer[channel][i] != encoder->private_->verify.input_fifo.data[channel][i]) {
4417                                         sample = i;
4418                                         expect = (FLAC__int32)encoder->private_->verify.input_fifo.data[channel][i];
4419                                         got = (FLAC__int32)buffer[channel][i];
4420                                         break;
4421                                 }
4422                         }
4423                         FLAC__ASSERT(i < blocksize);
4424                         FLAC__ASSERT(frame->header.number_type == FLAC__FRAME_NUMBER_TYPE_SAMPLE_NUMBER);
4425                         encoder->private_->verify.error_stats.absolute_sample = frame->header.number.sample_number + sample;
4426                         encoder->private_->verify.error_stats.frame_number = (unsigned)(frame->header.number.sample_number / blocksize);
4427                         encoder->private_->verify.error_stats.channel = channel;
4428                         encoder->private_->verify.error_stats.sample = sample;
4429                         encoder->private_->verify.error_stats.expected = expect;
4430                         encoder->private_->verify.error_stats.got = got;
4431                         encoder->protected_->state = FLAC__STREAM_ENCODER_VERIFY_MISMATCH_IN_AUDIO_DATA;
4432                         return FLAC__STREAM_DECODER_WRITE_STATUS_ABORT;
4433                 }
4434         }
4435         /* dequeue the frame from the fifo */
4436         for(channel = 0; channel < channels; channel++) {
4437                 memmove(&encoder->private_->verify.input_fifo.data[channel][0], &encoder->private_->verify.input_fifo.data[channel][blocksize], encoder->private_->verify.input_fifo.tail - blocksize);
4438         }
4439         encoder->private_->verify.input_fifo.tail -= blocksize;
4440         return FLAC__STREAM_DECODER_WRITE_STATUS_CONTINUE;
4441 }
4442
4443 void verify_metadata_callback_(const FLAC__StreamDecoder *decoder, const FLAC__StreamMetadata *metadata, void *client_data)
4444 {
4445         (void)decoder, (void)metadata, (void)client_data;
4446 }
4447
4448 void verify_error_callback_(const FLAC__StreamDecoder *decoder, FLAC__StreamDecoderErrorStatus status, void *client_data)
4449 {
4450         FLAC__StreamEncoder *encoder = (FLAC__StreamEncoder*)client_data;
4451         (void)decoder, (void)status;
4452         encoder->protected_->state = FLAC__STREAM_ENCODER_VERIFY_DECODER_ERROR;
4453 }
4454
4455 FLAC__StreamEncoderReadStatus file_read_callback_(const FLAC__StreamEncoder *encoder, FLAC__byte buffer[], size_t *bytes, void *client_data)
4456 {
4457         (void)client_data;
4458
4459         *bytes = fread(buffer, 1, *bytes, encoder->private_->file);
4460         if (*bytes == 0) {
4461                 if (feof(encoder->private_->file))
4462                         return FLAC__STREAM_ENCODER_READ_STATUS_END_OF_STREAM;
4463                 else if (ferror(encoder->private_->file))
4464                         return FLAC__STREAM_ENCODER_READ_STATUS_ABORT;
4465         }
4466         return FLAC__STREAM_ENCODER_READ_STATUS_CONTINUE;
4467 }
4468
4469 FLAC__StreamEncoderSeekStatus file_seek_callback_(const FLAC__StreamEncoder *encoder, FLAC__uint64 absolute_byte_offset, void *client_data)
4470 {
4471         (void)client_data;
4472
4473         if(fseeko(encoder->private_->file, (off_t)absolute_byte_offset, SEEK_SET) < 0)
4474                 return FLAC__STREAM_ENCODER_SEEK_STATUS_ERROR;
4475         else
4476                 return FLAC__STREAM_ENCODER_SEEK_STATUS_OK;
4477 }
4478
4479 FLAC__StreamEncoderTellStatus file_tell_callback_(const FLAC__StreamEncoder *encoder, FLAC__uint64 *absolute_byte_offset, void *client_data)
4480 {
4481         off_t offset;
4482
4483         (void)client_data;
4484
4485         offset = ftello(encoder->private_->file);
4486
4487         if(offset < 0) {
4488                 return FLAC__STREAM_ENCODER_TELL_STATUS_ERROR;
4489         }
4490         else {
4491                 *absolute_byte_offset = (FLAC__uint64)offset;
4492                 return FLAC__STREAM_ENCODER_TELL_STATUS_OK;
4493         }
4494 }
4495
4496 #ifdef FLAC__VALGRIND_TESTING
4497 static size_t local__fwrite(const void *ptr, size_t size, size_t nmemb, FILE *stream)
4498 {
4499         size_t ret = fwrite(ptr, size, nmemb, stream);
4500         if(!ferror(stream))
4501                 fflush(stream);
4502         return ret;
4503 }
4504 #else
4505 #define local__fwrite fwrite
4506 #endif
4507
4508 FLAC__StreamEncoderWriteStatus file_write_callback_(const FLAC__StreamEncoder *encoder, const FLAC__byte buffer[], size_t bytes, unsigned samples, unsigned current_frame, void *client_data)
4509 {
4510         (void)client_data, (void)current_frame;
4511
4512         if(local__fwrite(buffer, sizeof(FLAC__byte), bytes, encoder->private_->file) == bytes) {
4513                 FLAC__bool call_it = 0 != encoder->private_->progress_callback && (
4514 #if FLAC__HAS_OGG
4515                         /* We would like to be able to use 'samples > 0' in the
4516                          * clause here but currently because of the nature of our
4517                          * Ogg writing implementation, 'samples' is always 0 (see
4518                          * ogg_encoder_aspect.c).  The downside is extra progress
4519                          * callbacks.
4520                          */
4521                         encoder->private_->is_ogg? true :
4522 #endif
4523                         samples > 0
4524                 );
4525                 if(call_it) {
4526                         /* NOTE: We have to add +bytes, +samples, and +1 to the stats
4527                          * because at this point in the callback chain, the stats
4528                          * have not been updated.  Only after we return and control
4529                          * gets back to write_frame_() are the stats updated
4530                          */
4531                         encoder->private_->progress_callback(encoder, encoder->private_->bytes_written+bytes, encoder->private_->samples_written+samples, encoder->private_->frames_written+(samples?1:0), encoder->private_->total_frames_estimate, encoder->private_->client_data);
4532                 }
4533                 return FLAC__STREAM_ENCODER_WRITE_STATUS_OK;
4534         }
4535         else
4536                 return FLAC__STREAM_ENCODER_WRITE_STATUS_FATAL_ERROR;
4537 }
4538
4539 /*
4540  * This will forcibly set stdout to binary mode (for OSes that require it)
4541  */
4542 FILE *get_binary_stdout_()
4543 {
4544         /* if something breaks here it is probably due to the presence or
4545          * absence of an underscore before the identifiers 'setmode',
4546          * 'fileno', and/or 'O_BINARY'; check your system header files.
4547          */
4548 #if defined _MSC_VER || defined __MINGW32__
4549         _setmode(_fileno(stdout), _O_BINARY);
4550 #elif defined __CYGWIN__
4551         /* almost certainly not needed for any modern Cygwin, but let's be safe... */
4552         setmode(_fileno(stdout), _O_BINARY);
4553 #elif defined __EMX__
4554         setmode(fileno(stdout), O_BINARY);
4555 #endif
4556
4557         return stdout;
4558 }