// zlib open source license // // Copyright (c) 2018 to 2022 David Forsgren Piuva // // 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. #include #include "Font.h" #include "../../api/imageAPI.h" #include "../../api/drawAPI.h" using namespace dsr; RasterCharacter::RasterCharacter(const ImageU8& image, DsrChar unicodeValue, int32_t offsetY) : image(image), unicodeValue(unicodeValue), width(image_getWidth(image)), offsetY(offsetY) {} RasterFontImpl::RasterFontImpl(const String& name, int32_t size, int32_t spacing, int32_t spaceWidth) : name(name), size(size), spacing(spacing), spaceWidth(spaceWidth), tabWidth(spaceWidth * 4) { for (int32_t i = 0; i < 65536; i++) { this->indices[i] = -1; } } RasterFontImpl::~RasterFontImpl() {} Handle RasterFontImpl::createLatinOne(const String& name, const ImageU8& atlas) { int32_t size = image_getHeight(atlas) / 16; Handle result = handle_create(name, size, size / 16, size / 2); result->registerLatinOne16x16(atlas); return result; } void RasterFontImpl::registerCharacter(const ImageU8& characterImage, DsrChar unicodeValue, int32_t offsetY) { if (this->indices[unicodeValue] == -1) { // Add the unicode character this->characters.pushConstruct(characterImage, unicodeValue, offsetY); int32_t width = image_getWidth(characterImage); if (this->widest < width) this->widest = width; // Add to table if inside the range if (unicodeValue < 65536) { this->indices[unicodeValue] = this->characters.length() - 1; } } } static IRect getCharacterBound(const ImageU8& image, const IRect& searchRegion) { // Inclusive intervals for speed int32_t minX = searchRegion.right(); int32_t maxX = searchRegion.left(); int32_t minY = searchRegion.bottom(); int32_t maxY = searchRegion.top(); for (int y = searchRegion.top(); y < searchRegion.bottom(); y++) { for (int x = searchRegion.left(); x < searchRegion.right(); x++) { if (image_readPixel_border(image, x, y)) { if (x < minX) minX = x; if (x > maxX) maxX = x; if (y < minY) minY = y; if (y > maxY) maxY = y; } } } // Convert to width and height return IRect(minX, minY, (maxX + 1) - minX, (maxY + 1) - minY); } // Call after construction to register up to 256 characters in a 16x16 grid from the atlas void RasterFontImpl::registerLatinOne16x16(const ImageU8& atlas) { int32_t charWidth = image_getWidth(atlas) / 16; int32_t charHeight = image_getWidth(atlas) / 16; for (int y = 0; y < 16; y++) { for (int x = 0; x < 16; x++) { IRect searchRegion = IRect(x * charWidth, y * charHeight, charWidth, charHeight); IRect croppedRegion = getCharacterBound(atlas, searchRegion); if (croppedRegion.hasArea()) { int32_t offsetY = croppedRegion.top() - searchRegion.top(); this->registerCharacter(image_getSubImage(atlas, croppedRegion), y * 16 + x, offsetY); } } } } int32_t RasterFontImpl::getCharacterWidth(DsrChar unicodeValue) const { if (unicodeValue == 0 || unicodeValue == 10 || unicodeValue == 13) { return 0; } else { int32_t index = this->indices[unicodeValue]; if (index > -1) { return this->characters[index].width + this->spacing; } else { return spaceWidth; } } } // Prints a character and returns the horizontal stride in pixels int32_t RasterFontImpl::printCharacter(ImageRgbaU8& target, DsrChar unicodeValue, const IVector2D& location, const ColorRgbaI32& color) const { if (unicodeValue < 65536) { int32_t index = this->indices[unicodeValue]; if (index > -1) { const RasterCharacter *source = &(this->characters[index]); draw_silhouette(target, source->image, color, location.x, location.y + source->offsetY); } return this->getCharacterWidth(unicodeValue); } else { // TODO: Look up characters outside of the 16-bit range from a sparse data structure return 0; } } // Lets the print coordinate x jump to the next tab stop starting from the left origin static int64_t tabJump(int64_t oldLocation, int64_t leftOrigin, int64_t tabWidth) { // Get the pixel location relative to the origin int64_t localX = oldLocation - leftOrigin; // Get the remaining pixels until the next tab stop // If modulo returns zero at a tab stop, it will jump to the next with a full tab width int64_t remainder = tabWidth - (localX % tabWidth); return oldLocation + remainder; } void RasterFontImpl::printLine(ImageRgbaU8& target, const ReadableString& content, const IVector2D& location, const ColorRgbaI32& color) const { IVector2D currentLocation = location; for (int64_t i = 0; i < string_length(content); i++) { DsrChar code = content[i]; if (code == U'\t') { currentLocation.x = tabJump(currentLocation.x, location.x, this->tabWidth); } else { // TODO: Would right to left printing of Arabic text be too advanced to have in the core framework? currentLocation.x += this->printCharacter(target, code, currentLocation, color); } } } void RasterFontImpl::printMultiLine(ImageRgbaU8& target, const ReadableString& content, const IRect& bound, const ColorRgbaI32& color) const { int64_t y = bound.top(); // The upper vertical location of the currently printed row in pixels. int64_t lineWidth = 0; // The size of the currently scanned row, to make sure that it can be printed. int64_t rowStartIndex = 0; // The start of the current row or the unprinted remainder that didn't fit inside the bound. int64_t lastWordBreak = 0; // The last scanned location where the current row could've been broken off. bool wordStarted = false; // True iff the physical line after word wrapping has scanned the beginning of a word. if (bound.height() < this->size) { // Not enough height to print anything return; } for (int64_t i = 0; i < string_length(content); i++) { DsrChar code = content[i]; if (code == 10) { // Print the completed line this->printLine(target, string_exclusiveRange(content, rowStartIndex, i), IVector2D(bound.left(), y), color); y += this->size; if (y + this->size > bound.bottom()) { return; } lineWidth = 0; rowStartIndex = i + 1; lastWordBreak = rowStartIndex; wordStarted = false; } else { int32_t newCharWidth = this->getCharacterWidth(code); if (code == ' ' || code == 9) { // Space or tab if (wordStarted) { lastWordBreak = i; wordStarted = false; } } else { wordStarted = true; if (lineWidth + newCharWidth >= bound.width()) { int64_t splitIndex = lastWordBreak; if (lastWordBreak == rowStartIndex) { // The word is too big to be printed as a whole splitIndex = i; } ReadableString partialLine = string_exclusiveRange(content, rowStartIndex, splitIndex); int64_t partialLength = this->getLineWidth(partialLine); if (partialLength <= bound.width()) { this->printLine(target, partialLine, IVector2D(bound.left(), y), color); } y += this->size; if (y + this->size > bound.bottom()) { return; } lineWidth = 0; // Continue after splitIndex i = splitIndex; if (lastWordBreak > rowStartIndex) { i += 1; } rowStartIndex = i; lastWordBreak = i; wordStarted = false; } } if (code == 9) { // Tab lineWidth = tabJump(lineWidth, bound.left(), this->tabWidth); } else { lineWidth += newCharWidth; } } } this->printLine(target, string_from(content, rowStartIndex), IVector2D(bound.left(), y), color); } int64_t RasterFontImpl::getLineWidth(const ReadableString& content) const { int64_t result = 0; for (int64_t i = 0; i < string_length(content); i++) { DsrChar code = content[i]; if (code == 9) { // Tab result = tabJump(result, 0, this->tabWidth); } else { result += this->getCharacterWidth(code); } } return result; }