Changes between Version 6 and Version 7 of Tone_Generator

Timestamp:

Sep 22, 2008 9:40:56 AM (16 years ago)

Author:

bennylp

Comment:

--

Tone_Generator

@@ -5 +5 @@
 == The Algorithms ==
 
-The tone generator (tonegen.c) supports several algorithms, and since version 1.0-rc3, the use of these algorithms is controlled by {{{PJMEDIA_TONEGEN_ALG}}} setting:
- - {{{PJMEDIA_TONEGEN_SINE}}}: The good-old generation using math's sine(), floating point. This has very good precision but it's the slowest and requires floating point support and linking with the math library.
- - {{{PJMEDIA_TONEGEN_FLOATING_POINT}}}: Floating point approximation of sine(). This has relatively good precision and much faster than plain sine(), but it requires floating-point support and linking with the math library.
- - {{{PJMEDIA_TONEGEN_FIXED_POINT_CORDIC}}} (new in 1.0-rc3): Fixed point using sine signal generated by Cordic algorithm. This algorithm can be tuned to provide balance between precision and performance by tuning the {{{PJMEDIA_TONEGEN_FIXED_POINT_CORDIC_LOOP}}} setting, and may be suitable for platforms that lack floating-point support. 
- - {{{PJMEDIA_TONEGEN_FAST_FIXED_POINT}}}: Fast fixed point using some approximation to generate sine waves. The tone generated by this algorithm is not very precise, however the algorithm is very fast.
+The tone generator (tonegen.c) supports several algorithms, and since version 1.0-rc3, the use of these algorithms can be controlled by application by using the {{{PJMEDIA_TONEGEN_ALG}}} macro setting:
+ '''{{{PJMEDIA_TONEGEN_SINE}}}'''::
+ The good-old generation using math's sine(), floating point. This has very good precision but it's the slowest and requires floating point support and linking with the math library.
+
+ '''{{{PJMEDIA_TONEGEN_FLOATING_POINT}}}''' (default when floating point is enabled)::
+ Floating point approximation of sine(). This has relatively good precision and much faster than plain sine(), but it requires floating-point support and linking with the math library.
+
+ '''{{{PJMEDIA_TONEGEN_FIXED_POINT_CORDIC}}}''' (new in 1.0-rc3, and the default when floating point is disabled)::
+ Fixed point using sine signal generated by a 28-bit [http://en.wikipedia.org/wiki/CORDIC CORDIC] algorithm. This algorithm can be tuned to provide balance between precision and performance by tuning the {{{PJMEDIA_TONEGEN_FIXED_POINT_CORDIC_LOOP}}} setting, and it is suitable for platforms that lack floating-point support. 
+
+ '''{{{PJMEDIA_TONEGEN_FAST_FIXED_POINT}}}'''::
+ Fast fixed point using some approximation to generate sine waves. The tone generated by this algorithm is not very precise, however the algorithm is very fast.
 
 == Accuracy ==