src/ascension/ui/font.h

Thu, 18 Apr 2024 22:53:55 +0200

author
Mike Becker <universe@uap-core.de>
date
Thu, 18 Apr 2024 22:53:55 +0200
changeset 65
9c44c55d327a
parent 48
6e5b5ba2752c
child 66
8297afa1c29c
permissions
-rw-r--r--

consistently refer to windows by ID - fixes #381

This change discovered that the font cache is completely broken. We created issue #387 for this.

     1 /*
     2  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
     3  * Copyright 2023 Mike Becker. All rights reserved.
     4  *
     5  * Redistribution and use in source and binary forms, with or without
     6  * modification, are permitted provided that the following conditions are met:
     7  *
     8  *   1. Redistributions of source code must retain the above copyright
     9  *      notice, this list of conditions and the following disclaimer.
    10  *
    11  *   2. Redistributions in binary form must reproduce the above copyright
    12  *      notice, this list of conditions and the following disclaimer in the
    13  *      documentation and/or other materials provided with the distribution.
    14  *
    15  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
    16  * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
    17  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
    18  * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
    19  * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
    20  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
    21  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
    22  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
    23  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
    24  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
    25  * POSSIBILITY OF SUCH DAMAGE.
    26  */
    28 #ifndef ASCENSION_FONT_H
    29 #define ASCENSION_FONT_H
    31 #include <SDL2/SDL_ttf.h>
    33 #ifndef ASC_MAX_FONTS
    34 /** The maximum number of style/size combinations that can be loaded in parallel. */
    35 #define ASC_MAX_FONTS 64u
    36 #endif // ASC_MAX_FONTS
    38 enum AscFontStyle {
    39     ASC_FONT_REGULAR,
    40     ASC_FONT_BOLD,
    41     ASC_FONT_ITALIC,
    42     ASC_FONT_BOLD_ITALIC,
    43 };
    45 typedef struct AscFont {
    46     /**
    47      * Style of the font.
    48      */
    49     enum AscFontStyle style;
    50     /**
    51      * Point size.
    52      */
    53     int size;
    54     /**
    55      * TODO: remove from public struct
    56      * Pointer to the SDL TTF font structure.
    57      */
    58     TTF_Font *ptr;
    59 } AscFont;
    61 /**
    62  * Activates a font with the given style and size.
    63  *
    64  * The font is cached and activated faster the next time you call this
    65  * function with the same arguments. However, when you reach the maximum
    66  * number of fonts, the cache is completely cleared and rebuilt.
    67  *
    68  * That means in general, that you should not be using too many fonts of
    69  * different sizes at the same time.
    70  *
    71  * @param style the style
    72  * @param size the point size
    73  */
    74 void asc_font(enum AscFontStyle style, int size);
    76 #endif //ASCENSION_FONT_H

mercurial