/* * Carla State utils * Copyright (C) 2012-2013 Filipe Coelho * * This program is free software; you can redistribute it and/or * modify it under the terms of the GNU General Public License as * published by the Free Software Foundation; either version 2 of * the License, or 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 General Public License for more details. * * For a full copy of the GNU General Public License see the GPL.txt file */ #ifndef __CARLA_STATE_UTILS_HPP__ #define __CARLA_STATE_UTILS_HPP__ #include "CarlaBackendUtils.hpp" #include "CarlaMIDI.h" #include "RtList.hpp" #include CARLA_BACKEND_START_NAMESPACE // ------------------------------------------------- struct StateParameter { uint32_t index; const char* name; const char* symbol; float value; uint8_t midiChannel; int16_t midiCC; StateParameter() : index(0), name(nullptr), symbol(nullptr), value(0.0f), midiChannel(0), midiCC(-1) {} ~StateParameter() { if (name != nullptr) delete[] name; if (symbol != nullptr) delete[] symbol; } CARLA_DECLARE_NON_COPY_STRUCT(StateParameter) }; struct StateCustomData { const char* type; const char* key; const char* value; StateCustomData() : type(nullptr), key(nullptr), value(nullptr) {} ~StateCustomData() { if (type != nullptr) delete[] type; if (key != nullptr) delete[] key; if (value != nullptr) delete[] value; } CARLA_DECLARE_NON_COPY_STRUCT(StateCustomData) }; typedef NonRtList StateParameterList; typedef NonRtList StateCustomDataList; typedef NonRtList::Itenerator StateParameterItenerator; typedef NonRtList::Itenerator StateCustomDataItenerator; struct SaveState { const char* type; const char* name; const char* label; const char* binary; long uniqueID; bool active; float dryWet; float volume; float balanceLeft; float balanceRight; float panning; int8_t ctrlChannel; int32_t currentProgramIndex; const char* currentProgramName; int32_t currentMidiBank; int32_t currentMidiProgram; const char* chunk; StateParameterList parameters; StateCustomDataList customData; SaveState() : type(nullptr), name(nullptr), label(nullptr), binary(nullptr), uniqueID(0), active(false), dryWet(1.0f), volume(1.0f), balanceLeft(-1.0f), balanceRight(1.0f), panning(0.0f), ctrlChannel(0), currentProgramIndex(-1), currentProgramName(nullptr), currentMidiBank(-1), currentMidiProgram(-1), chunk(nullptr) {} ~SaveState() { reset(); } void reset() { if (type != nullptr) { delete[] type; type = nullptr; } if (name != nullptr) { delete[] name; name = nullptr; } if (label != nullptr) { delete[] label; label = nullptr; } if (binary != nullptr) { delete[] binary; binary = nullptr; } if (currentProgramName != nullptr) { delete[] currentProgramName; currentProgramName = nullptr; } if (chunk != nullptr) { delete[] chunk; chunk = nullptr; } uniqueID = 0; active = false; dryWet = 1.0f; volume = 1.0f; balanceLeft = -1.0f; balanceRight = 1.0f; panning = 0.0f; ctrlChannel = 0; currentProgramIndex = -1; currentMidiBank = -1; currentMidiProgram = -1; for (StateParameterItenerator it = parameters.begin(); it.valid(); it.next()) { StateParameter* const stateParameter(*it); delete stateParameter; } for (StateCustomDataItenerator it = customData.begin(); it.valid(); it.next()) { StateCustomData* const stateCustomData(*it); delete stateCustomData; } parameters.clear(); customData.clear(); } CARLA_DECLARE_NON_COPY_STRUCT_WITH_LEAK_DETECTOR(SaveState) }; // ------------------------------------------------- static inline QString xmlSafeString(const QString& string, const bool toXml) { QString newString(string); if (toXml) return newString.replace("&","&").replace("<","<").replace(">",">").replace("'","'").replace("\"","""); else return newString.replace("&","&").replace("<","<").replace(">",">").replace("'","'").replace(""","\""); } static inline const char* xmlSafeStringChar(const QString& string, const bool toXml) { return carla_strdup(xmlSafeString(string, toXml).toUtf8().constData()); } // ------------------------------------------------- static inline const SaveState& getSaveStateDictFromXML(const QDomNode& xmlNode) { static SaveState saveState; saveState.reset(); if (xmlNode.isNull()) return saveState; QDomNode node(xmlNode.firstChild()); while (! node.isNull()) { // ------------------------------------------------------ // Info if (node.toElement().tagName().compare("Info", Qt::CaseInsensitive) == 0) { QDomNode xmlInfo(node.toElement().firstChild()); while (! xmlInfo.isNull()) { const QString tag(xmlInfo.toElement().tagName()); const QString text(xmlInfo.toElement().text().trimmed()); if (tag.compare("Type", Qt::CaseInsensitive) == 0) saveState.type = xmlSafeStringChar(text, false); else if (tag.compare("Name", Qt::CaseInsensitive) == 0) saveState.name = xmlSafeStringChar(text, false); else if (tag.compare("Label", Qt::CaseInsensitive) == 0 || tag.compare("URI", Qt::CaseInsensitive) == 0) saveState.label = xmlSafeStringChar(text, false); else if (tag.compare("Binary", Qt::CaseInsensitive) == 0) saveState.binary = xmlSafeStringChar(text, false); else if (tag.compare("UniqueID", Qt::CaseInsensitive) == 0) { bool ok; long uniqueID = text.toLong(&ok); if (ok) saveState.uniqueID = uniqueID; } xmlInfo = xmlInfo.nextSibling(); } } // ------------------------------------------------------ // Data else if (node.toElement().tagName().compare("Data", Qt::CaseInsensitive) == 0) { QDomNode xmlData(node.toElement().firstChild()); while (! xmlData.isNull()) { const QString tag(xmlData.toElement().tagName()); const QString text(xmlData.toElement().text().trimmed()); // ---------------------------------------------- // Internal Data if (tag.compare("Active", Qt::CaseInsensitive) == 0) { saveState.active = (text.compare("Yes", Qt::CaseInsensitive) == 0); } else if (tag.compare("DryWet", Qt::CaseInsensitive) == 0) { bool ok; float value = text.toFloat(&ok); if (ok) saveState.dryWet = value; } else if (tag.compare("Volume", Qt::CaseInsensitive) == 0) { bool ok; float value = text.toFloat(&ok); if (ok) saveState.volume = value; } else if (tag.compare("Balance-Left", Qt::CaseInsensitive) == 0) { bool ok; float value = text.toFloat(&ok); if (ok) saveState.balanceLeft = value; } else if (tag.compare("Balance-Right", Qt::CaseInsensitive) == 0) { bool ok; float value = text.toFloat(&ok); if (ok) saveState.balanceRight = value; } else if (tag.compare("Panning", Qt::CaseInsensitive) == 0) { bool ok; float value = text.toFloat(&ok); if (ok) saveState.panning = value; } else if (tag.compare("ControlChannel", Qt::CaseInsensitive) == 0) { bool ok; short value = text.toShort(&ok); if (ok && value >= 1 && value < INT8_MAX) saveState.ctrlChannel = static_cast(value-1); } // ---------------------------------------------- // Program (current) else if (tag.compare("CurrentProgramIndex", Qt::CaseInsensitive) == 0) { bool ok; int value = text.toInt(&ok); if (ok && value >= 1) saveState.currentProgramIndex = value-1; } else if (tag.compare("CurrentProgramName", Qt::CaseInsensitive) == 0) { saveState.currentProgramName = xmlSafeStringChar(text, false); } // ---------------------------------------------- // Midi Program (current) else if (tag.compare("CurrentMidiBank", Qt::CaseInsensitive) == 0) { bool ok; int value = text.toInt(&ok); if (ok && value >= 1) saveState.currentMidiBank = value-1; } else if (tag.compare("CurrentMidiProgram", Qt::CaseInsensitive) == 0) { bool ok; int value = text.toInt(&ok); if (ok && value >= 1) saveState.currentMidiProgram = value-1; } // ---------------------------------------------- // Parameters else if (tag.compare("Parameter", Qt::CaseInsensitive) == 0) { StateParameter* const stateParameter(new StateParameter()); QDomNode xmlSubData(xmlData.toElement().firstChild()); while (! xmlSubData.isNull()) { const QString pTag(xmlSubData.toElement().tagName()); const QString pText(xmlSubData.toElement().text().trimmed()); if (pTag.compare("Index", Qt::CaseInsensitive) == 0) { bool ok; uint index = pText.toUInt(&ok); if (ok) stateParameter->index = index; } else if (pTag.compare("Name", Qt::CaseInsensitive) == 0) { stateParameter->name = xmlSafeStringChar(pText, false); } else if (pTag.compare("Symbol", Qt::CaseInsensitive) == 0) { stateParameter->symbol = xmlSafeStringChar(pText, false); } else if (pTag.compare("Value", Qt::CaseInsensitive) == 0) { bool ok; float value = pText.toFloat(&ok); if (ok) stateParameter->value = value; } else if (pTag.compare("MidiChannel", Qt::CaseInsensitive) == 0) { bool ok; ushort channel = pText.toUShort(&ok); if (ok && channel >= 1 && channel < MAX_MIDI_CHANNELS) stateParameter->midiChannel = static_cast(channel-1); } else if (pTag.compare("MidiCC", Qt::CaseInsensitive) == 0) { bool ok; int cc = pText.toInt(&ok); if (ok && cc >= 1 && cc < INT16_MAX) stateParameter->midiCC = static_cast(cc); } xmlSubData = xmlSubData.nextSibling(); } saveState.parameters.append(stateParameter); } // ---------------------------------------------- // Custom Data else if (tag.compare("CustomData", Qt::CaseInsensitive) == 0) { StateCustomData* const stateCustomData(new StateCustomData()); QDomNode xmlSubData(xmlData.toElement().firstChild()); while (! xmlSubData.isNull()) { const QString cTag(xmlSubData.toElement().tagName()); const QString cText(xmlSubData.toElement().text().trimmed()); if (cTag.compare("Type", Qt::CaseInsensitive) == 0) stateCustomData->type = xmlSafeStringChar(cText, false); else if (cTag.compare("Key", Qt::CaseInsensitive) == 0) stateCustomData->key = xmlSafeStringChar(cText, false); else if (cTag.compare("Value", Qt::CaseInsensitive) == 0) stateCustomData->value = xmlSafeStringChar(cText, false); xmlSubData = xmlSubData.nextSibling(); } saveState.customData.append(stateCustomData); } // ---------------------------------------------- // Chunk else if (tag.compare("Chunk", Qt::CaseInsensitive) == 0) { saveState.chunk = xmlSafeStringChar(text, false); } // ---------------------------------------------- xmlData = xmlData.nextSibling(); } } // ------------------------------------------------------ node = node.nextSibling(); } return saveState; } // ------------------------------------------------- static inline const QString& getXMLFromSaveState(const SaveState& saveState) { static QString content; content.clear(); { QString info(" \n"); info += QString(" %1\n").arg(saveState.type); info += QString(" %1\n").arg(xmlSafeString(saveState.name, true)); switch (getPluginTypeFromString(saveState.type)) { case PLUGIN_NONE: break; case PLUGIN_INTERNAL: info += QString(" \n").arg(xmlSafeString(saveState.label, true)); break; case PLUGIN_LADSPA: info += QString(" %1\n").arg(xmlSafeString(saveState.binary, true)); info += QString(" \n").arg(xmlSafeString(saveState.label, true)); info += QString(" %1\n").arg(saveState.uniqueID); break; case PLUGIN_DSSI: info += QString(" %1\n").arg(xmlSafeString(saveState.binary, true)); info += QString(" \n").arg(xmlSafeString(saveState.label, true)); break; case PLUGIN_LV2: info += QString(" %1\n").arg(xmlSafeString(saveState.label, true)); break; case PLUGIN_VST: info += QString(" %1\n").arg(xmlSafeString(saveState.binary, true)); info += QString(" %1\n").arg(saveState.uniqueID); break; case PLUGIN_VST3: // TODO? info += QString(" %1\n").arg(xmlSafeString(saveState.binary, true)); info += QString(" %1\n").arg(saveState.uniqueID); break; case PLUGIN_GIG: case PLUGIN_SF2: case PLUGIN_SFZ: info += QString(" %1\n").arg(xmlSafeString(saveState.binary, true)); info += QString(" \n").arg(xmlSafeString(saveState.label, true)); break; } info += " \n\n"; content += info; } { QString data(" \n"); data += QString(" %1\n").arg(saveState.active ? "Yes" : "No"); if (saveState.dryWet != 1.0f) data += QString(" %1\n").arg(saveState.dryWet); if (saveState.volume != 1.0f) data += QString(" %1\n").arg(saveState.volume); if (saveState.balanceLeft != -1.0f) data += QString(" %1\n").arg(saveState.balanceLeft); if (saveState.balanceRight != 1.0f) data += QString(" %1\n").arg(saveState.balanceRight); if (saveState.panning != 0.0f) data += QString(" %1\n").arg(saveState.panning); data += QString(" %1\n").arg(saveState.ctrlChannel+1); content += data; } for (StateParameterItenerator it = saveState.parameters.begin(); it.valid(); it.next()) { StateParameter* const stateParameter(*it); QString parameter("\n"" \n"); parameter += QString(" %1\n").arg(stateParameter->index); parameter += QString(" %1\n").arg(xmlSafeString(stateParameter->name, true)); if (stateParameter->symbol != nullptr && *stateParameter->symbol != '\0') parameter += QString(" %1\n").arg(xmlSafeString(stateParameter->symbol, true)); parameter += QString(" %1\n").arg(stateParameter->value); if (stateParameter->midiCC > 0) { parameter += QString(" %1\n").arg(stateParameter->midiCC); parameter += QString(" %1\n").arg(stateParameter->midiChannel+1); } parameter += " \n"; content += parameter; } if (saveState.currentProgramIndex >= 0 && saveState.currentProgramName != nullptr) { // ignore 'default' program #ifdef __USE_GNU if ((saveState.currentProgramIndex > 0 || strcasecmp(saveState.currentProgramName, "Default") != 0)) #else if ((saveState.currentProgramIndex > 0 || std::strcmp(saveState.currentProgramName, "Default") != 0)) #endif { QString program("\n"); program += QString(" %1\n").arg(saveState.currentProgramIndex+1); program += QString(" %1\n").arg(xmlSafeString(saveState.currentProgramName, true)); content += program; } } if (saveState.currentMidiBank >= 0 && saveState.currentMidiProgram >= 0) { QString midiProgram("\n"); midiProgram += QString(" %1\n").arg(saveState.currentMidiBank+1); midiProgram += QString(" %1\n").arg(saveState.currentMidiProgram+1); content += midiProgram; } for (StateCustomDataItenerator it = saveState.customData.begin(); it.valid(); it.next()) { StateCustomData* const stateCustomData(*it); QString customData("\n"" \n"); customData += QString(" %1\n").arg(xmlSafeString(stateCustomData->type, true)); customData += QString(" %1\n").arg(xmlSafeString(stateCustomData->key, true)); if (std::strcmp(stateCustomData->type, CUSTOM_DATA_CHUNK) == 0 || std::strlen(stateCustomData->value) >= 128) { customData += " \n"; customData += QString("%1\n").arg(xmlSafeString(stateCustomData->value, true)); customData += " \n"; } else customData += QString(" %1\n").arg(xmlSafeString(stateCustomData->value, true)); customData += " \n"; content += customData; } if (saveState.chunk != nullptr && *saveState.chunk != '\0') { QString chunk("\n"" \n"); chunk += QString("%1\n").arg(saveState.chunk); chunk += " \n"; content += chunk; } content += " \n"; return content; } // ------------------------------------------------- CARLA_BACKEND_END_NAMESPACE #endif // __CARLA_STATE_UTILS_HPP__