Changes between Version 4 and Version 5 of Tone_Generator

Timestamp:

Sep 18, 2008 1:58:12 PM (16 years ago)

Author:

bennylp

Comment:

--

Tone_Generator

@@ -8 +8 @@
  - {{{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. The default setting for {{{PJMEDIA_TONEGEN_FIXED_POINT_CORDIC_LOOP}}} is 8.
+ - {{{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.
 
@@ -31 +31 @@
 
 || PJMEDIA_TONEGEN_SINE:[[BR]] [[Image(sine.JPG)]] || PJMEDIA_TONEGEN_FLOATING_POINT:[[BR]] [[Image(float.JPG)]] ||
-|| PJMEDIA_TONEGEN_FIXED_POINT_CORDIC with 16 iterations:[[BR]] [[Image(cordic16.JPG)]] || PJMEDIA_TONEGEN_FIXED_POINT_CORDIC with 12 iterations (default):[[BR]][[Image(cordic12.JPG)]] ||
-|| PJMEDIA_TONEGEN_FIXED_POINT_CORDIC with 10 iterations:[[BR]] [[Image(cordic10.JPG)]] || PJMEDIA_TONEGEN_FIXED_POINT_CORDIC with 8 iterations (default):[[BR]][[Image(cordic8.JPG)]] ||
+|| PJMEDIA_TONEGEN_FIXED_POINT_CORDIC with 16 iterations:[[BR]] [[Image(cordic16.JPG)]] || PJMEDIA_TONEGEN_FIXED_POINT_CORDIC with 12 iterations:[[BR]][[Image(cordic12.JPG)]] ||
+|| PJMEDIA_TONEGEN_FIXED_POINT_CORDIC with 10 iterations:[[BR]] [[Image(cordic10.JPG)]] || PJMEDIA_TONEGEN_FIXED_POINT_CORDIC with 8 iterations:[[BR]][[Image(cordic8.JPG)]] ||
 || PJMEDIA_TONEGEN_FIXED_POINT_CORDIC with 7 iterations:[[BR]] [[Image(cordic7.JPG)]] || PJMEDIA_TONEGEN_FAST_FIXED_POINT: [[BR]][[Image(fast-fixed-point.JPG)]] ||
 
@@ -52 +52 @@
 || PJMEDIA_TONEGEN_FIXED_POINT_CORDIC with 12 iterations || 13,561 || 1.356 || 2.69 ||
 || PJMEDIA_TONEGEN_FIXED_POINT_CORDIC with 10 iterations || 11,662 || 1.166 || 2.31 ||
-|| PJMEDIA_TONEGEN_FIXED_POINT_CORDIC with 8 iterations (default) || 9,872 || 0.987 || 1.95 ||
+|| PJMEDIA_TONEGEN_FIXED_POINT_CORDIC with 8 iterations  || 9,872 || 0.987 || 1.95 ||
 || PJMEDIA_TONEGEN_FIXED_POINT_CORDIC with 7 iterations || 8,943 || 0.894 || 1.77 ||
 || PJMEDIA_TONEGEN_FAST_FIXED_POINT || 1,449 || 0.145 || 0.29 ||
@@ -65 +65 @@
 || PJMEDIA_TONEGEN_FIXED_POINT_CORDIC with 12 iterations || 1,140 || 0.114 || 9.24 ||
 || PJMEDIA_TONEGEN_FIXED_POINT_CORDIC with 10 iterations || 998 || 0.100 || 8.09 ||
-|| PJMEDIA_TONEGEN_FIXED_POINT_CORDIC with 8 iterations (default) || 826 || 0.083 || 6.69 ||
+|| PJMEDIA_TONEGEN_FIXED_POINT_CORDIC with 8 iterations  || 826 || 0.083 || 6.69 ||
 || PJMEDIA_TONEGEN_FIXED_POINT_CORDIC with 7 iterations || 743 || 0.074 || 6.02 ||
 || PJMEDIA_TONEGEN_FAST_FIXED_POINT || 117 || 0.012 || 0.95 ||
 
+
+== Conclusion ==
+
+Based on the results above, and as of version 1.0-rc3, we set the tone generator settings in {{{pjmedia/config.h}}} as follows:
+ - on PC and platforms where floating point '''is''' available:
+   {{{
+#define PJMEDIA_TONEGEN_ALG                       PJMEDIA_TONEGEN_FLOATING_POINT
+   }}}
+ - on platforms where floating point '''is NOT''' available:
+   {{{
+#define PJMEDIA_TONEGEN_ALG                       PJMEDIA_TONEGEN_FIXED_POINT_CORDIC
+#define PJMEDIA_TONEGEN_FIXED_POINT_CORDIC_LOOP   8
+   }}}
+
+These settings of course can be overridden in your {{{config_site.h}}} as usual.
+
+
+
+[[BR]]
+[[BR]]
+