Function wrapString

src/OpenLoco/src/Graphics/TextRenderer.cpp:1292–1410

0x00495301 Note: Returned break count is -1. TODO: Refactor out this -1. @return maxWidth @ (numLinesToDisplayAllChars-1) @

        // Note: Returned break count is -1. TODO: Refactor out this -1.
        // @return maxWidth @<cx> (numLinesToDisplayAllChars-1) @<di>
        static std::pair<uint16_t, uint16_t> wrapString(Font font, char* buffer, uint16_t stringWidth)
        {
            // std::vector<const char*> wrap; TODO: refactor to return pointers to line starts
            uint16_t wrapCount = 0;
            uint16_t maxWidth = 0;

            for (auto* ptr = buffer; *ptr != '\0';)
            {
                auto* startLine = ptr;
                uint16_t lineWidth = 0;
                auto lastWordLineWith = lineWidth;
                auto* wordStart = ptr;
                for (; *ptr != '\0' && lineWidth < stringWidth; ++ptr)
                {
                    const auto chr = static_cast<uint8_t>(*ptr);
                    if (chr >= ControlCodes::noArgBegin && chr < ControlCodes::noArgEnd)
                    {
                        bool forceEndl = false;
                        switch (chr)
                        {
                            case ControlCodes::newline:
                            {
                                *ptr = '\0';
                                forceEndl = true;
                                ++ptr; // Skip over '\0' when forcing a new line
                                wrapCount++;
                                // wrap.push_back(startLine); TODO: refactor to return pointers to line starts
                                maxWidth = std::max(maxWidth, lineWidth);
                                break;
                            }
                            case ControlCodes::Font::small:
                                font = Font::small;
                                break;
                            case ControlCodes::Font::large:
                                font = Font::large;
                                break;
                            case ControlCodes::Font::bold:
                                font = Font::medium_bold;
                                break;
                            case ControlCodes::Font::regular:
                                font = Font::medium_normal;
                                break;
                        }
                        if (forceEndl)
                        {
                            break;
                        }
                    }
                    else if (chr >= ControlCodes::oneArgBegin && chr < ControlCodes::oneArgEnd)
                    {
                        switch (chr)
                        {
                            case ControlCodes::moveX:
                                lineWidth = static_cast<uint8_t>(ptr[1]);
                                break;
                        }
                        ptr += 1;
                    }