From 74f4b1bc3b627ba4c7e03498234d88cacdfbe97b Mon Sep 17 00:00:00 2001 From: Aki Date: Wed, 29 Sep 2021 22:52:49 +0200 Subject: Squashed 'vorbis/' content from commit d22c3ab5f git-subtree-dir: vorbis git-subtree-split: d22c3ab5f633460abc2532feee60ca0892134cbf --- doc/vorbisenc/vorbis_encode_setup_managed.html | 102 +++++++++++++++++++++++++ 1 file changed, 102 insertions(+) create mode 100644 doc/vorbisenc/vorbis_encode_setup_managed.html (limited to 'doc/vorbisenc/vorbis_encode_setup_managed.html') diff --git a/doc/vorbisenc/vorbis_encode_setup_managed.html b/doc/vorbisenc/vorbis_encode_setup_managed.html new file mode 100644 index 0000000..0389dde --- /dev/null +++ b/doc/vorbisenc/vorbis_encode_setup_managed.html @@ -0,0 +1,102 @@ + + + +libvorbisenc - function - vorbis_encode_setup_managed + + + + + + + + + +

libvorbisenc documentation

libvorbisenc version 1.3.2 - 20101101

+ +

vorbis_encode_setup_managed

+ +

declared in "vorbis/vorbisenc.h";

+ +

This function performs step-one of a three-step bitrate-managed +encode setup. It functions similarly to the one-step setup performed +by vorbis_encode_init() but +allows an application to make further encode setup tweaks using vorbis_encode_ctl() before finally +calling vorbis_encode_setup_init() to +complete the setup process. + +

Before this function is called, the vorbis_info struct should be initialized +by using vorbis_info_init() from the libvorbis API. After encoding, +vorbis_info_clear should be called. + +

The max_bitrate, nominal_bitrate, and min_bitrate settings are used +to set constraints for the encoded file. This function uses these +settings to select the appropriate encoding mode and set it up. +

+

+ + + + +
+

+extern int vorbis_encode_init(vorbis_info *vi,
+			      long channels,
+			      long rate,
+			      
+			      long max_bitrate,
+			      long nominal_bitrate,
+			      long min_bitrate);
+
+
+
+ +

Parameters

+
+
vi
+
Pointer to an initialized vorbis_info struct.
+
channels
+
The number of channels to be encoded.
+
rate
+
The sampling rate of the source audio.
+
max_bitrate
+
Desired maximum bitrate (limit). -1 indicates unset.
+
nominal_bitrate
+
Desired average, or central, bitrate. -1 indicates unset.
+
min_bitrate
+
Desired minimum bitrate. -1 indicates unset.
+
+ + +

Return Values

+
+
  • +0 for success
    • + +
  • less than zero for failure:
    • + +
    +

    + +

    +

    + + + + + + + + +

    copyright © 2000-2010 Xiph.Org

    Ogg Vorbis

    libvorbisenc documentation

    libvorbisenc version 1.3.2 - 20101101

    + + + + + -- cgit v1.1