So we\u2019ve developed the theories<\/a>, we\u2019ve got mockups<\/a>, we\u2019ve got the necessary architecture<\/a>\u2026 surely it\u2019s time to start building the new UI layout, yeah? Not so fast!<\/p>\n It\u2019s true we could start now, but on the horizon I could already see the increasing usefulness of another supporting feature, and decided it was a good opportunity to finally automate Cogmind\u2019s font scaling.<\/p>\n Cogmind has always included many fonts available at many different sizes, all of these stored as bitmaps for pixel-perfect crispness. Each requires its own image file, and in the past I have always manually upscaled them to ensure availability at the appropriate higher resolutions, which means even more files.<\/p>\n Well with the advent of map zooming<\/a>, which itself needs 2x upscale versions of all fonts within each set, and this whole UI upscale project, which unlocks an average 33% font size increase for everyone, we\u2019re going to need quite a few more upscaled bitmap font files and going forward it doesn\u2019t really make much sense to keep doing this manually.<\/p>\n Okay if anyone\u2019s keeping count this will be the fourth<\/em> time I\u2019ve revisited the engine for a major update since starting map zoom and UI scaling work xD<\/p>\n Hi, REX.<\/p>\n I thought this would be a quick project, but it actually took several days to finally finish this feature because I ended up rewriting a lot<\/em> of the engine\u2019s font handling code, encountering a few challenging (hair-ripping) bugs along the way. The original system had made a lot of assumptions which would no longer hold true, and I wanted more features on top of the autoscaling as well, like only generating upscaled fonts once they\u2019re actually needed (yay for faster startup), and having all font sets reusing the same source file share a single reference image in memory rather than having multiple copies of the same bitmap. Individually nothing too complex, just a lot of changes necessary to the original architecture to make these features possible.<\/p>\n Once again back in the good old REX testing environment, I set to testing two new syntax options for the font set configuration file:<\/p>\n A sample config file used during REX testing, in some cases with font sets purely loaded from files, and in others partially or fully generated based on existing sets or bitmaps.<\/p>\n<\/div>\n This same format is used by anything else built on the engine, so both Cogmind and REXPaint<\/a> can benefit from this, the latter of which I hope to also release a new version before long!<\/p>\n A quick autoscaling test back in Cogmind, here using a 2x scale of a 4\u00d78 font, therefore turning it into a 8\u00d716 font for a 960p window. (This 4\u00d78 font is technically distributed with Cogmind, but since it\u2019s too small to be reasonably considered by players, or needed at all, it is not available by default and must be activated manually.)<\/p>\n<\/div>\n Cogmind\u2019s last public release, Beta 12, includes a total of 118 bitmaps font images, and that was before<\/em> all the map zooming and Beta 13 work, so without this autoscaling feature that number would balloon significantly.<\/p>\n As of writing, Beta 13 has currently dropped that file count to 80, this despite the zooming, nine brand new font types, and supporting even more large options derived from smaller ones.<\/p>\n I had to spend a while going back through all those files to confirm which were original files and which were upscaled–in most cases there were records, but I had to be sure, and did find a few outliers to which I made further manual modifications to their upscaled versions, or sourced from multiple different sets. Those required special treatment, but otherwise it was really nice to cut down on the clutter.<\/p>\n Comparing Cogmind\u2019s original font config file to the new one with automated upscaling enabled (and zoom support!).<\/p>\n<\/div>\n As of the current Beta 13 prerelease, the current max font size included with Cogmind is 48, needed for 5K displays, but with the new upscaled UI the max needed for that resolution will be 64! Definitely about time to get automated scaling\u2026<\/p>\n New font sizes aside, this also saves time when new tiles are added and need to be inserted throughout the images, since tiles themselves are also part of the font bitmaps. Tiles aren\u2019t added very often, but a new batch is indeed being released gradually over the next several versions.<\/p>\n Since I was working with fonts anyway, I also took advantage of this opportunity to add brand new options! In classic terminal roguelike style, some people like to switch their display font after a while in order to freshen up the whole experience, so in addition to others who simply want more options from which to select their favorite for readability or stylistic preferences, that\u2019s another good reason to make sure there is a good variety of styles available.<\/p>\n The main two new typefaces are Tamsyn<\/a>\u00a0and Cherry<\/a>, available at several sizes.<\/p>\n Sample Cogmind screenshot using size 24 Tamsyn.<\/p>\n<\/div>\n \u00a0<\/p>\n Sample Cogmind screenshot using size 14 Cherry Shadow,\u00a0 for which I added a slight drop shadow I think looks pretty cool, especially on a light background like item labels.<\/p>\n<\/div>\n While I was at it, I also made other font-related improvements, like having Cogmind\u2019s options menu list fonts from largest to smallest to be able to more easily adjust style via the menu without changing map size. The original approach based purely on how they\u2019re listed in the config file didn\u2019t make sense, and I\u2019m not sure why I left it that way for so long.<\/p>\n New sorting order for the font options menu!<\/p>\n<\/div>\n Shortly after releasing a build with autoscaled fonts to patrons, a wild bug appeared! Apparently some people were seeing artifacts on the display\u2026<\/p>\n Screenshot excerpt showing visual oddities. (sample provided by Luigi; you\u2019ll have to open it at full size to see some of the evidence)<\/p>\n<\/div>\n At first we weren\u2019t sure what it was, since it was only affecting a few people, and recent SDL DLL optimizations aimed at improving rendering speed had also been introduced as well. But bugs aren\u2019t all that elusive if they only affect some people and a discernible, repeatable pattern emerges, which happens to be the case here. That these artifacts only appeared for players using very high resolutions suggested it might be an issue with font scaling, since all of the high-resolution fonts are upscales.<\/p>\n So I set up a bunch of tests to confirm, and eventually found that some<\/em> large fonts ended up with these artifacts when scaled, and in all cases had a scaling multiplier of at least 3. How weird!<\/p>\n Anyway it\u2019s now even more clear this has gotta be something with the scaling process, right, for which I had actually just plugged in SDL_gfx<\/a>, a common companion library for doing this sort of thing. Cue stepping through its zoomSurface() function, specifically zoomSurfaceRGBA(), and while comparing how it handled a 2x vs a 3x scale operation, I noticed that there seems to be\u2026 a bug in the library?<\/p>\n This code truncates the result of floating point arithmetic, which under the right combination of variables causes the intended optimizations based on these values to generate artifacts.<\/p>\n<\/div>\n I\u2019m kinda surprised since this library has been in relatively wide use for over two decades, and even continues to be used alongside subsequent SDL versions<\/a>, but that code remains the same. Maybe most people tend to use it with smoothing\/antialiasing turned on (I had it off because I want crisp), or are using less tightly packed tilesets (or even separate files for their images), all of which may help conceal such an issue from discovery? Or maybe there\u2019s something else at play.<\/p>\n I replaced that whole optimized method with my own brute force scaling solution and *poof* the problem indeed disappeared. It\u2019s only rarely called anyway–as mentioned before fonts are only scaled when they\u2019re first needed, not before or ever again afterward, so we don\u2019t need to worry about performance. (And anyone who actually does need to worry about performance should probably avoid doing this in software mode in the first place \ud83d\ude1b –that\u2019s probably where all the other potential bug finders went off to\u2026)<\/p>\nREX, Again Again<\/h2>\n
\n
![\"rex_font_config_scaling_tests\"](\"https:\/\/www.gridsagegames.com\/blog\/gsg-content\/uploads\/2024\/01\/rex_font_config_scaling_tests.png\")
<\/p>\n![\"cogmind_font_scaling_demo_4x8mini_to_8x16\"](\"https:\/\/www.gridsagegames.com\/blog\/gsg-content\/uploads\/2024\/01\/cogmind_font_scaling_demo_4x8mini_to_8x16.png\")
<\/p>\nCogmind Applications<\/h2>\n
![\"cogmind_beta13_font_config_comparison\"](\"https:\/\/www.gridsagegames.com\/blog\/gsg-content\/uploads\/2024\/01\/cogmind_beta13_font_config_comparison.png\")
<\/p>\n![\"cogmind_screenshot_sample_tamsyn_24\"](\"https:\/\/www.gridsagegames.com\/blog\/gsg-content\/uploads\/2024\/01\/cogmind_screenshot_sample_tamsyn_24.png\")
<\/p>\n![\"cogmind_screenshot_sample_cherryshadow_14\"](\"https:\/\/www.gridsagegames.com\/blog\/gsg-content\/uploads\/2024\/01\/cogmind_screenshot_sample_cherryshadow_14.png\")
<\/p>\n![\"cogmind_options_menu_font_set_sorting\"](\"https:\/\/www.gridsagegames.com\/blog\/gsg-content\/uploads\/2024\/01\/cogmind_options_menu_font_set_sorting.gif\")
<\/p>\nPixel Corruption<\/h2>\n
![\"cogmind_prerelease_bug_font_scaling_artifacts\"](\"https:\/\/www.gridsagegames.com\/blog\/gsg-content\/uploads\/2024\/01\/cogmind_prerelease_bug_font_scaling_artifacts.png\")
<\/p>\n![\"SDL_gfx_suspicious_zooming_code\"](\"https:\/\/www.gridsagegames.com\/blog\/gsg-content\/uploads\/2024\/01\/SDL_gfx_suspicious_zooming_code.png\")
<\/p>\n