Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features.

BUG:215923


git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/kdemultimedia@1054174 283d02a7-25f6-0310-bc7c-ecb5cbfe19da

1 files changed, 147 insertions, 0 deletions

diff --git a/kmix/mixer_backend.cpp b/kmix/mixer_backend.cpp
new file mode 100644
index 00000000..2eb61089
--- /dev/null
+++ b/kmix/mixer_backend.cpp
@@ -0,0 +1,147 @@
+/*
+ * KMix -- KDE's full featured mini mixer
+ *
+ *
+ * This program is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Library General Public
+ * License as published by the Free Software Foundation; either
+ * version 2 of the License, or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+ * Library General Public License for more details.
+ *
+ * You should have received a copy of the GNU Library General Public
+ * License along with this program; if not, write to the Free
+ * Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
+ */
+
+#include <klocale.h>
+
+#include "mixer_backend.h"
+// for the "ERR_" declartions, #include mixer.h
+#include "mixer.h"
+
+Mixer_Backend::Mixer_Backend(int device) :
+   m_devnum (device) , m_isOpen(false), m_recommendedMaster(0)
+{
+  m_mixDevices.setAutoDelete( true );
+}
+
+Mixer_Backend::~Mixer_Backend()
+{
+}
+
+
+bool Mixer_Backend::isValid() {
+	bool valid = false;
+	int ret = open();
+	if ( ret == 0  && m_mixDevices.count() > 0) {
+	  valid = true;
+	}
+	close();
+	return valid;
+}
+
+bool Mixer_Backend::isOpen() {
+  return m_isOpen;
+}
+
+/**
+ * Queries the backend driver whether there are new changes in any of the controls.
+ * If you cannot find out for a backend, return "true" - this is also the default implementation.
+ * @return true, if there are changes. Otherwise false is returned.
+ */
+bool Mixer_Backend::prepareUpdateFromHW() {
+  return true;
+}
+
+/**
+ * Return the MixDevice, that would qualify best as MasterDevice. The default is to return the
+ * first device in the device list. Backends can override this (i.e. the ALSA Backend does so).
+ * The users preference is NOT returned by this method - see the Mixer class for that.
+ */
+MixDevice* Mixer_Backend::recommendedMaster() {
+   MixDevice* recommendedMixDevice = 0;
+   if ( m_recommendedMaster != 0 ) {
+      recommendedMixDevice = m_recommendedMaster;
+   } // recommendation from Backend
+   else {
+      if ( m_mixDevices.count() > 0 ) {
+         recommendedMixDevice = m_mixDevices.at(0);
+      } //first device (if exists)
+   }
+   return recommendedMixDevice;
+}
+
+/**
+ * Sets the ID of the currently selected Enum entry.
+ * This is a dummy implementation - if the Mixer backend
+ * wants to support it, it must implement the driver specific 
+ * code in its subclass (see Mixer_ALSA.cpp for an example).
+ */
+void Mixer_Backend::setEnumIdHW(int, unsigned int) {
+  return;
+}
+
+/**
+ * Return the ID of the currently selected Enum entry.
+ * This is a dummy implementation - if the Mixer backend
+ * wants to support it, it must implement the driver specific
+ * code in its subclass (see Mixer_ALSA.cpp for an example).
+ */
+unsigned int Mixer_Backend::enumIdHW(int) {
+  return 0;
+}
+
+void Mixer_Backend::errormsg(int mixer_error)
+{
+  QString l_s_errText;
+  l_s_errText = errorText(mixer_error);
+  kdError() << l_s_errText << "\n";
+}
+
+QString Mixer_Backend::errorText(int mixer_error)
+{
+  QString l_s_errmsg;
+  switch (mixer_error)
+  {
+    case Mixer::ERR_PERM:
+      l_s_errmsg = i18n("kmix:You do not have permission to access the mixer device.\n" \
+	  "Please check your operating systems manual to allow the access.");
+      break;
+    case Mixer::ERR_WRITE:
+      l_s_errmsg = i18n("kmix: Could not write to mixer.");
+      break;
+    case Mixer::ERR_READ:
+      l_s_errmsg = i18n("kmix: Could not read from mixer.");
+      break;
+    case Mixer::ERR_NODEV:
+      l_s_errmsg = i18n("kmix: Your mixer does not control any devices.");
+      break;
+    case  Mixer::ERR_NOTSUPP:
+      l_s_errmsg = i18n("kmix: Mixer does not support your platform. See mixer.cpp for porting hints (PORTING).");
+      break;
+    case  Mixer::ERR_NOMEM:
+      l_s_errmsg = i18n("kmix: Not enough memory.");
+      break;
+    case Mixer::ERR_OPEN:
+    case Mixer::ERR_MIXEROPEN:
+      // ERR_MIXEROPEN means: Soundcard could be opened, but has no mixer. ERR_MIXEROPEN is normally never
+      //      passed to the errorText() method, because KMix handles that case explicitely
+      l_s_errmsg = i18n("kmix: Mixer cannot be found.\n" \
+	  "Please check that the soundcard is installed and that\n" \
+	  "the soundcard driver is loaded.\n");
+      break;
+    case Mixer::ERR_INCOMPATIBLESET:
+      l_s_errmsg = i18n("kmix: Initial set is incompatible.\n" \
+	  "Using a default set.\n");
+      break;
+    default:
+      l_s_errmsg = i18n("kmix: Unknown error. Please report how you produced this error.");
+      break;
+  }
+  return l_s_errmsg;
+}
+