ConsoleFont.h

/*
 * Gamedev Framework (gf)
 * Copyright (C) 2016-2021 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