ConsoleFont.h

/*
 * Gamedev Framework (gf)
 * Copyright (C) 2016-2022 Julien Bernard
 *
 * This software is provided 'as-is', without any express or implied
 * warranty.  In no event will the authors be held liable for any damages
 * arising from the use of this software.
 *
 * Permission is granted to anyone to use this software for any purpose,
 * including commercial applications, and to alter it and redistribute it
 * freely, subject to the following restrictions:
 *
 * 1. The origin of this software must not be misrepresented; you must not
 *    claim that you wrote the original software. If you use this software
 *    in a product, an acknowledgment in the product documentation would be
 *    appreciated but is not required.
 * 2. Altered source versions must be plainly marked as such, and must not be
 *    misrepresented as being the original software.
 * 3. This notice may not be removed or altered from any source distribution.
 */
#ifndef GF_CONSOLE_FONT_H
#define GF_CONSOLE_FONT_H
 
#include <string_view>
 
#include "GraphicsApi.h"
#include "Path.h"
#include "Span.h"
#include "Texture.h"
#include "Vector.h"
 
namespace gf {
#ifndef DOXYGEN_SHOULD_SKIP_THIS
inline namespace v1 {
#endif
 
  struct GF_GRAPHICS_API ConsoleFontFormat {
    enum Transparency {
      Alpha,      
      Grayscale,  
      ColorKey,   
    };
 
    Transparency transparency; 
 
    enum Layout {
      InColumn, 
      InRow,    
    };
 
    Layout layout; 
 
    enum Mapping {
      CodePage437,          
      ModifiedCodePage437,  
      Special,              
      Custom,               
    };
 
    Mapping mapping; 
  };
 
  struct GF_GRAPHICS_API ConsoleFontElement {
    char16_t character; 
    uint8_t index;      
  };
 
  struct GF_GRAPHICS_API PredefinedConsoleFontFormat {
    static constexpr ConsoleFontFormat Libtcod = { ConsoleFontFormat::ColorKey, ConsoleFontFormat::InRow, ConsoleFontFormat::Special };
 
    static constexpr ConsoleFontFormat DwarfFortress = { ConsoleFontFormat::ColorKey, ConsoleFontFormat::InRow, ConsoleFontFormat::CodePage437 };
  };
 
  class GF_GRAPHICS_API ConsoleFont {
  public:
    ConsoleFont();
 
    ConsoleFont(const Image& image, ConsoleFontFormat format, Vector2i size);
 
    virtual ~ConsoleFont();
 
    ConsoleFontFormat getFormat() const {
      return m_format;
    }
 
    Vector2i getSize() const {
      return m_size;
    }
 
    Vector2i getCharacterSize() const {
      return m_characterSize;
    }
 
    void mapCode(char16_t c, Vector2i position);
 
    void mapCodeRange(char16_t c, int count, Vector2i position);
 
    void mapString(std::string_view str, Vector2i position);
 
    void mapElement(ConsoleFontElement element);
 
    void mapElements(Span<const ConsoleFontElement> elements);
 
    void clearMapping();
 
    RectI getSubTexture(char16_t c) const;
 
    RectF getTextureRect(char16_t c) const;
 
    virtual const BareTexture *getTexture() const = 0;
 
  protected:
    void logFormat(const Path& filename) const;
 
    Vector2i getColorKeyPosition() const;
 
  private:
    std::vector<uint8_t> m_mapping;
    ConsoleFontFormat m_format;
    Vector2i m_size;
    Vector2i m_characterSize;
  };
 
  class GF_GRAPHICS_API BitmapConsoleFont : public ConsoleFont {
  public:
    BitmapConsoleFont(const Image& image, ConsoleFontFormat format, Vector2i size = { 0u, 0u });
 
    BitmapConsoleFont(const Path& filename, ConsoleFontFormat format, Vector2i size = { 0u, 0u });
 
    const BareTexture *getTexture() const override;
 
  private:
    AlphaTexture m_texture;
  };
 
  class GF_GRAPHICS_API ColoredConsoleFont : public ConsoleFont {
  public:
    ColoredConsoleFont(const Image& image, ConsoleFontFormat format, Vector2i size = { 0u, 0u });
 
    ColoredConsoleFont(const Path& filename, ConsoleFontFormat format, Vector2i size = { 0u, 0u });
 
    const BareTexture *getTexture() const override;
 
  private:
    Texture m_texture;
  };
 
 
#ifndef DOXYGEN_SHOULD_SKIP_THIS
}
#endif
}
 
#endif // GF_CONSOLE_FONT_H