Tachikoma
eabb9ad376
TODO.md carried two records in one file: what had been done, with the measurements behind it, and what was left. The second half is what a tracker is for, and keeping it here has already cost something -- AGENTS.md records a round where eleven entries described code that had already changed, and this file admitted to three more. Every open item is now an issue on source.starfort.tech/andrew/libakgl, labelled by kind and blast radius and milestoned by what it can land in: 0.9.x for anything that breaks no ABI, 0.10.0 for new or changed public symbols, 1.0.0 for the design work. Four are epics: the performance plan (#60), coverage (#61), actor rotation (#62), and the false header comments (#63). Verified against the tree before filing rather than transcribed. Three entries were already fixed and were not filed: the akgl_path_relative context leak, the akgl_draw_background test extension, and the SDL enumeration audit -- keyboards, gamepads and mappings are all freed in CLEANUP today. Two were reworded because the code had moved: the fonts item is a missing teardown entry point rather than a missing API, since akgl_text_unloadallfonts exists, and draw_world's tilemap call is already bounded by numlayers, so only the per-layer actor rescan remains. TODO.md keeps the part a tracker has no place for: why a decision went the way it did, what the measurement was, and which arguments turned out to be wrong. TODO.txt is deleted. Four of its eight entries had shipped -- actor-to-actor collision, actor-to-world collision, automatic facing, image layers -- and the four that had not are #74 through #77, with the GPU renderer's research links kept because that is the part that took the time. Every reference that named an item number or a moved section is repointed, in the manual, the headers, the tests and the examples. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
126 lines
3.9 KiB
C
126 lines
3.9 KiB
C
/**
|
|
* @file textbox.c
|
|
* @brief The dialogue panel: two rectangles and a string, drawn over the world.
|
|
*
|
|
* Text in libakgl is immediate mode. Every akgl_text_rendertextat call
|
|
* rasterizes the string through SDL_ttf, uploads it as a texture, blits it and
|
|
* destroys the texture again -- there is no cached glyph atlas and no text
|
|
* object to hold on to. That is the wrong shape for a page of static prose
|
|
* redrawn sixty times a second and exactly the right shape for this: one short
|
|
* line, on screen only while somebody is talking.
|
|
*/
|
|
|
|
#include <stdbool.h>
|
|
|
|
#include <SDL3/SDL.h>
|
|
#include <SDL3_ttf/SDL_ttf.h>
|
|
#include <akerror.h>
|
|
#include <akstdlib.h>
|
|
|
|
#include <akgl/draw.h>
|
|
#include <akgl/error.h>
|
|
#include <akgl/game.h>
|
|
#include <akgl/registry.h>
|
|
#include <akgl/text.h>
|
|
|
|
#include "jrpg.h"
|
|
|
|
/*
|
|
* Colour R G B A
|
|
*/
|
|
static const SDL_Color TEXTBOX_FILL = { 24, 20, 37, 235 };
|
|
static const SDL_Color TEXTBOX_EDGE = { 240, 236, 214, 255 };
|
|
static const SDL_Color TEXTBOX_INK = { 240, 236, 214, 255 };
|
|
|
|
/** @brief Pixels between the panel and the edges of the screen. */
|
|
#define TEXTBOX_MARGIN 8.0f
|
|
/** @brief Panel height in pixels. Two lines of 12pt monospace, plus padding. */
|
|
#define TEXTBOX_HEIGHT 56.0f
|
|
/** @brief Pixels between the panel's edge and the text inside it. */
|
|
#define TEXTBOX_PADDING 8.0f
|
|
|
|
static char textbox_text[JRPG_TEXTBOX_MAX_TEXT];
|
|
static bool textbox_visible = false;
|
|
|
|
bool jrpg_textbox_showing(void)
|
|
{
|
|
return textbox_visible;
|
|
}
|
|
|
|
void jrpg_textbox_close(void)
|
|
{
|
|
textbox_visible = false;
|
|
}
|
|
|
|
akerr_ErrorContext *jrpg_textbox_open(char *text)
|
|
{
|
|
PREPARE_ERROR(errctx);
|
|
|
|
FAIL_ZERO_RETURN(errctx, text, AKERR_NULLPOINTER, "text");
|
|
// aksl_strncpy, not strncpy: this is a fixed-width field, and strncpy at
|
|
// exactly the field width leaves it unterminated. Bounded at one less than
|
|
// the field so an over-long line truncates rather than being refused.
|
|
PASS(errctx,
|
|
aksl_strncpy(
|
|
textbox_text,
|
|
sizeof(textbox_text),
|
|
text,
|
|
sizeof(textbox_text) - 1
|
|
));
|
|
textbox_visible = true;
|
|
SUCCEED_RETURN(errctx);
|
|
}
|
|
|
|
akerr_ErrorContext *jrpg_textbox_draw(void)
|
|
{
|
|
PREPARE_ERROR(errctx);
|
|
TTF_Font *font = NULL;
|
|
SDL_FRect panel;
|
|
|
|
if ( textbox_visible == false ) {
|
|
SUCCEED_RETURN(errctx);
|
|
}
|
|
// akgl_text_rendertextat refuses the empty string -- SDL_ttf reports "Text
|
|
// has zero width" and the library passes that on as AKERR_NULLPOINTER,
|
|
// while akgl_text_measure accepts it. The two disagree, so anything drawing
|
|
// a line that might be empty checks for it. TODO.md, "Found while
|
|
// rewriting the Doxygen comments".
|
|
if ( textbox_text[0] == '\0' ) {
|
|
SUCCEED_RETURN(errctx);
|
|
}
|
|
|
|
// Fonts live in a registry under a name, not in an akgl type. There is no
|
|
// handle to keep, and no reference counting either: whoever calls
|
|
// akgl_text_unloadfont invalidates every pointer anybody else fetched.
|
|
// Fetching it per frame is the cheap way to stay honest about that.
|
|
font = SDL_GetPointerProperty(AKGL_REGISTRY_FONT, JRPG_FONT_NAME, NULL);
|
|
FAIL_ZERO_RETURN(
|
|
errctx,
|
|
font,
|
|
AKGL_ERR_REGISTRY,
|
|
"No font registered as \"%s\"",
|
|
JRPG_FONT_NAME
|
|
);
|
|
|
|
// Screen coordinates, from the camera's size rather than from a second copy
|
|
// of the window dimensions. akgl_render_2d_init put them there.
|
|
panel.x = TEXTBOX_MARGIN;
|
|
panel.w = akgl_camera->w - (2.0f * TEXTBOX_MARGIN);
|
|
panel.h = TEXTBOX_HEIGHT;
|
|
panel.y = akgl_camera->h - TEXTBOX_MARGIN - panel.h;
|
|
|
|
PASS(errctx, akgl_draw_filled_rect(akgl_renderer, &panel, TEXTBOX_FILL));
|
|
PASS(errctx, akgl_draw_rect(akgl_renderer, &panel, TEXTBOX_EDGE));
|
|
PASS(errctx,
|
|
akgl_text_rendertextat(
|
|
font,
|
|
textbox_text,
|
|
TEXTBOX_INK,
|
|
(int)(panel.w - (2.0f * TEXTBOX_PADDING)),
|
|
(int)(panel.x + TEXTBOX_PADDING),
|
|
(int)(panel.y + TEXTBOX_PADDING)
|
|
));
|
|
|
|
SUCCEED_RETURN(errctx);
|
|
}
|