ref: 48069bf9bd2d1509185279d0d87e38aec84eea1a
parent: 25f7f35555168f3426b9aad1efefab466f365af6
author: Gregory Maxwell <[email protected]>
date: Thu Sep 15 07:33:18 EDT 2011
Documentation and build script updates.
--- a/celt/opus_defines.h
+++ b/celt/opus_defines.h
@@ -112,7 +112,7 @@
/** @endcond */
/** @defgroup encoderctls Encoder related CTLs
- * @see opus_encoder_ctl
+ * @see genericctls,opusencoder
* @{*/
/** @cond DOXYGEN_EXCLUDE */
@@ -135,7 +135,7 @@
/** Configures the encoder's computational complexity.
* The supported range is 0-10 inclusive with 10 representing the highest complexity.
- * The default value is inconsistent between modes
+ * The default value is 10.
* @param[in] x <tt>int</tt>: 0-10, inclusive
* @hideinitializer */
#define OPUS_SET_COMPLEXITY(x) OPUS_SET_COMPLEXITY_REQUEST, __opus_check_int(x)
@@ -201,7 +201,7 @@
* @hideinitializer */
#define OPUS_GET_FORCE_CHANNELS(x) OPUS_GET_FORCE_CHANNELS_REQUEST, __opus_check_int_ptr(x)
-/** Configures the encoder's bandpass.
+/** Configures the encoder's bandpass, @see OPUS_GET_BANDWIDTH
* The supported values are:
* - OPUS_BANDWIDTH_AUTO (default)
* - OPUS_BANDWIDTH_NARROWBAND 4kHz passband
@@ -212,10 +212,6 @@
* @param[in] x <tt>int</tt>: Bandwidth value
* @hideinitializer */
#define OPUS_SET_BANDWIDTH(x) OPUS_SET_BANDWIDTH_REQUEST, __opus_check_int(x)
-/** Gets the encoder's configured bandpass, @see OPUS_SET_BANDWIDTH
- * @param[out] x <tt>int*</tt>: Bandwidth value
- * @hideinitializer */
-#define OPUS_GET_BANDWIDTH(x) OPUS_GET_BANDWIDTH_REQUEST, __opus_check_int_ptr(x)
/** Configures the type of signal being encoded.
* This is a hint which helps the encoder's mode selection.
@@ -328,7 +324,7 @@
/**@}*/
/** @defgroup genericctls Generic CTLs
- * @see opus_encoder_ctl,opus_decoder_ctl
+ * @see opus_encoder_ctl,opusencoder,opusdecoder
* @{*/
@@ -358,6 +354,11 @@
*
* @hideinitializer */
#define OPUS_GET_PITCH(x) OPUS_GET_PITCH_REQUEST, __opus_check_int_ptr(x)
+
+/** Gets the encoder's configured bandpass or the decoder's last bandpass, @see OPUS_SET_BANDWIDTH
+ * @param[out] x <tt>int*</tt>: Bandwidth value
+ * @hideinitializer */
+#define OPUS_GET_BANDWIDTH(x) OPUS_GET_BANDWIDTH_REQUEST, __opus_check_int_ptr(x)
/**@}*/
--- a/configure.ac
+++ b/configure.ac
@@ -240,7 +240,7 @@
Fixed point debugging: ......... ${ac_enable_fixed_debug} Custom modes: .................. ${ac_enable_custom_modes} Assertion checking: ............ ${ac_enable_assertions}- Fuzzing: .. .......... ${ac_enable_fuzzing}+ Fuzzing: ....................... ${ac_enable_fuzzing} API documentation: ............. ${ac_enable_doc}------------------------------------------------------------------------
--- a/doc/Doxyfile.in
+++ b/doc/Doxyfile.in
@@ -1420,13 +1420,13 @@
# compilation will be performed. Macro expansion can be done in a controlled
# way by setting EXPAND_ONLY_PREDEF to YES.
-MACRO_EXPANSION = NO
+MACRO_EXPANSION = YES
# If the EXPAND_ONLY_PREDEF and MACRO_EXPANSION tags are both set to YES
# then the macro expansion is limited to the macros specified with the
# PREDEFINED and EXPAND_AS_DEFINED tags.
-EXPAND_ONLY_PREDEF = NO
+EXPAND_ONLY_PREDEF = YES
# If the SEARCH_INCLUDES tag is set to YES (the default) the includes files
# pointed to by INCLUDE_PATH will be searched when a #include is found.
@@ -1454,7 +1454,7 @@
# undefined via #undef or recursively expanded use the := operator
# instead of the = operator.
-PREDEFINED =
+PREDEFINED = OPUS_EXPORT=
# If the MACRO_EXPANSION and EXPAND_ONLY_PREDEF tags are set to YES then
# this tag can be used to specify a list of macro names that should be expanded.