MIDI debugging.
[ardour.git] / libs / ardour / parameter_descriptor.cc
index 310ec1a4832c0346a95c76237756c38483e16847..0bc81fa064f74096cab77a5d4d1861cf8c1d3d1d 100644 (file)
@@ -17,6 +17,7 @@
     675 Mass Ave, Cambridge, MA 02139, USA.
 */
 
+#include <algorithm>
 #include <boost/algorithm/string.hpp>
 
 #include "pbd/control_math.h"
@@ -100,20 +101,29 @@ ParameterDescriptor::ParameterDescriptor(const Evoral::Parameter& parameter)
                lower  = 0.0;
                normal = 0.0;
                upper  = 127.0;
+               print_fmt = "%.0f";
                break;
        case MidiPitchBenderAutomation:
                lower  = 0.0;
                normal = 8192.0;
                upper  = 16383.0;
+               print_fmt = "%.0f";
                break;
        case PhaseAutomation:
                toggled = true;
+               scale_points = boost::shared_ptr<ScalePoints>(new ScalePoints());
+               scale_points->insert (std::make_pair (_("Normal"), 0));
+               scale_points->insert (std::make_pair (_("Invert"), 1));
                break;
        case MonitoringAutomation:
                enumeration = true;
                integer_step = true;
                lower = MonitorAuto;
                upper = MonitorDisk; /* XXX bump when we add MonitorCue */
+               scale_points = boost::shared_ptr<ScalePoints>(new ScalePoints());
+               scale_points->insert (std::make_pair (_("Auto"), MonitorAuto));
+               scale_points->insert (std::make_pair (_("Input"), MonitorInput));
+               scale_points->insert (std::make_pair (_("Disk"), MonitorDisk));
                break;
        case SoloIsolateAutomation:
        case SoloSafeAutomation:
@@ -147,12 +157,38 @@ ParameterDescriptor::update_steps()
        if (toggled || enumeration) {
                logarithmic = false;
        }
+       if (logarithmic && sr_dependent && upper > lower && lower == 0) {
+               /* work-around for plugins with a log-scale control 0..SR; log (0) is not defined */
+               lower = upper / 1000.f;
+       }
        if (logarithmic && (upper <= lower || lower * upper <= 0)) {
+               /* log-scale params need upper > lower and both values need the same sign */
                logarithmic = false;
        }
        if (rangesteps < 2) {
                rangesteps = 0;
        }
+       if (enumeration) {
+               /* enums need scale-points.
+                * The GUI is more restrictive, a dropdown is displayed
+                * IIF  scale_points.size() == (1 + upper - lower)
+                */
+               if (!scale_points || scale_points->empty ()) {
+                       enumeration = false;
+               }
+       }
+       if (integer_step) {
+               if (lower >= upper) {
+                       integer_step = false;
+               }
+       }
+
+       /* upper == lower does not make any sense */
+       if (lower == upper) {
+               upper = lower + 0.01; // add some arbitrary value
+       }
+
+       /* set steps */
 
        if (unit == ParameterDescriptor::MIDI_NOTE) {
                step      = smallstep = 1;  // semitone
@@ -166,43 +202,28 @@ ParameterDescriptor::update_steps()
                smallstep = step;
        } else if (rangesteps > 1) {
                const float delta = upper - lower;
-
-               step = smallstep = (delta / (rangesteps - 1)); // XXX
-               largestep = std::min ((delta / 5.0f), 10.f * smallstep); // XXX
-
                if (logarithmic) {
-                       smallstep = smallstep / logf (rangesteps); // XXX
-                       step      = step      / logf (rangesteps);
-                       largestep = largestep / logf (rangesteps);
+                       smallstep = step = (powf (delta, 1.f  / (float)rangesteps) - 1.f) * lower;
+                       largestep = (powf (delta, std::max (0.5f, 10.f / (float)rangesteps)) - 1.f) * lower;
                } else if (integer_step) {
-                       smallstep = 1.0;
-                       step      = std::max(1.f, rintf (rangesteps));
-                       largestep = std::max(1.f, rintf (largestep));
+                       smallstep = step = 1.0;
+                       largestep = std::max(1.f, rintf (delta / (rangesteps - 1)));
+               } else {
+                       step = smallstep = delta / (rangesteps - 1);
+                       largestep = std::min ((delta / 4.0f), 10.f * smallstep); // XXX
                }
        } else {
                const float delta = upper - lower;
-
-               /* 30 happens to be the total number of steps for a fader with default
-                  max gain of 2.0 (6 dB), so we use 30 here too for consistency. */
-               step      = smallstep = (delta / 300.0f);
-               largestep = (delta / 30.0f);
-
+               /* 30 steps between min/max (300 for fine-grained) */
                if (logarithmic) {
-                       /* Steps are linear, but we map them with pow like values (in
-                          internal_to_interface).  Thus, they are applied exponentially,
-                          which means too few steps.  So, divide to get roughly the
-                          desired number of steps (30).  This is not mathematically
-                          precise but seems to be about right for the controls I tried.
-                          If you're reading this, you've probably found a case where that
-                          isn't true, and somebody needs to sit down with a piece of paper
-                          and actually do the math. */
-                       smallstep = smallstep / logf(30.0f);
-                       step      = step      / logf(30.0f);
-                       largestep = largestep / logf(30.0f);
+                       smallstep = step = (powf (delta, 1.f / 300.f) - 1.f) * lower;
+                       largestep = (powf (delta, 1.f / 30.f) - 1.f) * lower;
                } else if (integer_step) {
-                       smallstep = 1.0;
-                       step      = std::max(1.f, rintf (step));
-                       largestep = std::max(1.f, rintf (largestep));
+                       smallstep = step = 1.0;
+                       largestep = std::max(1.f, rintf (delta / 30.f));
+               } else {
+                       step      = smallstep = (delta / 300.0f);
+                       largestep = (delta / 30.0f);
                }
        }
 }
@@ -292,7 +313,7 @@ ParameterDescriptor::to_interface (float val) const
                        break;
                case PanAzimuthAutomation:
                case PanElevationAutomation:
-                       val = 1.f - val;
+                       val = val;
                        break;
                case PanWidthAutomation:
                        val = .5f + val * .5f;
@@ -343,7 +364,7 @@ ParameterDescriptor::from_interface (float val) const
                        break;
                case PanAzimuthAutomation:
                case PanElevationAutomation:
-                        val = 1.f - val;
+                        val = val;
                        break;
                case PanWidthAutomation:
                        val = 2.f * val - 1.f;
@@ -363,7 +384,7 @@ ParameterDescriptor::from_interface (float val) const
                                 * e.g. 5 integers 0,1,2,3,4 are mapped to a fader
                                 * [0.0 .. 0.2 | 0.2 .. 0.4 | 0.4 .. 0.6 | 0.6 .. 0.8 | 0.8 .. 1.0]
                                 */
-                               val =  round (lower + val * (1.f + upper - lower) - .5f);
+                               val = floor (lower + val * (1.f + upper - lower));
                        } else if (rangesteps > 1) {
                                /* similar to above, but for float controls */
                                val = floor (val * (rangesteps - 1.f)) / (rangesteps - 1.f); // XXX
@@ -416,4 +437,41 @@ ParameterDescriptor::apply_delta (float val, float delta) const
        }
 }
 
+float
+ParameterDescriptor::step_enum (float val, bool prev) const
+{
+       if (!enumeration) {
+               return val;
+       }
+       assert (scale_points && !scale_points->empty ());
+       float rv = scale_points->begin()->second;
+       float delta = fabsf (val - rv);
+       std::vector<float> avail;
+
+       for (ScalePoints::const_iterator i = scale_points->begin (); i != scale_points->end (); ++i) {
+               float s = i->second;
+               avail.push_back (s);
+               if (fabsf (val - s) < delta) {
+                       rv = s;
+                       delta = fabsf (val - s);
+               }
+       }
+       /* ScalePoints map is sorted by text string */
+       std::sort (avail.begin (), avail.end ());
+       std::vector<float>::const_iterator it = std::find (avail.begin (), avail.end (), rv);
+       assert (it != avail.end());
+
+       if (prev) {
+               if (it == avail.begin()) {
+                       return rv;
+               }
+               return *(--it);
+       } else {
+               if (++it == avail.end()) {
+                       return rv;
+               }
+               return *(it);
+       }
+}
+
 } // namespace ARDOUR