Function wrapString

src/openrct2/drawing/Drawing.String.cpp:150–245

* Wrap the text in buffer to width, returns width of longest line. * * Inserts NULL where line should break (as \n is used for something else), * so the number of lines is returned in num_lines. font_height seems to be * a control character for line height. * * rct2: 0x006C21E2 * buffer (esi) * width (edi) - in * num_lines (edi) - out * font_heigh

     * font_height (ebx) - out
     */
    int32_t wrapString(u8string_view text, int32_t width, FontStyle fontStyle, u8string* outWrappedText, int32_t* outNumLines)
    {
        constexpr size_t kNullIndex = std::numeric_limits<size_t>::max();
        u8string buffer;

        size_t currentLineIndex = 0;
        size_t splitIndex = kNullIndex;
        size_t bestSplitIndex = kNullIndex;
        size_t numLines = 0;
        int32_t maxWidth = 0;

        FmtString fmt(text);
        for (const auto& token : fmt)
        {
            if (token.IsLiteral())
            {
                CodepointView codepoints(token.text);
                for (auto codepoint : codepoints)
                {
                    char cb[8]{};
                    UTF8WriteCodepoint(cb, codepoint);
                    buffer.append(cb);

                    auto lineWidth = getStringWidth(&buffer[currentLineIndex], fontStyle);
                    if (lineWidth <= width || (splitIndex == kNullIndex && bestSplitIndex == kNullIndex))
                    {
                        if (codepoint == ' ')
                        {
                            // Mark line split here
                            splitIndex = buffer.size() - 1;
                        }
                        else if (splitIndex == kNullIndex)
                        {
                            // Mark line split here (this is after first character of line)
                            bestSplitIndex = buffer.size();
                        }
                    }
                    else
                    {
                        // Insert new line before current word
                        if (splitIndex == kNullIndex)
                        {
                            splitIndex = bestSplitIndex;
                        }
                        buffer.insert(buffer.begin() + splitIndex, '\0');

                        // Recalculate the line length after splitting
                        lineWidth = getStringWidth(&buffer[currentLineIndex], fontStyle);
                        maxWidth = std::max(maxWidth, lineWidth);
                        numLines++;

                        currentLineIndex = splitIndex + 1;
                        splitIndex = kNullIndex;
                        bestSplitIndex = kNullIndex;

                        // Trim the beginning of the new line
                        while (buffer[currentLineIndex] == ' ')
                        {