unify inlining method in prep for inline tests
[flac.git] / src / libFLAC / stream_encoder.c
1 /* libFLAC - Free Lossless Audio Codec library
2  * Copyright (C) 2000,2001,2002,2003,2004,2005,2006,2007  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 __BORLANDC__ || defined __MINGW32__
50 #if _MSC_VER <= 1600 || defined __BORLANDC__ /* @@@ [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/bitwriter.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 #if FLAC__HAS_OGG
68 #include "private/ogg_helper.h"
69 #include "private/ogg_mapping.h"
70 #endif
71 #include "private/stream_encoder_framing.h"
72 #include "private/window.h"
73
74 #ifndef FLaC__INLINE
75 #define FLaC__INLINE
76 #endif
77
78 #ifdef min
79 #undef min
80 #endif
81 #define min(x,y) ((x)<(y)?(x):(y))
82
83 #ifdef max
84 #undef max
85 #endif
86 #define max(x,y) ((x)>(y)?(x):(y))
87
88 /* Exact Rice codeword length calculation is off by default.  The simple
89  * (and fast) estimation (of how many bits a residual value will be
90  * encoded with) in this encoder is very good, almost always yielding
91  * compression within 0.1% of exact calculation.
92  */
93 #undef EXACT_RICE_BITS_CALCULATION
94 /* Rice parameter searching is off by default.  The simple (and fast)
95  * parameter estimation in this encoder is very good, almost always
96  * yielding compression within 0.1% of the optimal parameters.
97  */
98 #undef ENABLE_RICE_PARAMETER_SEARCH 
99
100
101 typedef struct {
102         FLAC__int32 *data[FLAC__MAX_CHANNELS];
103         unsigned size; /* of each data[] in samples */
104         unsigned tail;
105 } verify_input_fifo;
106
107 typedef struct {
108         const FLAC__byte *data;
109         unsigned capacity;
110         unsigned bytes;
111 } verify_output;
112
113 typedef enum {
114         ENCODER_IN_MAGIC = 0,
115         ENCODER_IN_METADATA = 1,
116         ENCODER_IN_AUDIO = 2
117 } EncoderStateHint;
118
119 static struct CompressionLevels {
120         FLAC__bool do_mid_side_stereo;
121         FLAC__bool loose_mid_side_stereo;
122         unsigned max_lpc_order;
123         unsigned qlp_coeff_precision;
124         FLAC__bool do_qlp_coeff_prec_search;
125         FLAC__bool do_escape_coding;
126         FLAC__bool do_exhaustive_model_search;
127         unsigned min_residual_partition_order;
128         unsigned max_residual_partition_order;
129         unsigned rice_parameter_search_dist;
130 } compression_levels_[] = {
131         { false, false,  0, 0, false, false, false, 0, 3, 0 },
132         { true , true ,  0, 0, false, false, false, 0, 3, 0 },
133         { true , false,  0, 0, false, false, false, 0, 3, 0 },
134         { false, false,  6, 0, false, false, false, 0, 4, 0 },
135         { true , true ,  8, 0, false, false, false, 0, 4, 0 },
136         { true , false,  8, 0, false, false, false, 0, 5, 0 },
137         { true , false,  8, 0, false, false, false, 0, 6, 0 },
138         { true , false,  8, 0, false, false, true , 0, 6, 0 },
139         { true , false, 12, 0, false, false, true , 0, 6, 0 }
140 };
141
142
143 /***********************************************************************
144  *
145  * Private class method prototypes
146  *
147  ***********************************************************************/
148
149 static void set_defaults_(FLAC__StreamEncoder *encoder);
150 static void free_(FLAC__StreamEncoder *encoder);
151 static FLAC__bool resize_buffers_(FLAC__StreamEncoder *encoder, unsigned new_blocksize);
152 static FLAC__bool write_bitbuffer_(FLAC__StreamEncoder *encoder, unsigned samples, FLAC__bool is_last_block);
153 static FLAC__StreamEncoderWriteStatus write_frame_(FLAC__StreamEncoder *encoder, const FLAC__byte buffer[], size_t bytes, unsigned samples, FLAC__bool is_last_block);
154 static void update_metadata_(const FLAC__StreamEncoder *encoder);
155 #if FLAC__HAS_OGG
156 static void update_ogg_metadata_(FLAC__StreamEncoder *encoder);
157 #endif
158 static FLAC__bool process_frame_(FLAC__StreamEncoder *encoder, FLAC__bool is_fractional_block, FLAC__bool is_last_block);
159 static FLAC__bool process_subframes_(FLAC__StreamEncoder *encoder, FLAC__bool is_fractional_block);
160
161 static FLAC__bool process_subframe_(
162         FLAC__StreamEncoder *encoder,
163         unsigned min_partition_order,
164         unsigned max_partition_order,
165         const FLAC__FrameHeader *frame_header,
166         unsigned subframe_bps,
167         const FLAC__int32 integer_signal[],
168 #ifndef FLAC__INTEGER_ONLY_LIBRARY
169         const FLAC__real real_signal[],
170 #endif
171         FLAC__Subframe *subframe[2],
172         FLAC__EntropyCodingMethod_PartitionedRiceContents *partitioned_rice_contents[2],
173         FLAC__int32 *residual[2],
174         unsigned *best_subframe,
175         unsigned *best_bits
176 );
177
178 static FLAC__bool add_subframe_(
179         FLAC__StreamEncoder *encoder,
180         unsigned blocksize,
181         unsigned subframe_bps,
182         const FLAC__Subframe *subframe,
183         FLAC__BitWriter *frame
184 );
185
186 static unsigned evaluate_constant_subframe_(
187         FLAC__StreamEncoder *encoder,
188         const FLAC__int32 signal,
189         unsigned blocksize,
190         unsigned subframe_bps,
191         FLAC__Subframe *subframe
192 );
193
194 static unsigned evaluate_fixed_subframe_(
195         FLAC__StreamEncoder *encoder,
196         const FLAC__int32 signal[],
197         FLAC__int32 residual[],
198         FLAC__uint64 abs_residual_partition_sums[],
199         unsigned raw_bits_per_partition[],
200         unsigned blocksize,
201         unsigned subframe_bps,
202         unsigned order,
203         unsigned rice_parameter,
204         unsigned min_partition_order,
205         unsigned max_partition_order,
206         FLAC__bool do_escape_coding,
207         unsigned rice_parameter_search_dist,
208         FLAC__Subframe *subframe,
209         FLAC__EntropyCodingMethod_PartitionedRiceContents *partitioned_rice_contents
210 );
211
212 #ifndef FLAC__INTEGER_ONLY_LIBRARY
213 static unsigned evaluate_lpc_subframe_(
214         FLAC__StreamEncoder *encoder,
215         const FLAC__int32 signal[],
216         FLAC__int32 residual[],
217         FLAC__uint64 abs_residual_partition_sums[],
218         unsigned raw_bits_per_partition[],
219         const FLAC__real lp_coeff[],
220         unsigned blocksize,
221         unsigned subframe_bps,
222         unsigned order,
223         unsigned qlp_coeff_precision,
224         unsigned rice_parameter,
225         unsigned min_partition_order,
226         unsigned max_partition_order,
227         FLAC__bool do_escape_coding,
228         unsigned rice_parameter_search_dist,
229         FLAC__Subframe *subframe,
230         FLAC__EntropyCodingMethod_PartitionedRiceContents *partitioned_rice_contents
231 );
232 #endif
233
234 static unsigned evaluate_verbatim_subframe_(
235         FLAC__StreamEncoder *encoder, 
236         const FLAC__int32 signal[],
237         unsigned blocksize,
238         unsigned subframe_bps,
239         FLAC__Subframe *subframe
240 );
241
242 static unsigned find_best_partition_order_(
243         struct FLAC__StreamEncoderPrivate *private_,
244         const FLAC__int32 residual[],
245         FLAC__uint64 abs_residual_partition_sums[],
246         unsigned raw_bits_per_partition[],
247         unsigned residual_samples,
248         unsigned predictor_order,
249         unsigned rice_parameter,
250         unsigned min_partition_order,
251         unsigned max_partition_order,
252         FLAC__bool do_escape_coding,
253         unsigned rice_parameter_search_dist,
254         FLAC__EntropyCodingMethod_PartitionedRice *best_partitioned_rice
255 );
256
257 static void precompute_partition_info_sums_(
258         const FLAC__int32 residual[],
259         FLAC__uint64 abs_residual_partition_sums[],
260         unsigned residual_samples,
261         unsigned predictor_order,
262         unsigned min_partition_order,
263         unsigned max_partition_order
264 );
265
266 static void precompute_partition_info_escapes_(
267         const FLAC__int32 residual[],
268         unsigned raw_bits_per_partition[],
269         unsigned residual_samples,
270         unsigned predictor_order,
271         unsigned min_partition_order,
272         unsigned max_partition_order
273 );
274
275 static FLAC__bool set_partitioned_rice_(
276 #ifdef EXACT_RICE_BITS_CALCULATION
277         const FLAC__int32 residual[],
278 #endif
279         const FLAC__uint64 abs_residual_partition_sums[],
280         const unsigned raw_bits_per_partition[],
281         const unsigned residual_samples,
282         const unsigned predictor_order,
283         const unsigned suggested_rice_parameter,
284         const unsigned rice_parameter_search_dist,
285         const unsigned partition_order,
286         const FLAC__bool search_for_escapes,
287         FLAC__EntropyCodingMethod_PartitionedRiceContents *partitioned_rice_contents,
288         unsigned *bits
289 );
290
291 static unsigned get_wasted_bits_(FLAC__int32 signal[], unsigned samples);
292
293 /* verify-related routines: */
294 static void append_to_verify_fifo_(
295         verify_input_fifo *fifo,
296         const FLAC__int32 * const input[],
297         unsigned input_offset,
298         unsigned channels,
299         unsigned wide_samples
300 );
301
302 static void append_to_verify_fifo_interleaved_(
303         verify_input_fifo *fifo,
304         const FLAC__int32 input[],
305         unsigned input_offset,
306         unsigned channels,
307         unsigned wide_samples
308 );
309
310 static FLAC__StreamDecoderReadStatus verify_read_callback_(const FLAC__StreamDecoder *decoder, FLAC__byte buffer[], size_t *bytes, void *client_data);
311 static FLAC__StreamDecoderWriteStatus verify_write_callback_(const FLAC__StreamDecoder *decoder, const FLAC__Frame *frame, const FLAC__int32 * const buffer[], void *client_data);
312 static void verify_metadata_callback_(const FLAC__StreamDecoder *decoder, const FLAC__StreamMetadata *metadata, void *client_data);
313 static void verify_error_callback_(const FLAC__StreamDecoder *decoder, FLAC__StreamDecoderErrorStatus status, void *client_data);
314
315 static FLAC__StreamEncoderReadStatus file_read_callback_(const FLAC__StreamEncoder *encoder, FLAC__byte buffer[], size_t *bytes, void *client_data);
316 static FLAC__StreamEncoderSeekStatus file_seek_callback_(const FLAC__StreamEncoder *encoder, FLAC__uint64 absolute_byte_offset, void *client_data);
317 static FLAC__StreamEncoderTellStatus file_tell_callback_(const FLAC__StreamEncoder *encoder, FLAC__uint64 *absolute_byte_offset, void *client_data);
318 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);
319 static FILE *get_binary_stdout_(void);
320
321
322 /***********************************************************************
323  *
324  * Private class data
325  *
326  ***********************************************************************/
327
328 typedef struct FLAC__StreamEncoderPrivate {
329         unsigned input_capacity;                          /* current size (in samples) of the signal and residual buffers */
330         FLAC__int32 *integer_signal[FLAC__MAX_CHANNELS];  /* the integer version of the input signal */
331         FLAC__int32 *integer_signal_mid_side[2];          /* the integer version of the mid-side input signal (stereo only) */
332 #ifndef FLAC__INTEGER_ONLY_LIBRARY
333         FLAC__real *real_signal[FLAC__MAX_CHANNELS];      /* the floating-point version of the input signal */
334         FLAC__real *real_signal_mid_side[2];              /* the floating-point version of the mid-side input signal (stereo only) */
335         FLAC__real *window[FLAC__MAX_APODIZATION_FUNCTIONS]; /* the pre-computed floating-point window for each apodization function */
336         FLAC__real *windowed_signal;                      /* the real_signal[] * current window[] */
337 #endif
338         unsigned subframe_bps[FLAC__MAX_CHANNELS];        /* the effective bits per sample of the input signal (stream bps - wasted bits) */
339         unsigned subframe_bps_mid_side[2];                /* the effective bits per sample of the mid-side input signal (stream bps - wasted bits + 0/1) */
340         FLAC__int32 *residual_workspace[FLAC__MAX_CHANNELS][2]; /* each channel has a candidate and best workspace where the subframe residual signals will be stored */
341         FLAC__int32 *residual_workspace_mid_side[2][2];
342         FLAC__Subframe subframe_workspace[FLAC__MAX_CHANNELS][2];
343         FLAC__Subframe subframe_workspace_mid_side[2][2];
344         FLAC__Subframe *subframe_workspace_ptr[FLAC__MAX_CHANNELS][2];
345         FLAC__Subframe *subframe_workspace_ptr_mid_side[2][2];
346         FLAC__EntropyCodingMethod_PartitionedRiceContents partitioned_rice_contents_workspace[FLAC__MAX_CHANNELS][2];
347         FLAC__EntropyCodingMethod_PartitionedRiceContents partitioned_rice_contents_workspace_mid_side[FLAC__MAX_CHANNELS][2];
348         FLAC__EntropyCodingMethod_PartitionedRiceContents *partitioned_rice_contents_workspace_ptr[FLAC__MAX_CHANNELS][2];
349         FLAC__EntropyCodingMethod_PartitionedRiceContents *partitioned_rice_contents_workspace_ptr_mid_side[FLAC__MAX_CHANNELS][2];
350         unsigned best_subframe[FLAC__MAX_CHANNELS];       /* index (0 or 1) into 2nd dimension of the above workspaces */
351         unsigned best_subframe_mid_side[2];
352         unsigned best_subframe_bits[FLAC__MAX_CHANNELS];  /* size in bits of the best subframe for each channel */
353         unsigned best_subframe_bits_mid_side[2];
354         FLAC__uint64 *abs_residual_partition_sums;        /* workspace where the sum of abs(candidate residual) for each partition is stored */
355         unsigned *raw_bits_per_partition;                 /* workspace where the sum of silog2(candidate residual) for each partition is stored */
356         FLAC__BitWriter *frame;                           /* the current frame being worked on */
357         unsigned loose_mid_side_stereo_frames;            /* rounded number of frames the encoder will use before trying both independent and mid/side frames again */
358         unsigned loose_mid_side_stereo_frame_count;       /* number of frames using the current channel assignment */
359         FLAC__ChannelAssignment last_channel_assignment;
360         FLAC__StreamMetadata streaminfo;                  /* scratchpad for STREAMINFO as it is built */
361         FLAC__StreamMetadata_SeekTable *seek_table;       /* pointer into encoder->protected_->metadata_ where the seek table is */
362         unsigned current_sample_number;
363         unsigned current_frame_number;
364         struct FLAC__MD5Context md5context;
365         FLAC__CPUInfo cpuinfo;
366 #ifndef FLAC__INTEGER_ONLY_LIBRARY
367         unsigned (*local_fixed_compute_best_predictor)(const FLAC__int32 data[], unsigned data_len, FLAC__float residual_bits_per_sample[FLAC__MAX_FIXED_ORDER+1]);
368 #else
369         unsigned (*local_fixed_compute_best_predictor)(const FLAC__int32 data[], unsigned data_len, FLAC__fixedpoint residual_bits_per_sample[FLAC__MAX_FIXED_ORDER+1]);
370 #endif
371 #ifndef FLAC__INTEGER_ONLY_LIBRARY
372         void (*local_lpc_compute_autocorrelation)(const FLAC__real data[], unsigned data_len, unsigned lag, FLAC__real autoc[]);
373         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[]);
374         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[]);
375         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[]);
376 #endif
377         FLAC__bool use_wide_by_block;          /* use slow 64-bit versions of some functions because of the block size */
378         FLAC__bool use_wide_by_partition;      /* use slow 64-bit versions of some functions because of the min partition order and blocksize */
379         FLAC__bool use_wide_by_order;          /* use slow 64-bit versions of some functions because of the lpc order */
380         FLAC__bool disable_constant_subframes;
381         FLAC__bool disable_fixed_subframes;
382         FLAC__bool disable_verbatim_subframes;
383 #if FLAC__HAS_OGG
384         FLAC__bool is_ogg;
385 #endif
386         FLAC__StreamEncoderReadCallback read_callback; /* currently only needed for Ogg FLAC */
387         FLAC__StreamEncoderSeekCallback seek_callback;
388         FLAC__StreamEncoderTellCallback tell_callback;
389         FLAC__StreamEncoderWriteCallback write_callback;
390         FLAC__StreamEncoderMetadataCallback metadata_callback;
391         FLAC__StreamEncoderProgressCallback progress_callback;
392         void *client_data;
393         unsigned first_seekpoint_to_check;
394         FILE *file;                            /* only used when encoding to a file */
395         FLAC__uint64 bytes_written;
396         FLAC__uint64 samples_written;
397         unsigned frames_written;
398         unsigned total_frames_estimate;
399         /* unaligned (original) pointers to allocated data */
400         FLAC__int32 *integer_signal_unaligned[FLAC__MAX_CHANNELS];
401         FLAC__int32 *integer_signal_mid_side_unaligned[2];
402 #ifndef FLAC__INTEGER_ONLY_LIBRARY
403         FLAC__real *real_signal_unaligned[FLAC__MAX_CHANNELS];
404         FLAC__real *real_signal_mid_side_unaligned[2];
405         FLAC__real *window_unaligned[FLAC__MAX_APODIZATION_FUNCTIONS];
406         FLAC__real *windowed_signal_unaligned;
407 #endif
408         FLAC__int32 *residual_workspace_unaligned[FLAC__MAX_CHANNELS][2];
409         FLAC__int32 *residual_workspace_mid_side_unaligned[2][2];
410         FLAC__uint64 *abs_residual_partition_sums_unaligned;
411         unsigned *raw_bits_per_partition_unaligned;
412         /*
413          * These fields have been moved here from private function local
414          * declarations merely to save stack space during encoding.
415          */
416 #ifndef FLAC__INTEGER_ONLY_LIBRARY
417         FLAC__real lp_coeff[FLAC__MAX_LPC_ORDER][FLAC__MAX_LPC_ORDER]; /* from process_subframe_() */
418 #endif
419         FLAC__EntropyCodingMethod_PartitionedRiceContents partitioned_rice_contents_extra[2]; /* from find_best_partition_order_() */
420         /*
421          * The data for the verify section
422          */
423         struct {
424                 FLAC__StreamDecoder *decoder;
425                 EncoderStateHint state_hint;
426                 FLAC__bool needs_magic_hack;
427                 verify_input_fifo input_fifo;
428                 verify_output output;
429                 struct {
430                         FLAC__uint64 absolute_sample;
431                         unsigned frame_number;
432                         unsigned channel;
433                         unsigned sample;
434                         FLAC__int32 expected;
435                         FLAC__int32 got;
436                 } error_stats;
437         } verify;
438         FLAC__bool is_being_deleted; /* if true, call to ..._finish() from ..._delete() will not call the callbacks */
439 } FLAC__StreamEncoderPrivate;
440
441 /***********************************************************************
442  *
443  * Public static class data
444  *
445  ***********************************************************************/
446
447 FLAC_API const char * const FLAC__StreamEncoderStateString[] = {
448         "FLAC__STREAM_ENCODER_OK",
449         "FLAC__STREAM_ENCODER_UNINITIALIZED",
450         "FLAC__STREAM_ENCODER_OGG_ERROR",
451         "FLAC__STREAM_ENCODER_VERIFY_DECODER_ERROR",
452         "FLAC__STREAM_ENCODER_VERIFY_MISMATCH_IN_AUDIO_DATA",
453         "FLAC__STREAM_ENCODER_CLIENT_ERROR",
454         "FLAC__STREAM_ENCODER_IO_ERROR",
455         "FLAC__STREAM_ENCODER_FRAMING_ERROR",
456         "FLAC__STREAM_ENCODER_MEMORY_ALLOCATION_ERROR"
457 };
458
459 FLAC_API const char * const FLAC__StreamEncoderInitStatusString[] = {
460         "FLAC__STREAM_ENCODER_INIT_STATUS_OK",
461         "FLAC__STREAM_ENCODER_INIT_STATUS_ENCODER_ERROR",
462         "FLAC__STREAM_ENCODER_INIT_STATUS_UNSUPPORTED_CONTAINER",
463         "FLAC__STREAM_ENCODER_INIT_STATUS_INVALID_CALLBACKS",
464         "FLAC__STREAM_ENCODER_INIT_STATUS_INVALID_NUMBER_OF_CHANNELS",
465         "FLAC__STREAM_ENCODER_INIT_STATUS_INVALID_BITS_PER_SAMPLE",
466         "FLAC__STREAM_ENCODER_INIT_STATUS_INVALID_SAMPLE_RATE",
467         "FLAC__STREAM_ENCODER_INIT_STATUS_INVALID_BLOCK_SIZE",
468         "FLAC__STREAM_ENCODER_INIT_STATUS_INVALID_MAX_LPC_ORDER",
469         "FLAC__STREAM_ENCODER_INIT_STATUS_INVALID_QLP_COEFF_PRECISION",
470         "FLAC__STREAM_ENCODER_INIT_STATUS_BLOCK_SIZE_TOO_SMALL_FOR_LPC_ORDER",
471         "FLAC__STREAM_ENCODER_INIT_STATUS_NOT_STREAMABLE",
472         "FLAC__STREAM_ENCODER_INIT_STATUS_INVALID_METADATA",
473         "FLAC__STREAM_ENCODER_INIT_STATUS_ALREADY_INITIALIZED"
474 };
475
476 FLAC_API const char * const FLAC__treamEncoderReadStatusString[] = {
477         "FLAC__STREAM_ENCODER_READ_STATUS_CONTINUE",
478         "FLAC__STREAM_ENCODER_READ_STATUS_END_OF_STREAM",
479         "FLAC__STREAM_ENCODER_READ_STATUS_ABORT",
480         "FLAC__STREAM_ENCODER_READ_STATUS_UNSUPPORTED"
481 };
482
483 FLAC_API const char * const FLAC__StreamEncoderWriteStatusString[] = {
484         "FLAC__STREAM_ENCODER_WRITE_STATUS_OK",
485         "FLAC__STREAM_ENCODER_WRITE_STATUS_FATAL_ERROR"
486 };
487
488 FLAC_API const char * const FLAC__StreamEncoderSeekStatusString[] = {
489         "FLAC__STREAM_ENCODER_SEEK_STATUS_OK",
490         "FLAC__STREAM_ENCODER_SEEK_STATUS_ERROR",
491         "FLAC__STREAM_ENCODER_SEEK_STATUS_UNSUPPORTED"
492 };
493
494 FLAC_API const char * const FLAC__StreamEncoderTellStatusString[] = {
495         "FLAC__STREAM_ENCODER_TELL_STATUS_OK",
496         "FLAC__STREAM_ENCODER_TELL_STATUS_ERROR",
497         "FLAC__STREAM_ENCODER_TELL_STATUS_UNSUPPORTED"
498 };
499
500 /* Number of samples that will be overread to watch for end of stream.  By
501  * 'overread', we mean that the FLAC__stream_encoder_process*() calls will
502  * always try to read blocksize+1 samples before encoding a block, so that
503  * even if the stream has a total sample count that is an integral multiple
504  * of the blocksize, we will still notice when we are encoding the last
505  * block.  This is needed, for example, to correctly set the end-of-stream
506  * marker in Ogg FLAC.
507  *
508  * WATCHOUT: some parts of the code assert that OVERREAD_ == 1 and there's
509  * not really any reason to change it.
510  */
511 static const unsigned OVERREAD_ = 1;
512
513 /***********************************************************************
514  *
515  * Class constructor/destructor
516  *
517  */
518 FLAC_API FLAC__StreamEncoder *FLAC__stream_encoder_new(void)
519 {
520         FLAC__StreamEncoder *encoder;
521         unsigned i;
522
523         FLAC__ASSERT(sizeof(int) >= 4); /* we want to die right away if this is not true */
524
525         encoder = (FLAC__StreamEncoder*)calloc(1, sizeof(FLAC__StreamEncoder));
526         if(encoder == 0) {
527                 return 0;
528         }
529
530         encoder->protected_ = (FLAC__StreamEncoderProtected*)calloc(1, sizeof(FLAC__StreamEncoderProtected));
531         if(encoder->protected_ == 0) {
532                 free(encoder);
533                 return 0;
534         }
535
536         encoder->private_ = (FLAC__StreamEncoderPrivate*)calloc(1, sizeof(FLAC__StreamEncoderPrivate));
537         if(encoder->private_ == 0) {
538                 free(encoder->protected_);
539                 free(encoder);
540                 return 0;
541         }
542
543         encoder->private_->frame = FLAC__bitwriter_new();
544         if(encoder->private_->frame == 0) {
545                 free(encoder->private_);
546                 free(encoder->protected_);
547                 free(encoder);
548                 return 0;
549         }
550
551         encoder->private_->file = 0;
552
553         set_defaults_(encoder);
554
555         encoder->private_->is_being_deleted = false;
556
557         for(i = 0; i < FLAC__MAX_CHANNELS; i++) {
558                 encoder->private_->subframe_workspace_ptr[i][0] = &encoder->private_->subframe_workspace[i][0];
559                 encoder->private_->subframe_workspace_ptr[i][1] = &encoder->private_->subframe_workspace[i][1];
560         }
561         for(i = 0; i < 2; i++) {
562                 encoder->private_->subframe_workspace_ptr_mid_side[i][0] = &encoder->private_->subframe_workspace_mid_side[i][0];
563                 encoder->private_->subframe_workspace_ptr_mid_side[i][1] = &encoder->private_->subframe_workspace_mid_side[i][1];
564         }
565         for(i = 0; i < FLAC__MAX_CHANNELS; i++) {
566                 encoder->private_->partitioned_rice_contents_workspace_ptr[i][0] = &encoder->private_->partitioned_rice_contents_workspace[i][0];
567                 encoder->private_->partitioned_rice_contents_workspace_ptr[i][1] = &encoder->private_->partitioned_rice_contents_workspace[i][1];
568         }
569         for(i = 0; i < 2; i++) {
570                 encoder->private_->partitioned_rice_contents_workspace_ptr_mid_side[i][0] = &encoder->private_->partitioned_rice_contents_workspace_mid_side[i][0];
571                 encoder->private_->partitioned_rice_contents_workspace_ptr_mid_side[i][1] = &encoder->private_->partitioned_rice_contents_workspace_mid_side[i][1];
572         }
573
574         for(i = 0; i < FLAC__MAX_CHANNELS; i++) {
575                 FLAC__format_entropy_coding_method_partitioned_rice_contents_init(&encoder->private_->partitioned_rice_contents_workspace[i][0]);
576                 FLAC__format_entropy_coding_method_partitioned_rice_contents_init(&encoder->private_->partitioned_rice_contents_workspace[i][1]);
577         }
578         for(i = 0; i < 2; i++) {
579                 FLAC__format_entropy_coding_method_partitioned_rice_contents_init(&encoder->private_->partitioned_rice_contents_workspace_mid_side[i][0]);
580                 FLAC__format_entropy_coding_method_partitioned_rice_contents_init(&encoder->private_->partitioned_rice_contents_workspace_mid_side[i][1]);
581         }
582         for(i = 0; i < 2; i++)
583                 FLAC__format_entropy_coding_method_partitioned_rice_contents_init(&encoder->private_->partitioned_rice_contents_extra[i]);
584
585         encoder->protected_->state = FLAC__STREAM_ENCODER_UNINITIALIZED;
586
587         return encoder;
588 }
589
590 FLAC_API void FLAC__stream_encoder_delete(FLAC__StreamEncoder *encoder)
591 {
592         unsigned i;
593
594         FLAC__ASSERT(0 != encoder);
595         FLAC__ASSERT(0 != encoder->protected_);
596         FLAC__ASSERT(0 != encoder->private_);
597         FLAC__ASSERT(0 != encoder->private_->frame);
598
599         encoder->private_->is_being_deleted = true;
600
601         (void)FLAC__stream_encoder_finish(encoder);
602
603         if(0 != encoder->private_->verify.decoder)
604                 FLAC__stream_decoder_delete(encoder->private_->verify.decoder);
605
606         for(i = 0; i < FLAC__MAX_CHANNELS; i++) {
607                 FLAC__format_entropy_coding_method_partitioned_rice_contents_clear(&encoder->private_->partitioned_rice_contents_workspace[i][0]);
608                 FLAC__format_entropy_coding_method_partitioned_rice_contents_clear(&encoder->private_->partitioned_rice_contents_workspace[i][1]);
609         }
610         for(i = 0; i < 2; i++) {
611                 FLAC__format_entropy_coding_method_partitioned_rice_contents_clear(&encoder->private_->partitioned_rice_contents_workspace_mid_side[i][0]);
612                 FLAC__format_entropy_coding_method_partitioned_rice_contents_clear(&encoder->private_->partitioned_rice_contents_workspace_mid_side[i][1]);
613         }
614         for(i = 0; i < 2; i++)
615                 FLAC__format_entropy_coding_method_partitioned_rice_contents_clear(&encoder->private_->partitioned_rice_contents_extra[i]);
616
617         FLAC__bitwriter_delete(encoder->private_->frame);
618         free(encoder->private_);
619         free(encoder->protected_);
620         free(encoder);
621 }
622
623 /***********************************************************************
624  *
625  * Public class methods
626  *
627  ***********************************************************************/
628
629 static FLAC__StreamEncoderInitStatus init_stream_internal_(
630         FLAC__StreamEncoder *encoder,
631         FLAC__StreamEncoderReadCallback read_callback,
632         FLAC__StreamEncoderWriteCallback write_callback,
633         FLAC__StreamEncoderSeekCallback seek_callback,
634         FLAC__StreamEncoderTellCallback tell_callback,
635         FLAC__StreamEncoderMetadataCallback metadata_callback,
636         void *client_data,
637         FLAC__bool is_ogg
638 )
639 {
640         unsigned i;
641         FLAC__bool metadata_has_seektable, metadata_has_vorbis_comment, metadata_picture_has_type1, metadata_picture_has_type2;
642
643         FLAC__ASSERT(0 != encoder);
644
645         if(encoder->protected_->state != FLAC__STREAM_ENCODER_UNINITIALIZED)
646                 return FLAC__STREAM_ENCODER_INIT_STATUS_ALREADY_INITIALIZED;
647
648 #if !FLAC__HAS_OGG
649         if(is_ogg)
650                 return FLAC__STREAM_ENCODER_INIT_STATUS_UNSUPPORTED_CONTAINER;
651 #endif
652
653         if(0 == write_callback || (seek_callback && 0 == tell_callback))
654                 return FLAC__STREAM_ENCODER_INIT_STATUS_INVALID_CALLBACKS;
655
656         if(encoder->protected_->channels == 0 || encoder->protected_->channels > FLAC__MAX_CHANNELS)
657                 return FLAC__STREAM_ENCODER_INIT_STATUS_INVALID_NUMBER_OF_CHANNELS;
658
659         if(encoder->protected_->channels != 2) {
660                 encoder->protected_->do_mid_side_stereo = false;
661                 encoder->protected_->loose_mid_side_stereo = false;
662         }
663         else if(!encoder->protected_->do_mid_side_stereo)
664                 encoder->protected_->loose_mid_side_stereo = false;
665
666         if(encoder->protected_->bits_per_sample >= 32)
667                 encoder->protected_->do_mid_side_stereo = false; /* since we currenty do 32-bit math, the side channel would have 33 bps and overflow */
668
669         if(encoder->protected_->bits_per_sample < FLAC__MIN_BITS_PER_SAMPLE || encoder->protected_->bits_per_sample > FLAC__REFERENCE_CODEC_MAX_BITS_PER_SAMPLE)
670                 return FLAC__STREAM_ENCODER_INIT_STATUS_INVALID_BITS_PER_SAMPLE;
671
672         if(!FLAC__format_sample_rate_is_valid(encoder->protected_->sample_rate))
673                 return FLAC__STREAM_ENCODER_INIT_STATUS_INVALID_SAMPLE_RATE;
674
675         if(encoder->protected_->blocksize == 0) {
676                 if(encoder->protected_->max_lpc_order == 0)
677                         encoder->protected_->blocksize = 1152;
678                 else
679                         encoder->protected_->blocksize = 4096;
680         }
681
682         if(encoder->protected_->blocksize < FLAC__MIN_BLOCK_SIZE || encoder->protected_->blocksize > FLAC__MAX_BLOCK_SIZE)
683                 return FLAC__STREAM_ENCODER_INIT_STATUS_INVALID_BLOCK_SIZE;
684
685         if(encoder->protected_->max_lpc_order > FLAC__MAX_LPC_ORDER)
686                 return FLAC__STREAM_ENCODER_INIT_STATUS_INVALID_MAX_LPC_ORDER;
687
688         if(encoder->protected_->blocksize < encoder->protected_->max_lpc_order)
689                 return FLAC__STREAM_ENCODER_INIT_STATUS_BLOCK_SIZE_TOO_SMALL_FOR_LPC_ORDER;
690
691         if(encoder->protected_->qlp_coeff_precision == 0) {
692                 if(encoder->protected_->bits_per_sample < 16) {
693                         /* @@@ need some data about how to set this here w.r.t. blocksize and sample rate */
694                         /* @@@ until then we'll make a guess */
695                         encoder->protected_->qlp_coeff_precision = max(FLAC__MIN_QLP_COEFF_PRECISION, 2 + encoder->protected_->bits_per_sample / 2);
696                 }
697                 else if(encoder->protected_->bits_per_sample == 16) {
698                         if(encoder->protected_->blocksize <= 192)
699                                 encoder->protected_->qlp_coeff_precision = 7;
700                         else if(encoder->protected_->blocksize <= 384)
701                                 encoder->protected_->qlp_coeff_precision = 8;
702                         else if(encoder->protected_->blocksize <= 576)
703                                 encoder->protected_->qlp_coeff_precision = 9;
704                         else if(encoder->protected_->blocksize <= 1152)
705                                 encoder->protected_->qlp_coeff_precision = 10;
706                         else if(encoder->protected_->blocksize <= 2304)
707                                 encoder->protected_->qlp_coeff_precision = 11;
708                         else if(encoder->protected_->blocksize <= 4608)
709                                 encoder->protected_->qlp_coeff_precision = 12;
710                         else
711                                 encoder->protected_->qlp_coeff_precision = 13;
712                 }
713                 else {
714                         if(encoder->protected_->blocksize <= 384)
715                                 encoder->protected_->qlp_coeff_precision = FLAC__MAX_QLP_COEFF_PRECISION-2;
716                         else if(encoder->protected_->blocksize <= 1152)
717                                 encoder->protected_->qlp_coeff_precision = FLAC__MAX_QLP_COEFF_PRECISION-1;
718                         else
719                                 encoder->protected_->qlp_coeff_precision = FLAC__MAX_QLP_COEFF_PRECISION;
720                 }
721                 FLAC__ASSERT(encoder->protected_->qlp_coeff_precision <= FLAC__MAX_QLP_COEFF_PRECISION);
722         }
723         else if(encoder->protected_->qlp_coeff_precision < FLAC__MIN_QLP_COEFF_PRECISION || encoder->protected_->qlp_coeff_precision > FLAC__MAX_QLP_COEFF_PRECISION)
724                 return FLAC__STREAM_ENCODER_INIT_STATUS_INVALID_QLP_COEFF_PRECISION;
725
726         if(encoder->protected_->streamable_subset) {
727                 if(
728                         encoder->protected_->blocksize != 192 &&
729                         encoder->protected_->blocksize != 576 &&
730                         encoder->protected_->blocksize != 1152 &&
731                         encoder->protected_->blocksize != 2304 &&
732                         encoder->protected_->blocksize != 4608 &&
733                         encoder->protected_->blocksize != 256 &&
734                         encoder->protected_->blocksize != 512 &&
735                         encoder->protected_->blocksize != 1024 &&
736                         encoder->protected_->blocksize != 2048 &&
737                         encoder->protected_->blocksize != 4096 &&
738                         encoder->protected_->blocksize != 8192 &&
739                         encoder->protected_->blocksize != 16384
740                 )
741                         return FLAC__STREAM_ENCODER_INIT_STATUS_NOT_STREAMABLE;
742                 if(
743                         encoder->protected_->sample_rate != 8000 &&
744                         encoder->protected_->sample_rate != 16000 &&
745                         encoder->protected_->sample_rate != 22050 &&
746                         encoder->protected_->sample_rate != 24000 &&
747                         encoder->protected_->sample_rate != 32000 &&
748                         encoder->protected_->sample_rate != 44100 &&
749                         encoder->protected_->sample_rate != 48000 &&
750                         encoder->protected_->sample_rate != 96000
751                 )
752                         return FLAC__STREAM_ENCODER_INIT_STATUS_NOT_STREAMABLE;
753                 if(
754                         encoder->protected_->bits_per_sample != 8 &&
755                         encoder->protected_->bits_per_sample != 12 &&
756                         encoder->protected_->bits_per_sample != 16 &&
757                         encoder->protected_->bits_per_sample != 20 &&
758                         encoder->protected_->bits_per_sample != 24
759                 )
760                         return FLAC__STREAM_ENCODER_INIT_STATUS_NOT_STREAMABLE;
761                 if(encoder->protected_->max_residual_partition_order > FLAC__SUBSET_MAX_RICE_PARTITION_ORDER)
762                         return FLAC__STREAM_ENCODER_INIT_STATUS_NOT_STREAMABLE;
763                 if(
764                         encoder->protected_->sample_rate <= 48000 &&
765                         (
766                                 encoder->protected_->blocksize > FLAC__SUBSET_MAX_BLOCK_SIZE_48000HZ ||
767                                 encoder->protected_->max_lpc_order > FLAC__SUBSET_MAX_LPC_ORDER_48000HZ
768                         )
769                 ) {
770                         return FLAC__STREAM_ENCODER_INIT_STATUS_NOT_STREAMABLE;
771                 }
772         }
773
774         if(encoder->protected_->max_residual_partition_order >= (1u << FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE_ORDER_LEN))
775                 encoder->protected_->max_residual_partition_order = (1u << FLAC__ENTROPY_CODING_METHOD_PARTITIONED_RICE_ORDER_LEN) - 1;
776         if(encoder->protected_->min_residual_partition_order >= encoder->protected_->max_residual_partition_order)
777                 encoder->protected_->min_residual_partition_order = encoder->protected_->max_residual_partition_order;
778
779 #if FLAC__HAS_OGG
780         /* reorder metadata if necessary to ensure that any VORBIS_COMMENT is the first, according to the mapping spec */
781         if(is_ogg && 0 != encoder->protected_->metadata && encoder->protected_->num_metadata_blocks > 1) {
782                 unsigned i;
783                 for(i = 1; i < encoder->protected_->num_metadata_blocks; i++) {
784                         if(0 != encoder->protected_->metadata[i] && encoder->protected_->metadata[i]->type == FLAC__METADATA_TYPE_VORBIS_COMMENT) {
785                                 FLAC__StreamMetadata *vc = encoder->protected_->metadata[i];
786                                 for( ; i > 0; i--)
787                                         encoder->protected_->metadata[i] = encoder->protected_->metadata[i-1];
788                                 encoder->protected_->metadata[0] = vc;
789                                 break;
790                         }
791                 }
792         }
793 #endif
794         /* keep track of any SEEKTABLE block */
795         if(0 != encoder->protected_->metadata && encoder->protected_->num_metadata_blocks > 0) {
796                 unsigned i;
797                 for(i = 0; i < encoder->protected_->num_metadata_blocks; i++) {
798                         if(0 != encoder->protected_->metadata[i] && encoder->protected_->metadata[i]->type == FLAC__METADATA_TYPE_SEEKTABLE) {
799                                 encoder->private_->seek_table = &encoder->protected_->metadata[i]->data.seek_table;
800                                 break; /* take only the first one */
801                         }
802                 }
803         }
804
805         /* validate metadata */
806         if(0 == encoder->protected_->metadata && encoder->protected_->num_metadata_blocks > 0)
807                 return FLAC__STREAM_ENCODER_INIT_STATUS_INVALID_METADATA;
808         metadata_has_seektable = false;
809         metadata_has_vorbis_comment = false;
810         metadata_picture_has_type1 = false;
811         metadata_picture_has_type2 = false;
812         for(i = 0; i < encoder->protected_->num_metadata_blocks; i++) {
813                 const FLAC__StreamMetadata *m = encoder->protected_->metadata[i];
814                 if(m->type == FLAC__METADATA_TYPE_STREAMINFO)
815                         return FLAC__STREAM_ENCODER_INIT_STATUS_INVALID_METADATA;
816                 else if(m->type == FLAC__METADATA_TYPE_SEEKTABLE) {
817                         if(metadata_has_seektable) /* only one is allowed */
818                                 return FLAC__STREAM_ENCODER_INIT_STATUS_INVALID_METADATA;
819                         metadata_has_seektable = true;
820                         if(!FLAC__format_seektable_is_legal(&m->data.seek_table))
821                                 return FLAC__STREAM_ENCODER_INIT_STATUS_INVALID_METADATA;
822                 }
823                 else if(m->type == FLAC__METADATA_TYPE_VORBIS_COMMENT) {
824                         if(metadata_has_vorbis_comment) /* only one is allowed */
825                                 return FLAC__STREAM_ENCODER_INIT_STATUS_INVALID_METADATA;
826                         metadata_has_vorbis_comment = true;
827                 }
828                 else if(m->type == FLAC__METADATA_TYPE_CUESHEET) {
829                         if(!FLAC__format_cuesheet_is_legal(&m->data.cue_sheet, m->data.cue_sheet.is_cd, /*violation=*/0))
830                                 return FLAC__STREAM_ENCODER_INIT_STATUS_INVALID_METADATA;
831                 }
832                 else if(m->type == FLAC__METADATA_TYPE_PICTURE) {
833                         if(!FLAC__format_picture_is_legal(&m->data.picture, /*violation=*/0))
834                                 return FLAC__STREAM_ENCODER_INIT_STATUS_INVALID_METADATA;
835                         if(m->data.picture.type == FLAC__STREAM_METADATA_PICTURE_TYPE_FILE_ICON_STANDARD) {
836                                 if(metadata_picture_has_type1) /* there should only be 1 per stream */
837                                         return FLAC__STREAM_ENCODER_INIT_STATUS_INVALID_METADATA;
838                                 metadata_picture_has_type1 = true;
839                                 /* standard icon must be 32x32 pixel PNG */
840                                 if(
841                                         m->data.picture.type == FLAC__STREAM_METADATA_PICTURE_TYPE_FILE_ICON_STANDARD && 
842                                         (
843                                                 (strcmp(m->data.picture.mime_type, "image/png") && strcmp(m->data.picture.mime_type, "-->")) ||
844                                                 m->data.picture.width != 32 ||
845                                                 m->data.picture.height != 32
846                                         )
847                                 )
848                                         return FLAC__STREAM_ENCODER_INIT_STATUS_INVALID_METADATA;
849                         }
850                         else if(m->data.picture.type == FLAC__STREAM_METADATA_PICTURE_TYPE_FILE_ICON) {
851                                 if(metadata_picture_has_type2) /* there should only be 1 per stream */
852                                         return FLAC__STREAM_ENCODER_INIT_STATUS_INVALID_METADATA;
853                                 metadata_picture_has_type2 = true;
854                         }
855                 }
856         }
857
858         encoder->private_->input_capacity = 0;
859         for(i = 0; i < encoder->protected_->channels; i++) {
860                 encoder->private_->integer_signal_unaligned[i] = encoder->private_->integer_signal[i] = 0;
861 #ifndef FLAC__INTEGER_ONLY_LIBRARY
862                 encoder->private_->real_signal_unaligned[i] = encoder->private_->real_signal[i] = 0;
863 #endif
864         }
865         for(i = 0; i < 2; i++) {
866                 encoder->private_->integer_signal_mid_side_unaligned[i] = encoder->private_->integer_signal_mid_side[i] = 0;
867 #ifndef FLAC__INTEGER_ONLY_LIBRARY
868                 encoder->private_->real_signal_mid_side_unaligned[i] = encoder->private_->real_signal_mid_side[i] = 0;
869 #endif
870         }
871 #ifndef FLAC__INTEGER_ONLY_LIBRARY
872         for(i = 0; i < encoder->protected_->num_apodizations; i++)
873                 encoder->private_->window_unaligned[i] = encoder->private_->window[i] = 0;
874         encoder->private_->windowed_signal_unaligned = encoder->private_->windowed_signal = 0;
875 #endif
876         for(i = 0; i < encoder->protected_->channels; i++) {
877                 encoder->private_->residual_workspace_unaligned[i][0] = encoder->private_->residual_workspace[i][0] = 0;
878                 encoder->private_->residual_workspace_unaligned[i][1] = encoder->private_->residual_workspace[i][1] = 0;
879                 encoder->private_->best_subframe[i] = 0;
880         }
881         for(i = 0; i < 2; i++) {
882                 encoder->private_->residual_workspace_mid_side_unaligned[i][0] = encoder->private_->residual_workspace_mid_side[i][0] = 0;
883                 encoder->private_->residual_workspace_mid_side_unaligned[i][1] = encoder->private_->residual_workspace_mid_side[i][1] = 0;
884                 encoder->private_->best_subframe_mid_side[i] = 0;
885         }
886         encoder->private_->abs_residual_partition_sums_unaligned = encoder->private_->abs_residual_partition_sums = 0;
887         encoder->private_->raw_bits_per_partition_unaligned = encoder->private_->raw_bits_per_partition = 0;
888 #ifndef FLAC__INTEGER_ONLY_LIBRARY
889         encoder->private_->loose_mid_side_stereo_frames = (unsigned)((FLAC__double)encoder->protected_->sample_rate * 0.4 / (FLAC__double)encoder->protected_->blocksize + 0.5);
890 #else
891         /* 26214 is the approximate fixed-point equivalent to 0.4 (0.4 * 2^16) */
892         /* sample rate can be up to 655350 Hz, and thus use 20 bits, so we do the multiply&divide by hand */
893         FLAC__ASSERT(FLAC__MAX_SAMPLE_RATE <= 655350);
894         FLAC__ASSERT(FLAC__MAX_BLOCK_SIZE <= 65535);
895         FLAC__ASSERT(encoder->protected_->sample_rate <= 655350);
896         FLAC__ASSERT(encoder->protected_->blocksize <= 65535);
897         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);
898 #endif
899         if(encoder->private_->loose_mid_side_stereo_frames == 0)
900                 encoder->private_->loose_mid_side_stereo_frames = 1;
901         encoder->private_->loose_mid_side_stereo_frame_count = 0;
902         encoder->private_->current_sample_number = 0;
903         encoder->private_->current_frame_number = 0;
904
905         encoder->private_->use_wide_by_block = (encoder->protected_->bits_per_sample + FLAC__bitmath_ilog2(encoder->protected_->blocksize)+1 > 30);
906         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? */
907         encoder->private_->use_wide_by_partition = (false); /*@@@ need to set this */
908
909         /*
910          * get the CPU info and set the function pointers
911          */
912         FLAC__cpu_info(&encoder->private_->cpuinfo);
913         /* first default to the non-asm routines */
914 #ifndef FLAC__INTEGER_ONLY_LIBRARY
915         encoder->private_->local_lpc_compute_autocorrelation = FLAC__lpc_compute_autocorrelation;
916 #endif
917         encoder->private_->local_fixed_compute_best_predictor = FLAC__fixed_compute_best_predictor;
918 #ifndef FLAC__INTEGER_ONLY_LIBRARY
919         encoder->private_->local_lpc_compute_residual_from_qlp_coefficients = FLAC__lpc_compute_residual_from_qlp_coefficients;
920         encoder->private_->local_lpc_compute_residual_from_qlp_coefficients_64bit = FLAC__lpc_compute_residual_from_qlp_coefficients_wide;
921         encoder->private_->local_lpc_compute_residual_from_qlp_coefficients_16bit = FLAC__lpc_compute_residual_from_qlp_coefficients;
922 #endif
923         /* now override with asm where appropriate */
924 #ifndef FLAC__INTEGER_ONLY_LIBRARY
925 # ifndef FLAC__NO_ASM
926         if(encoder->private_->cpuinfo.use_asm) {
927 #  ifdef FLAC__CPU_IA32
928                 FLAC__ASSERT(encoder->private_->cpuinfo.type == FLAC__CPUINFO_TYPE_IA32);
929 #   ifdef FLAC__HAS_NASM
930                 if(encoder->private_->cpuinfo.data.ia32.sse) {
931                         if(encoder->protected_->max_lpc_order < 4)
932                                 encoder->private_->local_lpc_compute_autocorrelation = FLAC__lpc_compute_autocorrelation_asm_ia32_sse_lag_4;
933                         else if(encoder->protected_->max_lpc_order < 8)
934                                 encoder->private_->local_lpc_compute_autocorrelation = FLAC__lpc_compute_autocorrelation_asm_ia32_sse_lag_8;
935                         else if(encoder->protected_->max_lpc_order < 12)
936                                 encoder->private_->local_lpc_compute_autocorrelation = FLAC__lpc_compute_autocorrelation_asm_ia32_sse_lag_12;
937                         else
938                                 encoder->private_->local_lpc_compute_autocorrelation = FLAC__lpc_compute_autocorrelation_asm_ia32;
939                 }
940                 else if(encoder->private_->cpuinfo.data.ia32._3dnow)
941                         encoder->private_->local_lpc_compute_autocorrelation = FLAC__lpc_compute_autocorrelation_asm_ia32_3dnow;
942                 else
943                         encoder->private_->local_lpc_compute_autocorrelation = FLAC__lpc_compute_autocorrelation_asm_ia32;
944                 if(encoder->private_->cpuinfo.data.ia32.mmx) {
945                         encoder->private_->local_lpc_compute_residual_from_qlp_coefficients = FLAC__lpc_compute_residual_from_qlp_coefficients_asm_ia32;
946                         encoder->private_->local_lpc_compute_residual_from_qlp_coefficients_16bit = FLAC__lpc_compute_residual_from_qlp_coefficients_asm_ia32_mmx;
947                 }
948                 else {
949                         encoder->private_->local_lpc_compute_residual_from_qlp_coefficients = FLAC__lpc_compute_residual_from_qlp_coefficients_asm_ia32;
950                         encoder->private_->local_lpc_compute_residual_from_qlp_coefficients_16bit = FLAC__lpc_compute_residual_from_qlp_coefficients_asm_ia32;
951                 }
952                 if(encoder->private_->cpuinfo.data.ia32.mmx && encoder->private_->cpuinfo.data.ia32.cmov)
953                         encoder->private_->local_fixed_compute_best_predictor = FLAC__fixed_compute_best_predictor_asm_ia32_mmx_cmov;
954 #   endif /* FLAC__HAS_NASM */
955 #  endif /* FLAC__CPU_IA32 */
956         }
957 # endif /* !FLAC__NO_ASM */
958 #endif /* !FLAC__INTEGER_ONLY_LIBRARY */
959         /* finally override based on wide-ness if necessary */
960         if(encoder->private_->use_wide_by_block) {
961                 encoder->private_->local_fixed_compute_best_predictor = FLAC__fixed_compute_best_predictor_wide;
962         }
963
964         /* set state to OK; from here on, errors are fatal and we'll override the state then */
965         encoder->protected_->state = FLAC__STREAM_ENCODER_OK;
966
967 #if FLAC__HAS_OGG
968         encoder->private_->is_ogg = is_ogg;
969         if(is_ogg && !FLAC__ogg_encoder_aspect_init(&encoder->protected_->ogg_encoder_aspect)) {
970                 encoder->protected_->state = FLAC__STREAM_ENCODER_OGG_ERROR;
971                 return FLAC__STREAM_ENCODER_INIT_STATUS_ENCODER_ERROR;
972         }
973 #endif
974
975         encoder->private_->read_callback = read_callback;
976         encoder->private_->write_callback = write_callback;
977         encoder->private_->seek_callback = seek_callback;
978         encoder->private_->tell_callback = tell_callback;
979         encoder->private_->metadata_callback = metadata_callback;
980         encoder->private_->client_data = client_data;
981
982         if(!resize_buffers_(encoder, encoder->protected_->blocksize)) {
983                 /* the above function sets the state for us in case of an error */
984                 return FLAC__STREAM_ENCODER_INIT_STATUS_ENCODER_ERROR;
985         }
986
987         if(!FLAC__bitwriter_init(encoder->private_->frame)) {
988                 encoder->protected_->state = FLAC__STREAM_ENCODER_MEMORY_ALLOCATION_ERROR;
989                 return FLAC__STREAM_ENCODER_INIT_STATUS_ENCODER_ERROR;
990         }
991
992         /*
993          * Set up the verify stuff if necessary
994          */
995         if(encoder->protected_->verify) {
996                 /*
997                  * First, set up the fifo which will hold the
998                  * original signal to compare against
999                  */
1000                 encoder->private_->verify.input_fifo.size = encoder->protected_->blocksize+OVERREAD_;
1001                 for(i = 0; i < encoder->protected_->channels; i++) {
1002                         if(0 == (encoder->private_->verify.input_fifo.data[i] = (FLAC__int32*)malloc(sizeof(FLAC__int32) * encoder->private_->verify.input_fifo.size))) {
1003                                 encoder->protected_->state = FLAC__STREAM_ENCODER_MEMORY_ALLOCATION_ERROR;
1004                                 return FLAC__STREAM_ENCODER_INIT_STATUS_ENCODER_ERROR;
1005                         }
1006                 }
1007                 encoder->private_->verify.input_fifo.tail = 0;
1008
1009                 /*
1010                  * Now set up a stream decoder for verification
1011                  */
1012                 encoder->private_->verify.decoder = FLAC__stream_decoder_new();
1013                 if(0 == encoder->private_->verify.decoder) {
1014                         encoder->protected_->state = FLAC__STREAM_ENCODER_VERIFY_DECODER_ERROR;
1015                         return FLAC__STREAM_ENCODER_INIT_STATUS_ENCODER_ERROR;
1016                 }
1017
1018                 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) {
1019                         encoder->protected_->state = FLAC__STREAM_ENCODER_VERIFY_DECODER_ERROR;
1020                         return FLAC__STREAM_ENCODER_INIT_STATUS_ENCODER_ERROR;
1021                 }
1022         }
1023         encoder->private_->verify.error_stats.absolute_sample = 0;
1024         encoder->private_->verify.error_stats.frame_number = 0;
1025         encoder->private_->verify.error_stats.channel = 0;
1026         encoder->private_->verify.error_stats.sample = 0;
1027         encoder->private_->verify.error_stats.expected = 0;
1028         encoder->private_->verify.error_stats.got = 0;
1029
1030         /*
1031          * These must be done before we write any metadata, because that
1032          * calls the write_callback, which uses these values.
1033          */
1034         encoder->private_->first_seekpoint_to_check = 0;
1035         encoder->private_->samples_written = 0;
1036         encoder->protected_->streaminfo_offset = 0;
1037         encoder->protected_->seektable_offset = 0;
1038         encoder->protected_->audio_offset = 0;
1039
1040         /*
1041          * write the stream header
1042          */
1043         if(encoder->protected_->verify)
1044                 encoder->private_->verify.state_hint = ENCODER_IN_MAGIC;
1045         if(!FLAC__bitwriter_write_raw_uint32(encoder->private_->frame, FLAC__STREAM_SYNC, FLAC__STREAM_SYNC_LEN)) {
1046                 encoder->protected_->state = FLAC__STREAM_ENCODER_FRAMING_ERROR;
1047                 return FLAC__STREAM_ENCODER_INIT_STATUS_ENCODER_ERROR;
1048         }
1049         if(!write_bitbuffer_(encoder, 0, /*is_last_block=*/false)) {
1050                 /* the above function sets the state for us in case of an error */
1051                 return FLAC__STREAM_ENCODER_INIT_STATUS_ENCODER_ERROR;
1052         }
1053
1054         /*
1055          * write the STREAMINFO metadata block
1056          */
1057         if(encoder->protected_->verify)
1058                 encoder->private_->verify.state_hint = ENCODER_IN_METADATA;
1059         encoder->private_->streaminfo.type = FLAC__METADATA_TYPE_STREAMINFO;
1060         encoder->private_->streaminfo.is_last = false; /* we will have at a minimum a VORBIS_COMMENT afterwards */
1061         encoder->private_->streaminfo.length = FLAC__STREAM_METADATA_STREAMINFO_LENGTH;
1062         encoder->private_->streaminfo.data.stream_info.min_blocksize = encoder->protected_->blocksize; /* this encoder uses the same blocksize for the whole stream */
1063         encoder->private_->streaminfo.data.stream_info.max_blocksize = encoder->protected_->blocksize;
1064         encoder->private_->streaminfo.data.stream_info.min_framesize = 0; /* we don't know this yet; have to fill it in later */
1065         encoder->private_->streaminfo.data.stream_info.max_framesize = 0; /* we don't know this yet; have to fill it in later */
1066         encoder->private_->streaminfo.data.stream_info.sample_rate = encoder->protected_->sample_rate;
1067         encoder->private_->streaminfo.data.stream_info.channels = encoder->protected_->channels;
1068         encoder->private_->streaminfo.data.stream_info.bits_per_sample = encoder->protected_->bits_per_sample;
1069         encoder->private_->streaminfo.data.stream_info.total_samples = encoder->protected_->total_samples_estimate; /* we will replace this later with the real total */
1070         memset(encoder->private_->streaminfo.data.stream_info.md5sum, 0, 16); /* we don't know this yet; have to fill it in later */
1071         FLAC__MD5Init(&encoder->private_->md5context);
1072         if(!FLAC__add_metadata_block(&encoder->private_->streaminfo, encoder->private_->frame)) {
1073                 encoder->protected_->state = FLAC__STREAM_ENCODER_FRAMING_ERROR;
1074                 return FLAC__STREAM_ENCODER_INIT_STATUS_ENCODER_ERROR;
1075         }
1076         if(!write_bitbuffer_(encoder, 0, /*is_last_block=*/false)) {
1077                 /* the above function sets the state for us in case of an error */
1078                 return FLAC__STREAM_ENCODER_INIT_STATUS_ENCODER_ERROR;
1079         }
1080
1081         /*
1082          * Now that the STREAMINFO block is written, we can init this to an
1083          * absurdly-high value...
1084          */
1085         encoder->private_->streaminfo.data.stream_info.min_framesize = (1u << FLAC__STREAM_METADATA_STREAMINFO_MIN_FRAME_SIZE_LEN) - 1;
1086         /* ... and clear this to 0 */
1087         encoder->private_->streaminfo.data.stream_info.total_samples = 0;
1088
1089         /*
1090          * Check to see if the supplied metadata contains a VORBIS_COMMENT;
1091          * if not, we will write an empty one (FLAC__add_metadata_block()
1092          * automatically supplies the vendor string).
1093          *
1094          * WATCHOUT: the Ogg FLAC mapping requires us to write this block after
1095          * the STREAMINFO.  (In the case that metadata_has_vorbis_comment is
1096          * true it will have already insured that the metadata list is properly
1097          * ordered.)
1098          */
1099         if(!metadata_has_vorbis_comment) {
1100                 FLAC__StreamMetadata vorbis_comment;
1101                 vorbis_comment.type = FLAC__METADATA_TYPE_VORBIS_COMMENT;
1102                 vorbis_comment.is_last = (encoder->protected_->num_metadata_blocks == 0);
1103                 vorbis_comment.length = 4 + 4; /* MAGIC NUMBER */
1104                 vorbis_comment.data.vorbis_comment.vendor_string.length = 0;
1105                 vorbis_comment.data.vorbis_comment.vendor_string.entry = 0;
1106                 vorbis_comment.data.vorbis_comment.num_comments = 0;
1107                 vorbis_comment.data.vorbis_comment.comments = 0;
1108                 if(!FLAC__add_metadata_block(&vorbis_comment, encoder->private_->frame)) {
1109                         encoder->protected_->state = FLAC__STREAM_ENCODER_FRAMING_ERROR;
1110                         return FLAC__STREAM_ENCODER_INIT_STATUS_ENCODER_ERROR;
1111                 }
1112                 if(!write_bitbuffer_(encoder, 0, /*is_last_block=*/false)) {
1113                         /* the above function sets the state for us in case of an error */
1114                         return FLAC__STREAM_ENCODER_INIT_STATUS_ENCODER_ERROR;
1115                 }
1116         }
1117
1118         /*
1119          * write the user's metadata blocks
1120          */
1121         for(i = 0; i < encoder->protected_->num_metadata_blocks; i++) {
1122                 encoder->protected_->metadata[i]->is_last = (i == encoder->protected_->num_metadata_blocks - 1);
1123                 if(!FLAC__add_metadata_block(encoder->protected_->metadata[i], encoder->private_->frame)) {
1124                         encoder->protected_->state = FLAC__STREAM_ENCODER_FRAMING_ERROR;
1125                         return FLAC__STREAM_ENCODER_INIT_STATUS_ENCODER_ERROR;
1126                 }
1127                 if(!write_bitbuffer_(encoder, 0, /*is_last_block=*/false)) {
1128                         /* the above function sets the state for us in case of an error */
1129                         return FLAC__STREAM_ENCODER_INIT_STATUS_ENCODER_ERROR;
1130                 }
1131         }
1132
1133         /* now that all the metadata is written, we save the stream offset */
1134         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 */
1135                 encoder->protected_->state = FLAC__STREAM_ENCODER_CLIENT_ERROR;
1136                 return FLAC__STREAM_ENCODER_INIT_STATUS_ENCODER_ERROR;
1137         }
1138
1139         if(encoder->protected_->verify)
1140                 encoder->private_->verify.state_hint = ENCODER_IN_AUDIO;
1141
1142         return FLAC__STREAM_ENCODER_INIT_STATUS_OK;
1143 }
1144
1145 FLAC_API FLAC__StreamEncoderInitStatus FLAC__stream_encoder_init_stream(
1146         FLAC__StreamEncoder *encoder,
1147         FLAC__StreamEncoderWriteCallback write_callback,
1148         FLAC__StreamEncoderSeekCallback seek_callback,
1149         FLAC__StreamEncoderTellCallback tell_callback,
1150         FLAC__StreamEncoderMetadataCallback metadata_callback,
1151         void *client_data
1152 )
1153 {
1154         return init_stream_internal_(
1155                 encoder,
1156                 /*read_callback=*/0,
1157                 write_callback,
1158                 seek_callback,
1159                 tell_callback,
1160                 metadata_callback,
1161                 client_data,
1162                 /*is_ogg=*/false
1163         );
1164 }
1165
1166 FLAC_API FLAC__StreamEncoderInitStatus FLAC__stream_encoder_init_ogg_stream(
1167         FLAC__StreamEncoder *encoder,
1168         FLAC__StreamEncoderReadCallback read_callback,
1169         FLAC__StreamEncoderWriteCallback write_callback,
1170         FLAC__StreamEncoderSeekCallback seek_callback,
1171         FLAC__StreamEncoderTellCallback tell_callback,
1172         FLAC__StreamEncoderMetadataCallback metadata_callback,
1173         void *client_data
1174 )
1175 {
1176         return init_stream_internal_(
1177                 encoder,
1178                 read_callback,
1179                 write_callback,
1180                 seek_callback,
1181                 tell_callback,
1182                 metadata_callback,
1183                 client_data,
1184                 /*is_ogg=*/true
1185         );
1186 }
1187  
1188 static FLAC__StreamEncoderInitStatus init_FILE_internal_(
1189         FLAC__StreamEncoder *encoder,
1190         FILE *file,
1191         FLAC__StreamEncoderProgressCallback progress_callback,
1192         void *client_data,
1193         FLAC__bool is_ogg
1194 )
1195 {
1196         FLAC__StreamEncoderInitStatus init_status;
1197
1198         FLAC__ASSERT(0 != encoder);
1199         FLAC__ASSERT(0 != file);
1200
1201         if(encoder->protected_->state != FLAC__STREAM_ENCODER_UNINITIALIZED)
1202                 return FLAC__STREAM_ENCODER_INIT_STATUS_ALREADY_INITIALIZED;
1203
1204         /* double protection */
1205         if(file == 0) {
1206                 encoder->protected_->state = FLAC__STREAM_ENCODER_IO_ERROR;
1207                 return FLAC__STREAM_ENCODER_INIT_STATUS_ENCODER_ERROR;
1208         }
1209
1210         /*
1211          * To make sure that our file does not go unclosed after an error, we
1212          * must assign the FILE pointer before any further error can occur in
1213          * this routine.
1214          */
1215         if(file == stdout)
1216                 file = get_binary_stdout_(); /* just to be safe */
1217
1218         encoder->private_->file = file;
1219
1220         encoder->private_->progress_callback = progress_callback;
1221         encoder->private_->bytes_written = 0;
1222         encoder->private_->samples_written = 0;
1223         encoder->private_->frames_written = 0;
1224
1225         init_status = init_stream_internal_(
1226                 encoder,
1227                 encoder->private_->file == stdout? 0 : is_ogg? file_read_callback_ : 0,
1228                 file_write_callback_,
1229                 encoder->private_->file == stdout? 0 : file_seek_callback_,
1230                 encoder->private_->file == stdout? 0 : file_tell_callback_,
1231                 /*metadata_callback=*/0,
1232                 client_data,
1233                 is_ogg
1234         );
1235         if(init_status != FLAC__STREAM_ENCODER_INIT_STATUS_OK) {
1236                 /* the above function sets the state for us in case of an error */
1237                 return init_status;
1238         }
1239
1240         {
1241                 unsigned blocksize = FLAC__stream_encoder_get_blocksize(encoder);
1242
1243                 FLAC__ASSERT(blocksize != 0);
1244                 encoder->private_->total_frames_estimate = (unsigned)((FLAC__stream_encoder_get_total_samples_estimate(encoder) + blocksize - 1) / blocksize);
1245         }
1246
1247         return init_status;
1248 }
1249  
1250 FLAC_API FLAC__StreamEncoderInitStatus FLAC__stream_encoder_init_FILE(
1251         FLAC__StreamEncoder *encoder,
1252         FILE *file,
1253         FLAC__StreamEncoderProgressCallback progress_callback,
1254         void *client_data
1255 )
1256 {
1257         return init_FILE_internal_(encoder, file, progress_callback, client_data, /*is_ogg=*/false);
1258 }
1259  
1260 FLAC_API FLAC__StreamEncoderInitStatus FLAC__stream_encoder_init_ogg_FILE(
1261         FLAC__StreamEncoder *encoder,
1262         FILE *file,
1263         FLAC__StreamEncoderProgressCallback progress_callback,
1264         void *client_data
1265 )
1266 {
1267         return init_FILE_internal_(encoder, file, progress_callback, client_data, /*is_ogg=*/true);
1268 }
1269
1270 static FLAC__StreamEncoderInitStatus init_file_internal_(
1271         FLAC__StreamEncoder *encoder,
1272         const char *filename,
1273         FLAC__StreamEncoderProgressCallback progress_callback,
1274         void *client_data,
1275         FLAC__bool is_ogg
1276 )
1277 {
1278         FILE *file;
1279
1280         FLAC__ASSERT(0 != encoder);
1281
1282         /*
1283          * To make sure that our file does not go unclosed after an error, we
1284          * have to do the same entrance checks here that are later performed
1285          * in FLAC__stream_encoder_init_FILE() before the FILE* is assigned.
1286          */
1287         if(encoder->protected_->state != FLAC__STREAM_ENCODER_UNINITIALIZED)
1288                 return FLAC__STREAM_ENCODER_INIT_STATUS_ALREADY_INITIALIZED;
1289
1290         file = filename? fopen(filename, "w+b") : stdout;
1291
1292         if(file == 0) {
1293                 encoder->protected_->state = FLAC__STREAM_ENCODER_IO_ERROR;
1294                 return FLAC__STREAM_ENCODER_INIT_STATUS_ENCODER_ERROR;
1295         }
1296
1297         return init_FILE_internal_(encoder, file, progress_callback, client_data, is_ogg);
1298 }
1299
1300 FLAC_API FLAC__StreamEncoderInitStatus FLAC__stream_encoder_init_file(
1301         FLAC__StreamEncoder *encoder,
1302         const char *filename,
1303         FLAC__StreamEncoderProgressCallback progress_callback,
1304         void *client_data
1305 )
1306 {
1307         return init_file_internal_(encoder, filename, progress_callback, client_data, /*is_ogg=*/false);
1308 }
1309
1310 FLAC_API FLAC__StreamEncoderInitStatus FLAC__stream_encoder_init_ogg_file(
1311         FLAC__StreamEncoder *encoder,
1312         const char *filename,
1313         FLAC__StreamEncoderProgressCallback progress_callback,
1314         void *client_data
1315 )
1316 {
1317         return init_file_internal_(encoder, filename, progress_callback, client_data, /*is_ogg=*/true);
1318 }
1319
1320 FLAC_API FLAC__bool FLAC__stream_encoder_finish(FLAC__StreamEncoder *encoder)
1321 {
1322         FLAC__bool error = false;
1323
1324         FLAC__ASSERT(0 != encoder);
1325         FLAC__ASSERT(0 != encoder->private_);
1326         FLAC__ASSERT(0 != encoder->protected_);
1327
1328         if(encoder->protected_->state == FLAC__STREAM_ENCODER_UNINITIALIZED)
1329                 return true;
1330
1331         if(encoder->protected_->state == FLAC__STREAM_ENCODER_OK && !encoder->private_->is_being_deleted) {
1332                 if(encoder->private_->current_sample_number != 0) {
1333                         const FLAC__bool is_fractional_block = encoder->protected_->blocksize != encoder->private_->current_sample_number;
1334                         encoder->protected_->blocksize = encoder->private_->current_sample_number;
1335                         if(!process_frame_(encoder, is_fractional_block, /*is_last_block=*/true))
1336                                 error = true;
1337                 }
1338         }
1339
1340         FLAC__MD5Final(encoder->private_->streaminfo.data.stream_info.md5sum, &encoder->private_->md5context);
1341
1342         if(!encoder->private_->is_being_deleted) {
1343                 if(encoder->protected_->state == FLAC__STREAM_ENCODER_OK) {
1344                         if(encoder->private_->seek_callback) {
1345 #if FLAC__HAS_OGG
1346                                 if(encoder->private_->is_ogg)
1347                                         update_ogg_metadata_(encoder);
1348                                 else
1349 #endif
1350                                 update_metadata_(encoder);
1351
1352                                 /* check if an error occurred while updating metadata */
1353                                 if(encoder->protected_->state != FLAC__STREAM_ENCODER_OK)
1354                                         error = true;
1355                         }
1356                         if(encoder->private_->metadata_callback)
1357                                 encoder->private_->metadata_callback(encoder, &encoder->private_->streaminfo, encoder->private_->client_data);
1358                 }
1359
1360                 if(encoder->protected_->verify && 0 != encoder->private_->verify.decoder && !FLAC__stream_decoder_finish(encoder->private_->verify.decoder)) {
1361                         if(!error)
1362                                 encoder->protected_->state = FLAC__STREAM_ENCODER_VERIFY_MISMATCH_IN_AUDIO_DATA;
1363                         error = true;
1364                 }
1365         }
1366
1367         if(0 != encoder->private_->file) {
1368                 if(encoder->private_->file != stdout)
1369                         fclose(encoder->private_->file);
1370                 encoder->private_->file = 0;
1371         }
1372
1373 #if FLAC__HAS_OGG
1374         if(encoder->private_->is_ogg)
1375                 FLAC__ogg_encoder_aspect_finish(&encoder->protected_->ogg_encoder_aspect);
1376 #endif
1377
1378         free_(encoder);
1379         set_defaults_(encoder);
1380
1381         if(!error)
1382                 encoder->protected_->state = FLAC__STREAM_ENCODER_UNINITIALIZED;
1383
1384         return !error;
1385 }
1386
1387 FLAC_API FLAC__bool FLAC__stream_encoder_set_ogg_serial_number(FLAC__StreamEncoder *encoder, long value)
1388 {
1389         FLAC__ASSERT(0 != encoder);
1390         FLAC__ASSERT(0 != encoder->private_);
1391         FLAC__ASSERT(0 != encoder->protected_);
1392         if(encoder->protected_->state != FLAC__STREAM_ENCODER_UNINITIALIZED)
1393                 return false;
1394 #if FLAC__HAS_OGG
1395         /* can't check encoder->private_->is_ogg since that's not set until init time */
1396         FLAC__ogg_encoder_aspect_set_serial_number(&encoder->protected_->ogg_encoder_aspect, value);
1397         return true;
1398 #else
1399         (void)value;
1400         return false;
1401 #endif
1402 }
1403
1404 FLAC_API FLAC__bool FLAC__stream_encoder_set_verify(FLAC__StreamEncoder *encoder, FLAC__bool 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 #ifndef FLAC__MANDATORY_VERIFY_WHILE_ENCODING
1412         encoder->protected_->verify = value;
1413 #endif
1414         return true;
1415 }
1416
1417 FLAC_API FLAC__bool FLAC__stream_encoder_set_streamable_subset(FLAC__StreamEncoder *encoder, FLAC__bool value)
1418 {
1419         FLAC__ASSERT(0 != encoder);
1420         FLAC__ASSERT(0 != encoder->private_);
1421         FLAC__ASSERT(0 != encoder->protected_);
1422         if(encoder->protected_->state != FLAC__STREAM_ENCODER_UNINITIALIZED)
1423                 return false;
1424         encoder->protected_->streamable_subset = value;
1425         return true;
1426 }
1427
1428 FLAC_API FLAC__bool FLAC__stream_encoder_set_channels(FLAC__StreamEncoder *encoder, unsigned value)
1429 {
1430         FLAC__ASSERT(0 != encoder);
1431         FLAC__ASSERT(0 != encoder->private_);
1432         FLAC__ASSERT(0 != encoder->protected_);
1433         if(encoder->protected_->state != FLAC__STREAM_ENCODER_UNINITIALIZED)
1434                 return false;
1435         encoder->protected_->channels = value;
1436         return true;
1437 }
1438
1439 FLAC_API FLAC__bool FLAC__stream_encoder_set_bits_per_sample(FLAC__StreamEncoder *encoder, unsigned value)
1440 {
1441         FLAC__ASSERT(0 != encoder);
1442         FLAC__ASSERT(0 != encoder->private_);
1443         FLAC__ASSERT(0 != encoder->protected_);
1444         if(encoder->protected_->state != FLAC__STREAM_ENCODER_UNINITIALIZED)
1445                 return false;
1446         encoder->protected_->bits_per_sample = value;
1447         return true;
1448 }
1449
1450 FLAC_API FLAC__bool FLAC__stream_encoder_set_sample_rate(FLAC__StreamEncoder *encoder, unsigned value)
1451 {
1452         FLAC__ASSERT(0 != encoder);
1453         FLAC__ASSERT(0 != encoder->private_);
1454         FLAC__ASSERT(0 != encoder->protected_);
1455         if(encoder->protected_->state != FLAC__STREAM_ENCODER_UNINITIALIZED)
1456                 return false;
1457         encoder->protected_->sample_rate = value;
1458         return true;
1459 }
1460
1461 FLAC_API FLAC__bool FLAC__stream_encoder_set_compression_level(FLAC__StreamEncoder *encoder, unsigned value)
1462 {
1463         FLAC__bool ok = true;
1464         FLAC__ASSERT(0 != encoder);
1465         FLAC__ASSERT(0 != encoder->private_);
1466         FLAC__ASSERT(0 != encoder->protected_);
1467         if(encoder->protected_->state != FLAC__STREAM_ENCODER_UNINITIALIZED)
1468                 return false;
1469         if(value >= sizeof(compression_levels_)/sizeof(compression_levels_[0]))
1470                 value = sizeof(compression_levels_)/sizeof(compression_levels_[0]) - 1;
1471         ok &= FLAC__stream_encoder_set_do_mid_side_stereo          (encoder, compression_levels_[value].do_mid_side_stereo);
1472         ok &= FLAC__stream_encoder_set_loose_mid_side_stereo       (encoder, compression_levels_[value].loose_mid_side_stereo);
1473 #if 0
1474         /* was: */
1475         ok &= FLAC__stream_encoder_set_apodization                 (encoder, compression_levels_[value].apodization);
1476         /* but it's too hard to specify the string in a locale-specific way */
1477 #else
1478         encoder->protected_->num_apodizations = 1;
1479         encoder->protected_->apodizations[0].type = FLAC__APODIZATION_TUKEY;
1480         encoder->protected_->apodizations[0].parameters.tukey.p = 0.5;
1481 #endif
1482         ok &= FLAC__stream_encoder_set_max_lpc_order               (encoder, compression_levels_[value].max_lpc_order);
1483         ok &= FLAC__stream_encoder_set_qlp_coeff_precision         (encoder, compression_levels_[value].qlp_coeff_precision);
1484         ok &= FLAC__stream_encoder_set_do_qlp_coeff_prec_search    (encoder, compression_levels_[value].do_qlp_coeff_prec_search);
1485         ok &= FLAC__stream_encoder_set_do_escape_coding            (encoder, compression_levels_[value].do_escape_coding);
1486         ok &= FLAC__stream_encoder_set_do_exhaustive_model_search  (encoder, compression_levels_[value].do_exhaustive_model_search);
1487         ok &= FLAC__stream_encoder_set_min_residual_partition_order(encoder, compression_levels_[value].min_residual_partition_order);
1488         ok &= FLAC__stream_encoder_set_max_residual_partition_order(encoder, compression_levels_[value].max_residual_partition_order);
1489         ok &= FLAC__stream_encoder_set_rice_parameter_search_dist  (encoder, compression_levels_[value].rice_parameter_search_dist);
1490         return ok;
1491 }
1492
1493 FLAC_API FLAC__bool FLAC__stream_encoder_set_blocksize(FLAC__StreamEncoder *encoder, unsigned value)
1494 {
1495         FLAC__ASSERT(0 != encoder);
1496         FLAC__ASSERT(0 != encoder->private_);
1497         FLAC__ASSERT(0 != encoder->protected_);
1498         if(encoder->protected_->state != FLAC__STREAM_ENCODER_UNINITIALIZED)
1499                 return false;
1500         encoder->protected_->blocksize = value;
1501         return true;
1502 }
1503
1504 FLAC_API FLAC__bool FLAC__stream_encoder_set_do_mid_side_stereo(FLAC__StreamEncoder *encoder, FLAC__bool value)
1505 {
1506         FLAC__ASSERT(0 != encoder);
1507         FLAC__ASSERT(0 != encoder->private_);
1508         FLAC__ASSERT(0 != encoder->protected_);
1509         if(encoder->protected_->state != FLAC__STREAM_ENCODER_UNINITIALIZED)
1510                 return false;
1511         encoder->protected_->do_mid_side_stereo = value;
1512         return true;
1513 }
1514
1515 FLAC_API FLAC__bool FLAC__stream_encoder_set_loose_mid_side_stereo(FLAC__StreamEncoder *encoder, FLAC__bool value)
1516 {
1517         FLAC__ASSERT(0 != encoder);
1518         FLAC__ASSERT(0 != encoder->private_);
1519         FLAC__ASSERT(0 != encoder->protected_);
1520         if(encoder->protected_->state != FLAC__STREAM_ENCODER_UNINITIALIZED)
1521                 return false;
1522         encoder->protected_->loose_mid_side_stereo = value;
1523         return true;
1524 }
1525
1526 FLAC_API FLAC__bool FLAC__stream_encoder_set_apodization(FLAC__StreamEncoder *encoder, const char *specification)
1527 {
1528         FLAC__ASSERT(0 != encoder);
1529         FLAC__ASSERT(0 != encoder->private_);
1530         FLAC__ASSERT(0 != encoder->protected_);
1531         FLAC__ASSERT(0 != specification);
1532         if(encoder->protected_->state != FLAC__STREAM_ENCODER_UNINITIALIZED)
1533                 return false;
1534 #ifdef FLAC__INTEGER_ONLY_LIBRARY
1535         (void)specification; /* silently ignore since we haven't integerized; will always use a rectangular window */
1536 #else
1537         encoder->protected_->num_apodizations = 0;
1538         while(1) {
1539                 const char *s = strchr(specification, ';');
1540                 const size_t n = s? (size_t)(s - specification) : strlen(specification);
1541                 if     (n==8  && 0 == strncmp("bartlett"     , specification, n))
1542                         encoder->protected_->apodizations[encoder->protected_->num_apodizations++].type = FLAC__APODIZATION_BARTLETT;
1543                 else if(n==13 && 0 == strncmp("bartlett_hann", specification, n))
1544                         encoder->protected_->apodizations[encoder->protected_->num_apodizations++].type = FLAC__APODIZATION_BARTLETT_HANN;
1545                 else if(n==8  && 0 == strncmp("blackman"     , specification, n))
1546                         encoder->protected_->apodizations[encoder->protected_->num_apodizations++].type = FLAC__APODIZATION_BLACKMAN;
1547                 else if(n==26 && 0 == strncmp("blackman_harris_4term_92db", specification, n))
1548                         encoder->protected_->apodizations[encoder->protected_->num_apodizations++].type = FLAC__APODIZATION_BLACKMAN_HARRIS_4TERM_92DB_SIDELOBE;
1549                 else if(n==6  && 0 == strncmp("connes"       , specification, n))
1550                         encoder->protected_->apodizations[encoder->protected_->num_apodizations++].type = FLAC__APODIZATION_CONNES;
1551                 else if(n==7  && 0 == strncmp("flattop"      , specification, n))
1552                         encoder->protected_->apodizations[encoder->protected_->num_apodizations++].type = FLAC__APODIZATION_FLATTOP;
1553                 else if(n>7   && 0 == strncmp("gauss("       , specification, 6)) {
1554                         FLAC__real stddev = (FLAC__real)strtod(specification+6, 0);
1555                         if (stddev > 0.0 && stddev <= 0.5) {
1556                                 encoder->protected_->apodizations[encoder->protected_->num_apodizations].parameters.gauss.stddev = stddev;
1557                                 encoder->protected_->apodizations[encoder->protected_->num_apodizations++].type = FLAC__APODIZATION_GAUSS;
1558                         }
1559                 }
1560                 else if(n==7  && 0 == strncmp("hamming"      , specification, n))
1561                         encoder->protected_->apodizations[encoder->protected_->num_apodizations++].type = FLAC__APODIZATION_HAMMING;
1562                 else if(n==4  && 0 == strncmp("hann"         , specification, n))
1563                         encoder->protected_->apodizations[encoder->protected_->num_apodizations++].type = FLAC__APODIZATION_HANN;
1564                 else if(n==13 && 0 == strncmp("kaiser_bessel", specification, n))
1565                         encoder->protected_->apodizations[encoder->protected_->num_apodizations++].type = FLAC__APODIZATION_KAISER_BESSEL;
1566                 else if(n==7  && 0 == strncmp("nuttall"      , specification, n))
1567                         encoder->protected_->apodizations[encoder->protected_->num_apodizations++].type = FLAC__APODIZATION_NUTTALL;
1568                 else if(n==9  && 0 == strncmp("rectangle"    , specification, n))
1569                         encoder->protected_->apodizations[encoder->protected_->num_apodizations++].type = FLAC__APODIZATION_RECTANGLE;
1570                 else if(n==8  && 0 == strncmp("triangle"     , specification, n))
1571                         encoder->protected_->apodizations[encoder->protected_->num_apodizations++].type = FLAC__APODIZATION_TRIANGLE;
1572                 else if(n>7   && 0 == strncmp("tukey("       , specification, 6)) {
1573                         FLAC__real p = (FLAC__real)strtod(specification+6, 0);
1574                         if (p >= 0.0 && p <= 1.0) {
1575                                 encoder->protected_->apodizations[encoder->protected_->num_apodizations].parameters.tukey.p = p;
1576                                 encoder->protected_->apodizations[encoder->protected_->num_apodizations++].type = FLAC__APODIZATION_TUKEY;
1577                         }
1578                 }
1579                 else if(n==5  && 0 == strncmp("welch"        , specification, n))
1580                         encoder->protected_->apodizations[encoder->protected_->num_apodizations++].type = FLAC__APODIZATION_WELCH;
1581                 if (encoder->protected_->num_apodizations == 32)
1582                         break;
1583                 if (s)
1584                         specification = s+1;
1585                 else
1586                         break;
1587         }
1588         if(encoder->protected_->num_apodizations == 0) {
1589                 encoder->protected_->num_apodizations = 1;
1590                 encoder->protected_->apodizations[0].type = FLAC__APODIZATION_TUKEY;
1591                 encoder->protected_->apodizations[0].parameters.tukey.p = 0.5;
1592         }
1593 #endif
1594         return true;
1595 }
1596
1597 FLAC_API FLAC__bool FLAC__stream_encoder_set_max_lpc_order(FLAC__StreamEncoder *encoder, unsigned value)
1598 {
1599         FLAC__ASSERT(0 != encoder);
1600         FLAC__ASSERT(0 != encoder->private_);
1601         FLAC__ASSERT(0 != encoder->protected_);
1602         if(encoder->protected_->state != FLAC__STREAM_ENCODER_UNINITIALIZED)
1603                 return false;
1604         encoder->protected_->max_lpc_order = value;
1605         return true;
1606 }
1607
1608 FLAC_API FLAC__bool FLAC__stream_encoder_set_qlp_coeff_precision(FLAC__StreamEncoder *encoder, unsigned value)
1609 {
1610         FLAC__ASSERT(0 != encoder);
1611         FLAC__ASSERT(0 != encoder->private_);
1612         FLAC__ASSERT(0 != encoder->protected_);
1613         if(encoder->protected_->state != FLAC__STREAM_ENCODER_UNINITIALIZED)
1614                 return false;
1615         encoder->protected_->qlp_coeff_precision = value;
1616         return true;
1617 }
1618
1619 FLAC_API FLAC__bool FLAC__stream_encoder_set_do_qlp_coeff_prec_search(FLAC__StreamEncoder *encoder, FLAC__bool value)
1620 {
1621         FLAC__ASSERT(0 != encoder);
1622         FLAC__ASSERT(0 != encoder->private_);
1623         FLAC__ASSERT(0 != encoder->protected_);
1624         if(encoder->protected_->state != FLAC__STREAM_ENCODER_UNINITIALIZED)
1625                 return false;
1626         encoder->protected_->do_qlp_coeff_prec_search = value;
1627         return true;
1628 }
1629
1630 FLAC_API FLAC__bool FLAC__stream_encoder_set_do_escape_coding(FLAC__StreamEncoder *encoder, FLAC__bool value)
1631 {
1632         FLAC__ASSERT(0 != encoder);
1633         FLAC__ASSERT(0 != encoder->private_);
1634         FLAC__ASSERT(0 != encoder->protected_);
1635         if(encoder->protected_->state != FLAC__STREAM_ENCODER_UNINITIALIZED)
1636                 return false;
1637 #if 0
1638         /*@@@ deprecated: */
1639         encoder->protected_->do_escape_coding = value;
1640 #else
1641         (void)value;
1642 #endif
1643         return true;
1644 }
1645
1646 FLAC_API FLAC__bool FLAC__stream_encoder_set_do_exhaustive_model_search(FLAC__StreamEncoder *encoder, FLAC__bool value)
1647 {
1648         FLAC__ASSERT(0 != encoder);
1649         FLAC__ASSERT(0 != encoder->private_);
1650         FLAC__ASSERT(0 != encoder->protected_);
1651         if(encoder->protected_->state != FLAC__STREAM_ENCODER_UNINITIALIZED)
1652                 return false;
1653         encoder->protected_->do_exhaustive_model_search = value;
1654         return true;
1655 }
1656
1657 FLAC_API FLAC__bool FLAC__stream_encoder_set_min_residual_partition_order(FLAC__StreamEncoder *encoder, unsigned value)
1658 {
1659         FLAC__ASSERT(0 != encoder);
1660         FLAC__ASSERT(0 != encoder->private_);
1661         FLAC__ASSERT(0 != encoder->protected_);
1662         if(encoder->protected_->state != FLAC__STREAM_ENCODER_UNINITIALIZED)
1663                 return false;
1664         encoder->protected_->min_residual_partition_order = value;
1665         return true;
1666 }
1667
1668 FLAC_API FLAC__bool FLAC__stream_encoder_set_max_residual_partition_order(FLAC__StreamEncoder *encoder, unsigned value)
1669 {
1670         FLAC__ASSERT(0 != encoder);
1671         FLAC__ASSERT(0 != encoder->private_);
1672         FLAC__ASSERT(0 != encoder->protected_);
1673         if(encoder->protected_->state != FLAC__STREAM_ENCODER_UNINITIALIZED)
1674                 return false;
1675         encoder->protected_->max_residual_partition_order = value;
1676         return true;
1677 }
1678
1679 FLAC_API FLAC__bool FLAC__stream_encoder_set_rice_parameter_search_dist(FLAC__StreamEncoder *encoder, unsigned value)
1680 {
1681         FLAC__ASSERT(0 != encoder);
1682         FLAC__ASSERT(0 != encoder->private_);
1683         FLAC__ASSERT(0 != encoder->protected_);
1684         if(encoder->protected_->state != FLAC__STREAM_ENCODER_UNINITIALIZED)
1685                 return false;
1686 #if 0
1687         /*@@@ deprecated: */
1688         encoder->protected_->rice_parameter_search_dist = value;
1689 #else
1690         (void)value;
1691 #endif
1692         return true;
1693 }
1694
1695 FLAC_API FLAC__bool FLAC__stream_encoder_set_total_samples_estimate(FLAC__StreamEncoder *encoder, FLAC__uint64 value)
1696 {
1697         FLAC__ASSERT(0 != encoder);
1698         FLAC__ASSERT(0 != encoder->private_);
1699         FLAC__ASSERT(0 != encoder->protected_);
1700         if(encoder->protected_->state != FLAC__STREAM_ENCODER_UNINITIALIZED)
1701                 return false;
1702         encoder->protected_->total_samples_estimate = value;
1703         return true;
1704 }
1705
1706 FLAC_API FLAC__bool FLAC__stream_encoder_set_metadata(FLAC__StreamEncoder *encoder, FLAC__StreamMetadata **metadata, unsigned num_blocks)
1707 {
1708         FLAC__ASSERT(0 != encoder);
1709         FLAC__ASSERT(0 != encoder->private_);
1710         FLAC__ASSERT(0 != encoder->protected_);
1711         if(encoder->protected_->state != FLAC__STREAM_ENCODER_UNINITIALIZED)
1712                 return false;
1713         if(0 == metadata)
1714                 num_blocks = 0;
1715         if(0 == num_blocks)
1716                 metadata = 0;
1717         /* realloc() does not do exactly what we want so... */
1718         if(encoder->protected_->metadata) {
1719                 free(encoder->protected_->metadata);
1720                 encoder->protected_->metadata = 0;
1721                 encoder->protected_->num_metadata_blocks = 0;
1722         }
1723         if(num_blocks) {
1724                 FLAC__StreamMetadata **m;
1725                 if(0 == (m = (FLAC__StreamMetadata**)malloc(sizeof(m[0]) * num_blocks)))
1726                         return false;
1727                 memcpy(m, metadata, sizeof(m[0]) * num_blocks);
1728                 encoder->protected_->metadata = m;
1729                 encoder->protected_->num_metadata_blocks = num_blocks;
1730         }
1731 #if FLAC__HAS_OGG
1732         if(!FLAC__ogg_encoder_aspect_set_num_metadata(&encoder->protected_->ogg_encoder_aspect, num_blocks))
1733                 return false;
1734 #endif
1735         return true;
1736 }
1737
1738 /*
1739  * These three functions are not static, but not publically exposed in
1740  * include/FLAC/ either.  They are used by the test suite.
1741  */
1742 FLAC_API FLAC__bool FLAC__stream_encoder_disable_constant_subframes(FLAC__StreamEncoder *encoder, FLAC__bool value)
1743 {
1744         FLAC__ASSERT(0 != encoder);
1745         FLAC__ASSERT(0 != encoder->private_);
1746         FLAC__ASSERT(0 != encoder->protected_);
1747         if(encoder->protected_->state != FLAC__STREAM_ENCODER_UNINITIALIZED)
1748                 return false;
1749         encoder->private_->disable_constant_subframes = value;
1750         return true;
1751 }
1752
1753 FLAC_API FLAC__bool FLAC__stream_encoder_disable_fixed_subframes(FLAC__StreamEncoder *encoder, FLAC__bool value)
1754 {
1755         FLAC__ASSERT(0 != encoder);
1756         FLAC__ASSERT(0 != encoder->private_);
1757         FLAC__ASSERT(0 != encoder->protected_);
1758         if(encoder->protected_->state != FLAC__STREAM_ENCODER_UNINITIALIZED)
1759                 return false;
1760         encoder->private_->disable_fixed_subframes = value;
1761         return true;
1762 }
1763
1764 FLAC_API FLAC__bool FLAC__stream_encoder_disable_verbatim_subframes(FLAC__StreamEncoder *encoder, FLAC__bool value)
1765 {
1766         FLAC__ASSERT(0 != encoder);
1767         FLAC__ASSERT(0 != encoder->private_);
1768         FLAC__ASSERT(0 != encoder->protected_);
1769         if(encoder->protected_->state != FLAC__STREAM_ENCODER_UNINITIALIZED)
1770                 return false;
1771         encoder->private_->disable_verbatim_subframes = value;
1772         return true;
1773 }
1774
1775 FLAC_API FLAC__StreamEncoderState FLAC__stream_encoder_get_state(const FLAC__StreamEncoder *encoder)
1776 {
1777         FLAC__ASSERT(0 != encoder);
1778         FLAC__ASSERT(0 != encoder->private_);
1779         FLAC__ASSERT(0 != encoder->protected_);
1780         return encoder->protected_->state;
1781 }
1782
1783 FLAC_API FLAC__StreamDecoderState FLAC__stream_encoder_get_verify_decoder_state(const FLAC__StreamEncoder *encoder)
1784 {
1785         FLAC__ASSERT(0 != encoder);
1786         FLAC__ASSERT(0 != encoder->private_);
1787         FLAC__ASSERT(0 != encoder->protected_);
1788         if(encoder->protected_->verify)
1789                 return FLAC__stream_decoder_get_state(encoder->private_->verify.decoder);
1790         else
1791                 return FLAC__STREAM_DECODER_UNINITIALIZED;
1792 }
1793
1794 FLAC_API const char *FLAC__stream_encoder_get_resolved_state_string(const FLAC__StreamEncoder *encoder)
1795 {
1796         FLAC__ASSERT(0 != encoder);
1797         FLAC__ASSERT(0 != encoder->private_);
1798         FLAC__ASSERT(0 != encoder->protected_);
1799         if(encoder->protected_->state != FLAC__STREAM_ENCODER_VERIFY_DECODER_ERROR)
1800                 return FLAC__StreamEncoderStateString[encoder->protected_->state];
1801         else
1802                 return FLAC__stream_decoder_get_resolved_state_string(encoder->private_->verify.decoder);
1803 }
1804
1805 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)
1806 {
1807         FLAC__ASSERT(0 != encoder);
1808         FLAC__ASSERT(0 != encoder->private_);
1809         FLAC__ASSERT(0 != encoder->protected_);
1810         if(0 != absolute_sample)
1811                 *absolute_sample = encoder->private_->verify.error_stats.absolute_sample;
1812         if(0 != frame_number)
1813                 *frame_number = encoder->private_->verify.error_stats.frame_number;
1814         if(0 != channel)
1815                 *channel = encoder->private_->verify.error_stats.channel;
1816         if(0 != sample)
1817                 *sample = encoder->private_->verify.error_stats.sample;
1818         if(0 != expected)
1819                 *expected = encoder->private_->verify.error_stats.expected;
1820         if(0 != got)
1821                 *got = encoder->private_->verify.error_stats.got;
1822 }
1823
1824 FLAC_API FLAC__bool FLAC__stream_encoder_get_verify(const FLAC__StreamEncoder *encoder)
1825 {
1826         FLAC__ASSERT(0 != encoder);
1827         FLAC__ASSERT(0 != encoder->private_);
1828         FLAC__ASSERT(0 != encoder->protected_);
1829         return encoder->protected_->verify;
1830 }
1831
1832 FLAC_API FLAC__bool FLAC__stream_encoder_get_streamable_subset(const FLAC__StreamEncoder *encoder)
1833 {
1834         FLAC__ASSERT(0 != encoder);
1835         FLAC__ASSERT(0 != encoder->private_);
1836         FLAC__ASSERT(0 != encoder->protected_);
1837         return encoder->protected_->streamable_subset;
1838 }
1839
1840 FLAC_API unsigned FLAC__stream_encoder_get_channels(const FLAC__StreamEncoder *encoder)
1841 {
1842         FLAC__ASSERT(0 != encoder);
1843         FLAC__ASSERT(0 != encoder->private_);
1844         FLAC__ASSERT(0 != encoder->protected_);
1845         return encoder->protected_->channels;
1846 }
1847
1848 FLAC_API unsigned FLAC__stream_encoder_get_bits_per_sample(const FLAC__StreamEncoder *encoder)
1849 {
1850         FLAC__ASSERT(0 != encoder);
1851         FLAC__ASSERT(0 != encoder->private_);
1852         FLAC__ASSERT(0 != encoder->protected_);
1853         return encoder->protected_->bits_per_sample;
1854 }
1855
1856 FLAC_API unsigned FLAC__stream_encoder_get_sample_rate(const FLAC__StreamEncoder *encoder)
1857 {
1858         FLAC__ASSERT(0 != encoder);
1859         FLAC__ASSERT(0 != encoder->private_);
1860         FLAC__ASSERT(0 != encoder->protected_);
1861         return encoder->protected_->sample_rate;
1862 }
1863
1864 FLAC_API unsigned FLAC__stream_encoder_get_blocksize(const FLAC__StreamEncoder *encoder)
1865 {
1866         FLAC__ASSERT(0 != encoder);
1867         FLAC__ASSERT(0 != encoder->private_);
1868         FLAC__ASSERT(0 != encoder->protected_);
1869         return encoder->protected_->blocksize;
1870 }
1871
1872 FLAC_API FLAC__bool FLAC__stream_encoder_get_do_mid_side_stereo(const FLAC__StreamEncoder *encoder)
1873 {
1874         FLAC__ASSERT(0 != encoder);
1875         FLAC__ASSERT(0 != encoder->private_);
1876         FLAC__ASSERT(0 != encoder->protected_);
1877         return encoder->protected_->do_mid_side_stereo;
1878 }
1879
1880 FLAC_API FLAC__bool FLAC__stream_encoder_get_loose_mid_side_stereo(const FLAC__StreamEncoder *encoder)
1881 {
1882         FLAC__ASSERT(0 != encoder);
1883         FLAC__ASSERT(0 != encoder->private_);
1884         FLAC__ASSERT(0 != encoder->protected_);
1885         return encoder->protected_->loose_mid_side_stereo;
1886 }
1887
1888 FLAC_API unsigned FLAC__stream_encoder_get_max_lpc_order(const FLAC__StreamEncoder *encoder)
1889 {
1890         FLAC__ASSERT(0 != encoder);
1891         FLAC__ASSERT(0 != encoder->private_);
1892         FLAC__ASSERT(0 != encoder->protected_);
1893         return encoder->protected_->max_lpc_order;
1894 }
1895
1896 FLAC_API unsigned FLAC__stream_encoder_get_qlp_coeff_precision(const FLAC__StreamEncoder *encoder)
1897 {
1898         FLAC__ASSERT(0 != encoder);
1899         FLAC__ASSERT(0 != encoder->private_);
1900         FLAC__ASSERT(0 != encoder->protected_);
1901         return encoder->protected_->qlp_coeff_precision;
1902 }
1903
1904 FLAC_API FLAC__bool FLAC__stream_encoder_get_do_qlp_coeff_prec_search(const FLAC__StreamEncoder *encoder)
1905 {
1906         FLAC__ASSERT(0 != encoder);
1907         FLAC__ASSERT(0 != encoder->private_);
1908         FLAC__ASSERT(0 != encoder->protected_);
1909         return encoder->protected_->do_qlp_coeff_prec_search;
1910 }
1911
1912 FLAC_API FLAC__bool FLAC__stream_encoder_get_do_escape_coding(const FLAC__StreamEncoder *encoder)
1913 {
1914         FLAC__ASSERT(0 != encoder);
1915         FLAC__ASSERT(0 != encoder->private_);
1916         FLAC__ASSERT(0 != encoder->protected_);
1917         return encoder->protected_->do_escape_coding;
1918 }
1919
1920 FLAC_API FLAC__bool FLAC__stream_encoder_get_do_exhaustive_model_search(const FLAC__StreamEncoder *encoder)
1921 {
1922         FLAC__ASSERT(0 != encoder);
1923         FLAC__ASSERT(0 != encoder->private_);
1924         FLAC__ASSERT(0 != encoder->protected_);
1925         return encoder->protected_->do_exhaustive_model_search;
1926 }
1927
1928 FLAC_API unsigned FLAC__stream_encoder_get_min_residual_partition_order(const FLAC__StreamEncoder *encoder)
1929 {
1930         FLAC__ASSERT(0 != encoder);
1931         FLAC__ASSERT(0 != encoder->private_);
1932         FLAC__ASSERT(0 != encoder->protected_);
1933         return encoder->protected_->min_residual_partition_order;
1934 }
1935
1936 FLAC_API unsigned FLAC__stream_encoder_get_max_residual_partition_order(const FLAC__StreamEncoder *encoder)
1937 {
1938         FLAC__ASSERT(0 != encoder);
1939         FLAC__ASSERT(0 != encoder->private_);
1940         FLAC__ASSERT(0 != encoder->protected_);
1941         return encoder->protected_->max_residual_partition_order;
1942 }
1943
1944 FLAC_API unsigned FLAC__stream_encoder_get_rice_parameter_search_dist(const FLAC__StreamEncoder *encoder)
1945 {
1946         FLAC__ASSERT(0 != encoder);
1947         FLAC__ASSERT(0 != encoder->private_);
1948         FLAC__ASSERT(0 != encoder->protected_);
1949         return encoder->protected_->rice_parameter_search_dist;
1950 }
1951
1952 FLAC_API FLAC__uint64 FLAC__stream_encoder_get_total_samples_estimate(const FLAC__StreamEncoder *encoder)
1953 {
1954         FLAC__ASSERT(0 != encoder);
1955         FLAC__ASSERT(0 != encoder->private_);
1956         FLAC__ASSERT(0 != encoder->protected_);
1957         return encoder->protected_->total_samples_estimate;
1958 }
1959
1960 FLAC_API FLAC__bool FLAC__stream_encoder_process(FLAC__StreamEncoder *encoder, const FLAC__int32 * const buffer[], unsigned samples)
1961 {
1962         unsigned i, j, channel;
1963         FLAC__int32 x, mid, side;
1964         const unsigned channels = encoder->protected_->channels, blocksize = encoder->protected_->blocksize;
1965
1966         FLAC__ASSERT(0 != encoder);
1967         FLAC__ASSERT(0 != encoder->private_);
1968         FLAC__ASSERT(0 != encoder->protected_);
1969         FLAC__ASSERT(encoder->protected_->state == FLAC__STREAM_ENCODER_OK);
1970
1971         j = 0;
1972         /*
1973          * we have several flavors of the same basic loop, optimized for
1974          * different conditions:
1975          */
1976         if(encoder->protected_->max_lpc_order > 0) {
1977                 if(encoder->protected_->do_mid_side_stereo && channels == 2) {
1978                         /*
1979                          * stereo coding: unroll channel loop
1980                          * with LPC: calculate floating point version of signal
1981                          */
1982                         do {
1983                                 if(encoder->protected_->verify)
1984                                         append_to_verify_fifo_(&encoder->private_->verify.input_fifo, buffer, j, channels, min(blocksize+1-encoder->private_->current_sample_number, samples-j));
1985
1986                                 /* "i <= blocksize" to overread 1 sample; see comment in OVERREAD_ decl */
1987                                 for(i = encoder->private_->current_sample_number; i <= blocksize && j < samples; i++, j++) {
1988                                         x = mid = side = buffer[0][j];
1989                                         encoder->private_->integer_signal[0][i] = x;
1990 #ifndef FLAC__INTEGER_ONLY_LIBRARY
1991                                         encoder->private_->real_signal[0][i] = (FLAC__real)x;
1992 #endif
1993                                         x = buffer[1][j];
1994                                         encoder->private_->integer_signal[1][i] = x;
1995 #ifndef FLAC__INTEGER_ONLY_LIBRARY
1996                                         encoder->private_->real_signal[1][i] = (FLAC__real)x;
1997 #endif
1998                                         mid += x;
1999                                         side -= x;
2000                                         mid >>= 1; /* NOTE: not the same as 'mid = (buffer[0][j] + buffer[1][j]) / 2' ! */
2001                                         encoder->private_->integer_signal_mid_side[1][i] = side;
2002                                         encoder->private_->integer_signal_mid_side[0][i] = mid;
2003 #ifndef FLAC__INTEGER_ONLY_LIBRARY
2004                                         encoder->private_->real_signal_mid_side[1][i] = (FLAC__real)side;
2005                                         encoder->private_->real_signal_mid_side[0][i] = (FLAC__real)mid;
2006 #endif
2007                                         encoder->private_->current_sample_number++;
2008                                 }
2009                                 /* we only process if we have a full block + 1 extra sample; final block is always handled by FLAC__stream_encoder_finish() */
2010                                 if(i > blocksize) {
2011                                         if(!process_frame_(encoder, /*is_fractional_block=*/false, /*is_last_block=*/false))
2012                                                 return false;
2013                                         /* move unprocessed overread samples to beginnings of arrays */
2014                                         FLAC__ASSERT(i == blocksize+OVERREAD_);
2015                                         FLAC__ASSERT(OVERREAD_ == 1); /* assert we only overread 1 sample which simplifies the rest of the code below */
2016                                         i--;
2017                                         encoder->private_->integer_signal[0][0] = encoder->private_->integer_signal[0][i];
2018                                         encoder->private_->integer_signal[1][0] = encoder->private_->integer_signal[1][i];
2019                                         encoder->private_->integer_signal_mid_side[0][0] = encoder->private_->integer_signal_mid_side[0][i];
2020                                         encoder->private_->integer_signal_mid_side[1][0] = encoder->private_->integer_signal_mid_side[1][i];
2021 #ifndef FLAC__INTEGER_ONLY_LIBRARY
2022                                         encoder->private_->real_signal[0][0] = encoder->private_->real_signal[0][i];
2023                                         encoder->private_->real_signal[1][0] = encoder->private_->real_signal[1][i];
2024                                         encoder->private_->real_signal_mid_side[0][0] = encoder->private_->real_signal_mid_side[0][i];
2025                                         encoder->private_->real_signal_mid_side[1][0] = encoder->private_->real_signal_mid_side[1][i];
2026 #endif
2027                                         encoder->private_->current_sample_number = 1;
2028                                 }
2029                         } while(j < samples);
2030                 }
2031                 else {
2032                         /*
2033                          * independent channel coding: buffer each channel in inner loop
2034                          * with LPC: calculate floating point version of signal
2035                          */
2036                         do {
2037                                 if(encoder->protected_->verify)
2038                                         append_to_verify_fifo_(&encoder->private_->verify.input_fifo, buffer, j, channels, min(blocksize+1-encoder->private_->current_sample_number, samples-j));
2039
2040                                 /* "i <= blocksize" to overread 1 sample; see comment in OVERREAD_ decl */
2041                                 for(i = encoder->private_->current_sample_number; i <= blocksize && j < samples; i++, j++) {
2042                                         for(channel = 0; channel < channels; channel++) {
2043                                                 x = buffer[channel][j];
2044                                                 encoder->private_->integer_signal[channel][i] = x;
2045 #ifndef FLAC__INTEGER_ONLY_LIBRARY
2046                                                 encoder->private_->real_signal[channel][i] = (FLAC__real)x;
2047 #endif
2048                                         }
2049                                         encoder->private_->current_sample_number++;
2050                                 }
2051                                 /* we only process if we have a full block + 1 extra sample; final block is always handled by FLAC__stream_encoder_finish() */
2052                                 if(i > blocksize) {
2053                                         if(!process_frame_(encoder, /*is_fractional_block=*/false, /*is_last_block=*/false))
2054                                                 return false;
2055                                         /* move unprocessed overread samples to beginnings of arrays */
2056                                         FLAC__ASSERT(i == blocksize+OVERREAD_);
2057                                         FLAC__ASSERT(OVERREAD_ == 1); /* assert we only overread 1 sample which simplifies the rest of the code below */
2058                                         i--;
2059                                         for(channel = 0; channel < channels; channel++) {
2060                                                 encoder->private_->integer_signal[channel][0] = encoder->private_->integer_signal[channel][i];
2061 #ifndef FLAC__INTEGER_ONLY_LIBRARY
2062                                                 encoder->private_->real_signal[channel][0] = encoder->private_->real_signal[channel][i];
2063 #endif
2064                                         }
2065                                         encoder->private_->current_sample_number = 1;
2066                                 }
2067                         } while(j < samples);
2068                 }
2069         }
2070         else {
2071                 if(encoder->protected_->do_mid_side_stereo && channels == 2) {
2072                         /*
2073                          * stereo coding: unroll channel loop
2074                          * without LPC: no need to calculate floating point version of signal
2075                          */
2076                         do {
2077                                 if(encoder->protected_->verify)
2078                                         append_to_verify_fifo_(&encoder->private_->verify.input_fifo, buffer, j, channels, min(blocksize+1-encoder->private_->current_sample_number, samples-j));
2079
2080                                 /* "i <= blocksize" to overread 1 sample; see comment in OVERREAD_ decl */
2081                                 for(i = encoder->private_->current_sample_number; i <= blocksize && j < samples; i++, j++) {
2082                                         encoder->private_->integer_signal[0][i] = mid = side = buffer[0][j];
2083                                         x = buffer[1][j];
2084                                         encoder->private_->integer_signal[1][i] = x;
2085                                         mid += x;
2086                                         side -= x;
2087                                         mid >>= 1; /* NOTE: not the same as 'mid = (buffer[0][j] + buffer[1][j]) / 2' ! */
2088                                         encoder->private_->integer_signal_mid_side[1][i] = side;
2089                                         encoder->private_->integer_signal_mid_side[0][i] = mid;
2090                                         encoder->private_->current_sample_number++;
2091                                 }
2092                                 /* we only process if we have a full block + 1 extra sample; final block is always handled by FLAC__stream_encoder_finish() */
2093                                 if(i > blocksize) {
2094                                         if(!process_frame_(encoder, /*is_fractional_block=*/false, /*is_last_block=*/false))
2095                                                 return false;
2096                                         /* move unprocessed overread samples to beginnings of arrays */
2097                                         FLAC__ASSERT(i == blocksize+OVERREAD_);
2098                                         FLAC__ASSERT(OVERREAD_ == 1); /* assert we only overread 1 sample which simplifies the rest of the code below */
2099                                         i--;
2100                                         encoder->private_->integer_signal[0][0] = encoder->private_->integer_signal[0][i];
2101                                         encoder->private_->integer_signal[1][0] = encoder->private_->integer_signal[1][i];
2102                                         encoder->private_->integer_signal_mid_side[0][0] = encoder->private_->integer_signal_mid_side[0][i];
2103                                         encoder->private_->integer_signal_mid_side[1][0] = encoder->private_->integer_signal_mid_side[1][i];
2104                                         encoder->private_->current_sample_number = 1;
2105                                 }
2106                         } while(j < samples);
2107                 }
2108                 else {
2109                         /*
2110                          * independent channel coding: buffer each channel in inner loop
2111                          * without LPC: no need to calculate floating point version of signal
2112                          */
2113                         do {
2114                                 if(encoder->protected_->verify)
2115                                         append_to_verify_fifo_(&encoder->private_->verify.input_fifo, buffer, j, channels, min(blocksize+1-encoder->private_->current_sample_number, samples-j));
2116
2117                                 /* "i <= blocksize" to overread 1 sample; see comment in OVERREAD_ decl */
2118                                 for(i = encoder->private_->current_sample_number; i <= blocksize && j < samples; i++, j++) {
2119                                         for(channel = 0; channel < channels; channel++)
2120                                                 encoder->private_->integer_signal[channel][i] = buffer[channel][j];
2121                                         encoder->private_->current_sample_number++;
2122                                 }
2123                                 /* we only process if we have a full block + 1 extra sample; final block is always handled by FLAC__stream_encoder_finish() */
2124                                 if(i > blocksize) {
2125                                         if(!process_frame_(encoder, /*is_fractional_block=*/false, /*is_last_block=*/false))
2126                                                 return false;
2127                                         /* move unprocessed overread samples to beginnings of arrays */
2128                                         FLAC__ASSERT(i == blocksize+OVERREAD_);
2129                                         FLAC__ASSERT(OVERREAD_ == 1); /* assert we only overread 1 sample which simplifies the rest of the code below */
2130                                         i--;
2131                                         for(channel = 0; channel < channels; channel++)
2132                                                 encoder->private_->integer_signal[channel][0] = encoder->private_->integer_signal[channel][i];
2133                                         encoder->private_->current_sample_number = 1;
2134                                 }
2135                         } while(j < samples);
2136                 }
2137         }
2138
2139         return true;
2140 }
2141
2142 FLAC_API FLAC__bool FLAC__stream_encoder_process_interleaved(FLAC__StreamEncoder *encoder, const FLAC__int32 buffer[], unsigned samples)
2143 {
2144         unsigned i, j, k, channel;
2145         FLAC__int32 x, mid, side;
2146         const unsigned channels = encoder->protected_->channels, blocksize = encoder->protected_->blocksize;
2147
2148         FLAC__ASSERT(0 != encoder);
2149         FLAC__ASSERT(0 != encoder->private_);
2150         FLAC__ASSERT(0 != encoder->protected_);
2151         FLAC__ASSERT(encoder->protected_->state == FLAC__STREAM_ENCODER_OK);
2152
2153         j = k = 0;
2154         /*
2155          * we have several flavors of the same basic loop, optimized for
2156          * different conditions:
2157          */
2158         if(encoder->protected_->max_lpc_order > 0) {
2159                 if(encoder->protected_->do_mid_side_stereo && channels == 2) {
2160                         /*
2161                          * stereo coding: unroll channel loop
2162                          * with LPC: calculate floating point version of signal
2163                          */
2164                         do {
2165                                 if(encoder->protected_->verify)
2166                                         append_to_verify_fifo_interleaved_(&encoder->private_->verify.input_fifo, buffer, j, channels, min(blocksize+1-encoder->private_->current_sample_number, samples-j));
2167
2168                                 /* "i <= blocksize" to overread 1 sample; see comment in OVERREAD_ decl */
2169                                 for(i = encoder->private_->current_sample_number; i <= blocksize && j < samples; i++, j++) {
2170                                         x = mid = side = buffer[k++];
2171                                         encoder->private_->integer_signal[0][i] = x;
2172 #ifndef FLAC__INTEGER_ONLY_LIBRARY
2173                                         encoder->private_->real_signal[0][i] = (FLAC__real)x;
2174 #endif
2175                                         x = buffer[k++];
2176                                         encoder->private_->integer_signal[1][i] = x;
2177 #ifndef FLAC__INTEGER_ONLY_LIBRARY
2178                                         encoder->private_->real_signal[1][i] = (FLAC__real)x;
2179 #endif
2180                                         mid += x;
2181                                         side -= x;
2182                                         mid >>= 1; /* NOTE: not the same as 'mid = (left + right) / 2' ! */
2183                                         encoder->private_->integer_signal_mid_side[1][i] = side;
2184                                         encoder->private_->integer_signal_mid_side[0][i] = mid;
2185 #ifndef FLAC__INTEGER_ONLY_LIBRARY
2186                                         encoder->private_->real_signal_mid_side[1][i] = (FLAC__real)side;
2187                                         encoder->private_->real_signal_mid_side[0][i] = (FLAC__real)mid;
2188 #endif
2189                                         encoder->private_->current_sample_number++;
2190                                 }
2191                                 /* we only process if we have a full block + 1 extra sample; final block is always handled by FLAC__stream_encoder_finish() */
2192                                 if(i > blocksize) {
2193                                         if(!process_frame_(encoder, /*is_fractional_block=*/false, /*is_last_block=*/false))
2194                                                 return false;
2195                                         /* move unprocessed overread samples to beginnings of arrays */
2196                                         FLAC__ASSERT(i == blocksize+OVERREAD_);
2197                                         FLAC__ASSERT(OVERREAD_ == 1); /* assert we only overread 1 sample which simplifies the rest of the code below */
2198                                         i--;
2199                                         encoder->private_->integer_signal[0][0] = encoder->private_->integer_signal[0][i];
2200                                         encoder->private_->integer_signal[1][0] = encoder->private_->integer_signal[1][i];
2201                                         encoder->private_->integer_signal_mid_side[0][0] = encoder->private_->integer_signal_mid_side[0][i];
2202                                         encoder->private_->integer_signal_mid_side[1][0] = encoder->private_->integer_signal_mid_side[1][i];
2203 #ifndef FLAC__INTEGER_ONLY_LIBRARY
2204                                         encoder->private_->real_signal[0][0] = encoder->private_->real_signal[0][i];
2205                                         encoder->private_->real_signal[1][0] = encoder->private_->real_signal[1][i];
2206                                         encoder->private_->real_signal_mid_side[0][0] = encoder->private_->real_signal_mid_side[0][i];
2207                                         encoder->private_->real_signal_mid_side[1][0] = encoder->private_->real_signal_mid_side[1][i];
2208 #endif
2209                                         encoder->private_->current_sample_number = 1;
2210                                 }
2211                         } while(j < samples);
2212                 }
2213                 else {
2214                         /*
2215                          * independent channel coding: buffer each channel in inner loop
2216                          * with LPC: calculate floating point version of signal
2217                          */
2218                         do {
2219                                 if(encoder->protected_->verify)
2220                                         append_to_verify_fifo_interleaved_(&encoder->private_->verify.input_fifo, buffer, j, channels, min(blocksize+1-encoder->private_->current_sample_number, samples-j));
2221
2222                                 /* "i <= blocksize" to overread 1 sample; see comment in OVERREAD_ decl */
2223                                 for(i = encoder->private_->current_sample_number; i <= blocksize && j < samples; i++, j++) {
2224                                         for(channel = 0; channel < channels; channel++) {
2225                                                 x = buffer[k++];
2226                                                 encoder->private_->integer_signal[channel][i] = x;
2227 #ifndef FLAC__INTEGER_ONLY_LIBRARY
2228                                                 encoder->private_->real_signal[channel][i] = (FLAC__real)x;
2229 #endif
2230                                         }
2231                                         encoder->private_->current_sample_number++;
2232                                 }
2233                                 /* we only process if we have a full block + 1 extra sample; final block is always handled by FLAC__stream_encoder_finish() */
2234                                 if(i > blocksize) {
2235                                         if(!process_frame_(encoder, /*is_fractional_block=*/false, /*is_last_block=*/false))
2236                                                 return false;
2237                                         /* move unprocessed overread samples to beginnings of arrays */
2238                                         FLAC__ASSERT(i == blocksize+OVERREAD_);
2239                                         FLAC__ASSERT(OVERREAD_ == 1); /* assert we only overread 1 sample which simplifies the rest of the code below */
2240                                         i--;
2241                                         for(channel = 0; channel < channels; channel++) {
2242                                                 encoder->private_->integer_signal[channel][0] = encoder->private_->integer_signal[channel][i];
2243 #ifndef FLAC__INTEGER_ONLY_LIBRARY
2244                                                 encoder->private_->real_signal[channel][0] = encoder->private_->real_signal[channel][i];
2245 #endif
2246                                         }
2247                                         encoder->private_->current_sample_number = 1;
2248                                 }
2249                         } while(j < samples);
2250                 }
2251         }
2252         else {
2253                 if(encoder->protected_->do_mid_side_stereo && channels == 2) {
2254                         /*
2255                          * stereo coding: unroll channel loop
2256                          * without LPC: no need to calculate floating point version of signal
2257                          */
2258                         do {
2259                                 if(encoder->protected_->verify)
2260                                         append_to_verify_fifo_interleaved_(&encoder->private_->verify.input_fifo, buffer, j, channels, min(blocksize+1-encoder->private_->current_sample_number, samples-j));
2261
2262                                 /* "i <= blocksize" to overread 1 sample; see comment in OVERREAD_ decl */
2263                                 for(i = encoder->private_->current_sample_number; i <= blocksize && j < samples; i++, j++) {
2264                                         encoder->private_->integer_signal[0][i] = mid = side = buffer[k++];
2265                                         x = buffer[k++];
2266                                         encoder->private_->integer_signal[1][i] = x;
2267                                         mid += x;
2268                                         side -= x;
2269                                         mid >>= 1; /* NOTE: not the same as 'mid = (left + right) / 2' ! */
2270                                         encoder->private_->integer_signal_mid_side[1][i] = side;
2271                                         encoder->private_->integer_signal_mid_side[0][i] = mid;
2272                                         encoder->private_->current_sample_number++;
2273                                 }
2274                                 /* we only process if we have a full block + 1 extra sample; final block is always handled by FLAC__stream_encoder_finish() */
2275                                 if(i > blocksize) {
2276                                         if(!process_frame_(encoder, /*is_fractional_block=*/false, /*is_last_block=*/false))
2277                                                 return false;
2278                                         /* move unprocessed overread samples to beginnings of arrays */
2279                                         FLAC__ASSERT(i == blocksize+OVERREAD_);
2280                                         FLAC__ASSERT(OVERREAD_ == 1); /* assert we only overread 1 sample which simplifies the rest of the code below */
2281                                         i--;
2282                                         encoder->private_->integer_signal[0][0] = encoder->private_->integer_signal[0][i];
2283                                         encoder->private_->integer_signal[1][0] = encoder->private_->integer_signal[1][i];
2284                                         encoder->private_->integer_signal_mid_side[0][0] = encoder->private_->integer_signal_mid_side[0][i];
2285                                         encoder->private_->integer_signal_mid_side[1][0] = encoder->private_->integer_signal_mid_side[1][i];
2286                                         encoder->private_->current_sample_number = 1;
2287                                 }
2288                         } while(j < samples);
2289                 }
2290                 else {
2291                         /*
2292                          * independent channel coding: buffer each channel in inner loop
2293                          * without LPC: no need to calculate floating point version of signal
2294                          */
2295                         do {
2296                                 if(encoder->protected_->verify)
2297                                         append_to_verify_fifo_interleaved_(&encoder->private_->verify.input_fifo, buffer, j, channels, min(blocksize+1-encoder->private_->current_sample_number, samples-j));
2298
2299                                 /* "i <= blocksize" to overread 1 sample; see comment in OVERREAD_ decl */
2300                                 for(i = encoder->private_->current_sample_number; i <= blocksize && j < samples; i++, j++) {
2301                                         for(channel = 0; channel < channels; channel++)
2302                                                 encoder->private_->integer_signal[channel][i] = buffer[k++];
2303                                         encoder->private_->current_sample_number++;
2304                                 }
2305                                 /* we only process if we have a full block + 1 extra sample; final block is always handled by FLAC__stream_encoder_finish() */
2306                                 if(i > blocksize) {
2307                                         if(!process_frame_(encoder, /*is_fractional_block=*/false, /*is_last_block=*/false))
2308                                                 return false;
2309                                         /* move unprocessed overread samples to beginnings of arrays */
2310                                         FLAC__ASSERT(i == blocksize+OVERREAD_);
2311                                         FLAC__ASSERT(OVERREAD_ == 1); /* assert we only overread 1 sample which simplifies the rest of the code below */
2312                                         i--;
2313                                         for(channel = 0; channel < channels; channel++)
2314                                                 encoder->private_->integer_signal[channel][0] = encoder->private_->integer_signal[channel][i];
2315                                         encoder->private_->current_sample_number = 1;
2316                                 }
2317                         } while(j < samples);
2318                 }
2319         }
2320
2321         return true;
2322 }
2323
2324 /***********************************************************************
2325  *
2326  * Private class methods
2327  *
2328  ***********************************************************************/
2329
2330 void set_defaults_(FLAC__StreamEncoder *encoder)
2331 {
2332         FLAC__ASSERT(0 != encoder);
2333
2334 #ifdef FLAC__MANDATORY_VERIFY_WHILE_ENCODING
2335         encoder->protected_->verify = true;
2336 #else
2337         encoder->protected_->verify = false;
2338 #endif
2339         encoder->protected_->streamable_subset = true;
2340         encoder->protected_->do_mid_side_stereo = false;
2341         encoder->protected_->loose_mid_side_stereo = false;
2342         encoder->protected_->channels = 2;
2343         encoder->protected_->bits_per_sample = 16;
2344         encoder->protected_->sample_rate = 44100;
2345         encoder->protected_->blocksize = 0;
2346 #ifndef FLAC__INTEGER_ONLY_LIBRARY
2347         encoder->protected_->num_apodizations = 1;
2348         encoder->protected_->apodizations[0].type = FLAC__APODIZATION_TUKEY;
2349         encoder->protected_->apodizations[0].parameters.tukey.p = 0.5;
2350 #endif
2351         encoder->protected_->max_lpc_order = 0;
2352         encoder->protected_->qlp_coeff_precision = 0;
2353         encoder->protected_->do_qlp_coeff_prec_search = false;
2354         encoder->protected_->do_exhaustive_model_search = false;
2355         encoder->protected_->do_escape_coding = false;
2356         encoder->protected_->min_residual_partition_order = 0;
2357         encoder->protected_->max_residual_partition_order = 0;
2358         encoder->protected_->rice_parameter_search_dist = 0;
2359         encoder->protected_->total_samples_estimate = 0;
2360         encoder->protected_->metadata = 0;
2361         encoder->protected_->num_metadata_blocks = 0;
2362
2363         encoder->private_->seek_table = 0;
2364         encoder->private_->disable_constant_subframes = false;
2365         encoder->private_->disable_fixed_subframes = false;
2366         encoder->private_->disable_verbatim_subframes = false;
2367 #if FLAC__HAS_OGG
2368         encoder->private_->is_ogg = false;
2369 #endif
2370         encoder->private_->read_callback = 0;
2371         encoder->private_->write_callback = 0;
2372         encoder->private_->seek_callback = 0;
2373         encoder->private_->tell_callback = 0;
2374         encoder->private_->metadata_callback = 0;
2375         encoder->private_->progress_callback = 0;
2376         encoder->private_->client_data = 0;
2377
2378 #if FLAC__HAS_OGG
2379         FLAC__ogg_encoder_aspect_set_defaults(&encoder->protected_->ogg_encoder_aspect);
2380 #endif
2381 }
2382
2383 void free_(FLAC__StreamEncoder *encoder)
2384 {
2385         unsigned i, channel;
2386
2387         FLAC__ASSERT(0 != encoder);
2388         if(encoder->protected_->metadata) {
2389                 free(encoder->protected_->metadata);
2390                 encoder->protected_->metadata = 0;
2391                 encoder->protected_->num_metadata_blocks = 0;
2392         }
2393         for(i = 0; i < encoder->protected_->channels; i++) {
2394                 if(0 != encoder->private_->integer_signal_unaligned[i]) {
2395                         free(encoder->private_->integer_signal_unaligned[i]);
2396                         encoder->private_->integer_signal_unaligned[i] = 0;
2397                 }
2398 #ifndef FLAC__INTEGER_ONLY_LIBRARY
2399                 if(0 != encoder->private_->real_signal_unaligned[i]) {
2400                         free(encoder->private_->real_signal_unaligned[i]);
2401                         encoder->private_->real_signal_unaligned[i] = 0;
2402                 }
2403 #endif
2404         }
2405         for(i = 0; i < 2; i++) {
2406                 if(0 != encoder->private_->integer_signal_mid_side_unaligned[i]) {
2407                         free(encoder->private_->integer_signal_mid_side_unaligned[i]);
2408                         encoder->private_->integer_signal_mid_side_unaligned[i] = 0;
2409                 }
2410 #ifndef FLAC__INTEGER_ONLY_LIBRARY
2411                 if(0 != encoder->private_->real_signal_mid_side_unaligned[i]) {
2412                         free(encoder->private_->real_signal_mid_side_unaligned[i]);
2413                         encoder->private_->real_signal_mid_side_unaligned[i] = 0;
2414                 }
2415 #endif
2416         }
2417 #ifndef FLAC__INTEGER_ONLY_LIBRARY
2418         for(i = 0; i < encoder->protected_->num_apodizations; i++) {
2419                 if(0 != encoder->private_->window_unaligned[i]) {
2420                         free(encoder->private_->window_unaligned[i]);
2421                         encoder->private_->window_unaligned[i] = 0;
2422                 }
2423         }
2424         if(0 != encoder->private_->windowed_signal_unaligned) {
2425                 free(encoder->private_->windowed_signal_unaligned);
2426                 encoder->private_->windowed_signal_unaligned = 0;
2427         }
2428 #endif
2429         for(channel = 0; channel < encoder->protected_->channels; channel++) {
2430                 for(i = 0; i < 2; i++) {
2431                         if(0 != encoder->private_->residual_workspace_unaligned[channel][i]) {
2432                                 free(encoder->private_->residual_workspace_unaligned[channel][i]);
2433                                 encoder->private_->residual_workspace_unaligned[channel][i] = 0;
2434                         }
2435                 }
2436         }
2437         for(channel = 0; channel < 2; channel++) {
2438                 for(i = 0; i < 2; i++) {
2439                         if(0 != encoder->private_->residual_workspace_mid_side_unaligned[channel][i]) {
2440                                 free(encoder->private_->residual_workspace_mid_side_unaligned[channel][i]);
2441                                 encoder->private_->residual_workspace_mid_side_unaligned[channel][i] = 0;
2442                         }
2443                 }
2444         }
2445         if(0 != encoder->private_->abs_residual_partition_sums_unaligned) {
2446                 free(encoder->private_->abs_residual_partition_sums_unaligned);
2447                 encoder->private_->abs_residual_partition_sums_unaligned = 0;
2448         }
2449         if(0 != encoder->private_->raw_bits_per_partition_unaligned) {
2450                 free(encoder->private_->raw_bits_per_partition_unaligned);
2451                 encoder->private_->raw_bits_per_partition_unaligned = 0;
2452         }
2453         if(encoder->protected_->verify) {
2454                 for(i = 0; i < encoder->protected_->channels; i++) {
2455                         if(0 != encoder->private_->verify.input_fifo.data[i]) {
2456                                 free(encoder->private_->verify.input_fifo.data[i]);
2457                                 encoder->private_->verify.input_fifo.data[i] = 0;
2458                         }
2459                 }
2460         }
2461         FLAC__bitwriter_free(encoder->private_->frame);
2462 }
2463
2464 FLAC__bool resize_buffers_(FLAC__StreamEncoder *encoder, unsigned new_blocksize)
2465 {
2466         FLAC__bool ok;
2467         unsigned i, channel;
2468
2469         FLAC__ASSERT(new_blocksize > 0);
2470         FLAC__ASSERT(encoder->protected_->state == FLAC__STREAM_ENCODER_OK);
2471         FLAC__ASSERT(encoder->private_->current_sample_number == 0);
2472
2473         /* To avoid excessive malloc'ing, we only grow the buffer; no shrinking. */
2474         if(new_blocksize <= encoder->private_->input_capacity)
2475                 return true;
2476
2477         ok = true;
2478
2479         /* WATCHOUT: FLAC__lpc_compute_residual_from_qlp_coefficients_asm_ia32_mmx()
2480          * requires that the input arrays (in our case the integer signals)
2481          * have a buffer of up to 3 zeroes in front (at negative indices) for
2482          * alignment purposes; we use 4 in front to keep the data well-aligned.
2483          */
2484
2485         for(i = 0; ok && i < encoder->protected_->channels; i++) {
2486                 ok = ok && FLAC__memory_alloc_aligned_int32_array(new_blocksize+4+OVERREAD_, &encoder->private_->integer_signal_unaligned[i], &encoder->private_->integer_signal[i]);
2487                 memset(encoder->private_->integer_signal[i], 0, sizeof(FLAC__int32)*4);
2488                 encoder->private_->integer_signal[i] += 4;
2489 #ifndef FLAC__INTEGER_ONLY_LIBRARY
2490                 if(encoder->protected_->max_lpc_order > 0)
2491                         ok = ok && FLAC__memory_alloc_aligned_real_array(new_blocksize+OVERREAD_, &encoder->private_->real_signal_unaligned[i], &encoder->private_->real_signal[i]);
2492 #endif
2493         }
2494         for(i = 0; ok && i < 2; i++) {
2495                 ok = ok && FLAC__memory_alloc_aligned_int32_array(new_blocksize+4+OVERREAD_, &encoder->private_->integer_signal_mid_side_unaligned[i], &encoder->private_->integer_signal_mid_side[i]);
2496                 memset(encoder->private_->integer_signal_mid_side[i], 0, sizeof(FLAC__int32)*4);
2497                 encoder->private_->integer_signal_mid_side[i] += 4;
2498 #ifndef FLAC__INTEGER_ONLY_LIBRARY
2499                 if(encoder->protected_->max_lpc_order > 0)
2500                         ok = ok && FLAC__memory_alloc_aligned_real_array(new_blocksize+OVERREAD_, &encoder->private_->real_signal_mid_side_unaligned[i], &encoder->private_->real_signal_mid_side[i]);
2501 #endif
2502         }
2503 #ifndef FLAC__INTEGER_ONLY_LIBRARY
2504         if(ok && encoder->protected_->max_lpc_order > 0) {
2505                 for(i = 0; ok && i < encoder->protected_->num_apodizations; i++)
2506                         ok = ok && FLAC__memory_alloc_aligned_real_array(new_blocksize, &encoder->private_->window_unaligned[i], &encoder->private_->window[i]);
2507                 ok = ok && FLAC__memory_alloc_aligned_real_array(new_blocksize, &encoder->private_->windowed_signal_unaligned, &encoder->private_->windowed_signal);
2508         }
2509 #endif
2510         for(channel = 0; ok && channel < encoder->protected_->channels; channel++) {
2511                 for(i = 0; ok && i < 2; i++) {
2512                         ok = ok && FLAC__memory_alloc_aligned_int32_array(new_blocksize, &encoder->private_->residual_workspace_unaligned[channel][i], &encoder->private_->residual_workspace[channel][i]);
2513                 }
2514         }
2515         for(channel = 0; ok && channel < 2; channel++) {
2516                 for(i = 0; ok && i < 2; i++) {
2517                         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]);
2518                 }
2519         }
2520         /* the *2 is an approximation to the series 1 + 1/2 + 1/4 + ... that sums tree occupies in a flat array */
2521         /*@@@ new_blocksize*2 is too pessimistic, but to fix, we need smarter logic because a smaller new_blocksize can actually increase the # of partitions; would require moving this out into a separate function, then checking its capacity against the need of the current blocksize&min/max_partition_order (and maybe predictor order) */
2522         ok = ok && FLAC__memory_alloc_aligned_uint64_array(new_blocksize * 2, &encoder->private_->abs_residual_partition_sums_unaligned, &encoder->private_->abs_residual_partition_sums);
2523         if(encoder->protected_->do_escape_coding)
2524                 ok = ok && FLAC__memory_alloc_aligned_unsigned_array(new_blocksize * 2, &encoder->private_->raw_bits_per_partition_unaligned, &encoder->private_->raw_bits_per_partition);
2525
2526         /* now adjust the windows if the blocksize has changed */
2527 #ifndef FLAC__INTEGER_ONLY_LIBRARY
2528         if(ok && new_blocksize != encoder->private_->input_capacity && encoder->protected_->max_lpc_order > 0) {
2529                 for(i = 0; ok && i < encoder->protected_->num_apodizations; i++) {
2530                         switch(encoder->protected_->apodizations[i].type) {
2531                                 case FLAC__APODIZATION_BARTLETT:
2532                                         FLAC__window_bartlett(encoder->private_->window[i], new_blocksize);
2533                                         break;
2534                                 case FLAC__APODIZATION_BARTLETT_HANN:
2535                                         FLAC__window_bartlett_hann(encoder->private_->window[i], new_blocksize);
2536                                         break;
2537                                 case FLAC__APODIZATION_BLACKMAN:
2538                                         FLAC__window_blackman(encoder->private_->window[i], new_blocksize);
2539                                         break;
2540                                 case FLAC__APODIZATION_BLACKMAN_HARRIS_4TERM_92DB_SIDELOBE:
2541                                         FLAC__window_blackman_harris_4term_92db_sidelobe(encoder->private_->window[i], new_blocksize);
2542                                         break;
2543                                 case FLAC__APODIZATION_CONNES:
2544                                         FLAC__window_connes(encoder->private_->window[i], new_blocksize);
2545                                         break;
2546                                 case FLAC__APODIZATION_FLATTOP:
2547                                         FLAC__window_flattop(encoder->private_->window[i], new_blocksize);
2548                                         break;
2549                                 case FLAC__APODIZATION_GAUSS:
2550                                         FLAC__window_gauss(encoder->private_->window[i], new_blocksize, encoder->protected_->apodizations[i].parameters.gauss.stddev);
2551                                         break;
2552                                 case FLAC__APODIZATION_HAMMING:
2553                                         FLAC__window_hamming(encoder->private_->window[i], new_blocksize);
2554                                         break;
2555                                 case FLAC__APODIZATION_HANN:
2556                                         FLAC__window_hann(encoder->private_->window[i], new_blocksize);
2557                                         break;
2558                                 case FLAC__APODIZATION_KAISER_BESSEL:
2559                                         FLAC__window_kaiser_bessel(encoder->private_->window[i], new_blocksize);
2560                                         break;
2561                                 case FLAC__APODIZATION_NUTTALL:
2562                                         FLAC__window_nuttall(encoder->private_->window[i], new_blocksize);
2563                                         break;
2564                                 case FLAC__APODIZATION_RECTANGLE:
2565                                         FLAC__window_rectangle(encoder->private_->window[i], new_blocksize);
2566                                         break;
2567                                 case FLAC__APODIZATION_TRIANGLE:
2568                                         FLAC__window_triangle(encoder->private_->window[i], new_blocksize);
2569                                         break;
2570                                 case FLAC__APODIZATION_TUKEY:
2571                                         FLAC__window_tukey(encoder->private_->window[i], new_blocksize, encoder->protected_->apodizations[i].parameters.tukey.p);
2572                                         break;
2573                                 case FLAC__APODIZATION_WELCH:
2574                                         FLAC__window_welch(encoder->private_->window[i], new_blocksize);
2575                                         break;
2576                                 default:
2577                                         FLAC__ASSERT(0);
2578                                         /* double protection */
2579                                         FLAC__window_hann(encoder->private_->window[i], new_blocksize);
2580                                         break;
2581                         }
2582                 }
2583         }
2584 #endif
2585
2586         if(ok)
2587                 encoder->private_->input_capacity = new_blocksize;
2588         else
2589                 encoder->protected_->state = FLAC__STREAM_ENCODER_MEMORY_ALLOCATION_ERROR;
2590
2591         return ok;
2592 }
2593
2594 FLAC__bool write_bitbuffer_(FLAC__StreamEncoder *encoder, unsigned samples, FLAC__bool is_last_block)
2595 {
2596         const FLAC__byte *buffer;
2597         size_t bytes;
2598
2599         FLAC__ASSERT(FLAC__bitwriter_is_byte_aligned(encoder->private_->frame));
2600
2601         if(!FLAC__bitwriter_get_buffer(encoder->private_->frame, &buffer, &bytes)) {
2602                 encoder->protected_->state = FLAC__STREAM_ENCODER_MEMORY_ALLOCATION_ERROR;
2603                 return false;
2604         }
2605
2606         if(encoder->protected_->verify) {
2607                 encoder->private_->verify.output.data = buffer;
2608                 encoder->private_->verify.output.bytes = bytes;
2609                 if(encoder->private_->verify.state_hint == ENCODER_IN_MAGIC) {
2610                         encoder->private_->verify.needs_magic_hack = true;
2611                 }
2612                 else {
2613                         if(!FLAC__stream_decoder_process_single(encoder->private_->verify.decoder)) {
2614                                 FLAC__bitwriter_release_buffer(encoder->private_->frame);
2615                                 FLAC__bitwriter_clear(encoder->private_->frame);
2616                                 if(encoder->protected_->state != FLAC__STREAM_ENCODER_VERIFY_MISMATCH_IN_AUDIO_DATA)
2617                                         encoder->protected_->state = FLAC__STREAM_ENCODER_VERIFY_DECODER_ERROR;
2618                                 return false;
2619                         }
2620                 }
2621         }
2622
2623         if(write_frame_(encoder, buffer, bytes, samples, is_last_block) != FLAC__STREAM_ENCODER_WRITE_STATUS_OK) {
2624                 FLAC__bitwriter_release_buffer(encoder->private_->frame);
2625                 FLAC__bitwriter_clear(encoder->private_->frame);
2626                 encoder->protected_->state = FLAC__STREAM_ENCODER_CLIENT_ERROR;
2627                 return false;
2628         }
2629
2630         FLAC__bitwriter_release_buffer(encoder->private_->frame);
2631         FLAC__bitwriter_clear(encoder->private_->frame);
2632
2633         if(samples > 0) {
2634                 encoder->private_->streaminfo.data.stream_info.min_framesize = min(bytes, encoder->private_->streaminfo.data.stream_info.min_framesize);
2635                 encoder->private_->streaminfo.data.stream_info.max_framesize = max(bytes, encoder->private_->streaminfo.data.stream_info.max_framesize);
2636         }
2637
2638         return true;
2639 }
2640
2641 FLAC__StreamEncoderWriteStatus write_frame_(FLAC__StreamEncoder *encoder, const FLAC__byte buffer[], size_t bytes, unsigned samples, FLAC__bool is_last_block)
2642 {
2643         FLAC__StreamEncoderWriteStatus status;
2644         FLAC__uint64 output_position = 0;
2645
2646         /* FLAC__STREAM_ENCODER_TELL_STATUS_UNSUPPORTED just means we didn't get the offset; no error */
2647         if(encoder->private_->tell_callback && encoder->private_->tell_callback(encoder, &output_position, encoder->private_->client_data) == FLAC__STREAM_ENCODER_TELL_STATUS_ERROR) {
2648                 encoder->protected_->state = FLAC__STREAM_ENCODER_CLIENT_ERROR;
2649                 return FLAC__STREAM_ENCODER_WRITE_STATUS_FATAL_ERROR;
2650         }
2651
2652         /*
2653          * Watch for the STREAMINFO block and first SEEKTABLE block to go by and store their offsets.
2654          */
2655         if(samples == 0) {
2656                 FLAC__MetadataType type = (buffer[0] & 0x7f);
2657                 if(type == FLAC__METADATA_TYPE_STREAMINFO)
2658                         encoder->protected_->streaminfo_offset = output_position;
2659                 else if(type == FLAC__METADATA_TYPE_SEEKTABLE && encoder->protected_->seektable_offset == 0)
2660                         encoder->protected_->seektable_offset = output_position;
2661         }
2662
2663         /*
2664          * Mark the current seek point if hit (if audio_offset == 0 that
2665          * means we're still writing metadata and haven't hit the first
2666          * frame yet)
2667          */
2668         if(0 != encoder->private_->seek_table && encoder->protected_->audio_offset > 0 && encoder->private_->seek_table->num_points > 0) {
2669                 const unsigned blocksize = FLAC__stream_encoder_get_blocksize(encoder);
2670                 const FLAC__uint64 frame_first_sample = encoder->private_->samples_written;
2671                 const FLAC__uint64 frame_last_sample = frame_first_sample + (FLAC__uint64)blocksize - 1;
2672                 FLAC__uint64 test_sample;
2673                 unsigned i;
2674                 for(i = encoder->private_->first_seekpoint_to_check; i < encoder->private_->seek_table->num_points; i++) {
2675                         test_sample = encoder->private_->seek_table->points[i].sample_number;
2676                         if(test_sample > frame_last_sample) {
2677                                 break;
2678                         }
2679                         else if(test_sample >= frame_first_sample) {
2680                                 encoder->private_->seek_table->points[i].sample_number = frame_first_sample;
2681                                 encoder->private_->seek_table->points[i].stream_offset = output_position - encoder->protected_->audio_offset;
2682                                 encoder->private_->seek_table->points[i].frame_samples = blocksize;
2683                                 encoder->private_->first_seekpoint_to_check++;
2684                                 /* DO NOT: "break;" and here's why:
2685                                  * The seektable template may contain more than one target
2686                                  * sample for any given frame; we will keep looping, generating
2687                                  * duplicate seekpoints for them, and we'll clean it up later,
2688                                  * just before writing the seektable back to the metadata.
2689                                  */
2690                         }
2691                         else {
2692                                 encoder->private_->first_seekpoint_to_check++;
2693                         }
2694                 }
2695         }
2696
2697 #if FLAC__HAS_OGG
2698         if(encoder->private_->is_ogg) {
2699                 status = FLAC__ogg_encoder_aspect_write_callback_wrapper(
2700                         &encoder->protected_->ogg_encoder_aspect,
2701                         buffer,
2702                         bytes,
2703                         samples,
2704                         encoder->private_->current_frame_number,
2705                         is_last_block,
2706                         (FLAC__OggEncoderAspectWriteCallbackProxy)encoder->private_->write_callback,
2707                         encoder,
2708                         encoder->private_->client_data
2709                 );
2710         }
2711         else
2712 #endif
2713         status = encoder->private_->write_callback(encoder, buffer, bytes, samples, encoder->private_->current_frame_number, encoder->private_->client_data);
2714
2715         if(status == FLAC__STREAM_ENCODER_WRITE_STATUS_OK) {
2716                 encoder->private_->bytes_written += bytes;
2717                 encoder->private_->samples_written += samples;
2718                 /* we keep a high watermark on the number of frames written because
2719                  * when the encoder goes back to write metadata, 'current_frame'
2720                  * will drop back to 0.
2721                  */
2722                 encoder->private_->frames_written = max(encoder->private_->frames_written, encoder->private_->current_frame_number+1);
2723         }
2724         else
2725                 encoder->protected_->state = FLAC__STREAM_ENCODER_CLIENT_ERROR;
2726
2727         return status;
2728 }
2729
2730 /* Gets called when the encoding process has finished so that we can update the STREAMINFO and SEEKTABLE blocks.  */
2731 void update_metadata_(const FLAC__StreamEncoder *encoder)
2732 {
2733         FLAC__byte b[max(6, FLAC__STREAM_METADATA_SEEKPOINT_LENGTH)];
2734         const FLAC__StreamMetadata *metadata = &encoder->private_->streaminfo;
2735         const FLAC__uint64 samples = metadata->data.stream_info.total_samples;
2736         const unsigned min_framesize = metadata->data.stream_info.min_framesize;
2737         const unsigned max_framesize = metadata->data.stream_info.max_framesize;
2738         const unsigned bps = metadata->data.stream_info.bits_per_sample;
2739         FLAC__StreamEncoderSeekStatus seek_status;
2740
2741         FLAC__ASSERT(metadata->type == FLAC__METADATA_TYPE_STREAMINFO);
2742
2743         /* All this is based on intimate knowledge of the stream header
2744          * layout, but a change to the header format that would break this
2745          * would also break all streams encoded in the previous format.
2746          */
2747
2748         /*
2749          * Write MD5 signature
2750          */
2751         {
2752                 const unsigned md5_offset =
2753                         FLAC__STREAM_METADATA_HEADER_LENGTH +
2754                         (
2755                                 FLAC__STREAM_METADATA_STREAMINFO_MIN_BLOCK_SIZE_LEN +
2756                                 FLAC__STREAM_METADATA_STREAMINFO_MAX_BLOCK_SIZE_LEN +
2757                                 FLAC__STREAM_METADATA_STREAMINFO_MIN_FRAME_SIZE_LEN +
2758                                 FLAC__STREAM_METADATA_STREAMINFO_MAX_FRAME_SIZE_LEN +
2759                                 FLAC__STREAM_METADATA_STREAMINFO_SAMPLE_RATE_LEN +
2760                                 FLAC__STREAM_METADATA_STREAMINFO_CHANNELS_LEN +
2761                                 FLAC__STREAM_METADATA_STREAMINFO_BITS_PER_SAMPLE_LEN +
2762                                 FLAC__STREAM_METADATA_STREAMINFO_TOTAL_SAMPLES_LEN
2763                         ) / 8;
2764
2765                 if((seek_status = encoder->private_->seek_callback(encoder, encoder->protected_->streaminfo_offset + md5_offset, encoder->private_->client_data)) != FLAC__STREAM_ENCODER_SEEK_STATUS_OK) {
2766                         if(seek_status == FLAC__STREAM_ENCODER_SEEK_STATUS_ERROR)
2767                                 encoder->protected_->state = FLAC__STREAM_ENCODER_CLIENT_ERROR;
2768                         return;
2769                 }
2770                 if(encoder->private_->write_callback(encoder, metadata->data.stream_info.md5sum, 16, 0, 0, encoder->private_->client_data) != FLAC__STREAM_ENCODER_WRITE_STATUS_OK) {
2771                         encoder->protected_->state = FLAC__STREAM_ENCODER_CLIENT_ERROR;
2772                         return;
2773                 }
2774         }
2775
2776         /*
2777          * Write total samples
2778          */
2779         {
2780                 const unsigned total_samples_byte_offset =
2781                         FLAC__STREAM_METADATA_HEADER_LENGTH +
2782                         (
2783                                 FLAC__STREAM_METADATA_STREAMINFO_MIN_BLOCK_SIZE_LEN +
2784                                 FLAC__STREAM_METADATA_STREAMINFO_MAX_BLOCK_SIZE_LEN +
2785                                 FLAC__STREAM_METADATA_STREAMINFO_MIN_FRAME_SIZE_LEN +
2786                                 FLAC__STREAM_METADATA_STREAMINFO_MAX_FRAME_SIZE_LEN +
2787                                 FLAC__STREAM_METADATA_STREAMINFO_SAMPLE_RATE_LEN +
2788                                 FLAC__STREAM_METADATA_STREAMINFO_CHANNELS_LEN +
2789                                 FLAC__STREAM_METADATA_STREAMINFO_BITS_PER_SAMPLE_LEN
2790                                 - 4
2791                         ) / 8;
2792
2793                 b[0] = ((FLAC__byte)(bps-1) << 4) | (FLAC__byte)((samples >> 32) & 0x0F);
2794                 b[1] = (FLAC__byte)((samples >> 24) & 0xFF);
2795                 b[2] = (FLAC__byte)((samples >> 16) & 0xFF);
2796                 b[3] = (FLAC__byte)((samples >> 8) & 0xFF);
2797                 b[4] = (FLAC__byte)(samples & 0xFF);
2798                 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) {
2799                         if(seek_status == FLAC__STREAM_ENCODER_SEEK_STATUS_ERROR)
2800                                 encoder->protected_->state = FLAC__STREAM_ENCODER_CLIENT_ERROR;
2801                         return;
2802                 }
2803                 if(encoder->private_->write_callback(encoder, b, 5, 0, 0, encoder->private_->client_data) != FLAC__STREAM_ENCODER_WRITE_STATUS_OK) {
2804                         encoder->protected_->state = FLAC__STREAM_ENCODER_CLIENT_ERROR;
2805                         return;
2806                 }
2807         }
2808
2809         /*
2810          * Write min/max framesize
2811          */
2812         {
2813                 const unsigned min_framesize_offset =
2814                         FLAC__STREAM_METADATA_HEADER_LENGTH +
2815                         (
2816                                 FLAC__STREAM_METADATA_STREAMINFO_MIN_BLOCK_SIZE_LEN +
2817                                 FLAC__STREAM_METADATA_STREAMINFO_MAX_BLOCK_SIZE_LEN
2818                         ) / 8;
2819
2820                 b[0] = (FLAC__byte)((min_framesize >> 16) & 0xFF);
2821                 b[1] = (FLAC__byte)((min_framesize >> 8) & 0xFF);
2822                 b[2] = (FLAC__byte)(min_framesize & 0xFF);
2823                 b[3] = (FLAC__byte)((max_framesize >> 16) & 0xFF);
2824                 b[4] = (FLAC__byte)((max_framesize >> 8) & 0xFF);
2825                 b[5] = (FLAC__byte)(max_framesize & 0xFF);
2826                 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) {
2827                         if(seek_status == FLAC__STREAM_ENCODER_SEEK_STATUS_ERROR)
2828                                 encoder->protected_->state = FLAC__STREAM_ENCODER_CLIENT_ERROR;
2829                         return;
2830                 }
2831                 if(encoder->private_->write_callback(encoder, b, 6, 0, 0, encoder->private_->client_data) != FLAC__STREAM_ENCODER_WRITE_STATUS_OK) {
2832                         encoder->protected_->state = FLAC__STREAM_ENCODER_CLIENT_ERROR;
2833                         return;
2834                 }
2835         }
2836
2837         /*
2838          * Write seektable
2839          */
2840         if(0 != encoder->private_->seek_table && encoder->private_->seek_table->num_points > 0 && encoder->protected_->seektable_offset > 0) {
2841                 unsigned i;
2842
2843                 FLAC__format_seektable_sort(encoder->private_->seek_table);
2844
2845                 FLAC__ASSERT(FLAC__format_seektable_is_legal(encoder->private_->seek_table));
2846
2847                 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) {
2848                         if(seek_status == FLAC__STREAM_ENCODER_SEEK_STATUS_ERROR)
2849                                 encoder->protected_->state = FLAC__STREAM_ENCODER_CLIENT_ERROR;
2850                         return;
2851                 }
2852
2853                 for(i = 0; i < encoder->private_->seek_table->num_points; i++) {
2854                         FLAC__uint64 xx;
2855                         unsigned x;
2856                         xx = encoder->private_->seek_table->points[i].sample_number;
2857                         b[7] = (FLAC__byte)xx; xx >>= 8;
2858                         b[6] = (FLAC__byte)xx; xx >>= 8;
2859                         b[5] = (FLAC__byte)xx; xx >>= 8;
2860                         b[4] = (FLAC__byte)xx; xx >>= 8;
2861                         b[3] = (FLAC__byte)xx; xx >>= 8;
2862                         b[2] = (FLAC__byte)xx; xx >>= 8;
2863                         b[1] = (FLAC__byte)xx; xx >>= 8;
2864                         b[0] = (FLAC__byte)xx; xx >>= 8;
2865                         xx = encoder->private_->seek_table->points[i].stream_offset;
2866                         b[15] = (FLAC__byte)xx; xx >>= 8;
2867                         b[14] = (FLAC__byte)xx; xx >>= 8;
2868                         b[13] = (FLAC__byte)xx; xx >>= 8;
2869                         b[12] = (FLAC__byte)xx; xx >>= 8;
2870                         b[11] = (FLAC__byte)xx; xx >>= 8;
2871                         b[10] = (FLAC__byte)xx; xx >>= 8;
2872                         b[9] = (FLAC__byte)xx; xx >>= 8;
2873                         b[8] = (FLAC__byte)xx; xx >>= 8;
2874                         x = encoder->private_->seek_table->points[i].frame_samples;
2875                         b[17] = (FLAC__byte)x; x >>= 8;
2876                         b[16] = (FLAC__byte)x; x >>= 8;
2877                         if(encoder->private_->write_callback(encoder, b, 18, 0, 0, encoder->private_->client_data) != FLAC__STREAM_ENCODER_WRITE_STATUS_OK) {
2878                                 encoder->protected_->state = FLAC__STREAM_ENCODER_CLIENT_ERROR;
2879                                 return;
2880                         }
2881                 }
2882         }
2883 }
2884
2885 #if FLAC__HAS_OGG
2886 /* Gets called when the encoding process has finished so that we can update the STREAMINFO and SEEKTABLE blocks.  */
2887 void update_ogg_metadata_(FLAC__StreamEncoder *encoder)
2888 {
2889         /* the # of bytes in the 1st packet that precede the STREAMINFO */
2890         static const unsigned FIRST_OGG_PACKET_STREAMINFO_PREFIX_LENGTH =
2891                 FLAC__OGG_MAPPING_PACKET_TYPE_LENGTH +
2892                 FLAC__OGG_MAPPING_MAGIC_LENGTH +
2893                 FLAC__OGG_MAPPING_VERSION_MAJOR_LENGTH +
2894                 FLAC__OGG_MAPPING_VERSION_MINOR_LENGTH +
2895                 FLAC__OGG_MAPPING_NUM_HEADERS_LENGTH +
2896                 FLAC__STREAM_SYNC_LENGTH
2897         ;
2898         FLAC__byte b[max(6, FLAC__STREAM_METADATA_SEEKPOINT_LENGTH)];
2899         const FLAC__StreamMetadata *metadata = &encoder->private_->streaminfo;
2900         const FLAC__uint64 samples = metadata->data.stream_info.total_samples;
2901         const unsigned min_framesize = metadata->data.stream_info.min_framesize;
2902         const unsigned max_framesize = metadata->data.stream_info.max_framesize;
2903         ogg_page page;
2904
2905         FLAC__ASSERT(metadata->type == FLAC__METADATA_TYPE_STREAMINFO);
2906         FLAC__ASSERT(0 != encoder->private_->seek_callback);
2907
2908         /* Pre-check that client supports seeking, since we don't want the
2909          * ogg_helper code to ever have to deal with this condition.
2910          */
2911         if(encoder->private_->seek_callback(encoder, 0, encoder->private_->client_data) == FLAC__STREAM_ENCODER_SEEK_STATUS_UNSUPPORTED)
2912                 return;
2913
2914         /* All this is based on intimate knowledge of the stream header
2915          * layout, but a change to the header format that would break this
2916          * would also break all streams encoded in the previous format.
2917          */
2918
2919         /**
2920          ** Write STREAMINFO stats
2921          **/
2922         simple_ogg_page__init(&page);
2923         if(!simple_ogg_page__get_at(encoder, encoder->protected_->streaminfo_offset, &page, encoder->private_->seek_callback, encoder->private_->read_callback, encoder->private_->client_data)) {
2924                 simple_ogg_page__clear(&page);
2925                 return; /* state already set */
2926         }
2927
2928         /*
2929          * Write MD5 signature
2930          */
2931         {
2932                 const unsigned md5_offset =
2933                         FIRST_OGG_PACKET_STREAMINFO_PREFIX_LENGTH +
2934                         FLAC__STREAM_METADATA_HEADER_LENGTH +
2935                         (
2936                                 FLAC__STREAM_METADATA_STREAMINFO_MIN_BLOCK_SIZE_LEN +
2937                                 FLAC__STREAM_METADATA_STREAMINFO_MAX_BLOCK_SIZE_LEN +
2938                                 FLAC__STREAM_METADATA_STREAMINFO_MIN_FRAME_SIZE_LEN +
2939                                 FLAC__STREAM_METADATA_STREAMINFO_MAX_FRAME_SIZE_LEN +
2940                                 FLAC__STREAM_METADATA_STREAMINFO_SAMPLE_RATE_LEN +
2941                                 FLAC__STREAM_METADATA_STREAMINFO_CHANNELS_LEN +
2942                                 FLAC__STREAM_METADATA_STREAMINFO_BITS_PER_SAMPLE_LEN +
2943                                 FLAC__STREAM_METADATA_STREAMINFO_TOTAL_SAMPLES_LEN
2944                         ) / 8;
2945
2946                 if(md5_offset + 16 > (unsigned)page.body_len) {
2947                         encoder->protected_->state = FLAC__STREAM_ENCODER_OGG_ERROR;
2948                         simple_ogg_page__clear(&page);
2949                         return;
2950                 }
2951                 memcpy(page.body + md5_offset, metadata->data.stream_info.md5sum, 16);
2952         }
2953
2954         /*
2955          * Write total samples
2956          */
2957         {
2958                 const unsigned total_samples_byte_offset =
2959                         FIRST_OGG_PACKET_STREAMINFO_PREFIX_LENGTH +
2960                         FLAC__STREAM_METADATA_HEADER_LENGTH +
2961                         (
2962                                 FLAC__STREAM_METADATA_STREAMINFO_MIN_BLOCK_SIZE_LEN +
2963                                 FLAC__STREAM_METADATA_STREAMINFO_MAX_BLOCK_SIZE_LEN +
2964                                 FLAC__STREAM_METADATA_STREAMINFO_MIN_FRAME_SIZE_LEN +
2965                                 FLAC__STREAM_METADATA_STREAMINFO_MAX_FRAME_SIZE_LEN +
2966                                 FLAC__STREAM_METADATA_STREAMINFO_SAMPLE_RATE_LEN +
2967                                 FLAC__STREAM_METADATA_STREAMINFO_CHANNELS_LEN +
2968                                 FLAC__STREAM_METADATA_STREAMINFO_BITS_PER_SAMPLE_LEN
2969                                 - 4
2970                         ) / 8;
2971
2972                 if(total_samples_byte_offset + 5 > (unsigned)page.body_len) {
2973                         encoder->protected_->state = FLAC__STREAM_ENCODER_OGG_ERROR;
2974                         simple_ogg_page__clear(&page);
2975                         return;
2976                 }
2977                 b[0] = (FLAC__byte)page.body[total_samples_byte_offset] & 0xF0;
2978                 b[0] |= (FLAC__byte)((samples >> 32) & 0x0F);
2979                 b[1] = (FLAC__byte)((samples >> 24) & 0xFF);
2980                 b[2] = (FLAC__byte)((samples >> 16) & 0xFF);
2981                 b[3] = (FLAC__byte)((samples >> 8) & 0xFF);
2982                 b[4] = (FLAC__byte)(samples & 0xFF);
2983                 memcpy(page.body + total_samples_byte_offset, b, 5);
2984         }
2985
2986         /*
2987          * Write min/max framesize
2988          */
2989         {
2990                 const unsigned min_framesize_offset =
2991                         FIRST_OGG_PACKET_STREAMINFO_PREFIX_LENGTH +
2992                         FLAC__STREAM_METADATA_HEADER_LENGTH +
2993                         (
2994                                 FLAC__STREAM_METADATA_STREAMINFO_MIN_BLOCK_SIZE_LEN +
2995                                 FLAC__STREAM_METADATA_STREAMINFO_MAX_BLOCK_SIZE_LEN
2996                         ) / 8;
2997
2998                 if(min_framesize_offset + 6 > (unsigned)page.body_len) {
2999                         encoder->protected_->state = FLAC__STREAM_ENCODER_OGG_ERROR;
3000                         simple_ogg_page__clear(&page);
3001                         return;
3002                 }
3003                 b[0] = (FLAC__byte)((min_framesize >> 16) & 0xFF);
3004                 b[1] = (FLAC__byte)((min_framesize >> 8) & 0xFF);
3005                 b[2] = (FLAC__byte)(min_framesize & 0xFF);
3006                 b[3] = (FLAC__byte)((max_framesize >> 16) & 0xFF);
3007                 b[4] = (FLAC__byte)((max_framesize >> 8) & 0xFF);
3008                 b[5] = (FLAC__byte)(max_framesize & 0xFF);
3009                 memcpy(page.body + min_framesize_offset, b, 6);
3010         }
3011         if(!simple_ogg_page__set_at(encoder, encoder->protected_->streaminfo_offset, &page, encoder->private_->seek_callback, encoder->private_->write_callback, encoder->private_->client_data)) {
3012                 simple_ogg_page__clear(&page);
3013                 return; /* state already set */
3014         }
3015         simple_ogg_page__clear(&page);
3016
3017         /*
3018          * Write seektable
3019          */
3020         if(0 != encoder->private_->seek_table && encoder->private_->seek_table->num_points > 0 && encoder->protected_->seektable_offset > 0) {
3021                 unsigned i;
3022                 FLAC__byte *p;
3023
3024                 FLAC__format_seektable_sort(encoder->private_->seek_table);
3025
3026                 FLAC__ASSERT(FLAC__format_seektable_is_legal(encoder->private_->seek_table));
3027
3028                 simple_ogg_page__init(&page);
3029                 if(!simple_ogg_page__get_at(encoder, encoder->protected_->seektable_offset, &page, encoder->private_->seek_callback, encoder->private_->read_callback, encoder->private_->client_data)) {
3030                         simple_ogg_page__clear(&page);
3031                         return; /* state already set */
3032                 }
3033
3034                 if((FLAC__STREAM_METADATA_HEADER_LENGTH + 18*encoder->private_->seek_table->num_points) != (unsigned)page.body_len) {
3035                         encoder->protected_->state = FLAC__STREAM_ENCODER_OGG_ERROR;
3036                         simple_ogg_page__clear(&page);
3037                         return;
3038                 }
3039
3040                 for(i = 0, p = page.body + FLAC__STREAM_METADATA_HEADER_LENGTH; i < encoder->private_->seek_table->num_points; i++, p += 18) {
3041                         FLAC__uint64 xx;
3042                         unsigned x;
3043                         xx = encoder->private_->seek_table->points[i].sample_number;
3044                         b[7] = (FLAC__byte)xx; xx >>= 8;
3045                         b[6] = (FLAC__byte)xx; xx >>= 8;
3046                         b[5] = (FLAC__byte)xx; xx >>= 8;
3047                         b[4] = (FLAC__byte)xx; xx >>= 8;
3048                         b[3] = (FLAC__byte)xx; xx >>= 8;
3049                         b[2] = (FLAC__byte)xx; xx >>= 8;
3050                         b[1] = (FLAC__byte)xx; xx >>= 8;
3051                         b[0] = (FLAC__byte)xx; xx >>= 8;
3052                         xx = encoder->private_->seek_table->points[i].stream_offset;
3053                         b[15] = (FLAC__byte)xx; xx >>= 8;
3054                         b[14] = (FLAC__byte)xx; xx >>= 8;
3055                         b[13] = (FLAC__byte)xx; xx >>= 8;
3056                         b[12] = (FLAC__byte)xx; xx >>= 8;
3057                         b[11] = (FLAC__byte)xx; xx >>= 8;
3058                         b[10] = (FLAC__byte)xx; xx >>= 8;
3059                         b[9] = (FLAC__byte)xx; xx >>= 8;
3060                         b[8] = (FLAC__byte)xx; xx >>= 8;
3061                         x = encoder->private_->seek_table->points[i].frame_samples;
3062                         b[17] = (FLAC__byte)x; x >>= 8;
3063                         b[16] = (FLAC__byte)x; x >>= 8;
3064                         memcpy(p, b, 18);
3065                 }
3066
3067                 if(!simple_ogg_page__set_at(encoder, encoder->protected_->seektable_offset, &page, encoder->private_->seek_callback, encoder->private_->write_callback, encoder->private_->client_data)) {
3068                         simple_ogg_page__clear(&page);
3069                         return; /* state already set */
3070                 }
3071                 simple_ogg_page__clear(&page);
3072         }
3073 }
3074 #endif
3075
3076 FLAC__bool process_frame_(FLAC__StreamEncoder *encoder, FLAC__bool is_fractional_block, FLAC__bool is_last_block)
3077 {
3078         FLAC__uint16 crc;
3079         FLAC__ASSERT(encoder->protected_->state == FLAC__STREAM_ENCODER_OK);
3080
3081         /*
3082          * Accumulate raw signal to the MD5 signature
3083          */
3084         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)) {
3085                 encoder->protected_->state = FLAC__STREAM_ENCODER_MEMORY_ALLOCATION_ERROR;
3086                 return false;
3087         }
3088
3089         /*
3090          * Process the frame header and subframes into the frame bitbuffer
3091          */
3092         if(!process_subframes_(encoder, is_fractional_block)) {
3093                 /* the above function sets the state for us in case of an error */
3094                 return false;
3095         }
3096
3097         /*
3098          * Zero-pad the frame to a byte_boundary
3099          */
3100         if(!FLAC__bitwriter_zero_pad_to_byte_boundary(encoder->private_->frame)) {
3101                 encoder->protected_->state = FLAC__STREAM_ENCODER_MEMORY_ALLOCATION_ERROR;
3102                 return false;
3103         }
3104
3105         /*
3106          * CRC-16 the whole thing
3107          */
3108         FLAC__ASSERT(FLAC__bitwriter_is_byte_aligned(encoder->private_->frame));
3109         if(
3110                 !FLAC__bitwriter_get_write_crc16(encoder->private_->frame, &crc) ||
3111                 !FLAC__bitwriter_write_raw_uint32(encoder->private_->frame, crc, FLAC__FRAME_FOOTER_CRC_LEN)
3112         ) {
3113                 encoder->protected_->state = FLAC__STREAM_ENCODER_MEMORY_ALLOCATION_ERROR;
3114                 return false;
3115         }
3116
3117         /*
3118          * Write it
3119          */
3120         if(!write_bitbuffer_(encoder, encoder->protected_->blocksize, is_last_block)) {
3121                 /* the above function sets the state for us in case of an error */
3122                 return false;
3123         }
3124
3125         /*
3126          * Get ready for the next frame
3127          */
3128         encoder->private_->current_sample_number = 0;
3129         encoder->private_->current_frame_number++;
3130         encoder->private_->streaminfo.data.stream_info.total_samples += (FLAC__uint64)encoder->protected_->blocksize;
3131
3132         return true;
3133 }
3134
3135 FLAC__bool process_subframes_(FLAC__StreamEncoder *encoder, FLAC__bool is_fractional_block)
3136 {
3137         FLAC__FrameHeader frame_header;
3138         unsigned channel, min_partition_order = encoder->protected_->min_residual_partition_order, max_partition_order;
3139         FLAC__bool do_independent, do_mid_side;
3140
3141         /*
3142          * Calculate the min,max Rice partition orders
3143          */
3144         if(is_fractional_block) {
3145                 max_partition_order = 0;
3146         }
3147         else {
3148                 max_partition_order = FLAC__format_get_max_rice_partition_order_from_blocksize(encoder->protected_->blocksize);
3149                 max_partition_order = min(max_partition_order, encoder->protected_->max_residual_partition_order);
3150         }
3151         min_partition_order = min(min_partition_order, max_partition_order);
3152
3153         /*
3154          * Setup the frame
3155          */
3156         frame_header.blocksize = encoder->protected_->blocksize;
3157         frame_header.sample_rate = encoder->protected_->sample_rate;
3158         frame_header.channels = encoder->protected_->channels;
3159         frame_header.channel_assignment = FLAC__CHANNEL_ASSIGNMENT_INDEPENDENT; /* the default unless the encoder determines otherwise */
3160         frame_header.bits_per_sample = encoder->protected_->bits_per_sample;
3161         frame_header.number_type = FLAC__FRAME_NUMBER_TYPE_FRAME_NUMBER;
3162         frame_header.number.frame_number = encoder->private_->current_frame_number;
3163
3164         /*
3165          * Figure out what channel assignments to try
3166          */
3167         if(encoder->protected_->do_mid_side_stereo) {
3168                 if(encoder->protected_->loose_mid_side_stereo) {
3169                         if(encoder->private_->loose_mid_side_stereo_frame_count == 0) {
3170                                 do_independent = true;
3171                                 do_mid_side = true;
3172                         }
3173                         else {
3174                                 do_independent = (encoder->private_->last_channel_assignment == FLAC__CHANNEL_ASSIGNMENT_INDEPENDENT);
3175                                 do_mid_side = !do_independent;
3176                         }
3177                 }
3178                 else {
3179                         do_independent = true;
3180                         do_mid_side = true;
3181                 }
3182         }
3183         else {
3184                 do_independent = true;
3185                 do_mid_side = false;
3186         }
3187
3188         FLAC__ASSERT(do_independent || do_mid_side);
3189
3190         /*
3191          * Check for wasted bits; set effective bps for each subframe
3192          */
3193         if(do_independent) {
3194                 for(channel = 0; channel < encoder->protected_->channels; channel++) {
3195                         const unsigned w = get_wasted_bits_(encoder->private_->integer_signal[channel], encoder->protected_->blocksize);
3196                         encoder->private_->subframe_workspace[channel][0].wasted_bits = encoder->private_->subframe_workspace[channel][1].wasted_bits = w;
3197                         encoder->private_->subframe_bps[channel] = encoder->protected_->bits_per_sample - w;
3198                 }
3199         }
3200         if(do_mid_side) {
3201                 FLAC__ASSERT(encoder->protected_->channels == 2);
3202                 for(channel = 0; channel < 2; channel++) {
3203                         const unsigned w = get_wasted_bits_(encoder->private_->integer_signal_mid_side[channel], encoder->protected_->blocksize);
3204                         encoder->private_->subframe_workspace_mid_side[channel][0].wasted_bits = encoder->private_->subframe_workspace_mid_side[channel][1].wasted_bits = w;
3205                         encoder->private_->subframe_bps_mid_side[channel] = encoder->protected_->bits_per_sample - w + (channel==0? 0:1);
3206                 }
3207         }
3208
3209         /*
3210          * First do a normal encoding pass of each independent channel
3211          */
3212         if(do_independent) {
3213                 for(channel = 0; channel < encoder->protected_->channels; channel++) {
3214                         if(!
3215                                 process_subframe_(
3216                                         encoder,
3217                                         min_partition_order,
3218                                         max_partition_order,
3219                                         &frame_header,
3220                                         encoder->private_->subframe_bps[channel],
3221                                         encoder->private_->integer_signal[channel],
3222 #ifndef FLAC__INTEGER_ONLY_LIBRARY
3223                                         encoder->private_->real_signal[channel],
3224 #endif
3225                                         encoder->private_->subframe_workspace_ptr[channel],
3226                                         encoder->private_->partitioned_rice_contents_workspace_ptr[channel],
3227                                         encoder->private_->residual_workspace[channel],
3228                                         encoder->private_->best_subframe+channel,
3229                                         encoder->private_->best_subframe_bits+channel
3230                                 )
3231                         )
3232                                 return false;
3233                 }
3234         }
3235
3236         /*
3237          * Now do mid and side channels if requested
3238          */
3239         if(do_mid_side) {
3240                 FLAC__ASSERT(encoder->protected_->channels == 2);
3241
3242                 for(channel = 0; channel < 2; channel++) {
3243                         if(!
3244                                 process_subframe_(
3245                                         encoder,
3246                                         min_partition_order,
3247                                         max_partition_order,
3248                                         &frame_header,
3249                                         encoder->private_->subframe_bps_mid_side[channel],
3250                                         encoder->private_->integer_signal_mid_side[channel],
3251 #ifndef FLAC__INTEGER_ONLY_LIBRARY
3252                                         encoder->private_->real_signal_mid_side[channel],
3253 #endif
3254                                         encoder->private_->subframe_workspace_ptr_mid_side[channel],
3255                                         encoder->private_->partitioned_rice_contents_workspace_ptr_mid_side[channel],
3256                                         encoder->private_->residual_workspace_mid_side[channel],
3257                                         encoder->private_->best_subframe_mid_side+channel,
3258                                         encoder->private_->best_subframe_bits_mid_side+channel
3259                                 )
3260                         )
3261                                 return false;
3262                 }
3263         }
3264
3265         /*
3266          * Compose the frame bitbuffer
3267          */
3268         if(do_mid_side) {
3269                 unsigned left_bps = 0, right_bps = 0; /* initialized only to prevent superfluous compiler warning */
3270                 FLAC__Subframe *left_subframe = 0, *right_subframe = 0; /* initialized only to prevent superfluous compiler warning */
3271                 FLAC__ChannelAssignment channel_assignment;
3272
3273                 FLAC__ASSERT(encoder->protected_->channels == 2);
3274
3275                 if(encoder->protected_->loose_mid_side_stereo && encoder->private_->loose_mid_side_stereo_frame_count > 0) {
3276                         channel_assignment = (encoder->private_->last_channel_assignment == FLAC__CHANNEL_ASSIGNMENT_INDEPENDENT? FLAC__CHANNEL_ASSIGNMENT_INDEPENDENT : FLAC__CHANNEL_ASSIGNMENT_MID_SIDE);
3277                 }
3278                 else {
3279                         unsigned bits[4]; /* WATCHOUT - indexed by FLAC__ChannelAssignment */
3280                         unsigned min_bits;
3281                         int ca;
3282
3283                         FLAC__ASSERT(FLAC__CHANNEL_ASSIGNMENT_INDEPENDENT == 0);
3284                         FLAC__ASSERT(FLAC__CHANNEL_ASSIGNMENT_LEFT_SIDE   == 1);
3285                         FLAC__ASSERT(FLAC__CHANNEL_ASSIGNMENT_RIGHT_SIDE  == 2);
3286                         FLAC__ASSERT(FLAC__CHANNEL_ASSIGNMENT_MID_SIDE    == 3);
3287                         FLAC__ASSERT(do_independent && do_mid_side);
3288
3289                         /* We have to figure out which channel assignent results in the smallest frame */
3290                         bits[FLAC__CHANNEL_ASSIGNMENT_INDEPENDENT] = encoder->private_->best_subframe_bits         [0] + encoder->private_->best_subframe_bits         [1];
3291                         bits[FLAC__CHANNEL_ASSIGNMENT_LEFT_SIDE  ] = encoder->private_->best_subframe_bits         [0] + encoder->private_->best_subframe_bits_mid_side[1];
3292                         bits[FLAC__CHANNEL_ASSIGNMENT_RIGHT_SIDE ] = encoder->private_->best_subframe_bits         [1] + encoder->private_->best_subframe_bits_mid_side[1];
3293                         bits[FLAC__CHANNEL_ASSIGNMENT_MID_SIDE   ] = encoder->private_->best_subframe_bits_mid_side[0] + encoder->private_->best_subframe_bits_mid_side[1];
3294
3295                         channel_assignment = FLAC__CHANNEL_ASSIGNMENT_INDEPENDENT;
3296                         min_bits = bits[channel_assignment];
3297                         for(ca = 1; ca <= 3; ca++) {
3298                                 if(bits[ca] < min_bits) {
3299                                         min_bits = bits[ca];
3300                                         channel_assignment = (FLAC__ChannelAssignment)ca;
3301                                 }
3302                         }
3303                 }
3304
3305                 frame_header.channel_assignment = channel_assignment;
3306
3307                 if(!FLAC__frame_add_header(&frame_header, encoder->private_->frame)) {
3308                         encoder->protected_->state = FLAC__STREAM_ENCODER_FRAMING_ERROR;
3309                         return false;
3310                 }
3311
3312                 switch(channel_assignment) {
3313                         case FLAC__CHANNEL_ASSIGNMENT_INDEPENDENT:
3314                                 left_subframe  = &encoder->private_->subframe_workspace         [0][encoder->private_->best_subframe         [0]];
3315                                 right_subframe = &encoder->private_->subframe_workspace         [1][encoder->private_->best_subframe         [1]];
3316                                 break;
3317                         case FLAC__CHANNEL_ASSIGNMENT_LEFT_SIDE:
3318                                 left_subframe  = &encoder->private_->subframe_workspace         [0][encoder->private_->best_subframe         [0]];
3319                                 right_subframe = &encoder->private_->subframe_workspace_mid_side[1][encoder->private_->best_subframe_mid_side[1]];
3320                                 break;
3321                         case FLAC__CHANNEL_ASSIGNMENT_RIGHT_SIDE:
3322                                 left_subframe  = &encoder->private_->subframe_workspace_mid_side[1][encoder->private_->best_subframe_mid_side[1]];
3323                                 right_subframe = &encoder->private_->subframe_workspace         [1][encoder->private_->best_subframe         [1]];
3324                                 break;
3325                         case FLAC__CHANNEL_ASSIGNMENT_MID_SIDE:
3326                                 left_subframe  = &encoder->private_->subframe_workspace_mid_side[0][encoder->private_->best_subframe_mid_side[0]];
3327                                 right_subframe = &encoder->private_->subframe_workspace_mid_side[1][encoder->private_->best_subframe_mid_side[1]];
3328                                 break;
3329                         default:
3330                                 FLAC__ASSERT(0);
3331                 }
3332
3333                 switch(channel_assignment) {
3334                         case FLAC__CHANNEL_ASSIGNMENT_INDEPENDENT:
3335                                 left_bps  = encoder->private_->subframe_bps         [0];
3336                                 right_bps = encoder->private_->subframe_bps         [1];
3337                                 break;
3338                         case FLAC__CHANNEL_ASSIGNMENT_LEFT_SIDE:
3339                                 left_bps  = encoder->private_->subframe_bps         [0];
3340                                 right_bps = encoder->private_->subframe_bps_mid_side[1];
3341                                 break;
3342                         case FLAC__CHANNEL_ASSIGNMENT_RIGHT_SIDE:
3343                                 left_bps  = encoder->private_->subframe_bps_mid_side[1];
3344                                 right_bps = encoder->private_->subframe_bps         [1];
3345                                 break;
3346                         case FLAC__CHANNEL_ASSIGNMENT_MID_SIDE:
3347                                 left_bps  = encoder->private_->subframe_bps_mid_side[0];
3348                                 right_bps = encoder->private_->subframe_bps_mid_side[1];
3349                                 break;
3350                         default:
3351                                 FLAC__ASSERT(0);
3352                 }
3353
3354                 /* note that encoder_add_subframe_ sets the state for us in case of an error */
3355                 if(!add_subframe_(encoder, frame_header.blocksize, left_bps , left_subframe , encoder->private_->frame))
3356                         return false;
3357                 if(!add_subframe_(encoder, frame_header.blocksize, right_bps, right_subframe, encoder->private_->frame))
3358                         return false;
3359         }
3360         else {
3361                 if(!FLAC__frame_add_header(&frame_header, encoder->private_->frame)) {
3362                         encoder->protected_->state = FLAC__STREAM_ENCODER_FRAMING_ERROR;
3363                         return false;
3364                 }
3365
3366                 for(channel = 0; channel < encoder->protected_->channels; channel++) {
3367                         if(!add_subframe_(encoder, frame_header.blocksize, encoder->private_->subframe_bps[channel], &encoder->private_->subframe_workspace[channel][encoder->private_->best_subframe[channel]], encoder->private_->frame)) {
3368                                 /* the above function sets the state for us in case of an error */
3369                                 return false;
3370                         }
3371                 }
3372         }
3373
3374         if(encoder->protected_->loose_mid_side_stereo) {
3375                 encoder->private_->loose_mid_side_stereo_frame_count++;
3376                 if(encoder->private_->loose_mid_side_stereo_frame_count >= encoder->private_->loose_mid_side_stereo_frames)
3377                         encoder->private_->loose_mid_side_stereo_frame_count = 0;
3378         }
3379
3380         encoder->private_->last_channel_assignment = frame_header.channel_assignment;
3381
3382         return true;
3383 }
3384
3385 FLAC__bool process_subframe_(
3386         FLAC__StreamEncoder *encoder,
3387         unsigned min_partition_order,
3388         unsigned max_partition_order,
3389         const FLAC__FrameHeader *frame_header,
3390         unsigned subframe_bps,
3391         const FLAC__int32 integer_signal[],
3392 #ifndef FLAC__INTEGER_ONLY_LIBRARY
3393         const FLAC__real real_signal[],
3394 #endif
3395         FLAC__Subframe *subframe[2],
3396         FLAC__EntropyCodingMethod_PartitionedRiceContents *partitioned_rice_contents[2],
3397         FLAC__int32 *residual[2],
3398         unsigned *best_subframe,
3399         unsigned *best_bits
3400 )
3401 {
3402 #ifndef FLAC__INTEGER_ONLY_LIBRARY
3403         FLAC__float fixed_residual_bits_per_sample[FLAC__MAX_FIXED_ORDER+1];
3404 #else
3405         FLAC__fixedpoint fixed_residual_bits_per_sample[FLAC__MAX_FIXED_ORDER+1];
3406 #endif
3407 #ifndef FLAC__INTEGER_ONLY_LIBRARY
3408         FLAC__double lpc_residual_bits_per_sample;
3409         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 */
3410         FLAC__double lpc_error[FLAC__MAX_LPC_ORDER];
3411         unsigned min_lpc_order, max_lpc_order, lpc_order;
3412         unsigned min_qlp_coeff_precision, max_qlp_coeff_precision, qlp_coeff_precision;
3413 #endif
3414         unsigned min_fixed_order, max_fixed_order, guess_fixed_order, fixed_order;
3415         unsigned rice_parameter;
3416         unsigned _candidate_bits, _best_bits;
3417         unsigned _best_subframe;
3418
3419         FLAC__ASSERT(frame_header->blocksize > 0);
3420
3421         /* verbatim subframe is the baseline against which we measure other compressed subframes */
3422         _best_subframe = 0;
3423         if(encoder->private_->disable_verbatim_subframes && frame_header->blocksize >= FLAC__MAX_FIXED_ORDER)
3424                 _best_bits = UINT_MAX;
3425         else
3426                 _best_bits = evaluate_verbatim_subframe_(encoder, integer_signal, frame_header->blocksize, subframe_bps, subframe[_best_subframe]);
3427
3428         if(frame_header->blocksize >= FLAC__MAX_FIXED_ORDER) {
3429                 unsigned signal_is_constant = false;
3430                 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);
3431                 /* check for constant subframe */
3432                 if(
3433                         !encoder->private_->disable_constant_subframes &&
3434 #ifndef FLAC__INTEGER_ONLY_LIBRARY
3435                         fixed_residual_bits_per_sample[1] == 0.0
3436 #else
3437                         fixed_residual_bits_per_sample[1] == FLAC__FP_ZERO
3438 #endif
3439                 ) {
3440                         /* the above means it's possible all samples are the same value; now double-check it: */
3441                         unsigned i;
3442                         signal_is_constant = true;
3443                         for(i = 1; i < frame_header->blocksize; i++) {
3444                                 if(integer_signal[0] != integer_signal[i]) {
3445                                         signal_is_constant = false;
3446                                         break;
3447                                 }
3448                         }
3449                 }
3450                 if(signal_is_constant) {
3451                         _candidate_bits = evaluate_constant_subframe_(encoder, integer_signal[0], frame_header->blocksize, subframe_bps, subframe[!_best_subframe]);
3452                         if(_candidate_bits < _best_bits) {
3453                                 _best_subframe = !_best_subframe;
3454                                 _best_bits = _candidate_bits;
3455                         }
3456                 }
3457                 else {
3458                         if(!encoder->private_->disable_fixed_subframes || (encoder->protected_->max_lpc_order == 0 && _best_bits == UINT_MAX)) {
3459                                 /* encode fixed */
3460                                 if(encoder->protected_->do_exhaustive_model_search) {
3461                                         min_fixed_order = 0;
3462                                         max_fixed_order = FLAC__MAX_FIXED_ORDER;
3463                                 }
3464                                 else {
3465                                         min_fixed_order&nb