94 lines
2.5 KiB
C
94 lines
2.5 KiB
C
|
/*
|
||
|
|
* tuningCollection.h
|
||
|
|
* ------------------
|
||
|
|
* Purpose: Alternative sample tuning collection class.
|
||
|
|
* Notes : (currently none)
|
||
|
|
* Authors: OpenMPT Devs
|
||
|
|
* The OpenMPT source code is released under the BSD license. Read LICENSE for more details.
|
||
|
|
*/
|
||
|
|
|
||
|
|
|
||
|
|
#pragma once
|
||
|
|
|
||
|
|
#include "BuildSettings.h"
|
||
|
|
|
||
|
|
#include "tuning.h"
|
||
|
|
#include <vector>
|
||
|
|
#include <string>
|
||
|
|
|
||
|
|
|
||
|
|
OPENMPT_NAMESPACE_BEGIN
|
||
|
|
|
||
|
|
|
||
|
|
namespace Tuning {
|
||
|
|
|
||
|
|
|
||
|
|
class CTuningCollection
|
||
|
|
{
|
||
|
|
|
||
|
|
public:
|
||
|
|
|
||
|
|
static constexpr char s_FileExtension[4] = ".tc";
|
||
|
|
|
||
|
|
// OpenMPT <= 1.26 had to following limits:
|
||
|
|
// * 255 built-in tunings (only 2 were ever actually provided)
|
||
|
|
// * 255 local tunings
|
||
|
|
// * 255 tune-specific tunings
|
||
|
|
// As 1.27 copies all used tunings into the module, the limit of 255 is no
|
||
|
|
// longer sufficient. In the worst case scenario, the module contains 255
|
||
|
|
// unused tunings and uses 255 local ones. In addition to that, allow the
|
||
|
|
// user to additionally import both built-in tunings.
|
||
|
|
// Older OpenMPT versions will silently skip loading tunings beyond index
|
||
|
|
// 255.
|
||
|
|
enum : size_t { s_nMaxTuningCount = 255 + 255 + 2 };
|
||
|
|
|
||
|
|
public:
|
||
|
|
|
||
|
|
// returns observer ptr if successfull
|
||
|
|
CTuning* AddTuning(std::unique_ptr<CTuning> pT);
|
||
|
|
CTuning* AddTuning(std::istream &inStrm, mpt::Charset defaultCharset);
|
||
|
|
|
||
|
|
bool Remove(const std::size_t i);
|
||
|
|
bool Remove(const CTuning *pT);
|
||
|
|
|
||
|
|
CTuning& GetTuning(size_t i) {return *m_Tunings.at(i).get();}
|
||
|
|
const CTuning& GetTuning(size_t i) const {return *m_Tunings.at(i).get();}
|
||
|
|
CTuning* GetTuning(const mpt::ustring &name);
|
||
|
|
const CTuning* GetTuning(const mpt::ustring &name) const;
|
||
|
|
|
||
|
|
size_t GetNumTunings() const {return m_Tunings.size();}
|
||
|
|
|
||
|
|
Tuning::SerializationResult Serialize(std::ostream &oStrm, const mpt::ustring &name) const;
|
||
|
|
Tuning::SerializationResult Deserialize(std::istream &iStrm, mpt::ustring &name, mpt::Charset defaultCharset);
|
||
|
|
|
||
|
|
auto begin() { return m_Tunings.begin(); }
|
||
|
|
auto begin() const { return m_Tunings.begin(); }
|
||
|
|
auto cbegin() { return m_Tunings.cbegin(); }
|
||
|
|
auto end() { return m_Tunings.end(); }
|
||
|
|
auto end() const { return m_Tunings.end(); }
|
||
|
|
auto cend() { return m_Tunings.cend(); }
|
||
|
|
|
||
|
|
private:
|
||
|
|
|
||
|
|
std::vector<std::unique_ptr<CTuning> > m_Tunings;
|
||
|
|
|
||
|
|
private:
|
||
|
|
|
||
|
|
Tuning::SerializationResult DeserializeOLD(std::istream &inStrm, mpt::ustring &uname, mpt::Charset defaultCharset);
|
||
|
|
|
||
|
|
};
|
||
|
|
|
||
|
|
|
||
|
|
#ifdef MODPLUG_TRACKER
|
||
|
|
bool UnpackTuningCollection(const CTuningCollection &tc, const mpt::PathString &prefix);
|
||
|
|
#endif
|
||
|
|
|
||
|
|
|
||
|
|
} // namespace Tuning
|
||
|
|
|
||
|
|
|
||
|
|
typedef Tuning::CTuningCollection CTuningCollection;
|
||
|
|
|
||
|
|
|
||
|
|
OPENMPT_NAMESPACE_END
|