/* Wellspring - An immediate mode font rendering system in C * * Copyright (c) 2022 Evan Hemsley * * 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. * * Evan "cosmonaut" Hemsley * */ #ifndef WELLSPRING_H #define WELLSPRING_H #ifdef _WIN32 #define WELLSPRINGAPI __declspec(dllexport) #define WELLSPRINGCALL __cdecl #else #define WELLSPRINGAPI #define WELLSPRINGCALL #endif #include #ifdef USE_SDL2 #include #endif #ifdef __cplusplus extern "C" { #endif /* __cplusplus */ /* Version API */ #define WELLSPRING_MAJOR_VERSION 0 #define WELLSPRING_MINOR_VERSION 3 #define WELLSPRING_PATCH_VERSION 0 #define WELLSPRING_COMPILED_VERSION ( \ (WELLSPRING_MAJOR_VERSION * 100 * 100) + \ (WELLSPRING_MINOR_VERSION * 100) + \ (WELLSPRING_PATCH_VERSION) \ ) WELLSPRINGAPI uint32_t Wellspring_LinkedVersion(void); /* Type definitions */ typedef struct Wellspring_Font Wellspring_Font; typedef struct Wellspring_TextBatch Wellspring_TextBatch; typedef struct Wellspring_FontRange { uint32_t firstCodepoint; uint32_t numChars; uint8_t oversampleH; uint8_t oversampleV; } Wellspring_FontRange; typedef struct Wellspring_Color { uint8_t r, g, b, a; } Wellspring_Color; typedef struct Wellspring_Vertex { float x, y, z; float u, v; uint8_t r, g, b, a; } Wellspring_Vertex; typedef struct Wellspring_Rectangle { float x; float y; float w; float h; } Wellspring_Rectangle; typedef enum Wellspring_HorizontalAlignment { WELLSPRING_HORIZONTALALIGNMENT_LEFT, WELLSPRING_HORIZONTALALIGNMENT_CENTER, WELLSPRING_HORIZONTALALIGNMENT_RIGHT } Wellspring_HorizontalAlignment; typedef enum Wellspring_VerticalAlignment { WELLSPRING_VERTICALALIGNMENT_BASELINE, WELLSPRING_VERTICALALIGNMENT_TOP, WELLSPRING_VERTICALALIGNMENT_MIDDLE, WELLSPRING_VERTICALALIGNMENT_BOTTOM } Wellspring_VerticalAlignment; /* API definition */ WELLSPRINGAPI Wellspring_Font* Wellspring_CreateFont( const uint8_t *fontBytes, uint32_t fontBytesLength, const uint8_t *atlasJsonBytes, uint32_t atlasJsonBytesLength, float *pPixelsPerEm, float *pDistanceRange ); /* Batches are not thread-safe, recommend one batch per thread. */ WELLSPRINGAPI Wellspring_TextBatch* Wellspring_CreateTextBatch(void); /* Also restarts the batch */ WELLSPRINGAPI void Wellspring_StartTextBatch( Wellspring_TextBatch *textBatch, Wellspring_Font *font ); WELLSPRINGAPI uint8_t Wellspring_TextBounds( Wellspring_Font *font, int pixelSize, Wellspring_HorizontalAlignment horizontalAlignment, Wellspring_VerticalAlignment verticalAlignment, const uint8_t *strBytes, uint32_t strLengthInBytes, Wellspring_Rectangle *pRectangle ); WELLSPRINGAPI uint8_t Wellspring_AddToTextBatch( Wellspring_TextBatch *textBatch, int pixelSize, Wellspring_Color *color, Wellspring_HorizontalAlignment horizontalAlignment, Wellspring_VerticalAlignment verticalAlignment, const uint8_t *strBytes, uint32_t strLengthInBytes ); WELLSPRINGAPI void Wellspring_GetBufferData( Wellspring_TextBatch *textBatch, uint32_t* pVertexCount, Wellspring_Vertex **pVertexBuffer, uint32_t *pVertexBufferLengthInBytes, uint32_t **pIndexBuffer, uint32_t *pIndexBufferLengthInBytes ); WELLSPRINGAPI void Wellspring_DestroyTextBatch(Wellspring_TextBatch *textBatch); WELLSPRINGAPI void Wellspring_DestroyFont(Wellspring_Font *font); #ifdef __cplusplus } #endif /* __cplusplus */ #endif /* WELLSPRING_H */