1
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
2
<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1">
3
<title>FLAC/file_encoder.h: file encoder interface</title>
4
<link href="doxygen.css" rel="stylesheet" type="text/css">
6
<!-- Generated by Doxygen 1.2.14 -->
8
<a class="qindex" href="index.html">Main Page</a> <a class="qindex" href="modules.html">Modules</a> <a class="qindex" href="hierarchy.html">Class Hierarchy</a> <a class="qindex" href="classes.html">Alphabetical List</a> <a class="qindex" href="annotated.html">Compound List</a> <a class="qindex" href="files.html">File List</a> <a class="qindex" href="functions.html">Compound Members</a> <a class="qindex" href="globals.html">File Members</a> </center>
9
<hr><h1>FLAC/file_encoder.h: file encoder interface<br>
11
[<a class="el" href="group__flac__encoder.html">FLAC/_encoder.h: encoder interfaces</a>]</small>
12
</h1>This module contains the functions which implement the file encoder.
13
<a href="#_details">More...</a><table border=0 cellpadding=0 cellspacing=0>
14
<tr><td colspan=2><br><h2>Compounds</h2></td></tr>
15
<tr><td nowrap align=right valign=top>struct </td><td valign=bottom><a class="el" href="structFLAC____FileEncoder.html">FLAC__FileEncoder</a></td></tr>
16
<tr><td colspan=2><br><h2>Typedefs</h2></td></tr>
17
<tr><td nowrap align=right valign=top>typedef void(* </td><td valign=bottom><a class="el" href="group__flac__file__encoder.html#a1">FLAC__FileEncoderProgressCallback</a> )(const <a class="el" href="structFLAC____FileEncoder.html">FLAC__FileEncoder</a> *encoder, FLAC__uint64 bytes_written, FLAC__uint64 samples_written, unsigned frames_written, unsigned total_frames_estimate, void *client_data)</td></tr>
18
<tr><td colspan=2><br><h2>Enumerations</h2></td></tr>
19
<tr><td nowrap align=right valign=top>enum </td><td valign=bottom><a class="el" href="group__flac__file__encoder.html#a52">FLAC__FileEncoderState</a> { <br>
20
<a class="el" href="group__flac__file__encoder.html#a52a2">FLAC__FILE_ENCODER_OK</a> = 0,
21
<a class="el" href="group__flac__file__encoder.html#a52a3">FLAC__FILE_ENCODER_NO_FILENAME</a>,
22
<a class="el" href="group__flac__file__encoder.html#a52a4">FLAC__FILE_ENCODER_SEEKABLE_STREAM_ENCODER_ERROR</a>,
23
<a class="el" href="group__flac__file__encoder.html#a52a5">FLAC__FILE_ENCODER_FATAL_ERROR_WHILE_WRITING</a>,
25
<a class="el" href="group__flac__file__encoder.html#a52a6">FLAC__FILE_ENCODER_ERROR_OPENING_FILE</a>,
26
<a class="el" href="group__flac__file__encoder.html#a52a7">FLAC__FILE_ENCODER_MEMORY_ALLOCATION_ERROR</a>,
27
<a class="el" href="group__flac__file__encoder.html#a52a8">FLAC__FILE_ENCODER_ALREADY_INITIALIZED</a>,
28
<a class="el" href="group__flac__file__encoder.html#a52a9">FLAC__FILE_ENCODER_UNINITIALIZED</a>
31
<tr><td colspan=2><br><h2>Functions</h2></td></tr>
32
<tr><td nowrap align=right valign=top><a class="el" href="structFLAC____FileEncoder.html">FLAC__FileEncoder</a> * </td><td valign=bottom><a class="el" href="group__flac__file__encoder.html#a2">FLAC__file_encoder_new</a> ()</td></tr>
33
<tr><td nowrap align=right valign=top>void </td><td valign=bottom><a class="el" href="group__flac__file__encoder.html#a3">FLAC__file_encoder_delete</a> (<a class="el" href="structFLAC____FileEncoder.html">FLAC__FileEncoder</a> *encoder)</td></tr>
34
<tr><td nowrap align=right valign=top>FLAC__bool </td><td valign=bottom><a class="el" href="group__flac__file__encoder.html#a4">FLAC__file_encoder_set_verify</a> (<a class="el" href="structFLAC____FileEncoder.html">FLAC__FileEncoder</a> *encoder, FLAC__bool value)</td></tr>
35
<tr><td nowrap align=right valign=top>FLAC__bool </td><td valign=bottom><a class="el" href="group__flac__file__encoder.html#a5">FLAC__file_encoder_set_streamable_subset</a> (<a class="el" href="structFLAC____FileEncoder.html">FLAC__FileEncoder</a> *encoder, FLAC__bool value)</td></tr>
36
<tr><td nowrap align=right valign=top>FLAC__bool </td><td valign=bottom><a class="el" href="group__flac__file__encoder.html#a6">FLAC__file_encoder_set_do_mid_side_stereo</a> (<a class="el" href="structFLAC____FileEncoder.html">FLAC__FileEncoder</a> *encoder, FLAC__bool value)</td></tr>
37
<tr><td nowrap align=right valign=top>FLAC__bool </td><td valign=bottom><a class="el" href="group__flac__file__encoder.html#a7">FLAC__file_encoder_set_loose_mid_side_stereo</a> (<a class="el" href="structFLAC____FileEncoder.html">FLAC__FileEncoder</a> *encoder, FLAC__bool value)</td></tr>
38
<tr><td nowrap align=right valign=top>FLAC__bool </td><td valign=bottom><a class="el" href="group__flac__file__encoder.html#a8">FLAC__file_encoder_set_channels</a> (<a class="el" href="structFLAC____FileEncoder.html">FLAC__FileEncoder</a> *encoder, unsigned value)</td></tr>
39
<tr><td nowrap align=right valign=top>FLAC__bool </td><td valign=bottom><a class="el" href="group__flac__file__encoder.html#a9">FLAC__file_encoder_set_bits_per_sample</a> (<a class="el" href="structFLAC____FileEncoder.html">FLAC__FileEncoder</a> *encoder, unsigned value)</td></tr>
40
<tr><td nowrap align=right valign=top>FLAC__bool </td><td valign=bottom><a class="el" href="group__flac__file__encoder.html#a10">FLAC__file_encoder_set_sample_rate</a> (<a class="el" href="structFLAC____FileEncoder.html">FLAC__FileEncoder</a> *encoder, unsigned value)</td></tr>
41
<tr><td nowrap align=right valign=top>FLAC__bool </td><td valign=bottom><a class="el" href="group__flac__file__encoder.html#a11">FLAC__file_encoder_set_blocksize</a> (<a class="el" href="structFLAC____FileEncoder.html">FLAC__FileEncoder</a> *encoder, unsigned value)</td></tr>
42
<tr><td nowrap align=right valign=top>FLAC__bool </td><td valign=bottom><a class="el" href="group__flac__file__encoder.html#a12">FLAC__file_encoder_set_max_lpc_order</a> (<a class="el" href="structFLAC____FileEncoder.html">FLAC__FileEncoder</a> *encoder, unsigned value)</td></tr>
43
<tr><td nowrap align=right valign=top>FLAC__bool </td><td valign=bottom><a class="el" href="group__flac__file__encoder.html#a13">FLAC__file_encoder_set_qlp_coeff_precision</a> (<a class="el" href="structFLAC____FileEncoder.html">FLAC__FileEncoder</a> *encoder, unsigned value)</td></tr>
44
<tr><td nowrap align=right valign=top>FLAC__bool </td><td valign=bottom><a class="el" href="group__flac__file__encoder.html#a14">FLAC__file_encoder_set_do_qlp_coeff_prec_search</a> (<a class="el" href="structFLAC____FileEncoder.html">FLAC__FileEncoder</a> *encoder, FLAC__bool value)</td></tr>
45
<tr><td nowrap align=right valign=top>FLAC__bool </td><td valign=bottom><a class="el" href="group__flac__file__encoder.html#a15">FLAC__file_encoder_set_do_escape_coding</a> (<a class="el" href="structFLAC____FileEncoder.html">FLAC__FileEncoder</a> *encoder, FLAC__bool value)</td></tr>
46
<tr><td nowrap align=right valign=top>FLAC__bool </td><td valign=bottom><a class="el" href="group__flac__file__encoder.html#a16">FLAC__file_encoder_set_do_exhaustive_model_search</a> (<a class="el" href="structFLAC____FileEncoder.html">FLAC__FileEncoder</a> *encoder, FLAC__bool value)</td></tr>
47
<tr><td nowrap align=right valign=top>FLAC__bool </td><td valign=bottom><a class="el" href="group__flac__file__encoder.html#a17">FLAC__file_encoder_set_min_residual_partition_order</a> (<a class="el" href="structFLAC____FileEncoder.html">FLAC__FileEncoder</a> *encoder, unsigned value)</td></tr>
48
<tr><td nowrap align=right valign=top>FLAC__bool </td><td valign=bottom><a class="el" href="group__flac__file__encoder.html#a18">FLAC__file_encoder_set_max_residual_partition_order</a> (<a class="el" href="structFLAC____FileEncoder.html">FLAC__FileEncoder</a> *encoder, unsigned value)</td></tr>
49
<tr><td nowrap align=right valign=top>FLAC__bool </td><td valign=bottom><a class="el" href="group__flac__file__encoder.html#a19">FLAC__file_encoder_set_rice_parameter_search_dist</a> (<a class="el" href="structFLAC____FileEncoder.html">FLAC__FileEncoder</a> *encoder, unsigned value)</td></tr>
50
<tr><td nowrap align=right valign=top>FLAC__bool </td><td valign=bottom><a class="el" href="group__flac__file__encoder.html#a20">FLAC__file_encoder_set_total_samples_estimate</a> (<a class="el" href="structFLAC____FileEncoder.html">FLAC__FileEncoder</a> *encoder, FLAC__uint64 value)</td></tr>
51
<tr><td nowrap align=right valign=top>FLAC__bool </td><td valign=bottom><a class="el" href="group__flac__file__encoder.html#a21">FLAC__file_encoder_set_metadata</a> (<a class="el" href="structFLAC____FileEncoder.html">FLAC__FileEncoder</a> *encoder, <a class="el" href="structFLAC____StreamMetadata.html">FLAC__StreamMetadata</a> **metadata, unsigned num_blocks)</td></tr>
52
<tr><td nowrap align=right valign=top>FLAC__bool </td><td valign=bottom><a class="el" href="group__flac__file__encoder.html#a22">FLAC__file_encoder_set_filename</a> (<a class="el" href="structFLAC____FileEncoder.html">FLAC__FileEncoder</a> *encoder, const char *value)</td></tr>
53
<tr><td nowrap align=right valign=top>FLAC__bool </td><td valign=bottom><a class="el" href="group__flac__file__encoder.html#a23">FLAC__file_encoder_set_progress_callback</a> (<a class="el" href="structFLAC____FileEncoder.html">FLAC__FileEncoder</a> *encoder, <a class="el" href="group__flac__file__encoder.html#a1">FLAC__FileEncoderProgressCallback</a> value)</td></tr>
54
<tr><td nowrap align=right valign=top>FLAC__bool </td><td valign=bottom><a class="el" href="group__flac__file__encoder.html#a24">FLAC__file_encoder_set_client_data</a> (<a class="el" href="structFLAC____FileEncoder.html">FLAC__FileEncoder</a> *encoder, void *value)</td></tr>
55
<tr><td nowrap align=right valign=top><a class="el" href="group__flac__file__encoder.html#a52">FLAC__FileEncoderState</a> </td><td valign=bottom><a class="el" href="group__flac__file__encoder.html#a25">FLAC__file_encoder_get_state</a> (const <a class="el" href="structFLAC____FileEncoder.html">FLAC__FileEncoder</a> *encoder)</td></tr>
56
<tr><td nowrap align=right valign=top><a class="el" href="group__flac__seekable__stream__encoder.html#a56">FLAC__SeekableStreamEncoderState</a> </td><td valign=bottom><a class="el" href="group__flac__file__encoder.html#a26">FLAC__file_encoder_get_seekable_stream_encoder_state</a> (const <a class="el" href="structFLAC____FileEncoder.html">FLAC__FileEncoder</a> *encoder)</td></tr>
57
<tr><td nowrap align=right valign=top><a class="el" href="group__flac__stream__encoder.html#a52">FLAC__StreamEncoderState</a> </td><td valign=bottom><a class="el" href="group__flac__file__encoder.html#a27">FLAC__file_encoder_get_stream_encoder_state</a> (const <a class="el" href="structFLAC____FileEncoder.html">FLAC__FileEncoder</a> *encoder)</td></tr>
58
<tr><td nowrap align=right valign=top><a class="el" href="group__flac__stream__decoder.html#a36">FLAC__StreamDecoderState</a> </td><td valign=bottom><a class="el" href="group__flac__file__encoder.html#a28">FLAC__file_encoder_get_verify_decoder_state</a> (const <a class="el" href="structFLAC____FileEncoder.html">FLAC__FileEncoder</a> *encoder)</td></tr>
59
<tr><td nowrap align=right valign=top>const char * </td><td valign=bottom><a class="el" href="group__flac__file__encoder.html#a29">FLAC__file_encoder_get_resolved_state_string</a> (const <a class="el" href="structFLAC____FileEncoder.html">FLAC__FileEncoder</a> *encoder)</td></tr>
60
<tr><td nowrap align=right valign=top>void </td><td valign=bottom><a class="el" href="group__flac__file__encoder.html#a30">FLAC__file_encoder_get_verify_decoder_error_stats</a> (const <a class="el" href="structFLAC____FileEncoder.html">FLAC__FileEncoder</a> *encoder, FLAC__uint64 *absolute_sample, unsigned *frame_number, unsigned *channel, unsigned *sample, FLAC__int32 *expected, FLAC__int32 *got)</td></tr>
61
<tr><td nowrap align=right valign=top>FLAC__bool </td><td valign=bottom><a class="el" href="group__flac__file__encoder.html#a31">FLAC__file_encoder_get_verify</a> (const <a class="el" href="structFLAC____FileEncoder.html">FLAC__FileEncoder</a> *encoder)</td></tr>
62
<tr><td nowrap align=right valign=top>FLAC__bool </td><td valign=bottom><a class="el" href="group__flac__file__encoder.html#a32">FLAC__file_encoder_get_streamable_subset</a> (const <a class="el" href="structFLAC____FileEncoder.html">FLAC__FileEncoder</a> *encoder)</td></tr>
63
<tr><td nowrap align=right valign=top>FLAC__bool </td><td valign=bottom><a class="el" href="group__flac__file__encoder.html#a33">FLAC__file_encoder_get_do_mid_side_stereo</a> (const <a class="el" href="structFLAC____FileEncoder.html">FLAC__FileEncoder</a> *encoder)</td></tr>
64
<tr><td nowrap align=right valign=top>FLAC__bool </td><td valign=bottom><a class="el" href="group__flac__file__encoder.html#a34">FLAC__file_encoder_get_loose_mid_side_stereo</a> (const <a class="el" href="structFLAC____FileEncoder.html">FLAC__FileEncoder</a> *encoder)</td></tr>
65
<tr><td nowrap align=right valign=top>unsigned </td><td valign=bottom><a class="el" href="group__flac__file__encoder.html#a35">FLAC__file_encoder_get_channels</a> (const <a class="el" href="structFLAC____FileEncoder.html">FLAC__FileEncoder</a> *encoder)</td></tr>
66
<tr><td nowrap align=right valign=top>unsigned </td><td valign=bottom><a class="el" href="group__flac__file__encoder.html#a36">FLAC__file_encoder_get_bits_per_sample</a> (const <a class="el" href="structFLAC____FileEncoder.html">FLAC__FileEncoder</a> *encoder)</td></tr>
67
<tr><td nowrap align=right valign=top>unsigned </td><td valign=bottom><a class="el" href="group__flac__file__encoder.html#a37">FLAC__file_encoder_get_sample_rate</a> (const <a class="el" href="structFLAC____FileEncoder.html">FLAC__FileEncoder</a> *encoder)</td></tr>
68
<tr><td nowrap align=right valign=top>unsigned </td><td valign=bottom><a class="el" href="group__flac__file__encoder.html#a38">FLAC__file_encoder_get_blocksize</a> (const <a class="el" href="structFLAC____FileEncoder.html">FLAC__FileEncoder</a> *encoder)</td></tr>
69
<tr><td nowrap align=right valign=top>unsigned </td><td valign=bottom><a class="el" href="group__flac__file__encoder.html#a39">FLAC__file_encoder_get_max_lpc_order</a> (const <a class="el" href="structFLAC____FileEncoder.html">FLAC__FileEncoder</a> *encoder)</td></tr>
70
<tr><td nowrap align=right valign=top>unsigned </td><td valign=bottom><a class="el" href="group__flac__file__encoder.html#a40">FLAC__file_encoder_get_qlp_coeff_precision</a> (const <a class="el" href="structFLAC____FileEncoder.html">FLAC__FileEncoder</a> *encoder)</td></tr>
71
<tr><td nowrap align=right valign=top>FLAC__bool </td><td valign=bottom><a class="el" href="group__flac__file__encoder.html#a41">FLAC__file_encoder_get_do_qlp_coeff_prec_search</a> (const <a class="el" href="structFLAC____FileEncoder.html">FLAC__FileEncoder</a> *encoder)</td></tr>
72
<tr><td nowrap align=right valign=top>FLAC__bool </td><td valign=bottom><a class="el" href="group__flac__file__encoder.html#a42">FLAC__file_encoder_get_do_escape_coding</a> (const <a class="el" href="structFLAC____FileEncoder.html">FLAC__FileEncoder</a> *encoder)</td></tr>
73
<tr><td nowrap align=right valign=top>FLAC__bool </td><td valign=bottom><a class="el" href="group__flac__file__encoder.html#a43">FLAC__file_encoder_get_do_exhaustive_model_search</a> (const <a class="el" href="structFLAC____FileEncoder.html">FLAC__FileEncoder</a> *encoder)</td></tr>
74
<tr><td nowrap align=right valign=top>unsigned </td><td valign=bottom><a class="el" href="group__flac__file__encoder.html#a44">FLAC__file_encoder_get_min_residual_partition_order</a> (const <a class="el" href="structFLAC____FileEncoder.html">FLAC__FileEncoder</a> *encoder)</td></tr>
75
<tr><td nowrap align=right valign=top>unsigned </td><td valign=bottom><a class="el" href="group__flac__file__encoder.html#a45">FLAC__file_encoder_get_max_residual_partition_order</a> (const <a class="el" href="structFLAC____FileEncoder.html">FLAC__FileEncoder</a> *encoder)</td></tr>
76
<tr><td nowrap align=right valign=top>unsigned </td><td valign=bottom><a class="el" href="group__flac__file__encoder.html#a46">FLAC__file_encoder_get_rice_parameter_search_dist</a> (const <a class="el" href="structFLAC____FileEncoder.html">FLAC__FileEncoder</a> *encoder)</td></tr>
77
<tr><td nowrap align=right valign=top>FLAC__uint64 </td><td valign=bottom><a class="el" href="group__flac__file__encoder.html#a47">FLAC__file_encoder_get_total_samples_estimate</a> (const <a class="el" href="structFLAC____FileEncoder.html">FLAC__FileEncoder</a> *encoder)</td></tr>
78
<tr><td nowrap align=right valign=top><a class="el" href="group__flac__file__encoder.html#a52">FLAC__FileEncoderState</a> </td><td valign=bottom><a class="el" href="group__flac__file__encoder.html#a48">FLAC__file_encoder_init</a> (<a class="el" href="structFLAC____FileEncoder.html">FLAC__FileEncoder</a> *encoder)</td></tr>
79
<tr><td nowrap align=right valign=top>void </td><td valign=bottom><a class="el" href="group__flac__file__encoder.html#a49">FLAC__file_encoder_finish</a> (<a class="el" href="structFLAC____FileEncoder.html">FLAC__FileEncoder</a> *encoder)</td></tr>
80
<tr><td nowrap align=right valign=top>FLAC__bool </td><td valign=bottom><a class="el" href="group__flac__file__encoder.html#a50">FLAC__file_encoder_process</a> (<a class="el" href="structFLAC____FileEncoder.html">FLAC__FileEncoder</a> *encoder, const FLAC__int32 *const buffer[], unsigned samples)</td></tr>
81
<tr><td nowrap align=right valign=top>FLAC__bool </td><td valign=bottom><a class="el" href="group__flac__file__encoder.html#a51">FLAC__file_encoder_process_interleaved</a> (<a class="el" href="structFLAC____FileEncoder.html">FLAC__FileEncoder</a> *encoder, const FLAC__int32 buffer[], unsigned samples)</td></tr>
82
<tr><td colspan=2><br><h2>Variables</h2></td></tr>
83
<tr><td nowrap align=right valign=top>const char *const </td><td valign=bottom><a class="el" href="group__flac__file__encoder.html#a0">FLAC__FileEncoderStateString</a> []</td></tr>
85
<hr><a name="_details"></a><h2>Detailed Description</h2>
86
This module contains the functions which implement the file encoder.
90
The basic usage of this encoder is as follows:<ul>
91
<li>The program creates an instance of an encoder using <a class="el" href="group__flac__file__encoder.html#a2">FLAC__file_encoder_new</a>().<li>The program overrides the default settings using FLAC__file_encoder_set_*() functions.<li>The program initializes the instance to validate the settings and prepare for encoding using <a class="el" href="group__flac__file__encoder.html#a48">FLAC__file_encoder_init</a>().<li>The program calls <a class="el" href="group__flac__file__encoder.html#a50">FLAC__file_encoder_process</a>() or <a class="el" href="group__flac__file__encoder.html#a51">FLAC__file_encoder_process_interleaved</a>() to encode data, which subsequently writes data to the output file.<li>The program finishes the encoding with <a class="el" href="group__flac__file__encoder.html#a49">FLAC__file_encoder_finish</a>(), which causes the encoder to encode any data still in its input pipe, rewind and write the STREAMINFO metadata to file, and finally reset the encoder to the uninitialized state.<li>The instance may be used again or deleted with <a class="el" href="group__flac__file__encoder.html#a3">FLAC__file_encoder_delete</a>().</ul>
92
The file encoder is a wrapper around the <a class="el" href="group__flac__seekable__stream__encoder.html">seekable stream encoder</a> which supplies all callbacks internally; the user need specify only the filename.
94
Make sure to read the detailed description of the <a class="el" href="group__flac__seekable__stream__encoder.html">seekable stream encoder module</a> since the <a class="el" href="group__flac__stream__encoder.html">stream encoder module</a> since the file encoder inherits much of its behavior from them.
98
The "set" functions may only be called when the encoder is in the state FLAC__FILE_ENCODER_UNINITIALIZED, i.e. after <a class="el" href="group__flac__file__encoder.html#a2">FLAC__file_encoder_new</a>() or <a class="el" href="group__flac__file__encoder.html#a49">FLAC__file_encoder_finish</a>(), but before <a class="el" href="group__flac__file__encoder.html#a48">FLAC__file_encoder_init</a>(). If this is the case they will return <code>true</code>, otherwise <code>false</code>.</dl><dl compact><dt><b>
100
<a class="el" href="group__flac__file__encoder.html#a49">FLAC__file_encoder_finish</a>() resets all settings to the constructor defaults. </dl><hr><h2>Typedef Documentation</h2>
101
<a name="a1" doxytag="file_encoder.h::FLAC__FileEncoderProgressCallback"></a><p>
102
<table width="100%" cellpadding="2" cellspacing="0" border="0">
105
<table cellpadding="0" cellspacing="0" border="0">
107
<td class="md" nowrap valign="top"> typedef void(* FLAC__FileEncoderProgressCallback)(const <a class="el" href="structFLAC____FileEncoder.html">FLAC__FileEncoder</a> *encoder, FLAC__uint64 bytes_written, FLAC__uint64 samples_written, unsigned frames_written, unsigned total_frames_estimate, void *client_data)
112
<table cellspacing=5 cellpadding=0 border=0>
120
Signature for the progress callback. See <a class="el" href="group__flac__file__encoder.html#a23">FLAC__file_encoder_set_progress_callback</a>() for more info.<dl compact><dt><b>
122
<table border=0 cellspacing=2 cellpadding=0>
123
<tr><td valign=top><em>encoder</em> </td><td>
124
The encoder instance calling the callback. </td></tr>
125
<tr><td valign=top><em>bytes_written</em> </td><td>
126
Bytes written so far. </td></tr>
127
<tr><td valign=top><em>samples_written</em> </td><td>
128
Samples written so far. </td></tr>
129
<tr><td valign=top><em>frames_written</em> </td><td>
130
Frames written so far. </td></tr>
131
<tr><td valign=top><em>total_frames_estimate</em> </td><td>
132
The estimate of the total number of frames to be written. </td></tr>
133
<tr><td valign=top><em>client_data</em> </td><td>
134
The callee's client data set through <a class="el" href="group__flac__file__encoder.html#a24">FLAC__file_encoder_set_client_data</a>(). </td></tr>
139
<hr><h2>Enumeration Type Documentation</h2>
140
<a name="a52" doxytag="file_encoder.h::FLAC__FileEncoderState"></a><p>
141
<table width="100%" cellpadding="2" cellspacing="0" border="0">
144
<table cellpadding="0" cellspacing="0" border="0">
146
<td class="md" nowrap valign="top"> enum FLAC__FileEncoderState
151
<table cellspacing=5 cellpadding=0 border=0>
159
State values for a <a class="el" href="structFLAC____FileEncoder.html">FLAC__FileEncoder</a>
161
The encoder's state can be obtained by calling <a class="el" href="group__flac__file__encoder.html#a25">FLAC__file_encoder_get_state</a>(). <dl compact><dt><b>
162
Enumeration values:</b><dd>
163
<table border=0 cellspacing=2 cellpadding=0>
164
<tr><td valign=top><em><a name="a52a2" doxytag="FLAC__FILE_ENCODER_OK"></a><em>FLAC__FILE_ENCODER_OK</em></em> </td><td>
165
The encoder is in the normal OK state. </td></tr>
166
<tr><td valign=top><em><a name="a52a3" doxytag="FLAC__FILE_ENCODER_NO_FILENAME"></a><em>FLAC__FILE_ENCODER_NO_FILENAME</em></em> </td><td>
167
<a class="el" href="group__flac__file__encoder.html#a48">FLAC__file_encoder_init</a>() was called without first calling <a class="el" href="group__flac__file__encoder.html#a22">FLAC__file_encoder_set_filename</a>(). </td></tr>
168
<tr><td valign=top><em><a name="a52a4" doxytag="FLAC__FILE_ENCODER_SEEKABLE_STREAM_ENCODER_ERROR"></a><em>FLAC__FILE_ENCODER_SEEKABLE_STREAM_ENCODER_ERROR</em></em> </td><td>
169
An error occurred in the underlying seekable stream encoder; check <a class="el" href="group__flac__file__encoder.html#a26">FLAC__file_encoder_get_seekable_stream_encoder_state</a>(). </td></tr>
170
<tr><td valign=top><em><a name="a52a5" doxytag="FLAC__FILE_ENCODER_FATAL_ERROR_WHILE_WRITING"></a><em>FLAC__FILE_ENCODER_FATAL_ERROR_WHILE_WRITING</em></em> </td><td>
171
A fatal error occurred while writing to the encoded file. </td></tr>
172
<tr><td valign=top><em><a name="a52a6" doxytag="FLAC__FILE_ENCODER_ERROR_OPENING_FILE"></a><em>FLAC__FILE_ENCODER_ERROR_OPENING_FILE</em></em> </td><td>
173
An error occurred opening the output file for writing. </td></tr>
174
<tr><td valign=top><em><a name="a52a7" doxytag="FLAC__FILE_ENCODER_MEMORY_ALLOCATION_ERROR"></a><em>FLAC__FILE_ENCODER_MEMORY_ALLOCATION_ERROR</em></em> </td><td>
175
Memory allocation failed. </td></tr>
176
<tr><td valign=top><em><a name="a52a8" doxytag="FLAC__FILE_ENCODER_ALREADY_INITIALIZED"></a><em>FLAC__FILE_ENCODER_ALREADY_INITIALIZED</em></em> </td><td>
177
<a class="el" href="group__flac__file__encoder.html#a48">FLAC__file_encoder_init</a>() was called when the encoder was already initialized, usually because <a class="el" href="group__flac__file__encoder.html#a49">FLAC__file_encoder_finish</a>() was not called. </td></tr>
178
<tr><td valign=top><em><a name="a52a9" doxytag="FLAC__FILE_ENCODER_UNINITIALIZED"></a><em>FLAC__FILE_ENCODER_UNINITIALIZED</em></em> </td><td>
179
The encoder is in the uninitialized state. </td></tr>
185
<hr><h2>Function Documentation</h2>
186
<a name="a2" doxytag="file_encoder.h::FLAC__file_encoder_new"></a><p>
187
<table width="100%" cellpadding="2" cellspacing="0" border="0">
190
<table cellpadding="0" cellspacing="0" border="0">
192
<td class="md" nowrap valign="top"> <a class="el" href="structFLAC____FileEncoder.html">FLAC__FileEncoder</a>* FLAC__file_encoder_new </td>
193
<td class="md" valign="top">( </td>
194
<td class="mdname1" valign="top" nowrap> </td>
195
<td class="md" valign="top">) </td>
196
<td class="md" nowrap></td>
203
<table cellspacing=5 cellpadding=0 border=0>
211
Create a new file encoder instance. The instance is created with default settings; see the individual FLAC__file_encoder_set_*() functions for each setting's default.<dl compact><dt><b>
212
Return values: </b><dd>
213
<table border=0 cellspacing=2 cellpadding=0>
214
<tr><td valign=top><em><a class="el" href="structFLAC____FileEncoder.html">FLAC__FileEncoder</a></em> </td><td>
215
* <code>NULL</code> if there was an error allocating memory, else the new instance. </td></tr>
220
<a name="a3" doxytag="file_encoder.h::FLAC__file_encoder_delete"></a><p>
221
<table width="100%" cellpadding="2" cellspacing="0" border="0">
224
<table cellpadding="0" cellspacing="0" border="0">
226
<td class="md" nowrap valign="top"> void FLAC__file_encoder_delete </td>
227
<td class="md" valign="top">( </td>
228
<td class="md" nowrap valign="top"><a class="el" href="structFLAC____FileEncoder.html">FLAC__FileEncoder</a> * </td>
229
<td class="mdname1" valign="top" nowrap> <em>encoder</em> </td>
230
<td class="md" valign="top">) </td>
231
<td class="md" nowrap></td>
238
<table cellspacing=5 cellpadding=0 border=0>
246
Free an encoder instance. Deletes the object pointed to by <em>encoder</em>.<dl compact><dt><b>
248
<table border=0 cellspacing=2 cellpadding=0>
249
<tr><td valign=top><em>encoder</em> </td><td>
250
A pointer to an existing encoder. </td></tr>
252
</dl><dl compact><dt><b>
254
<div class="fragment"><pre>encoder != NULL
255
</pre></div> </dl> </td>
258
<a name="a4" doxytag="file_encoder.h::FLAC__file_encoder_set_verify"></a><p>
259
<table width="100%" cellpadding="2" cellspacing="0" border="0">
262
<table cellpadding="0" cellspacing="0" border="0">
264
<td class="md" nowrap valign="top"> FLAC__bool FLAC__file_encoder_set_verify </td>
265
<td class="md" valign="top">( </td>
266
<td class="md" nowrap valign="top"><a class="el" href="structFLAC____FileEncoder.html">FLAC__FileEncoder</a> * </td>
267
<td class="mdname" nowrap> <em>encoder</em>, </td>
272
<td class="md" nowrap>FLAC__bool </td>
273
<td class="mdname" nowrap> <em>value</em></td>
277
<td class="md">) </td>
278
<td class="md" colspan="2"></td>
285
<table cellspacing=5 cellpadding=0 border=0>
293
This is inherited from <a class="el" href="structFLAC____SeekableStreamEncoder.html">FLAC__SeekableStreamEncoder</a>; see <a class="el" href="group__flac__seekable__stream__encoder.html#a8">FLAC__seekable_stream_encoder_set_verify</a>().<dl compact><dt><b>
294
Default Value:</b><dd>
295
<code>true</code> </dl><dl compact><dt><b>
297
<table border=0 cellspacing=2 cellpadding=0>
298
<tr><td valign=top><em>encoder</em> </td><td>
299
An encoder instance to set. </td></tr>
300
<tr><td valign=top><em>value</em> </td><td>
301
See above. </td></tr>
303
</dl><dl compact><dt><b>
305
<div class="fragment"><pre>encoder != NULL
306
</pre></div> </dl><dl compact><dt><b>
307
Return values: </b><dd>
308
<table border=0 cellspacing=2 cellpadding=0>
309
<tr><td valign=top><em>FLAC__bool</em> </td><td>
310
<code>false</code> if the encoder is already initialized, else <code>true</code>. </td></tr>
315
<a name="a5" doxytag="file_encoder.h::FLAC__file_encoder_set_streamable_subset"></a><p>
316
<table width="100%" cellpadding="2" cellspacing="0" border="0">
319
<table cellpadding="0" cellspacing="0" border="0">
321
<td class="md" nowrap valign="top"> FLAC__bool FLAC__file_encoder_set_streamable_subset </td>
322
<td class="md" valign="top">( </td>
323
<td class="md" nowrap valign="top"><a class="el" href="structFLAC____FileEncoder.html">FLAC__FileEncoder</a> * </td>
324
<td class="mdname" nowrap> <em>encoder</em>, </td>
329
<td class="md" nowrap>FLAC__bool </td>
330
<td class="mdname" nowrap> <em>value</em></td>
334
<td class="md">) </td>
335
<td class="md" colspan="2"></td>
342
<table cellspacing=5 cellpadding=0 border=0>
350
This is inherited from <a class="el" href="structFLAC____SeekableStreamEncoder.html">FLAC__SeekableStreamEncoder</a>; see <a class="el" href="group__flac__seekable__stream__encoder.html#a9">FLAC__seekable_stream_encoder_set_streamable_subset</a>().<dl compact><dt><b>
351
Default Value:</b><dd>
352
<code>true</code> </dl><dl compact><dt><b>
354
<table border=0 cellspacing=2 cellpadding=0>
355
<tr><td valign=top><em>encoder</em> </td><td>
356
An encoder instance to set. </td></tr>
357
<tr><td valign=top><em>value</em> </td><td>
358
See above. </td></tr>
360
</dl><dl compact><dt><b>
362
<div class="fragment"><pre>encoder != NULL
363
</pre></div> </dl><dl compact><dt><b>
364
Return values: </b><dd>
365
<table border=0 cellspacing=2 cellpadding=0>
366
<tr><td valign=top><em>FLAC__bool</em> </td><td>
367
<code>false</code> if the encoder is already initialized, else <code>true</code>. </td></tr>
372
<a name="a6" doxytag="file_encoder.h::FLAC__file_encoder_set_do_mid_side_stereo"></a><p>
373
<table width="100%" cellpadding="2" cellspacing="0" border="0">
376
<table cellpadding="0" cellspacing="0" border="0">
378
<td class="md" nowrap valign="top"> FLAC__bool FLAC__file_encoder_set_do_mid_side_stereo </td>
379
<td class="md" valign="top">( </td>
380
<td class="md" nowrap valign="top"><a class="el" href="structFLAC____FileEncoder.html">FLAC__FileEncoder</a> * </td>
381
<td class="mdname" nowrap> <em>encoder</em>, </td>
386
<td class="md" nowrap>FLAC__bool </td>
387
<td class="mdname" nowrap> <em>value</em></td>
391
<td class="md">) </td>
392
<td class="md" colspan="2"></td>
399
<table cellspacing=5 cellpadding=0 border=0>
407
This is inherited from <a class="el" href="structFLAC____SeekableStreamEncoder.html">FLAC__SeekableStreamEncoder</a>; see <a class="el" href="group__flac__seekable__stream__encoder.html#a10">FLAC__seekable_stream_encoder_set_do_mid_side_stereo</a>().<dl compact><dt><b>
408
Default Value:</b><dd>
409
<code>false</code> </dl><dl compact><dt><b>
411
<table border=0 cellspacing=2 cellpadding=0>
412
<tr><td valign=top><em>encoder</em> </td><td>
413
An encoder instance to set. </td></tr>
414
<tr><td valign=top><em>value</em> </td><td>
415
See above. </td></tr>
417
</dl><dl compact><dt><b>
419
<div class="fragment"><pre>encoder != NULL
420
</pre></div> </dl><dl compact><dt><b>
421
Return values: </b><dd>
422
<table border=0 cellspacing=2 cellpadding=0>
423
<tr><td valign=top><em>FLAC__bool</em> </td><td>
424
<code>false</code> if the encoder is already initialized, else <code>true</code>. </td></tr>
429
<a name="a7" doxytag="file_encoder.h::FLAC__file_encoder_set_loose_mid_side_stereo"></a><p>
430
<table width="100%" cellpadding="2" cellspacing="0" border="0">
433
<table cellpadding="0" cellspacing="0" border="0">
435
<td class="md" nowrap valign="top"> FLAC__bool FLAC__file_encoder_set_loose_mid_side_stereo </td>
436
<td class="md" valign="top">( </td>
437
<td class="md" nowrap valign="top"><a class="el" href="structFLAC____FileEncoder.html">FLAC__FileEncoder</a> * </td>
438
<td class="mdname" nowrap> <em>encoder</em>, </td>
443
<td class="md" nowrap>FLAC__bool </td>
444
<td class="mdname" nowrap> <em>value</em></td>
448
<td class="md">) </td>
449
<td class="md" colspan="2"></td>
456
<table cellspacing=5 cellpadding=0 border=0>
464
This is inherited from <a class="el" href="structFLAC____SeekableStreamEncoder.html">FLAC__SeekableStreamEncoder</a>; see <a class="el" href="group__flac__seekable__stream__encoder.html#a11">FLAC__seekable_stream_encoder_set_loose_mid_side_stereo</a>().<dl compact><dt><b>
465
Default Value:</b><dd>
466
<code>false</code> </dl><dl compact><dt><b>
468
<table border=0 cellspacing=2 cellpadding=0>
469
<tr><td valign=top><em>encoder</em> </td><td>
470
An encoder instance to set. </td></tr>
471
<tr><td valign=top><em>value</em> </td><td>
472
See above. </td></tr>
474
</dl><dl compact><dt><b>
476
<div class="fragment"><pre>encoder != NULL
477
</pre></div> </dl><dl compact><dt><b>
478
Return values: </b><dd>
479
<table border=0 cellspacing=2 cellpadding=0>
480
<tr><td valign=top><em>FLAC__bool</em> </td><td>
481
<code>false</code> if the encoder is already initialized, else <code>true</code>. </td></tr>
486
<a name="a8" doxytag="file_encoder.h::FLAC__file_encoder_set_channels"></a><p>
487
<table width="100%" cellpadding="2" cellspacing="0" border="0">
490
<table cellpadding="0" cellspacing="0" border="0">
492
<td class="md" nowrap valign="top"> FLAC__bool FLAC__file_encoder_set_channels </td>
493
<td class="md" valign="top">( </td>
494
<td class="md" nowrap valign="top"><a class="el" href="structFLAC____FileEncoder.html">FLAC__FileEncoder</a> * </td>
495
<td class="mdname" nowrap> <em>encoder</em>, </td>
500
<td class="md" nowrap>unsigned </td>
501
<td class="mdname" nowrap> <em>value</em></td>
505
<td class="md">) </td>
506
<td class="md" colspan="2"></td>
513
<table cellspacing=5 cellpadding=0 border=0>
521
This is inherited from <a class="el" href="structFLAC____SeekableStreamEncoder.html">FLAC__SeekableStreamEncoder</a>; see <a class="el" href="group__flac__seekable__stream__encoder.html#a12">FLAC__seekable_stream_encoder_set_channels</a>().<dl compact><dt><b>
522
Default Value:</b><dd>
523
<code>2</code> </dl><dl compact><dt><b>
525
<table border=0 cellspacing=2 cellpadding=0>
526
<tr><td valign=top><em>encoder</em> </td><td>
527
An encoder instance to set. </td></tr>
528
<tr><td valign=top><em>value</em> </td><td>
529
See above. </td></tr>
531
</dl><dl compact><dt><b>
533
<div class="fragment"><pre>encoder != NULL
534
</pre></div> </dl><dl compact><dt><b>
535
Return values: </b><dd>
536
<table border=0 cellspacing=2 cellpadding=0>
537
<tr><td valign=top><em>FLAC__bool</em> </td><td>
538
<code>false</code> if the encoder is already initialized, else <code>true</code>. </td></tr>
543
<a name="a9" doxytag="file_encoder.h::FLAC__file_encoder_set_bits_per_sample"></a><p>
544
<table width="100%" cellpadding="2" cellspacing="0" border="0">
547
<table cellpadding="0" cellspacing="0" border="0">
549
<td class="md" nowrap valign="top"> FLAC__bool FLAC__file_encoder_set_bits_per_sample </td>
550
<td class="md" valign="top">( </td>
551
<td class="md" nowrap valign="top"><a class="el" href="structFLAC____FileEncoder.html">FLAC__FileEncoder</a> * </td>
552
<td class="mdname" nowrap> <em>encoder</em>, </td>
557
<td class="md" nowrap>unsigned </td>
558
<td class="mdname" nowrap> <em>value</em></td>
562
<td class="md">) </td>
563
<td class="md" colspan="2"></td>
570
<table cellspacing=5 cellpadding=0 border=0>
578
This is inherited from <a class="el" href="structFLAC____SeekableStreamEncoder.html">FLAC__SeekableStreamEncoder</a>; see <a class="el" href="group__flac__seekable__stream__encoder.html#a13">FLAC__seekable_stream_encoder_set_bits_per_sample</a>().
582
Do not feed the encoder data that is wider than the value you set here or you will generate an invalid stream.</dl><dl compact><dt><b>
583
Default Value:</b><dd>
584
<code>16</code> </dl><dl compact><dt><b>
586
<table border=0 cellspacing=2 cellpadding=0>
587
<tr><td valign=top><em>encoder</em> </td><td>
588
An encoder instance to set. </td></tr>
589
<tr><td valign=top><em>value</em> </td><td>
590
See above. </td></tr>
592
</dl><dl compact><dt><b>
594
<div class="fragment"><pre>encoder != NULL
595
</pre></div> </dl><dl compact><dt><b>
596
Return values: </b><dd>
597
<table border=0 cellspacing=2 cellpadding=0>
598
<tr><td valign=top><em>FLAC__bool</em> </td><td>
599
<code>false</code> if the encoder is already initialized, else <code>true</code>. </td></tr>
604
<a name="a10" doxytag="file_encoder.h::FLAC__file_encoder_set_sample_rate"></a><p>
605
<table width="100%" cellpadding="2" cellspacing="0" border="0">
608
<table cellpadding="0" cellspacing="0" border="0">
610
<td class="md" nowrap valign="top"> FLAC__bool FLAC__file_encoder_set_sample_rate </td>
611
<td class="md" valign="top">( </td>
612
<td class="md" nowrap valign="top"><a class="el" href="structFLAC____FileEncoder.html">FLAC__FileEncoder</a> * </td>
613
<td class="mdname" nowrap> <em>encoder</em>, </td>
618
<td class="md" nowrap>unsigned </td>
619
<td class="mdname" nowrap> <em>value</em></td>
623
<td class="md">) </td>
624
<td class="md" colspan="2"></td>
631
<table cellspacing=5 cellpadding=0 border=0>
639
This is inherited from <a class="el" href="structFLAC____SeekableStreamEncoder.html">FLAC__SeekableStreamEncoder</a>; see <a class="el" href="group__flac__seekable__stream__encoder.html#a14">FLAC__seekable_stream_encoder_set_sample_rate</a>().<dl compact><dt><b>
640
Default Value:</b><dd>
641
<code>44100</code> </dl><dl compact><dt><b>
643
<table border=0 cellspacing=2 cellpadding=0>
644
<tr><td valign=top><em>encoder</em> </td><td>
645
An encoder instance to set. </td></tr>
646
<tr><td valign=top><em>value</em> </td><td>
647
See above. </td></tr>
649
</dl><dl compact><dt><b>
651
<div class="fragment"><pre>encoder != NULL
652
</pre></div> </dl><dl compact><dt><b>
653
Return values: </b><dd>
654
<table border=0 cellspacing=2 cellpadding=0>
655
<tr><td valign=top><em>FLAC__bool</em> </td><td>
656
<code>false</code> if the encoder is already initialized, else <code>true</code>. </td></tr>
661
<a name="a11" doxytag="file_encoder.h::FLAC__file_encoder_set_blocksize"></a><p>
662
<table width="100%" cellpadding="2" cellspacing="0" border="0">
665
<table cellpadding="0" cellspacing="0" border="0">
667
<td class="md" nowrap valign="top"> FLAC__bool FLAC__file_encoder_set_blocksize </td>
668
<td class="md" valign="top">( </td>
669
<td class="md" nowrap valign="top"><a class="el" href="structFLAC____FileEncoder.html">FLAC__FileEncoder</a> * </td>
670
<td class="mdname" nowrap> <em>encoder</em>, </td>
675
<td class="md" nowrap>unsigned </td>
676
<td class="mdname" nowrap> <em>value</em></td>
680
<td class="md">) </td>
681
<td class="md" colspan="2"></td>
688
<table cellspacing=5 cellpadding=0 border=0>
696
This is inherited from <a class="el" href="structFLAC____SeekableStreamEncoder.html">FLAC__SeekableStreamEncoder</a>; see <a class="el" href="group__flac__seekable__stream__encoder.html#a15">FLAC__seekable_stream_encoder_set_blocksize</a>().<dl compact><dt><b>
697
Default Value:</b><dd>
698
<code>1152</code> </dl><dl compact><dt><b>
700
<table border=0 cellspacing=2 cellpadding=0>
701
<tr><td valign=top><em>encoder</em> </td><td>
702
An encoder instance to set. </td></tr>
703
<tr><td valign=top><em>value</em> </td><td>
704
See above. </td></tr>
706
</dl><dl compact><dt><b>
708
<div class="fragment"><pre>encoder != NULL
709
</pre></div> </dl><dl compact><dt><b>
710
Return values: </b><dd>
711
<table border=0 cellspacing=2 cellpadding=0>
712
<tr><td valign=top><em>FLAC__bool</em> </td><td>
713
<code>false</code> if the encoder is already initialized, else <code>true</code>. </td></tr>
718
<a name="a12" doxytag="file_encoder.h::FLAC__file_encoder_set_max_lpc_order"></a><p>
719
<table width="100%" cellpadding="2" cellspacing="0" border="0">
722
<table cellpadding="0" cellspacing="0" border="0">
724
<td class="md" nowrap valign="top"> FLAC__bool FLAC__file_encoder_set_max_lpc_order </td>
725
<td class="md" valign="top">( </td>
726
<td class="md" nowrap valign="top"><a class="el" href="structFLAC____FileEncoder.html">FLAC__FileEncoder</a> * </td>
727
<td class="mdname" nowrap> <em>encoder</em>, </td>
732
<td class="md" nowrap>unsigned </td>
733
<td class="mdname" nowrap> <em>value</em></td>
737
<td class="md">) </td>
738
<td class="md" colspan="2"></td>
745
<table cellspacing=5 cellpadding=0 border=0>
753
This is inherited from <a class="el" href="structFLAC____SeekableStreamEncoder.html">FLAC__SeekableStreamEncoder</a>; see <a class="el" href="group__flac__seekable__stream__encoder.html#a16">FLAC__seekable_stream_encoder_set_max_lpc_order</a>().<dl compact><dt><b>
754
Default Value:</b><dd>
755
<code>0</code> </dl><dl compact><dt><b>
757
<table border=0 cellspacing=2 cellpadding=0>
758
<tr><td valign=top><em>encoder</em> </td><td>
759
An encoder instance to set. </td></tr>
760
<tr><td valign=top><em>value</em> </td><td>
761
See above. </td></tr>
763
</dl><dl compact><dt><b>
765
<div class="fragment"><pre>encoder != NULL
766
</pre></div> </dl><dl compact><dt><b>
767
Return values: </b><dd>
768
<table border=0 cellspacing=2 cellpadding=0>
769
<tr><td valign=top><em>FLAC__bool</em> </td><td>
770
<code>false</code> if the encoder is already initialized, else <code>true</code>. </td></tr>
775
<a name="a13" doxytag="file_encoder.h::FLAC__file_encoder_set_qlp_coeff_precision"></a><p>
776
<table width="100%" cellpadding="2" cellspacing="0" border="0">
779
<table cellpadding="0" cellspacing="0" border="0">
781
<td class="md" nowrap valign="top"> FLAC__bool FLAC__file_encoder_set_qlp_coeff_precision </td>
782
<td class="md" valign="top">( </td>
783
<td class="md" nowrap valign="top"><a class="el" href="structFLAC____FileEncoder.html">FLAC__FileEncoder</a> * </td>
784
<td class="mdname" nowrap> <em>encoder</em>, </td>
789
<td class="md" nowrap>unsigned </td>
790
<td class="mdname" nowrap> <em>value</em></td>
794
<td class="md">) </td>
795
<td class="md" colspan="2"></td>
802
<table cellspacing=5 cellpadding=0 border=0>
810
This is inherited from <a class="el" href="structFLAC____SeekableStreamEncoder.html">FLAC__SeekableStreamEncoder</a>; see <a class="el" href="group__flac__seekable__stream__encoder.html#a17">FLAC__seekable_stream_encoder_set_qlp_coeff_precision</a>().
814
In the current implementation, qlp_coeff_precision + bits_per_sample must be less than 32.</dl><dl compact><dt><b>
815
Default Value:</b><dd>
816
<code>0</code> </dl><dl compact><dt><b>
818
<table border=0 cellspacing=2 cellpadding=0>
819
<tr><td valign=top><em>encoder</em> </td><td>
820
An encoder instance to set. </td></tr>
821
<tr><td valign=top><em>value</em> </td><td>
822
See above. </td></tr>
824
</dl><dl compact><dt><b>
826
<div class="fragment"><pre>encoder != NULL
827
</pre></div> </dl><dl compact><dt><b>
828
Return values: </b><dd>
829
<table border=0 cellspacing=2 cellpadding=0>
830
<tr><td valign=top><em>FLAC__bool</em> </td><td>
831
<code>false</code> if the encoder is already initialized, else <code>true</code>. </td></tr>
836
<a name="a14" doxytag="file_encoder.h::FLAC__file_encoder_set_do_qlp_coeff_prec_search"></a><p>
837
<table width="100%" cellpadding="2" cellspacing="0" border="0">
840
<table cellpadding="0" cellspacing="0" border="0">
842
<td class="md" nowrap valign="top"> FLAC__bool FLAC__file_encoder_set_do_qlp_coeff_prec_search </td>
843
<td class="md" valign="top">( </td>
844
<td class="md" nowrap valign="top"><a class="el" href="structFLAC____FileEncoder.html">FLAC__FileEncoder</a> * </td>
845
<td class="mdname" nowrap> <em>encoder</em>, </td>
850
<td class="md" nowrap>FLAC__bool </td>
851
<td class="mdname" nowrap> <em>value</em></td>
855
<td class="md">) </td>
856
<td class="md" colspan="2"></td>
863
<table cellspacing=5 cellpadding=0 border=0>
871
This is inherited from <a class="el" href="structFLAC____SeekableStreamEncoder.html">FLAC__SeekableStreamEncoder</a>; see <a class="el" href="group__flac__seekable__stream__encoder.html#a18">FLAC__seekable_stream_encoder_set_do_qlp_coeff_prec_search</a>().<dl compact><dt><b>
872
Default Value:</b><dd>
873
<code>false</code> </dl><dl compact><dt><b>
875
<table border=0 cellspacing=2 cellpadding=0>
876
<tr><td valign=top><em>encoder</em> </td><td>
877
An encoder instance to set. </td></tr>
878
<tr><td valign=top><em>value</em> </td><td>
879
See above. </td></tr>
881
</dl><dl compact><dt><b>
883
<div class="fragment"><pre>encoder != NULL
884
</pre></div> </dl><dl compact><dt><b>
885
Return values: </b><dd>
886
<table border=0 cellspacing=2 cellpadding=0>
887
<tr><td valign=top><em>FLAC__bool</em> </td><td>
888
<code>false</code> if the encoder is already initialized, else <code>true</code>. </td></tr>
893
<a name="a15" doxytag="file_encoder.h::FLAC__file_encoder_set_do_escape_coding"></a><p>
894
<table width="100%" cellpadding="2" cellspacing="0" border="0">
897
<table cellpadding="0" cellspacing="0" border="0">
899
<td class="md" nowrap valign="top"> FLAC__bool FLAC__file_encoder_set_do_escape_coding </td>
900
<td class="md" valign="top">( </td>
901
<td class="md" nowrap valign="top"><a class="el" href="structFLAC____FileEncoder.html">FLAC__FileEncoder</a> * </td>
902
<td class="mdname" nowrap> <em>encoder</em>, </td>
907
<td class="md" nowrap>FLAC__bool </td>
908
<td class="mdname" nowrap> <em>value</em></td>
912
<td class="md">) </td>
913
<td class="md" colspan="2"></td>
920
<table cellspacing=5 cellpadding=0 border=0>
928
This is inherited from <a class="el" href="structFLAC____SeekableStreamEncoder.html">FLAC__SeekableStreamEncoder</a>; see <a class="el" href="group__flac__seekable__stream__encoder.html#a19">FLAC__seekable_stream_encoder_set_do_escape_coding</a>().<dl compact><dt><b>
929
Default Value:</b><dd>
930
<code>false</code> </dl><dl compact><dt><b>
932
<table border=0 cellspacing=2 cellpadding=0>
933
<tr><td valign=top><em>encoder</em> </td><td>
934
An encoder instance to set. </td></tr>
935
<tr><td valign=top><em>value</em> </td><td>
936
See above. </td></tr>
938
</dl><dl compact><dt><b>
940
<div class="fragment"><pre>encoder != NULL
941
</pre></div> </dl><dl compact><dt><b>
942
Return values: </b><dd>
943
<table border=0 cellspacing=2 cellpadding=0>
944
<tr><td valign=top><em>FLAC__bool</em> </td><td>
945
<code>false</code> if the encoder is already initialized, else <code>true</code>. </td></tr>
950
<a name="a16" doxytag="file_encoder.h::FLAC__file_encoder_set_do_exhaustive_model_search"></a><p>
951
<table width="100%" cellpadding="2" cellspacing="0" border="0">
954
<table cellpadding="0" cellspacing="0" border="0">
956
<td class="md" nowrap valign="top"> FLAC__bool FLAC__file_encoder_set_do_exhaustive_model_search </td>
957
<td class="md" valign="top">( </td>
958
<td class="md" nowrap valign="top"><a class="el" href="structFLAC____FileEncoder.html">FLAC__FileEncoder</a> * </td>
959
<td class="mdname" nowrap> <em>encoder</em>, </td>
964
<td class="md" nowrap>FLAC__bool </td>
965
<td class="mdname" nowrap> <em>value</em></td>
969
<td class="md">) </td>
970
<td class="md" colspan="2"></td>
977
<table cellspacing=5 cellpadding=0 border=0>
985
This is inherited from <a class="el" href="structFLAC____SeekableStreamEncoder.html">FLAC__SeekableStreamEncoder</a>; see <a class="el" href="group__flac__seekable__stream__encoder.html#a20">FLAC__seekable_stream_encoder_set_do_exhaustive_model_search</a>().<dl compact><dt><b>
986
Default Value:</b><dd>
987
<code>false</code> </dl><dl compact><dt><b>
989
<table border=0 cellspacing=2 cellpadding=0>
990
<tr><td valign=top><em>encoder</em> </td><td>
991
An encoder instance to set. </td></tr>
992
<tr><td valign=top><em>value</em> </td><td>
993
See above. </td></tr>
995
</dl><dl compact><dt><b>
997
<div class="fragment"><pre>encoder != NULL
998
</pre></div> </dl><dl compact><dt><b>
999
Return values: </b><dd>
1000
<table border=0 cellspacing=2 cellpadding=0>
1001
<tr><td valign=top><em>FLAC__bool</em> </td><td>
1002
<code>false</code> if the encoder is already initialized, else <code>true</code>. </td></tr>
1007
<a name="a17" doxytag="file_encoder.h::FLAC__file_encoder_set_min_residual_partition_order"></a><p>
1008
<table width="100%" cellpadding="2" cellspacing="0" border="0">
1011
<table cellpadding="0" cellspacing="0" border="0">
1013
<td class="md" nowrap valign="top"> FLAC__bool FLAC__file_encoder_set_min_residual_partition_order </td>
1014
<td class="md" valign="top">( </td>
1015
<td class="md" nowrap valign="top"><a class="el" href="structFLAC____FileEncoder.html">FLAC__FileEncoder</a> * </td>
1016
<td class="mdname" nowrap> <em>encoder</em>, </td>
1021
<td class="md" nowrap>unsigned </td>
1022
<td class="mdname" nowrap> <em>value</em></td>
1026
<td class="md">) </td>
1027
<td class="md" colspan="2"></td>
1034
<table cellspacing=5 cellpadding=0 border=0>
1042
This is inherited from <a class="el" href="structFLAC____SeekableStreamEncoder.html">FLAC__SeekableStreamEncoder</a>; see <a class="el" href="group__flac__seekable__stream__encoder.html#a21">FLAC__seekable_stream_encoder_set_min_residual_partition_order</a>().<dl compact><dt><b>
1043
Default Value:</b><dd>
1044
<code>0</code> </dl><dl compact><dt><b>
1045
Parameters: </b><dd>
1046
<table border=0 cellspacing=2 cellpadding=0>
1047
<tr><td valign=top><em>encoder</em> </td><td>
1048
An encoder instance to set. </td></tr>
1049
<tr><td valign=top><em>value</em> </td><td>
1050
See above. </td></tr>
1052
</dl><dl compact><dt><b>
1054
<div class="fragment"><pre>encoder != NULL
1055
</pre></div> </dl><dl compact><dt><b>
1056
Return values: </b><dd>
1057
<table border=0 cellspacing=2 cellpadding=0>
1058
<tr><td valign=top><em>FLAC__bool</em> </td><td>
1059
<code>false</code> if the encoder is already initialized, else <code>true</code>. </td></tr>
1064
<a name="a18" doxytag="file_encoder.h::FLAC__file_encoder_set_max_residual_partition_order"></a><p>
1065
<table width="100%" cellpadding="2" cellspacing="0" border="0">
1068
<table cellpadding="0" cellspacing="0" border="0">
1070
<td class="md" nowrap valign="top"> FLAC__bool FLAC__file_encoder_set_max_residual_partition_order </td>
1071
<td class="md" valign="top">( </td>
1072
<td class="md" nowrap valign="top"><a class="el" href="structFLAC____FileEncoder.html">FLAC__FileEncoder</a> * </td>
1073
<td class="mdname" nowrap> <em>encoder</em>, </td>
1078
<td class="md" nowrap>unsigned </td>
1079
<td class="mdname" nowrap> <em>value</em></td>
1083
<td class="md">) </td>
1084
<td class="md" colspan="2"></td>
1091
<table cellspacing=5 cellpadding=0 border=0>
1099
This is inherited from <a class="el" href="structFLAC____SeekableStreamEncoder.html">FLAC__SeekableStreamEncoder</a>; see <a class="el" href="group__flac__seekable__stream__encoder.html#a22">FLAC__seekable_stream_encoder_set_max_residual_partition_order</a>().<dl compact><dt><b>
1100
Default Value:</b><dd>
1101
<code>0</code> </dl><dl compact><dt><b>
1102
Parameters: </b><dd>
1103
<table border=0 cellspacing=2 cellpadding=0>
1104
<tr><td valign=top><em>encoder</em> </td><td>
1105
An encoder instance to set. </td></tr>
1106
<tr><td valign=top><em>value</em> </td><td>
1107
See above. </td></tr>
1109
</dl><dl compact><dt><b>
1111
<div class="fragment"><pre>encoder != NULL
1112
</pre></div> </dl><dl compact><dt><b>
1113
Return values: </b><dd>
1114
<table border=0 cellspacing=2 cellpadding=0>
1115
<tr><td valign=top><em>FLAC__bool</em> </td><td>
1116
<code>false</code> if the encoder is already initialized, else <code>true</code>. </td></tr>
1121
<a name="a19" doxytag="file_encoder.h::FLAC__file_encoder_set_rice_parameter_search_dist"></a><p>
1122
<table width="100%" cellpadding="2" cellspacing="0" border="0">
1125
<table cellpadding="0" cellspacing="0" border="0">
1127
<td class="md" nowrap valign="top"> FLAC__bool FLAC__file_encoder_set_rice_parameter_search_dist </td>
1128
<td class="md" valign="top">( </td>
1129
<td class="md" nowrap valign="top"><a class="el" href="structFLAC____FileEncoder.html">FLAC__FileEncoder</a> * </td>
1130
<td class="mdname" nowrap> <em>encoder</em>, </td>
1135
<td class="md" nowrap>unsigned </td>
1136
<td class="mdname" nowrap> <em>value</em></td>
1140
<td class="md">) </td>
1141
<td class="md" colspan="2"></td>
1148
<table cellspacing=5 cellpadding=0 border=0>
1156
This is inherited from <a class="el" href="structFLAC____SeekableStreamEncoder.html">FLAC__SeekableStreamEncoder</a>; see <a class="el" href="group__flac__seekable__stream__encoder.html#a23">FLAC__seekable_stream_encoder_set_rice_parameter_search_dist</a>().<dl compact><dt><b>
1157
Default Value:</b><dd>
1158
<code>0</code> </dl><dl compact><dt><b>
1159
Parameters: </b><dd>
1160
<table border=0 cellspacing=2 cellpadding=0>
1161
<tr><td valign=top><em>encoder</em> </td><td>
1162
An encoder instance to set. </td></tr>
1163
<tr><td valign=top><em>value</em> </td><td>
1164
See above. </td></tr>
1166
</dl><dl compact><dt><b>
1168
<div class="fragment"><pre>encoder != NULL
1169
</pre></div> </dl><dl compact><dt><b>
1170
Return values: </b><dd>
1171
<table border=0 cellspacing=2 cellpadding=0>
1172
<tr><td valign=top><em>FLAC__bool</em> </td><td>
1173
<code>false</code> if the encoder is already initialized, else <code>true</code>. </td></tr>
1178
<a name="a20" doxytag="file_encoder.h::FLAC__file_encoder_set_total_samples_estimate"></a><p>
1179
<table width="100%" cellpadding="2" cellspacing="0" border="0">
1182
<table cellpadding="0" cellspacing="0" border="0">
1184
<td class="md" nowrap valign="top"> FLAC__bool FLAC__file_encoder_set_total_samples_estimate </td>
1185
<td class="md" valign="top">( </td>
1186
<td class="md" nowrap valign="top"><a class="el" href="structFLAC____FileEncoder.html">FLAC__FileEncoder</a> * </td>
1187
<td class="mdname" nowrap> <em>encoder</em>, </td>
1192
<td class="md" nowrap>FLAC__uint64 </td>
1193
<td class="mdname" nowrap> <em>value</em></td>
1197
<td class="md">) </td>
1198
<td class="md" colspan="2"></td>
1205
<table cellspacing=5 cellpadding=0 border=0>
1213
This is inherited from <a class="el" href="structFLAC____SeekableStreamEncoder.html">FLAC__SeekableStreamEncoder</a>; see <a class="el" href="group__flac__seekable__stream__encoder.html#a24">FLAC__seekable_stream_encoder_set_total_samples_estimate</a>().<dl compact><dt><b>
1214
Default Value:</b><dd>
1215
<code>0</code> </dl><dl compact><dt><b>
1216
Parameters: </b><dd>
1217
<table border=0 cellspacing=2 cellpadding=0>
1218
<tr><td valign=top><em>encoder</em> </td><td>
1219
An encoder instance to set. </td></tr>
1220
<tr><td valign=top><em>value</em> </td><td>
1221
See above. </td></tr>
1223
</dl><dl compact><dt><b>
1225
<div class="fragment"><pre>encoder != NULL
1226
</pre></div> </dl><dl compact><dt><b>
1227
Return values: </b><dd>
1228
<table border=0 cellspacing=2 cellpadding=0>
1229
<tr><td valign=top><em>FLAC__bool</em> </td><td>
1230
<code>false</code> if the encoder is already initialized, else <code>true</code>. </td></tr>
1235
<a name="a21" doxytag="file_encoder.h::FLAC__file_encoder_set_metadata"></a><p>
1236
<table width="100%" cellpadding="2" cellspacing="0" border="0">
1239
<table cellpadding="0" cellspacing="0" border="0">
1241
<td class="md" nowrap valign="top"> FLAC__bool FLAC__file_encoder_set_metadata </td>
1242
<td class="md" valign="top">( </td>
1243
<td class="md" nowrap valign="top"><a class="el" href="structFLAC____FileEncoder.html">FLAC__FileEncoder</a> * </td>
1244
<td class="mdname" nowrap> <em>encoder</em>, </td>
1249
<td class="md" nowrap><a class="el" href="structFLAC____StreamMetadata.html">FLAC__StreamMetadata</a> ** </td>
1250
<td class="mdname" nowrap> <em>metadata</em>, </td>
1255
<td class="md" nowrap>unsigned </td>
1256
<td class="mdname" nowrap> <em>num_blocks</em></td>
1260
<td class="md">) </td>
1261
<td class="md" colspan="2"></td>
1268
<table cellspacing=5 cellpadding=0 border=0>
1276
This is inherited from <a class="el" href="structFLAC____SeekableStreamEncoder.html">FLAC__SeekableStreamEncoder</a>; see <a class="el" href="group__flac__seekable__stream__encoder.html#a25">FLAC__seekable_stream_encoder_set_metadata</a>().<dl compact><dt><b>
1277
Default Value:</b><dd>
1278
<code>NULL</code>, 0 </dl><dl compact><dt><b>
1279
Parameters: </b><dd>
1280
<table border=0 cellspacing=2 cellpadding=0>
1281
<tr><td valign=top><em>encoder</em> </td><td>
1282
An encoder instance to set. </td></tr>
1283
<tr><td valign=top><em>metadata</em> </td><td>
1284
See above. </td></tr>
1285
<tr><td valign=top><em>num_blocks</em> </td><td>
1286
See above. </td></tr>
1288
</dl><dl compact><dt><b>
1290
<div class="fragment"><pre>encoder != NULL
1291
</pre></div> </dl><dl compact><dt><b>
1292
Return values: </b><dd>
1293
<table border=0 cellspacing=2 cellpadding=0>
1294
<tr><td valign=top><em>FLAC__bool</em> </td><td>
1295
<code>false</code> if the encoder is already initialized, else <code>true</code>. </td></tr>
1300
<a name="a22" doxytag="file_encoder.h::FLAC__file_encoder_set_filename"></a><p>
1301
<table width="100%" cellpadding="2" cellspacing="0" border="0">
1304
<table cellpadding="0" cellspacing="0" border="0">
1306
<td class="md" nowrap valign="top"> FLAC__bool FLAC__file_encoder_set_filename </td>
1307
<td class="md" valign="top">( </td>
1308
<td class="md" nowrap valign="top"><a class="el" href="structFLAC____FileEncoder.html">FLAC__FileEncoder</a> * </td>
1309
<td class="mdname" nowrap> <em>encoder</em>, </td>
1314
<td class="md" nowrap>const char * </td>
1315
<td class="mdname" nowrap> <em>value</em></td>
1319
<td class="md">) </td>
1320
<td class="md" colspan="2"></td>
1327
<table cellspacing=5 cellpadding=0 border=0>
1335
Set the output file name encode to.
1339
The filename is mandatory and must be set before initialization.</dl><dl compact><dt><b>
1341
Unlike the <a class="el" href="structFLAC____FileDecoder.html">FLAC__FileDecoder</a>, the filename does not interpret "-" for <code>stdout</code>; writing to <code>stdout</code> is not relevant in the file encoder.</dl><dl compact><dt><b>
1342
Default Value:</b><dd>
1343
<code>NULL</code> </dl><dl compact><dt><b>
1344
Parameters: </b><dd>
1345
<table border=0 cellspacing=2 cellpadding=0>
1346
<tr><td valign=top><em>encoder</em> </td><td>
1347
A encoder instance to set. </td></tr>
1348
<tr><td valign=top><em>value</em> </td><td>
1349
The output file name. </td></tr>
1351
</dl><dl compact><dt><b>
1353
<div class="fragment"><pre>encoder != NULL
1354
</pre></div> <div class="fragment"><pre>value != NULL
1355
</pre></div> </dl><dl compact><dt><b>
1356
Return values: </b><dd>
1357
<table border=0 cellspacing=2 cellpadding=0>
1358
<tr><td valign=top><em>FLAC__bool</em> </td><td>
1359
<code>false</code> if the encoder is already initialized, or there was a memory allocation error, else <code>true</code>. </td></tr>
1364
<a name="a23" doxytag="file_encoder.h::FLAC__file_encoder_set_progress_callback"></a><p>
1365
<table width="100%" cellpadding="2" cellspacing="0" border="0">
1368
<table cellpadding="0" cellspacing="0" border="0">
1370
<td class="md" nowrap valign="top"> FLAC__bool FLAC__file_encoder_set_progress_callback </td>
1371
<td class="md" valign="top">( </td>
1372
<td class="md" nowrap valign="top"><a class="el" href="structFLAC____FileEncoder.html">FLAC__FileEncoder</a> * </td>
1373
<td class="mdname" nowrap> <em>encoder</em>, </td>
1378
<td class="md" nowrap><a class="el" href="group__flac__file__encoder.html#a1">FLAC__FileEncoderProgressCallback</a> </td>
1379
<td class="mdname" nowrap> <em>value</em></td>
1383
<td class="md">) </td>
1384
<td class="md" colspan="2"></td>
1391
<table cellspacing=5 cellpadding=0 border=0>
1399
Set the progress callback. The supplied function will be called when the encoder has finished writing a frame. The <code>total_frames_estimate</code> argument to the callback will be based on the value from <a class="el" href="group__flac__file__encoder.html#a20">FLAC__file_encoder_set_total_samples_estimate</a>().
1403
Unlike most other callbacks, the progress callback is <b>not</b> mandatory and need not be set before initialization.</dl><dl compact><dt><b>
1404
Default Value:</b><dd>
1405
<code>NULL</code> </dl><dl compact><dt><b>
1406
Parameters: </b><dd>
1407
<table border=0 cellspacing=2 cellpadding=0>
1408
<tr><td valign=top><em>encoder</em> </td><td>
1409
An encoder instance to set. </td></tr>
1410
<tr><td valign=top><em>value</em> </td><td>
1411
See above. </td></tr>
1413
</dl><dl compact><dt><b>
1415
<div class="fragment"><pre>encoder != NULL
1416
</pre></div> <div class="fragment"><pre>value != NULL
1417
</pre></div> </dl><dl compact><dt><b>
1418
Return values: </b><dd>
1419
<table border=0 cellspacing=2 cellpadding=0>
1420
<tr><td valign=top><em>FLAC__bool</em> </td><td>
1421
<code>false</code> if the encoder is already initialized, else <code>true</code>. </td></tr>
1426
<a name="a24" doxytag="file_encoder.h::FLAC__file_encoder_set_client_data"></a><p>
1427
<table width="100%" cellpadding="2" cellspacing="0" border="0">
1430
<table cellpadding="0" cellspacing="0" border="0">
1432
<td class="md" nowrap valign="top"> FLAC__bool FLAC__file_encoder_set_client_data </td>
1433
<td class="md" valign="top">( </td>
1434
<td class="md" nowrap valign="top"><a class="el" href="structFLAC____FileEncoder.html">FLAC__FileEncoder</a> * </td>
1435
<td class="mdname" nowrap> <em>encoder</em>, </td>
1440
<td class="md" nowrap>void * </td>
1441
<td class="mdname" nowrap> <em>value</em></td>
1445
<td class="md">) </td>
1446
<td class="md" colspan="2"></td>
1453
<table cellspacing=5 cellpadding=0 border=0>
1461
Set the client data to be passed back to callbacks. This value will be supplied to callbacks in their <em>client_data</em> argument.<dl compact><dt><b>
1462
Default Value:</b><dd>
1463
<code>NULL</code> </dl><dl compact><dt><b>
1464
Parameters: </b><dd>
1465
<table border=0 cellspacing=2 cellpadding=0>
1466
<tr><td valign=top><em>encoder</em> </td><td>
1467
An encoder instance to set. </td></tr>
1468
<tr><td valign=top><em>value</em> </td><td>
1469
See above. </td></tr>
1471
</dl><dl compact><dt><b>
1473
<div class="fragment"><pre>encoder != NULL
1474
</pre></div> </dl><dl compact><dt><b>
1475
Return values: </b><dd>
1476
<table border=0 cellspacing=2 cellpadding=0>
1477
<tr><td valign=top><em>FLAC__bool</em> </td><td>
1478
<code>false</code> if the encoder is already initialized, else <code>true</code>. </td></tr>
1483
<a name="a25" doxytag="file_encoder.h::FLAC__file_encoder_get_state"></a><p>
1484
<table width="100%" cellpadding="2" cellspacing="0" border="0">
1487
<table cellpadding="0" cellspacing="0" border="0">
1489
<td class="md" nowrap valign="top"> <a class="el" href="group__flac__file__encoder.html#a52">FLAC__FileEncoderState</a> FLAC__file_encoder_get_state </td>
1490
<td class="md" valign="top">( </td>
1491
<td class="md" nowrap valign="top">const <a class="el" href="structFLAC____FileEncoder.html">FLAC__FileEncoder</a> * </td>
1492
<td class="mdname1" valign="top" nowrap> <em>encoder</em> </td>
1493
<td class="md" valign="top">) </td>
1494
<td class="md" nowrap></td>
1501
<table cellspacing=5 cellpadding=0 border=0>
1509
Get the current encoder state.<dl compact><dt><b>
1510
Parameters: </b><dd>
1511
<table border=0 cellspacing=2 cellpadding=0>
1512
<tr><td valign=top><em>encoder</em> </td><td>
1513
An encoder instance to query. </td></tr>
1515
</dl><dl compact><dt><b>
1517
<div class="fragment"><pre>encoder != NULL
1518
</pre></div> </dl><dl compact><dt><b>
1519
Return values: </b><dd>
1520
<table border=0 cellspacing=2 cellpadding=0>
1521
<tr><td valign=top><em>FLAC__FileEncoderState</em> </td><td>
1522
The current encoder state. </td></tr>
1527
<a name="a26" doxytag="file_encoder.h::FLAC__file_encoder_get_seekable_stream_encoder_state"></a><p>
1528
<table width="100%" cellpadding="2" cellspacing="0" border="0">
1531
<table cellpadding="0" cellspacing="0" border="0">
1533
<td class="md" nowrap valign="top"> <a class="el" href="group__flac__seekable__stream__encoder.html#a56">FLAC__SeekableStreamEncoderState</a> FLAC__file_encoder_get_seekable_stream_encoder_state </td>
1534
<td class="md" valign="top">( </td>
1535
<td class="md" nowrap valign="top">const <a class="el" href="structFLAC____FileEncoder.html">FLAC__FileEncoder</a> * </td>
1536
<td class="mdname1" valign="top" nowrap> <em>encoder</em> </td>
1537
<td class="md" valign="top">) </td>
1538
<td class="md" nowrap></td>
1545
<table cellspacing=5 cellpadding=0 border=0>
1553
Get the state of the underlying seekable stream encoder. Useful when the file encoder state is <code>FLAC__FILE_ENCODER_SEEKABLE_STREAM_ENCODER_ERROR</code>.<dl compact><dt><b>
1554
Parameters: </b><dd>
1555
<table border=0 cellspacing=2 cellpadding=0>
1556
<tr><td valign=top><em>encoder</em> </td><td>
1557
An encoder instance to query. </td></tr>
1559
</dl><dl compact><dt><b>
1561
<div class="fragment"><pre>encoder != NULL
1562
</pre></div> </dl><dl compact><dt><b>
1563
Return values: </b><dd>
1564
<table border=0 cellspacing=2 cellpadding=0>
1565
<tr><td valign=top><em>FLAC__SeekableStreamEncoderState</em> </td><td>
1566
The seekable stream encoder state. </td></tr>
1571
<a name="a27" doxytag="file_encoder.h::FLAC__file_encoder_get_stream_encoder_state"></a><p>
1572
<table width="100%" cellpadding="2" cellspacing="0" border="0">
1575
<table cellpadding="0" cellspacing="0" border="0">
1577
<td class="md" nowrap valign="top"> <a class="el" href="group__flac__stream__encoder.html#a52">FLAC__StreamEncoderState</a> FLAC__file_encoder_get_stream_encoder_state </td>
1578
<td class="md" valign="top">( </td>
1579
<td class="md" nowrap valign="top">const <a class="el" href="structFLAC____FileEncoder.html">FLAC__FileEncoder</a> * </td>
1580
<td class="mdname1" valign="top" nowrap> <em>encoder</em> </td>
1581
<td class="md" valign="top">) </td>
1582
<td class="md" nowrap></td>
1589
<table cellspacing=5 cellpadding=0 border=0>
1597
Get the state of the underlying stream encoder. Useful when the file encoder state is <code>FLAC__FILE_ENCODER_SEEKABLE_STREAM_ENCODER_ERROR</code> and the seekable stream encoder state is <code>FLAC__SEEKABLE_STREAM_ENCODER_STREAM_ENCODER_ERROR</code>.<dl compact><dt><b>
1598
Parameters: </b><dd>
1599
<table border=0 cellspacing=2 cellpadding=0>
1600
<tr><td valign=top><em>encoder</em> </td><td>
1601
An encoder instance to query. </td></tr>
1603
</dl><dl compact><dt><b>
1605
<div class="fragment"><pre>encoder != NULL
1606
</pre></div> </dl><dl compact><dt><b>
1607
Return values: </b><dd>
1608
<table border=0 cellspacing=2 cellpadding=0>
1609
<tr><td valign=top><em>FLAC__StreamEncoderState</em> </td><td>
1610
The seekable stream encoder state. </td></tr>
1615
<a name="a28" doxytag="file_encoder.h::FLAC__file_encoder_get_verify_decoder_state"></a><p>
1616
<table width="100%" cellpadding="2" cellspacing="0" border="0">
1619
<table cellpadding="0" cellspacing="0" border="0">
1621
<td class="md" nowrap valign="top"> <a class="el" href="group__flac__stream__decoder.html#a36">FLAC__StreamDecoderState</a> FLAC__file_encoder_get_verify_decoder_state </td>
1622
<td class="md" valign="top">( </td>
1623
<td class="md" nowrap valign="top">const <a class="el" href="structFLAC____FileEncoder.html">FLAC__FileEncoder</a> * </td>
1624
<td class="mdname1" valign="top" nowrap> <em>encoder</em> </td>
1625
<td class="md" valign="top">) </td>
1626
<td class="md" nowrap></td>
1633
<table cellspacing=5 cellpadding=0 border=0>
1641
Get the state of the underlying stream encoder's verify decoder. Useful when the file encoder state is <code>FLAC__FILE_ENCODER_SEEKABLE_STREAM_ENCODER_ERROR</code> and the seekable stream encoder state is <code>FLAC__SEEKABLE_STREAM_ENCODER_STREAM_ENCODER_ERROR</code> and the stream encoder state is <code>FLAC__STREAM_ENCODER_VERIFY_DECODER_ERROR</code>.<dl compact><dt><b>
1642
Parameters: </b><dd>
1643
<table border=0 cellspacing=2 cellpadding=0>
1644
<tr><td valign=top><em>encoder</em> </td><td>
1645
An encoder instance to query. </td></tr>
1647
</dl><dl compact><dt><b>
1649
<div class="fragment"><pre>encoder != NULL
1650
</pre></div> </dl><dl compact><dt><b>
1651
Return values: </b><dd>
1652
<table border=0 cellspacing=2 cellpadding=0>
1653
<tr><td valign=top><em>FLAC__StreamDecoderState</em> </td><td>
1654
The stream encoder state. </td></tr>
1659
<a name="a29" doxytag="file_encoder.h::FLAC__file_encoder_get_resolved_state_string"></a><p>
1660
<table width="100%" cellpadding="2" cellspacing="0" border="0">
1663
<table cellpadding="0" cellspacing="0" border="0">
1665
<td class="md" nowrap valign="top"> const char* FLAC__file_encoder_get_resolved_state_string </td>
1666
<td class="md" valign="top">( </td>
1667
<td class="md" nowrap valign="top">const <a class="el" href="structFLAC____FileEncoder.html">FLAC__FileEncoder</a> * </td>
1668
<td class="mdname1" valign="top" nowrap> <em>encoder</em> </td>
1669
<td class="md" valign="top">) </td>
1670
<td class="md" nowrap></td>
1677
<table cellspacing=5 cellpadding=0 border=0>
1685
Get the current encoder state as a C string. This version automatically resolves <code>FLAC__FILE_ENCODER_SEEKABLE_STREAM_ENCODER_ERROR</code> by getting the seekable stream encoder's state.<dl compact><dt><b>
1686
Parameters: </b><dd>
1687
<table border=0 cellspacing=2 cellpadding=0>
1688
<tr><td valign=top><em>encoder</em> </td><td>
1689
A encoder instance to query. </td></tr>
1691
</dl><dl compact><dt><b>
1693
<div class="fragment"><pre>encoder != NULL
1694
</pre></div> </dl><dl compact><dt><b>
1695
Return values: </b><dd>
1696
<table border=0 cellspacing=2 cellpadding=0>
1697
<tr><td valign=top><em>const</em> </td><td>
1698
char * The encoder state as a C string. Do not modify the contents. </td></tr>
1703
<a name="a30" doxytag="file_encoder.h::FLAC__file_encoder_get_verify_decoder_error_stats"></a><p>
1704
<table width="100%" cellpadding="2" cellspacing="0" border="0">
1707
<table cellpadding="0" cellspacing="0" border="0">
1709
<td class="md" nowrap valign="top"> void FLAC__file_encoder_get_verify_decoder_error_stats </td>
1710
<td class="md" valign="top">( </td>
1711
<td class="md" nowrap valign="top">const <a class="el" href="structFLAC____FileEncoder.html">FLAC__FileEncoder</a> * </td>
1712
<td class="mdname" nowrap> <em>encoder</em>, </td>
1717
<td class="md" nowrap>FLAC__uint64 * </td>
1718
<td class="mdname" nowrap> <em>absolute_sample</em>, </td>
1723
<td class="md" nowrap>unsigned * </td>
1724
<td class="mdname" nowrap> <em>frame_number</em>, </td>
1729
<td class="md" nowrap>unsigned * </td>
1730
<td class="mdname" nowrap> <em>channel</em>, </td>
1735
<td class="md" nowrap>unsigned * </td>
1736
<td class="mdname" nowrap> <em>sample</em>, </td>
1741
<td class="md" nowrap>FLAC__int32 * </td>
1742
<td class="mdname" nowrap> <em>expected</em>, </td>
1747
<td class="md" nowrap>FLAC__int32 * </td>
1748
<td class="mdname" nowrap> <em>got</em></td>
1752
<td class="md">) </td>
1753
<td class="md" colspan="2"></td>
1760
<table cellspacing=5 cellpadding=0 border=0>
1768
Get relevant values about the nature of a verify decoder error. Inherited from <a class="el" href="group__flac__seekable__stream__encoder.html#a34">FLAC__seekable_stream_encoder_get_verify_decoder_error_stats</a>(). Useful when the file encoder state is <code>FLAC__FILE_ENCODER_SEEKABLE_STREAM_ENCODER_ERROR</code> and the seekable stream encoder state is <code>FLAC__SEEKABLE_STREAM_ENCODER_STREAM_ENCODER_ERROR</code> and the stream encoder state is <code>FLAC__STREAM_ENCODER_VERIFY_DECODER_ERROR</code>.<dl compact><dt><b>
1769
Parameters: </b><dd>
1770
<table border=0 cellspacing=2 cellpadding=0>
1771
<tr><td valign=top><em>encoder</em> </td><td>
1772
An encoder instance to query. </td></tr>
1773
<tr><td valign=top><em>absolute_sample</em> </td><td>
1774
The absolute sample number of the mismatch. </td></tr>
1775
<tr><td valign=top><em>frame_number</em> </td><td>
1776
The number of the frame in which the mismatch occurred. </td></tr>
1777
<tr><td valign=top><em>channel</em> </td><td>
1778
The channel in which the mismatch occurred. </td></tr>
1779
<tr><td valign=top><em>sample</em> </td><td>
1780
The number of the sample (relative to the frame) in which the mismatch occurred. </td></tr>
1781
<tr><td valign=top><em>expected</em> </td><td>
1782
The expected value for the sample in question. </td></tr>
1783
<tr><td valign=top><em>got</em> </td><td>
1784
The actual value returned by the decoder. </td></tr>
1786
</dl><dl compact><dt><b>
1788
<div class="fragment"><pre>encoder != NULL
1789
</pre></div> </dl> </td>
1792
<a name="a31" doxytag="file_encoder.h::FLAC__file_encoder_get_verify"></a><p>
1793
<table width="100%" cellpadding="2" cellspacing="0" border="0">
1796
<table cellpadding="0" cellspacing="0" border="0">
1798
<td class="md" nowrap valign="top"> FLAC__bool FLAC__file_encoder_get_verify </td>
1799
<td class="md" valign="top">( </td>
1800
<td class="md" nowrap valign="top">const <a class="el" href="structFLAC____FileEncoder.html">FLAC__FileEncoder</a> * </td>
1801
<td class="mdname1" valign="top" nowrap> <em>encoder</em> </td>
1802
<td class="md" valign="top">) </td>
1803
<td class="md" nowrap></td>
1810
<table cellspacing=5 cellpadding=0 border=0>
1818
Get the "verify" flag. This is inherited from <a class="el" href="structFLAC____SeekableStreamEncoder.html">FLAC__SeekableStreamEncoder</a>; see <a class="el" href="group__flac__seekable__stream__encoder.html#a35">FLAC__seekable_stream_encoder_get_verify</a>().<dl compact><dt><b>
1819
Parameters: </b><dd>
1820
<table border=0 cellspacing=2 cellpadding=0>
1821
<tr><td valign=top><em>encoder</em> </td><td>
1822
An encoder instance to query. </td></tr>
1824
</dl><dl compact><dt><b>
1826
<div class="fragment"><pre>encoder != NULL
1827
</pre></div> </dl><dl compact><dt><b>
1828
Return values: </b><dd>
1829
<table border=0 cellspacing=2 cellpadding=0>
1830
<tr><td valign=top><em>FLAC__bool</em> </td><td>
1831
See <a class="el" href="group__flac__file__encoder.html#a4">FLAC__file_encoder_set_verify</a>(). </td></tr>
1836
<a name="a32" doxytag="file_encoder.h::FLAC__file_encoder_get_streamable_subset"></a><p>
1837
<table width="100%" cellpadding="2" cellspacing="0" border="0">
1840
<table cellpadding="0" cellspacing="0" border="0">
1842
<td class="md" nowrap valign="top"> FLAC__bool FLAC__file_encoder_get_streamable_subset </td>
1843
<td class="md" valign="top">( </td>
1844
<td class="md" nowrap valign="top">const <a class="el" href="structFLAC____FileEncoder.html">FLAC__FileEncoder</a> * </td>
1845
<td class="mdname1" valign="top" nowrap> <em>encoder</em> </td>
1846
<td class="md" valign="top">) </td>
1847
<td class="md" nowrap></td>
1854
<table cellspacing=5 cellpadding=0 border=0>
1862
Get the "streamable subset" flag. This is inherited from <a class="el" href="structFLAC____SeekableStreamEncoder.html">FLAC__SeekableStreamEncoder</a>; see <a class="el" href="group__flac__seekable__stream__encoder.html#a36">FLAC__seekable_stream_encoder_get_streamable_subset</a>().<dl compact><dt><b>
1863
Parameters: </b><dd>
1864
<table border=0 cellspacing=2 cellpadding=0>
1865
<tr><td valign=top><em>encoder</em> </td><td>
1866
An encoder instance to query. </td></tr>
1868
</dl><dl compact><dt><b>
1870
<div class="fragment"><pre>encoder != NULL
1871
</pre></div> </dl><dl compact><dt><b>
1872
Return values: </b><dd>
1873
<table border=0 cellspacing=2 cellpadding=0>
1874
<tr><td valign=top><em>FLAC__bool</em> </td><td>
1875
See <a class="el" href="group__flac__file__encoder.html#a5">FLAC__file_encoder_set_streamable_subset</a>(). </td></tr>
1880
<a name="a33" doxytag="file_encoder.h::FLAC__file_encoder_get_do_mid_side_stereo"></a><p>
1881
<table width="100%" cellpadding="2" cellspacing="0" border="0">
1884
<table cellpadding="0" cellspacing="0" border="0">
1886
<td class="md" nowrap valign="top"> FLAC__bool FLAC__file_encoder_get_do_mid_side_stereo </td>
1887
<td class="md" valign="top">( </td>
1888
<td class="md" nowrap valign="top">const <a class="el" href="structFLAC____FileEncoder.html">FLAC__FileEncoder</a> * </td>
1889
<td class="mdname1" valign="top" nowrap> <em>encoder</em> </td>
1890
<td class="md" valign="top">) </td>
1891
<td class="md" nowrap></td>
1898
<table cellspacing=5 cellpadding=0 border=0>
1906
Get the "mid/side stereo coding" flag. This is inherited from <a class="el" href="structFLAC____SeekableStreamEncoder.html">FLAC__SeekableStreamEncoder</a>; see <a class="el" href="group__flac__seekable__stream__encoder.html#a37">FLAC__seekable_stream_encoder_get_do_mid_side_stereo</a>().<dl compact><dt><b>
1907
Parameters: </b><dd>
1908
<table border=0 cellspacing=2 cellpadding=0>
1909
<tr><td valign=top><em>encoder</em> </td><td>
1910
An encoder instance to query. </td></tr>
1912
</dl><dl compact><dt><b>
1914
<div class="fragment"><pre>encoder != NULL
1915
</pre></div> </dl><dl compact><dt><b>
1916
Return values: </b><dd>
1917
<table border=0 cellspacing=2 cellpadding=0>
1918
<tr><td valign=top><em>FLAC__bool</em> </td><td>
1919
See <a class="el" href="group__flac__file__encoder.html#a33">FLAC__file_encoder_get_do_mid_side_stereo</a>(). </td></tr>
1924
<a name="a34" doxytag="file_encoder.h::FLAC__file_encoder_get_loose_mid_side_stereo"></a><p>
1925
<table width="100%" cellpadding="2" cellspacing="0" border="0">
1928
<table cellpadding="0" cellspacing="0" border="0">
1930
<td class="md" nowrap valign="top"> FLAC__bool FLAC__file_encoder_get_loose_mid_side_stereo </td>
1931
<td class="md" valign="top">( </td>
1932
<td class="md" nowrap valign="top">const <a class="el" href="structFLAC____FileEncoder.html">FLAC__FileEncoder</a> * </td>
1933
<td class="mdname1" valign="top" nowrap> <em>encoder</em> </td>
1934
<td class="md" valign="top">) </td>
1935
<td class="md" nowrap></td>
1942
<table cellspacing=5 cellpadding=0 border=0>
1950
Get the "adaptive mid/side switching" flag. This is inherited from <a class="el" href="structFLAC____SeekableStreamEncoder.html">FLAC__SeekableStreamEncoder</a>; see <a class="el" href="group__flac__seekable__stream__encoder.html#a38">FLAC__seekable_stream_encoder_get_loose_mid_side_stereo</a>().<dl compact><dt><b>
1951
Parameters: </b><dd>
1952
<table border=0 cellspacing=2 cellpadding=0>
1953
<tr><td valign=top><em>encoder</em> </td><td>
1954
An encoder instance to query. </td></tr>
1956
</dl><dl compact><dt><b>
1958
<div class="fragment"><pre>encoder != NULL
1959
</pre></div> </dl><dl compact><dt><b>
1960
Return values: </b><dd>
1961
<table border=0 cellspacing=2 cellpadding=0>
1962
<tr><td valign=top><em>FLAC__bool</em> </td><td>
1963
See <a class="el" href="group__flac__file__encoder.html#a7">FLAC__file_encoder_set_loose_mid_side_stereo</a>(). </td></tr>
1968
<a name="a35" doxytag="file_encoder.h::FLAC__file_encoder_get_channels"></a><p>
1969
<table width="100%" cellpadding="2" cellspacing="0" border="0">
1972
<table cellpadding="0" cellspacing="0" border="0">
1974
<td class="md" nowrap valign="top"> unsigned FLAC__file_encoder_get_channels </td>
1975
<td class="md" valign="top">( </td>
1976
<td class="md" nowrap valign="top">const <a class="el" href="structFLAC____FileEncoder.html">FLAC__FileEncoder</a> * </td>
1977
<td class="mdname1" valign="top" nowrap> <em>encoder</em> </td>
1978
<td class="md" valign="top">) </td>
1979
<td class="md" nowrap></td>
1986
<table cellspacing=5 cellpadding=0 border=0>
1994
Get the number of input channels being processed. This is inherited from <a class="el" href="structFLAC____SeekableStreamEncoder.html">FLAC__SeekableStreamEncoder</a>; see <a class="el" href="group__flac__seekable__stream__encoder.html#a39">FLAC__seekable_stream_encoder_get_channels</a>().<dl compact><dt><b>
1995
Parameters: </b><dd>
1996
<table border=0 cellspacing=2 cellpadding=0>
1997
<tr><td valign=top><em>encoder</em> </td><td>
1998
An encoder instance to query. </td></tr>
2000
</dl><dl compact><dt><b>
2002
<div class="fragment"><pre>encoder != NULL
2003
</pre></div> </dl><dl compact><dt><b>
2004
Return values: </b><dd>
2005
<table border=0 cellspacing=2 cellpadding=0>
2006
<tr><td valign=top><em>unsigned</em> </td><td>
2007
See <a class="el" href="group__flac__file__encoder.html#a8">FLAC__file_encoder_set_channels</a>(). </td></tr>
2012
<a name="a36" doxytag="file_encoder.h::FLAC__file_encoder_get_bits_per_sample"></a><p>
2013
<table width="100%" cellpadding="2" cellspacing="0" border="0">
2016
<table cellpadding="0" cellspacing="0" border="0">
2018
<td class="md" nowrap valign="top"> unsigned FLAC__file_encoder_get_bits_per_sample </td>
2019
<td class="md" valign="top">( </td>
2020
<td class="md" nowrap valign="top">const <a class="el" href="structFLAC____FileEncoder.html">FLAC__FileEncoder</a> * </td>
2021
<td class="mdname1" valign="top" nowrap> <em>encoder</em> </td>
2022
<td class="md" valign="top">) </td>
2023
<td class="md" nowrap></td>
2030
<table cellspacing=5 cellpadding=0 border=0>
2038
Get the input sample resolution setting. This is inherited from <a class="el" href="structFLAC____SeekableStreamEncoder.html">FLAC__SeekableStreamEncoder</a>; see <a class="el" href="group__flac__seekable__stream__encoder.html#a40">FLAC__seekable_stream_encoder_get_bits_per_sample</a>().<dl compact><dt><b>
2039
Parameters: </b><dd>
2040
<table border=0 cellspacing=2 cellpadding=0>
2041
<tr><td valign=top><em>encoder</em> </td><td>
2042
An encoder instance to query. </td></tr>
2044
</dl><dl compact><dt><b>
2046
<div class="fragment"><pre>encoder != NULL
2047
</pre></div> </dl><dl compact><dt><b>
2048
Return values: </b><dd>
2049
<table border=0 cellspacing=2 cellpadding=0>
2050
<tr><td valign=top><em>unsigned</em> </td><td>
2051
See <a class="el" href="group__flac__file__encoder.html#a9">FLAC__file_encoder_set_bits_per_sample</a>(). </td></tr>
2056
<a name="a37" doxytag="file_encoder.h::FLAC__file_encoder_get_sample_rate"></a><p>
2057
<table width="100%" cellpadding="2" cellspacing="0" border="0">
2060
<table cellpadding="0" cellspacing="0" border="0">
2062
<td class="md" nowrap valign="top"> unsigned FLAC__file_encoder_get_sample_rate </td>
2063
<td class="md" valign="top">( </td>
2064
<td class="md" nowrap valign="top">const <a class="el" href="structFLAC____FileEncoder.html">FLAC__FileEncoder</a> * </td>
2065
<td class="mdname1" valign="top" nowrap> <em>encoder</em> </td>
2066
<td class="md" valign="top">) </td>
2067
<td class="md" nowrap></td>
2074
<table cellspacing=5 cellpadding=0 border=0>
2082
Get the input sample rate setting. This is inherited from <a class="el" href="structFLAC____SeekableStreamEncoder.html">FLAC__SeekableStreamEncoder</a>; see <a class="el" href="group__flac__seekable__stream__encoder.html#a41">FLAC__seekable_stream_encoder_get_sample_rate</a>().<dl compact><dt><b>
2083
Parameters: </b><dd>
2084
<table border=0 cellspacing=2 cellpadding=0>
2085
<tr><td valign=top><em>encoder</em> </td><td>
2086
An encoder instance to query. </td></tr>
2088
</dl><dl compact><dt><b>
2090
<div class="fragment"><pre>encoder != NULL
2091
</pre></div> </dl><dl compact><dt><b>
2092
Return values: </b><dd>
2093
<table border=0 cellspacing=2 cellpadding=0>
2094
<tr><td valign=top><em>unsigned</em> </td><td>
2095
See <a class="el" href="group__flac__file__encoder.html#a10">FLAC__file_encoder_set_sample_rate</a>(). </td></tr>
2100
<a name="a38" doxytag="file_encoder.h::FLAC__file_encoder_get_blocksize"></a><p>
2101
<table width="100%" cellpadding="2" cellspacing="0" border="0">
2104
<table cellpadding="0" cellspacing="0" border="0">
2106
<td class="md" nowrap valign="top"> unsigned FLAC__file_encoder_get_blocksize </td>
2107
<td class="md" valign="top">( </td>
2108
<td class="md" nowrap valign="top">const <a class="el" href="structFLAC____FileEncoder.html">FLAC__FileEncoder</a> * </td>
2109
<td class="mdname1" valign="top" nowrap> <em>encoder</em> </td>
2110
<td class="md" valign="top">) </td>
2111
<td class="md" nowrap></td>
2118
<table cellspacing=5 cellpadding=0 border=0>
2126
Get the blocksize setting. This is inherited from <a class="el" href="structFLAC____SeekableStreamEncoder.html">FLAC__SeekableStreamEncoder</a>; see <a class="el" href="group__flac__seekable__stream__encoder.html#a42">FLAC__seekable_stream_encoder_get_blocksize</a>().<dl compact><dt><b>
2127
Parameters: </b><dd>
2128
<table border=0 cellspacing=2 cellpadding=0>
2129
<tr><td valign=top><em>encoder</em> </td><td>
2130
An encoder instance to query. </td></tr>
2132
</dl><dl compact><dt><b>
2134
<div class="fragment"><pre>encoder != NULL
2135
</pre></div> </dl><dl compact><dt><b>
2136
Return values: </b><dd>
2137
<table border=0 cellspacing=2 cellpadding=0>
2138
<tr><td valign=top><em>unsigned</em> </td><td>
2139
See <a class="el" href="group__flac__file__encoder.html#a11">FLAC__file_encoder_set_blocksize</a>(). </td></tr>
2144
<a name="a39" doxytag="file_encoder.h::FLAC__file_encoder_get_max_lpc_order"></a><p>
2145
<table width="100%" cellpadding="2" cellspacing="0" border="0">
2148
<table cellpadding="0" cellspacing="0" border="0">
2150
<td class="md" nowrap valign="top"> unsigned FLAC__file_encoder_get_max_lpc_order </td>
2151
<td class="md" valign="top">( </td>
2152
<td class="md" nowrap valign="top">const <a class="el" href="structFLAC____FileEncoder.html">FLAC__FileEncoder</a> * </td>
2153
<td class="mdname1" valign="top" nowrap> <em>encoder</em> </td>
2154
<td class="md" valign="top">) </td>
2155
<td class="md" nowrap></td>
2162
<table cellspacing=5 cellpadding=0 border=0>
2170
Get the maximum LPC order setting. This is inherited from <a class="el" href="structFLAC____SeekableStreamEncoder.html">FLAC__SeekableStreamEncoder</a>; see <a class="el" href="group__flac__seekable__stream__encoder.html#a43">FLAC__seekable_stream_encoder_get_max_lpc_order</a>().<dl compact><dt><b>
2171
Parameters: </b><dd>
2172
<table border=0 cellspacing=2 cellpadding=0>
2173
<tr><td valign=top><em>encoder</em> </td><td>
2174
An encoder instance to query. </td></tr>
2176
</dl><dl compact><dt><b>
2178
<div class="fragment"><pre>encoder != NULL
2179
</pre></div> </dl><dl compact><dt><b>
2180
Return values: </b><dd>
2181
<table border=0 cellspacing=2 cellpadding=0>
2182
<tr><td valign=top><em>unsigned</em> </td><td>
2183
See <a class="el" href="group__flac__file__encoder.html#a12">FLAC__file_encoder_set_max_lpc_order</a>(). </td></tr>
2188
<a name="a40" doxytag="file_encoder.h::FLAC__file_encoder_get_qlp_coeff_precision"></a><p>
2189
<table width="100%" cellpadding="2" cellspacing="0" border="0">
2192
<table cellpadding="0" cellspacing="0" border="0">
2194
<td class="md" nowrap valign="top"> unsigned FLAC__file_encoder_get_qlp_coeff_precision </td>
2195
<td class="md" valign="top">( </td>
2196
<td class="md" nowrap valign="top">const <a class="el" href="structFLAC____FileEncoder.html">FLAC__FileEncoder</a> * </td>
2197
<td class="mdname1" valign="top" nowrap> <em>encoder</em> </td>
2198
<td class="md" valign="top">) </td>
2199
<td class="md" nowrap></td>
2206
<table cellspacing=5 cellpadding=0 border=0>
2214
Get the quantized linear predictor coefficient precision setting. This is inherited from <a class="el" href="structFLAC____SeekableStreamEncoder.html">FLAC__SeekableStreamEncoder</a>; see <a class="el" href="group__flac__seekable__stream__encoder.html#a44">FLAC__seekable_stream_encoder_get_qlp_coeff_precision</a>().<dl compact><dt><b>
2215
Parameters: </b><dd>
2216
<table border=0 cellspacing=2 cellpadding=0>
2217
<tr><td valign=top><em>encoder</em> </td><td>
2218
An encoder instance to query. </td></tr>
2220
</dl><dl compact><dt><b>
2222
<div class="fragment"><pre>encoder != NULL
2223
</pre></div> </dl><dl compact><dt><b>
2224
Return values: </b><dd>
2225
<table border=0 cellspacing=2 cellpadding=0>
2226
<tr><td valign=top><em>unsigned</em> </td><td>
2227
See <a class="el" href="group__flac__file__encoder.html#a13">FLAC__file_encoder_set_qlp_coeff_precision</a>(). </td></tr>
2232
<a name="a41" doxytag="file_encoder.h::FLAC__file_encoder_get_do_qlp_coeff_prec_search"></a><p>
2233
<table width="100%" cellpadding="2" cellspacing="0" border="0">
2236
<table cellpadding="0" cellspacing="0" border="0">
2238
<td class="md" nowrap valign="top"> FLAC__bool FLAC__file_encoder_get_do_qlp_coeff_prec_search </td>
2239
<td class="md" valign="top">( </td>
2240
<td class="md" nowrap valign="top">const <a class="el" href="structFLAC____FileEncoder.html">FLAC__FileEncoder</a> * </td>
2241
<td class="mdname1" valign="top" nowrap> <em>encoder</em> </td>
2242
<td class="md" valign="top">) </td>
2243
<td class="md" nowrap></td>
2250
<table cellspacing=5 cellpadding=0 border=0>
2258
Get the qlp coefficient precision search flag. This is inherited from <a class="el" href="structFLAC____SeekableStreamEncoder.html">FLAC__SeekableStreamEncoder</a>; see <a class="el" href="group__flac__seekable__stream__encoder.html#a45">FLAC__seekable_stream_encoder_get_do_qlp_coeff_prec_search</a>().<dl compact><dt><b>
2259
Parameters: </b><dd>
2260
<table border=0 cellspacing=2 cellpadding=0>
2261
<tr><td valign=top><em>encoder</em> </td><td>
2262
An encoder instance to query. </td></tr>
2264
</dl><dl compact><dt><b>
2266
<div class="fragment"><pre>encoder != NULL
2267
</pre></div> </dl><dl compact><dt><b>
2268
Return values: </b><dd>
2269
<table border=0 cellspacing=2 cellpadding=0>
2270
<tr><td valign=top><em>FLAC__bool</em> </td><td>
2271
See <a class="el" href="group__flac__file__encoder.html#a14">FLAC__file_encoder_set_do_qlp_coeff_prec_search</a>(). </td></tr>
2276
<a name="a42" doxytag="file_encoder.h::FLAC__file_encoder_get_do_escape_coding"></a><p>
2277
<table width="100%" cellpadding="2" cellspacing="0" border="0">
2280
<table cellpadding="0" cellspacing="0" border="0">
2282
<td class="md" nowrap valign="top"> FLAC__bool FLAC__file_encoder_get_do_escape_coding </td>
2283
<td class="md" valign="top">( </td>
2284
<td class="md" nowrap valign="top">const <a class="el" href="structFLAC____FileEncoder.html">FLAC__FileEncoder</a> * </td>
2285
<td class="mdname1" valign="top" nowrap> <em>encoder</em> </td>
2286
<td class="md" valign="top">) </td>
2287
<td class="md" nowrap></td>
2294
<table cellspacing=5 cellpadding=0 border=0>
2302
Get the "escape coding" flag. This is inherited from <a class="el" href="structFLAC____SeekableStreamEncoder.html">FLAC__SeekableStreamEncoder</a>; see <a class="el" href="group__flac__seekable__stream__encoder.html#a46">FLAC__seekable_stream_encoder_get_do_escape_coding</a>().<dl compact><dt><b>
2303
Parameters: </b><dd>
2304
<table border=0 cellspacing=2 cellpadding=0>
2305
<tr><td valign=top><em>encoder</em> </td><td>
2306
An encoder instance to query. </td></tr>
2308
</dl><dl compact><dt><b>
2310
<div class="fragment"><pre>encoder != NULL
2311
</pre></div> </dl><dl compact><dt><b>
2312
Return values: </b><dd>
2313
<table border=0 cellspacing=2 cellpadding=0>
2314
<tr><td valign=top><em>FLAC__bool</em> </td><td>
2315
See <a class="el" href="group__flac__file__encoder.html#a15">FLAC__file_encoder_set_do_escape_coding</a>(). </td></tr>
2320
<a name="a43" doxytag="file_encoder.h::FLAC__file_encoder_get_do_exhaustive_model_search"></a><p>
2321
<table width="100%" cellpadding="2" cellspacing="0" border="0">
2324
<table cellpadding="0" cellspacing="0" border="0">
2326
<td class="md" nowrap valign="top"> FLAC__bool FLAC__file_encoder_get_do_exhaustive_model_search </td>
2327
<td class="md" valign="top">( </td>
2328
<td class="md" nowrap valign="top">const <a class="el" href="structFLAC____FileEncoder.html">FLAC__FileEncoder</a> * </td>
2329
<td class="mdname1" valign="top" nowrap> <em>encoder</em> </td>
2330
<td class="md" valign="top">) </td>
2331
<td class="md" nowrap></td>
2338
<table cellspacing=5 cellpadding=0 border=0>
2346
Get the exhaustive model search flag. This is inherited from <a class="el" href="structFLAC____SeekableStreamEncoder.html">FLAC__SeekableStreamEncoder</a>; see <a class="el" href="group__flac__seekable__stream__encoder.html#a47">FLAC__seekable_stream_encoder_get_do_exhaustive_model_search</a>().<dl compact><dt><b>
2347
Parameters: </b><dd>
2348
<table border=0 cellspacing=2 cellpadding=0>
2349
<tr><td valign=top><em>encoder</em> </td><td>
2350
An encoder instance to query. </td></tr>
2352
</dl><dl compact><dt><b>
2354
<div class="fragment"><pre>encoder != NULL
2355
</pre></div> </dl><dl compact><dt><b>
2356
Return values: </b><dd>
2357
<table border=0 cellspacing=2 cellpadding=0>
2358
<tr><td valign=top><em>FLAC__bool</em> </td><td>
2359
See <a class="el" href="group__flac__file__encoder.html#a16">FLAC__file_encoder_set_do_exhaustive_model_search</a>(). </td></tr>
2364
<a name="a44" doxytag="file_encoder.h::FLAC__file_encoder_get_min_residual_partition_order"></a><p>
2365
<table width="100%" cellpadding="2" cellspacing="0" border="0">
2368
<table cellpadding="0" cellspacing="0" border="0">
2370
<td class="md" nowrap valign="top"> unsigned FLAC__file_encoder_get_min_residual_partition_order </td>
2371
<td class="md" valign="top">( </td>
2372
<td class="md" nowrap valign="top">const <a class="el" href="structFLAC____FileEncoder.html">FLAC__FileEncoder</a> * </td>
2373
<td class="mdname1" valign="top" nowrap> <em>encoder</em> </td>
2374
<td class="md" valign="top">) </td>
2375
<td class="md" nowrap></td>
2382
<table cellspacing=5 cellpadding=0 border=0>
2390
Get the minimum residual partition order setting. This is inherited from <a class="el" href="structFLAC____SeekableStreamEncoder.html">FLAC__SeekableStreamEncoder</a>; see <a class="el" href="group__flac__seekable__stream__encoder.html#a48">FLAC__seekable_stream_encoder_get_min_residual_partition_order</a>().<dl compact><dt><b>
2391
Parameters: </b><dd>
2392
<table border=0 cellspacing=2 cellpadding=0>
2393
<tr><td valign=top><em>encoder</em> </td><td>
2394
An encoder instance to query. </td></tr>
2396
</dl><dl compact><dt><b>
2398
<div class="fragment"><pre>encoder != NULL
2399
</pre></div> </dl><dl compact><dt><b>
2400
Return values: </b><dd>
2401
<table border=0 cellspacing=2 cellpadding=0>
2402
<tr><td valign=top><em>unsigned</em> </td><td>
2403
See <a class="el" href="group__flac__file__encoder.html#a17">FLAC__file_encoder_set_min_residual_partition_order</a>(). </td></tr>
2408
<a name="a45" doxytag="file_encoder.h::FLAC__file_encoder_get_max_residual_partition_order"></a><p>
2409
<table width="100%" cellpadding="2" cellspacing="0" border="0">
2412
<table cellpadding="0" cellspacing="0" border="0">
2414
<td class="md" nowrap valign="top"> unsigned FLAC__file_encoder_get_max_residual_partition_order </td>
2415
<td class="md" valign="top">( </td>
2416
<td class="md" nowrap valign="top">const <a class="el" href="structFLAC____FileEncoder.html">FLAC__FileEncoder</a> * </td>
2417
<td class="mdname1" valign="top" nowrap> <em>encoder</em> </td>
2418
<td class="md" valign="top">) </td>
2419
<td class="md" nowrap></td>
2426
<table cellspacing=5 cellpadding=0 border=0>
2434
Get maximum residual partition order setting. This is inherited from <a class="el" href="structFLAC____SeekableStreamEncoder.html">FLAC__SeekableStreamEncoder</a>; see <a class="el" href="group__flac__seekable__stream__encoder.html#a49">FLAC__seekable_stream_encoder_get_max_residual_partition_order</a>().<dl compact><dt><b>
2435
Parameters: </b><dd>
2436
<table border=0 cellspacing=2 cellpadding=0>
2437
<tr><td valign=top><em>encoder</em> </td><td>
2438
An encoder instance to query. </td></tr>
2440
</dl><dl compact><dt><b>
2442
<div class="fragment"><pre>encoder != NULL
2443
</pre></div> </dl><dl compact><dt><b>
2444
Return values: </b><dd>
2445
<table border=0 cellspacing=2 cellpadding=0>
2446
<tr><td valign=top><em>unsigned</em> </td><td>
2447
See <a class="el" href="group__flac__file__encoder.html#a18">FLAC__file_encoder_set_max_residual_partition_order</a>(). </td></tr>
2452
<a name="a46" doxytag="file_encoder.h::FLAC__file_encoder_get_rice_parameter_search_dist"></a><p>
2453
<table width="100%" cellpadding="2" cellspacing="0" border="0">
2456
<table cellpadding="0" cellspacing="0" border="0">
2458
<td class="md" nowrap valign="top"> unsigned FLAC__file_encoder_get_rice_parameter_search_dist </td>
2459
<td class="md" valign="top">( </td>
2460
<td class="md" nowrap valign="top">const <a class="el" href="structFLAC____FileEncoder.html">FLAC__FileEncoder</a> * </td>
2461
<td class="mdname1" valign="top" nowrap> <em>encoder</em> </td>
2462
<td class="md" valign="top">) </td>
2463
<td class="md" nowrap></td>
2470
<table cellspacing=5 cellpadding=0 border=0>
2478
Get the Rice parameter search distance setting. This is inherited from <a class="el" href="structFLAC____SeekableStreamEncoder.html">FLAC__SeekableStreamEncoder</a>; see <a class="el" href="group__flac__seekable__stream__encoder.html#a50">FLAC__seekable_stream_encoder_get_rice_parameter_search_dist</a>().<dl compact><dt><b>
2479
Parameters: </b><dd>
2480
<table border=0 cellspacing=2 cellpadding=0>
2481
<tr><td valign=top><em>encoder</em> </td><td>
2482
An encoder instance to query. </td></tr>
2484
</dl><dl compact><dt><b>
2486
<div class="fragment"><pre>encoder != NULL
2487
</pre></div> </dl><dl compact><dt><b>
2488
Return values: </b><dd>
2489
<table border=0 cellspacing=2 cellpadding=0>
2490
<tr><td valign=top><em>unsigned</em> </td><td>
2491
See <a class="el" href="group__flac__file__encoder.html#a19">FLAC__file_encoder_set_rice_parameter_search_dist</a>(). </td></tr>
2496
<a name="a47" doxytag="file_encoder.h::FLAC__file_encoder_get_total_samples_estimate"></a><p>
2497
<table width="100%" cellpadding="2" cellspacing="0" border="0">
2500
<table cellpadding="0" cellspacing="0" border="0">
2502
<td class="md" nowrap valign="top"> FLAC__uint64 FLAC__file_encoder_get_total_samples_estimate </td>
2503
<td class="md" valign="top">( </td>
2504
<td class="md" nowrap valign="top">const <a class="el" href="structFLAC____FileEncoder.html">FLAC__FileEncoder</a> * </td>
2505
<td class="mdname1" valign="top" nowrap> <em>encoder</em> </td>
2506
<td class="md" valign="top">) </td>
2507
<td class="md" nowrap></td>
2514
<table cellspacing=5 cellpadding=0 border=0>
2522
Get the previously set estimate of the total samples to be encoded. This is inherited from <a class="el" href="structFLAC____SeekableStreamEncoder.html">FLAC__SeekableStreamEncoder</a>; see <a class="el" href="group__flac__seekable__stream__encoder.html#a51">FLAC__seekable_stream_encoder_get_total_samples_estimate</a>().<dl compact><dt><b>
2523
Parameters: </b><dd>
2524
<table border=0 cellspacing=2 cellpadding=0>
2525
<tr><td valign=top><em>encoder</em> </td><td>
2526
An encoder instance to query. </td></tr>
2528
</dl><dl compact><dt><b>
2530
<div class="fragment"><pre>encoder != NULL
2531
</pre></div> </dl><dl compact><dt><b>
2532
Return values: </b><dd>
2533
<table border=0 cellspacing=2 cellpadding=0>
2534
<tr><td valign=top><em>FLAC__uint64</em> </td><td>
2535
See <a class="el" href="group__flac__file__encoder.html#a20">FLAC__file_encoder_set_total_samples_estimate</a>(). </td></tr>
2540
<a name="a48" doxytag="file_encoder.h::FLAC__file_encoder_init"></a><p>
2541
<table width="100%" cellpadding="2" cellspacing="0" border="0">
2544
<table cellpadding="0" cellspacing="0" border="0">
2546
<td class="md" nowrap valign="top"> <a class="el" href="group__flac__file__encoder.html#a52">FLAC__FileEncoderState</a> FLAC__file_encoder_init </td>
2547
<td class="md" valign="top">( </td>
2548
<td class="md" nowrap valign="top"><a class="el" href="structFLAC____FileEncoder.html">FLAC__FileEncoder</a> * </td>
2549
<td class="mdname1" valign="top" nowrap> <em>encoder</em> </td>
2550
<td class="md" valign="top">) </td>
2551
<td class="md" nowrap></td>
2558
<table cellspacing=5 cellpadding=0 border=0>
2566
Initialize the encoder instance. Should be called after <a class="el" href="group__flac__file__encoder.html#a2">FLAC__file_encoder_new</a>() and FLAC__file_encoder_set_*() but before <a class="el" href="group__flac__file__encoder.html#a50">FLAC__file_encoder_process</a>() or <a class="el" href="group__flac__file__encoder.html#a51">FLAC__file_encoder_process_interleaved</a>(). Will set and return the encoder state, which will be FLAC__FILE_ENCODER_OK if initialization succeeded.<dl compact><dt><b>
2567
Parameters: </b><dd>
2568
<table border=0 cellspacing=2 cellpadding=0>
2569
<tr><td valign=top><em>encoder</em> </td><td>
2570
An uninitialized encoder instance. </td></tr>
2572
</dl><dl compact><dt><b>
2574
<div class="fragment"><pre>encoder != NULL
2575
</pre></div> </dl><dl compact><dt><b>
2576
Return values: </b><dd>
2577
<table border=0 cellspacing=2 cellpadding=0>
2578
<tr><td valign=top><em>FLAC__FileEncoderState</em> </td><td>
2579
<code>FLAC__FILE_ENCODER_OK</code> if initialization was successful; see FLAC__FileEncoderState for the meanings of other return values. </td></tr>
2584
<a name="a49" doxytag="file_encoder.h::FLAC__file_encoder_finish"></a><p>
2585
<table width="100%" cellpadding="2" cellspacing="0" border="0">
2588
<table cellpadding="0" cellspacing="0" border="0">
2590
<td class="md" nowrap valign="top"> void FLAC__file_encoder_finish </td>
2591
<td class="md" valign="top">( </td>
2592
<td class="md" nowrap valign="top"><a class="el" href="structFLAC____FileEncoder.html">FLAC__FileEncoder</a> * </td>
2593
<td class="mdname1" valign="top" nowrap> <em>encoder</em> </td>
2594
<td class="md" valign="top">) </td>
2595
<td class="md" nowrap></td>
2602
<table cellspacing=5 cellpadding=0 border=0>
2610
Finish the encoding process. Flushes the encoding buffer, releases resources, resets the encoder settings to their defaults, and returns the encoder state to FLAC__FILE_ENCODER_UNINITIALIZED.
2612
In the event of a prematurely-terminated encode, it is not strictly necessary to call this immediately before <a class="el" href="group__flac__file__encoder.html#a3">FLAC__file_encoder_delete</a>() but it is good practice to match every <a class="el" href="group__flac__file__encoder.html#a48">FLAC__file_encoder_init</a>() with a <a class="el" href="group__flac__file__encoder.html#a49">FLAC__file_encoder_finish</a>().<dl compact><dt><b>
2613
Parameters: </b><dd>
2614
<table border=0 cellspacing=2 cellpadding=0>
2615
<tr><td valign=top><em>encoder</em> </td><td>
2616
An uninitialized encoder instance. </td></tr>
2618
</dl><dl compact><dt><b>
2620
<div class="fragment"><pre>encoder != NULL
2621
</pre></div> </dl> </td>
2624
<a name="a50" doxytag="file_encoder.h::FLAC__file_encoder_process"></a><p>
2625
<table width="100%" cellpadding="2" cellspacing="0" border="0">
2628
<table cellpadding="0" cellspacing="0" border="0">
2630
<td class="md" nowrap valign="top"> FLAC__bool FLAC__file_encoder_process </td>
2631
<td class="md" valign="top">( </td>
2632
<td class="md" nowrap valign="top"><a class="el" href="structFLAC____FileEncoder.html">FLAC__FileEncoder</a> * </td>
2633
<td class="mdname" nowrap> <em>encoder</em>, </td>
2638
<td class="md" nowrap>const FLAC__int32 *const </td>
2639
<td class="mdname" nowrap> <em>buffer</em>[], </td>
2644
<td class="md" nowrap>unsigned </td>
2645
<td class="mdname" nowrap> <em>samples</em></td>
2649
<td class="md">) </td>
2650
<td class="md" colspan="2"></td>
2657
<table cellspacing=5 cellpadding=0 border=0>
2665
Submit data for encoding. This is inherited from <a class="el" href="structFLAC____SeekableStreamEncoder.html">FLAC__SeekableStreamEncoder</a>; see <a class="el" href="group__flac__seekable__stream__encoder.html#a54">FLAC__seekable_stream_encoder_process</a>().<dl compact><dt><b>
2666
Parameters: </b><dd>
2667
<table border=0 cellspacing=2 cellpadding=0>
2668
<tr><td valign=top><em>encoder</em> </td><td>
2669
An initialized encoder instance in the OK state. </td></tr>
2670
<tr><td valign=top><em>buffer</em> </td><td>
2671
An array of pointers to each channel's signal. </td></tr>
2672
<tr><td valign=top><em>samples</em> </td><td>
2673
The number of samples in one channel. </td></tr>
2675
</dl><dl compact><dt><b>
2677
<div class="fragment"><pre>encoder != NULL
2678
</pre></div> <div class="fragment"><pre><a class="code" href="FLAC_2file__encoder_8h.html#a25">FLAC__file_encoder_get_state</a>(encoder) == <a class="code" href="FLAC_2file__encoder_8h.html#a52a2">FLAC__FILE_ENCODER_OK</a>
2679
</pre></div> </dl><dl compact><dt><b>
2680
Return values: </b><dd>
2681
<table border=0 cellspacing=2 cellpadding=0>
2682
<tr><td valign=top><em>FLAC__bool</em> </td><td>
2683
<code>true</code> if successful, else <code>false</code>; in this case, check the encoder state with <a class="el" href="group__flac__file__encoder.html#a25">FLAC__file_encoder_get_state</a>() to see what went wrong. </td></tr>
2688
<a name="a51" doxytag="file_encoder.h::FLAC__file_encoder_process_interleaved"></a><p>
2689
<table width="100%" cellpadding="2" cellspacing="0" border="0">
2692
<table cellpadding="0" cellspacing="0" border="0">
2694
<td class="md" nowrap valign="top"> FLAC__bool FLAC__file_encoder_process_interleaved </td>
2695
<td class="md" valign="top">( </td>
2696
<td class="md" nowrap valign="top"><a class="el" href="structFLAC____FileEncoder.html">FLAC__FileEncoder</a> * </td>
2697
<td class="mdname" nowrap> <em>encoder</em>, </td>
2702
<td class="md" nowrap>const FLAC__int32 </td>
2703
<td class="mdname" nowrap> <em>buffer</em>[], </td>
2708
<td class="md" nowrap>unsigned </td>
2709
<td class="mdname" nowrap> <em>samples</em></td>
2713
<td class="md">) </td>
2714
<td class="md" colspan="2"></td>
2721
<table cellspacing=5 cellpadding=0 border=0>
2729
Submit data for encoding. This is inherited from <a class="el" href="structFLAC____SeekableStreamEncoder.html">FLAC__SeekableStreamEncoder</a>; see <a class="el" href="group__flac__seekable__stream__encoder.html#a55">FLAC__seekable_stream_encoder_process_interleaved</a>().<dl compact><dt><b>
2730
Parameters: </b><dd>
2731
<table border=0 cellspacing=2 cellpadding=0>
2732
<tr><td valign=top><em>encoder</em> </td><td>
2733
An initialized encoder instance in the OK state. </td></tr>
2734
<tr><td valign=top><em>buffer</em> </td><td>
2735
An array of channel-interleaved data (see above). </td></tr>
2736
<tr><td valign=top><em>samples</em> </td><td>
2737
The number of samples in one channel, the same as for <a class="el" href="group__flac__file__encoder.html#a50">FLAC__file_encoder_process</a>(). For example, if encoding two channels, <code>1000</code> <em>samples</em> corresponds to a <em>buffer</em> of 2000 values. </td></tr>
2739
</dl><dl compact><dt><b>
2741
<div class="fragment"><pre>encoder != NULL
2742
</pre></div> <div class="fragment"><pre><a class="code" href="FLAC_2file__encoder_8h.html#a25">FLAC__file_encoder_get_state</a>(encoder) == <a class="code" href="FLAC_2file__encoder_8h.html#a52a2">FLAC__FILE_ENCODER_OK</a>
2743
</pre></div> </dl><dl compact><dt><b>
2744
Return values: </b><dd>
2745
<table border=0 cellspacing=2 cellpadding=0>
2746
<tr><td valign=top><em>FLAC__bool</em> </td><td>
2747
<code>true</code> if successful, else <code>false</code>; in this case, check the encoder state with <a class="el" href="group__flac__file__encoder.html#a25">FLAC__file_encoder_get_state</a>() to see what went wrong. </td></tr>
2752
<hr><h2>Variable Documentation</h2>
2753
<a name="a0" doxytag="file_encoder.h::FLAC__FileEncoderStateString"></a><p>
2754
<table width="100%" cellpadding="2" cellspacing="0" border="0">
2757
<table cellpadding="0" cellspacing="0" border="0">
2759
<td class="md" nowrap valign="top"> const char* const FLAC__FileEncoderStateString[]
2764
<table cellspacing=5 cellpadding=0 border=0>
2772
Maps a FLAC__FileEncoderState to a C string.
2774
Using a FLAC__FileEncoderState as the index to this array will give the string equivalent. The contents should not be modified. </td>
2777
<hr><address><small>Generated on Fri Feb 4 18:39:15 2005 for FLAC by
2778
<a href="http://www.doxygen.org/index.html">
2779
<img src="doxygen.gif" alt="doxygen" align="middle" border=0
2780
width=110 height=53></a>1.2.14 written by <a href="mailto:dimitri@stack.nl">Dimitri van Heesch</a>,
2781
© 1997-2002</small></address>