MsxChar2Unicode.hh

Go to the documentation of this file.

#ifndef MSXCHAR2UNICODE_HH
#define MSXCHAR2UNICODE_HH
 
#include <array>
#include <cstdint>
#include <functional>
#include <span>
#include <string>
#include <string_view>
#include <vector>
 
namespace openmsx {
 
class MsxChar2Unicode
{
public:
        explicit MsxChar2Unicode(std::string_view mappingName);
 
        [[nodiscard]] std::string msxToUtf8(
                std::span<const uint8_t> msx,
                const std::function<uint32_t(uint8_t)>& fallback) const;
        [[nodiscard]] std::vector<uint8_t> utf8ToMsx(
                std::string_view utf8,
                const std::function<uint8_t(uint32_t)>& fallback) const;
 
        [[nodiscard]] std::string msxToUtf8(std::span<const uint8_t> msx, char fallback) const;
        [[nodiscard]] std::vector<uint8_t> utf8ToMsx(std::string_view utf8, char fallback) const;
 
private:
        void parseVid(std::string_view file);
 
private:
        // LUT: msx graphical character code (as stored in VRAM) -> unicode character
        // Some entries are not filled in (are invalid), they contain the value -1.
        // There may be different (valid) entries that contain the same value.
        std::array<uint32_t, 256> msx2unicode;
 
        // Reverse LUT: unicode character -> msx graphical character
        struct Entry {
                Entry(uint32_t u, uint8_t m) : unicode(u), msx(m) {}
                uint32_t unicode;
                uint8_t msx;
        };
        // Sorted on Entry::unicode. All 'unicode' fields are unique, but
        // there can be different entries that have the same 'msx' field.
        std::vector<Entry> unicode2msx;
};
 
} // namespace openmsx
 
#endif