diff --git a/utf8display/utf8display.lua b/utf8display/utf8display.lua index 93c369e..470e3d2 100644 --- a/utf8display/utf8display.lua +++ b/utf8display/utf8display.lua @@ -1,477 +1,564 @@ --- UTF-8 Display Library for ComputerCraft --- 文件名: utf8display.lua - -local utf8display = {} - --- 配置参数 -utf8display.config = { - fontUrl = "https://git.liulikeji.cn/xingluo/ComputerCraft-Utf8/raw/branch/main/fonts/fusion-pixel-8px-proportional-zh_hans.lua", - fontPath = nil, - cacheFont = true, - autoScroll = true -} - --- 内部状态 -local state = { - font = nil, - fontHeight = 8, - loadedFonts = {} -} - --- 字体管理模块 -local fontManager = {} - -function fontManager.loadRemoteFont(url) - if state.loadedFonts[url] then - return state.loadedFonts[url] - end - - local response = http.get(url) - if not response then - return nil, "无法连接到字体服务器: " .. url - end - - if response.getResponseCode() ~= 200 then - return nil, "字体服务器返回错误: " .. response.getResponseCode() - end - - local content = response.readAll() - response.close() - - local sandbox = {} - local chunk, err = load(content, "=remoteFont", "t", sandbox) - if not chunk then - return nil, "加载字体失败: " .. err - end - - local success, result = pcall(chunk) - if not success then - return nil, "执行字体脚本失败: " .. result - end - - local fontData = sandbox.font or sandbox[1] or result - if utf8display.config.cacheFont then - state.loadedFonts[url] = fontData - end - - return fontData -end - -function fontManager.loadLocalFont(path) - if state.loadedFonts[path] then - return state.loadedFonts[path] - end - - if not fs.exists(path) then - return nil, "字体文件不存在: " .. path - end - - local file = fs.open(path, "r") - local content = file.readAll() - file.close() - - local sandbox = {} - local chunk, err = load(content, "=localFont", "t", sandbox) - if not chunk then - return nil, "加载本地字体失败: " .. err - end - - local success, result = pcall(chunk) - if not success then - return nil, "执行本地字体脚本失败: " .. result - end - - local fontData = sandbox.font or sandbox[1] or result - if utf8display.config.cacheFont then - state.loadedFonts[path] = fontData - end - - return fontData -end - -function fontManager.getFont() - if not state.font then - local success, err = utf8display.loadFont() - if not success then - error("字体加载失败: " .. err) - end - end - return state.font -end - -function fontManager.getFontHeight() - local font = fontManager.getFont() - if font and font[32] then - return #font[32] - end - return state.fontHeight -end - --- 渲染引擎模块 -local renderer = {} - -function renderer.displayChar(charMap, x, y, textColor, backgroundColor) - if not charMap or #charMap == 0 then - return - end - - -- 保存当前终端颜色和光标位置 - local originalTextColor = term.getTextColor() - local originalBackgroundColor = term.getBackgroundColor() - local originalCursorX, originalCursorY = term.getCursorPos() - - -- 如果没有提供自定义颜色，则使用当前终端颜色 - local useTextColor = textColor or originalTextColor - local useBackgroundColor = backgroundColor or originalBackgroundColor - - -- 渲染字符（仅在可视区域内） - local width, height = term.getSize() - for row = 1, #charMap do - local drawY = y + row - 1 - if drawY > height then break end -- 超出底部，不再绘制 - term.setCursorPos(x, drawY) - local line = charMap[row] - - for col = 1, #line do - local byte = string.byte(line, col) - if byte < 128 then - term.setTextColor(useBackgroundColor) - term.setBackgroundColor(useTextColor) - term.write(string.char(byte + 128)) - else - term.setTextColor(useTextColor) - term.setBackgroundColor(useBackgroundColor) - term.write(string.char(byte)) - end - end - end - - -- 恢复原始终端颜色和光标位置 - term.setTextColor(originalTextColor) - term.setBackgroundColor(originalBackgroundColor) - term.setCursorPos(originalCursorX, originalCursorY) -end - -function renderer.utf8Decode(str) - local i = 1 - return function() - if i > #str then return end - - local b1 = string.byte(str, i) - i = i + 1 - - if b1 < 0x80 then - return b1 - elseif b1 >= 0xC0 and b1 < 0xE0 then - local b2 = string.byte(str, i) or 0 - i = i + 1 - return (b1 - 0xC0) * 64 + (b2 - 0x80) - elseif b1 >= 0xE0 and b1 < 0xF0 then - local b2 = string.byte(str, i) or 0 - i = i + 1 - local b3 = string.byte(str, i) or 0 - i = i + 1 - return (b1 - 0xE0) * 4096 + (b2 - 0x80) * 64 + (b3 - 0x80) - else - return 32 - end - end -end - --- 公共API函数 -function utf8display.setConfig(key, value) - if utf8display.config[key] ~= nil then - utf8display.config[key] = value - return true - end - return false, "配置项不存在" -end - -function utf8display.getConfig(key) - if utf8display.config[key] ~= nil then - return utf8display.config[key] - end - return nil, "配置项不存在" -end - -function utf8display.loadFont() - if utf8display.config.fontPath then - state.font, err = fontManager.loadLocalFont(utf8display.config.fontPath) - if not state.font then - return false, err - end - else - state.font, err = fontManager.loadRemoteFont(utf8display.config.fontUrl) - if not state.font then - return false, err - end - end - state.fontHeight = fontManager.getFontHeight() - return true -end - --- 主动初始化字体函数 -function utf8display.initFont() - return utf8display.loadFont() -end - -local function clampCursorPos(x, y, width, height) - return math.min(math.max(x, 1), width), math.min(math.max(y, 1), height) -end - -function utf8display.write(raw_str) - str = tostring(raw_str) - -- 将换行符替换为空格 - str = string.gsub(str, "\n", " ") - - local font = fontManager.getFont() - local fontHeight = fontManager.getFontHeight() - local textColor = term.getTextColor() - local backgroundColor = term.getBackgroundColor() - - local startX, startY = term.getCursorPos() - local width, height = term.getSize() - local cursorX, cursorY = startX, startY - local charCount = 0 - local contentFitsHorizontally = true - local contentFitsVertically = true - - for code in renderer.utf8Decode(str) do - if code == 10 then -- 换行符 (理论上不会再有，因为我们已经替换了) - cursorX = 1 - cursorY = cursorY + fontHeight - else - local charMap = font[code] or font[32] - local charWidth = #charMap[1] - - -- 不自动换行：即使超出横向宽度也继续写（但不渲染超出部分） - if cursorX + charWidth - 1 > width then - contentFitsHorizontally = false - end - - -- 判断是否还能在竖直方向绘制（至少第一行能画） - if cursorY <= height then - renderer.displayChar(charMap, cursorX, cursorY, textColor, backgroundColor) - charCount = charCount + 1 - else - contentFitsVertically = false - -- 不 break，继续推进光标逻辑（用于正确设置最终光标位置） - end - - cursorX = cursorX + charWidth - end - end - - -- 确定最终光标位置 - local finalX, finalY - if not contentFitsHorizontally or not contentFitsVertically then - -- 若任一方向溢出，光标回到起始位置 - finalX, finalY = startX, startY - else - -- 否则放在正常结束位置 - finalX, finalY = cursorX, cursorY - end - - -- 安全设置光标（避免超出屏幕导致卡住） - finalX, finalY = clampCursorPos(finalX, finalY, width, height) - term.setCursorPos(finalX, finalY) - - return true, { - textColor = textColor, - backgroundColor = backgroundColor, - startX = startX, - startY = startY, - endX = finalX, - endY = finalY, - charCount = charCount, - fontHeight = fontHeight, - overflowX = not contentFitsHorizontally, - overflowY = not contentFitsVertically - } -end - -function utf8display.print(raw_str) - str = tostring(raw_str) - local font = fontManager.getFont() - local fontHeight = fontManager.getFontHeight() - local textColor = term.getTextColor() - local backgroundColor = term.getBackgroundColor() - - local startX, startY = term.getCursorPos() - local width, height = term.getSize() - - -- 预计算所需总高度（用于滚动） - local tempCursorX, tempCursorY = startX, startY - for code in renderer.utf8Decode(str) do - if code == 10 then - tempCursorX = 1 - tempCursorY = tempCursorY + fontHeight - else - local charMap = font[code] or font[32] - local charWidth = #charMap[1] - if tempCursorX + charWidth - 1 > width then - tempCursorX = 1 - tempCursorY = tempCursorY + fontHeight - end - tempCursorX = tempCursorX + charWidth - end - end - - local totalContentHeight = tempCursorY + fontHeight - startY - local availableHeight = height - startY + 1 - local scrollHeight = math.max(0, totalContentHeight - availableHeight) - - if scrollHeight > 0 and utf8display.config.autoScroll then - term.scroll(scrollHeight) - startY = startY - scrollHeight - end - - -- 实际渲染 - local cursorX, cursorY = startX, startY - local charCount = 0 - - for code in renderer.utf8Decode(str) do - if code == 10 then - cursorX = 1 - cursorY = cursorY + fontHeight - else - local charMap = font[code] or font[32] - local charWidth = #charMap[1] - if cursorX + charWidth - 1 > width then - cursorX = 1 - cursorY = cursorY + fontHeight - end - if cursorY <= height then - renderer.displayChar(charMap, cursorX, cursorY, textColor, backgroundColor) - charCount = charCount + 1 - end - cursorX = cursorX + charWidth - end - end - - -- print 总是把光标放到下一行开头（符合常规行为） - local finalY = cursorY + fontHeight - local finalX = 1 - finalX, finalY = clampCursorPos(finalX, finalY, width, height) - term.setCursorPos(finalX, finalY) - - return true, { - textColor = textColor, - backgroundColor = backgroundColor, - startX = startX, - startY = startY, - endX = finalX, - endY = finalY, - charCount = charCount, - fontHeight = fontHeight - } -end - -function utf8display.blit(raw_str, textColorStr, backgroundColorStr) - text = tostring(raw_str) - -- 将换行符替换为空格 - text = string.gsub(text, "\n", " ") - - local font = fontManager.getFont() - local fontHeight = fontManager.getFontHeight() - - local startX, startY = term.getCursorPos() - local width, height = term.getSize() - local cursorX, cursorY = startX, startY - local charCount = 0 - local contentFitsHorizontally = true - local contentFitsVertically = true - - -- 解析颜色字符串 - local textColors = {} - local backgroundColors = {} - for i = 1, #textColorStr do - textColors[i] = colors.fromBlit(string.sub(textColorStr, i, i)) - end - for i = 1, #backgroundColorStr do - backgroundColors[i] = colors.fromBlit(string.sub(backgroundColorStr, i, i)) - end - - local index = 1 - for code in renderer.utf8Decode(text) do - if code == 10 then -- 换行符 (理论上不会再有，因为我们已经替换了) - cursorX = 1 - cursorY = cursorY + fontHeight - else - local charMap = font[code] or font[32] - local charWidth = #charMap[1] - - if cursorX + charWidth - 1 > width then - contentFitsHorizontally = false - end - - if cursorY <= height then - local useTextColor = textColors[index] or term.getTextColor() - local useBackgroundColor = backgroundColors[index] or term.getBackgroundColor() - renderer.displayChar(charMap, cursorX, cursorY, useTextColor, useBackgroundColor) - charCount = charCount + 1 - else - contentFitsVertically = false - end - - cursorX = cursorX + charWidth - index = index + 1 - end - end - - local finalX, finalY - if not contentFitsHorizontally or not contentFitsVertically then - finalX, finalY = startX, startY - else - finalX, finalY = cursorX, cursorY - end - - finalX, finalY = clampCursorPos(finalX, finalY, width, height) - term.setCursorPos(finalX, finalY) - - return true, { - startX = startX, - startY = startY, - endX = finalX, - endY = finalY, - charCount = charCount, - fontHeight = fontHeight, - overflowX = not contentFitsHorizontally, - overflowY = not contentFitsVertically - } -end - --- 工具函数 -function utf8display.getFontInfo() - local font = fontManager.getFont() - local fontHeight = fontManager.getFontHeight() - - return { - height = fontHeight, - loaded = font ~= nil, - source = utf8display.config.fontPath or utf8display.config.fontUrl, - cached = state.loadedFonts[utf8display.config.fontPath or utf8display.config.fontUrl] ~= nil - } -end - -function utf8display.isInitialized() - return state.font ~= nil -end - --- 自动初始化（第一次使用时） -setmetatable(utf8display, { - __index = function(self, key) - if key == "write" or key == "print" or key == "blit" then - if not utf8display.isInitialized() then - local success, err = utf8display.loadFont() - if not success then - error("自动初始化失败: " .. err) - end - end - return rawget(self, key) - end - return rawget(self, key) - end -}) - +-- UTF-8 Display Library for ComputerCraft (完整修正版) +-- 文件名: utf8display.lua + +local utf8display = {} + +-- 配置参数 +utf8display.config = { + fontUrl = "https://git.liulikeji.cn/xingluo/ComputerCraft-Utf8/raw/branch/main/fonts/fusion-pixel-8px-proportional-zh_hans.lua", + fontPath = nil, + cacheFont = true, + autoScroll = true +} + +-- 内部状态 +local state = { + font = nil, + fontHeight = 8, + loadedFonts = {} +} + +-- 字体管理模块 +local fontManager = {} + +function fontManager.loadRemoteFont(url) + if state.loadedFonts[url] then + return state.loadedFonts[url] + end + + local response = http.get(url) + if not response then + return nil, "无法连接到字体服务器: " .. url + end + + if response.getResponseCode() ~= 200 then + return nil, "字体服务器返回错误: " .. response.getResponseCode() + end + + local content = response.readAll() + response.close() + + local sandbox = {} + local chunk, err = load(content, "=remoteFont", "t", sandbox) + if not chunk then + return nil, "加载字体失败: " .. err + end + + local success, result = pcall(chunk) + if not success then + return nil, "执行字体脚本失败: " .. result + end + + local fontData = sandbox.font or sandbox[1] or result + if utf8display.config.cacheFont then + state.loadedFonts[url] = fontData + end + + return fontData +end + +function fontManager.loadLocalFont(path) + if state.loadedFonts[path] then + return state.loadedFonts[path] + end + + if not fs.exists(path) then + return nil, "字体文件不存在: " .. path + end + + local file = fs.open(path, "r") + local content = file.readAll() + file.close() + + local sandbox = {} + local chunk, err = load(content, "=localFont", "t", sandbox) + if not chunk then + return nil, "加载本地字体失败: " .. err + end + + local success, result = pcall(chunk) + if not success then + return nil, "执行本地字体脚本失败: " .. result + end + + local fontData = sandbox.font or sandbox[1] or result + if utf8display.config.cacheFont then + state.loadedFonts[path] = fontData + end + + return fontData +end + +function fontManager.getFont() + if not state.font then + local success, err = utf8display.loadFont() + if not success then + error("字体加载失败: " .. err) + end + end + return state.font +end + +function fontManager.getFontHeight() + local font = fontManager.getFont() + if font and font[72] then -- 'H' (ASCII 72) 表示最大高度 + return #font[72] + elseif font and font[32] then + return #font[32] + end + return state.fontHeight +end + +-- 渲染引擎模块 +local renderer = {} + +function renderer.utf8Decode(str) + local i = 1 + return function() + if i > #str then return end + + local b1 = string.byte(str, i) + i = i + 1 + + if b1 < 0x80 then + return b1 + elseif b1 >= 0xC0 and b1 < 0xE0 then + local b2 = string.byte(str, i) or 0 + i = i + 1 + return (b1 - 0xC0) * 64 + (b2 - 0x80) + elseif b1 >= 0xE0 and b1 < 0xF0 then + local b2 = string.byte(str, i) or 0 + i = i + 1 + local b3 = string.byte(str, i) or 0 + i = i + 1 + return (b1 - 0xE0) * 4096 + (b2 - 0x80) * 64 + (b3 - 0x80) + else + return 32 + end + end +end + +-- 公共API函数 +function utf8display.setConfig(key, value) + if utf8display.config[key] ~= nil then + utf8display.config[key] = value + return true + end + return false, "配置项不存在" +end + +function utf8display.getConfig(key) + if utf8display.config[key] ~= nil then + return utf8display.config[key] + end + return nil, "配置项不存在" +end + +function utf8display.loadFont() + if utf8display.config.fontPath then + state.font, err = fontManager.loadLocalFont(utf8display.config.fontPath) + if not state.font then + return false, err + end + else + state.font, err = fontManager.loadRemoteFont(utf8display.config.fontUrl) + if not state.font then + return false, err + end + end + state.fontHeight = fontManager.getFontHeight() + return true +end + +-- 将字符串转换为bimg格式（完整修正版，支持逐字颜色） +function utf8display.strToBimg(str, textColor, backgroundColor, width) + str = tostring(str) + local font = fontManager.getFont() + local fontHeight = fontManager.getFontHeight() + + -- 判断颜色参数类型 + local textIsString = type(textColor) == "string" + local bgIsString = type(backgroundColor) == "string" + + -- 获取默认颜色 + local defaultTextColor = term.getTextColor() + local defaultBgColor = term.getBackgroundColor() + + -- 处理统一颜色（数字）或逐字颜色（字符串） + local uniformTextBlit, uniformBgBlit + if not textIsString then + uniformTextBlit = colors.toBlit(type(textColor) == "number" and textColor or defaultTextColor) + end + if not bgIsString then + uniformBgBlit = colors.toBlit(type(backgroundColor) == "number" and backgroundColor or defaultBgColor) + end + + -- 初始化bimg结构 + local bimg = {} + + -- 处理换行符 + local lines = {} + local start = 1 + while start <= #str do + local nl_pos = str:find("\n", start, true) + if nl_pos then + local line = str:sub(start, nl_pos - 1) + table.insert(lines, line) + start = nl_pos + 1 + else + -- 到末尾了 + local line = str:sub(start) + table.insert(lines, line) + break + end + end + + for _, lineStr in ipairs(lines) do + -- 收集该行所有字符信息 + local allChars = {} + for code in renderer.utf8Decode(lineStr) do + local charMap = font[code] or font[32] + local charWidth = #charMap[1] + table.insert(allChars, {code = code, map = charMap, width = charWidth}) + end + + if width then + -- 有宽度限制，需要处理自动换行 + local segments = {} + local currentSegment = {} + local currentLineWidth = 0 + + -- 遍历字符 + for i, charInfo in ipairs(allChars) do + -- 检查是否需要换行 + if currentLineWidth + charInfo.width > width then + -- 将当前段添加到segments + if #currentSegment > 0 then + table.insert(segments, currentSegment) + end + + -- 开始新段 + currentSegment = {} + currentLineWidth = 0 + end + + -- 添加字符到当前段 + table.insert(currentSegment, charInfo) + currentLineWidth = currentLineWidth + charInfo.width + end + + -- 添加最后一段（如果存在） + if #currentSegment > 0 then + table.insert(segments, currentSegment) + end + + -- 渲染每个段（每个段高度 = fontHeight） + for _, segment in ipairs(segments) do + -- 为该段构建每行的 text/colors/bg + for row = 1, fontHeight do + local lineText = "" + local lineTextColors = "" + local lineBgColors = "" + + -- 为每个字符计算颜色（如果使用字符串颜色） + local charIndexInLine = 1 + for _, char in ipairs(segment) do + local fgBlit, bgBlit + + if textIsString then + local colorChar = string.sub(textColor, charIndexInLine, charIndexInLine) + fgBlit = colorChar ~= "" and colorChar or "f" -- 默认白色 + else + fgBlit = uniformTextBlit + end + + if bgIsString then + local colorChar = string.sub(backgroundColor, charIndexInLine, charIndexInLine) + bgBlit = colorChar ~= "" and colorChar or "0" -- 默认黑色 + else + bgBlit = uniformBgBlit + end + + -- 处理该字符的当前行 + if row <= #char.map then + local rowStr = char.map[row] + for col = 1, #rowStr do + local byte = string.byte(rowStr, col) + local displayByte + if byte < 128 then + -- 颜色反转 + displayByte = byte + 128 + lineText = lineText .. string.char(displayByte) + lineTextColors = lineTextColors .. bgBlit -- 原背景色变前景 + lineBgColors = lineBgColors .. fgBlit -- 原前景色变背景 + else + -- 正常 + displayByte = byte + lineText = lineText .. string.char(displayByte) + lineTextColors = lineTextColors .. fgBlit + lineBgColors = lineBgColors .. bgBlit + end + end + end + + charIndexInLine = charIndexInLine + 1 + end + + table.insert(bimg, {lineText, lineTextColors, lineBgColors}) + end + end + else + -- 无宽度限制，整行处理 + if #allChars > 0 then + -- 为该行构建每行的 text/colors/bg + for row = 1, fontHeight do + local lineText = "" + local lineTextColors = "" + local lineBgColors = "" + + -- 为每个字符计算颜色（如果使用字符串颜色） + local charIndexInLine = 1 + for _, char in ipairs(allChars) do + local fgBlit, bgBlit + + if textIsString then + local colorChar = string.sub(textColor, charIndexInLine, charIndexInLine) + fgBlit = colorChar ~= "" and colorChar or "f" -- 默认白色 + else + fgBlit = uniformTextBlit + end + + if bgIsString then + local colorChar = string.sub(backgroundColor, charIndexInLine, charIndexInLine) + bgBlit = colorChar ~= "" and colorChar or "0" -- 默认黑色 + else + bgBlit = uniformBgBlit + end + + -- 处理该字符的当前行 + if row <= #char.map then + local rowStr = char.map[row] + for col = 1, #rowStr do + local byte = string.byte(rowStr, col) + local displayByte + if byte < 128 then + -- 颜色反转 + displayByte = byte + 128 + lineText = lineText .. string.char(displayByte) + lineTextColors = lineTextColors .. bgBlit -- 原背景色变前景 + lineBgColors = lineBgColors .. fgBlit -- 原前景色变背景 + else + -- 正常 + displayByte = byte + lineText = lineText .. string.char(displayByte) + lineTextColors = lineTextColors .. fgBlit + lineBgColors = lineBgColors .. bgBlit + end + end + end + + charIndexInLine = charIndexInLine + 1 + end + + table.insert(bimg, {lineText, lineTextColors, lineBgColors}) + end + else + -- 空行也需要保留 + table.insert(bimg, {"", "", ""}) + end + end + end + + -- 如果没有内容，创建一个空行 + if #bimg == 0 then + table.insert(bimg, {"", "", ""}) + end + + -- 将所有行包装在第一帧中 + return {{unpack(bimg)}} +end + + +local function clampCursorPos(x, y, width, height) + return math.min(math.max(x, 1), width), math.min(math.max(y, 1), height) +end + +function utf8display.write(raw_str, textColor, backgroundColor) + local str = tostring(raw_str) + str = string.gsub(str, "\n", " ") -- 替换换行为空格 + + local startX, startY = term.getCursorPos() + local termWidth, termHeight = term.getSize() + + -- 获取 bimg（无宽度限制，所以不会自动换行） + local bimg = utf8display.strToBimg(str, textColor, backgroundColor) + local frame = bimg[1] + + if #frame == 0 then + -- 空内容，直接返回 + return true, { charCount = 0, overflowX = false, overflowY = false } + end + + local firstLineWidth = #frame[1][1] + local totalHeight = #frame + + -- 渲染每一行 + for i, row in ipairs(frame) do + local drawY = startY + i - 1 + if drawY > termHeight then + -- 超出底部，跳过绘制 + break + end + term.setCursorPos(startX, drawY) + term.blit(row[1], row[2], row[3]) + end + + -- 判断是否纵向溢出 + local verticalOverflow = (startY + totalHeight - 1) > termHeight + local horizontalOverflow = firstLineWidth >= termWidth + + local finalX, finalY + + if verticalOverflow then + -- 情况3：纵向溢出 → 回退到起点 + finalX, finalY = startX, startY + elseif horizontalOverflow then + -- 情况2：宽但不高 → 光标移到块下方 + finalX, finalY = startX, startY + totalHeight + else + -- 情况1：窄且不高 → 横向推进（仅第一行宽度） + finalX, finalY = startX + firstLineWidth, startY + end + + finalX, finalY = clampCursorPos(finalX, finalY, termWidth, termHeight) + term.setCursorPos(finalX, finalY) + + return true, { + startX = startX, + startY = startY, + endX = finalX, + endY = finalY, + charCount = utf8.len(str), -- 假设有 utf8.len，或可估算 + fontHeight = fontManager.getFontHeight(), + overflowX = horizontalOverflow, + overflowY = verticalOverflow + } +end + +function utf8display.blit(raw_str, textColorStr, backgroundColorStr) + local str = tostring(raw_str) + str = string.gsub(str, "\n", " ") + + local startX, startY = term.getCursorPos() + local termWidth, termHeight = term.getSize() + + -- 直接传入颜色字符串 + local bimg = utf8display.strToBimg(str, textColorStr, backgroundColorStr) + local frame = bimg[1] + + if #frame == 0 then + return true, { charCount = 0, overflowX = false, overflowY = false } + end + + local firstLineWidth = #frame[1][1] + local totalHeight = #frame + + -- 渲染 + for i, row in ipairs(frame) do + local drawY = startY + i - 1 + if drawY > termHeight then + break + end + term.setCursorPos(startX, drawY) + term.blit(row[1], row[2], row[3]) + end + + local verticalOverflow = (startY + totalHeight - 1) > termHeight + local horizontalOverflow = firstLineWidth >= termWidth + + local finalX, finalY + + if verticalOverflow then + finalX, finalY = startX, startY + elseif horizontalOverflow then + finalX, finalY = startX, startY + totalHeight + else + finalX, finalY = startX + firstLineWidth, startY + end + + finalX, finalY = clampCursorPos(finalX, finalY, termWidth, termHeight) + term.setCursorPos(finalX, finalY) + + return true, { + startX = startX, + startY = startY, + endX = finalX, + endY = finalY, + charCount = utf8.len(str), + fontHeight = fontManager.getFontHeight(), + overflowX = horizontalOverflow, + overflowY = verticalOverflow + } +end + +function utf8display.print(raw_str, textColor, backgroundColor) + local str = tostring(raw_str) + + local startX, startY = term.getCursorPos() + local width, height = term.getSize() + + -- 获取颜色 + local useTextColor = textColor + local useBackgroundColor = backgroundColor + if useTextColor == nil then useTextColor = term.getTextColor() end + if useBackgroundColor == nil then useBackgroundColor = term.getBackgroundColor() end + + -- 生成 bimg（传入宽度以启用自动换行） + local bimg = utf8display.strToBimg(str, useTextColor, useBackgroundColor, width) + local frame = bimg[1] + + local totalLines = #frame + local availableLines = height - startY + 1 + + + -- 渲染 + for i, rowData in ipairs(frame) do + local drawY = startY + i - 1 + + if drawY >= height then term.setCursorPos(1, height) else term.setCursorPos(1, drawY) end + term.blit(rowData[1], rowData[2], rowData[3]) + if drawY >= height then term.scroll(1) end + end + + -- 光标移到下一行开头 + local finalY = startY + totalLines + local finalX = 1 + finalX, finalY = clampCursorPos(finalX, finalY, width, height) + term.setCursorPos(finalX, finalY) + + return true, { + startX = startX, + startY = startY, + endX = finalX, + endY = finalY, + lineCount = totalLines + } +end + +-- 自动初始化（第一次使用时） +setmetatable(utf8display, { + __index = function(self, key) + if key == "write" or key == "print" or key == "blit" then + if not utf8display.isInitialized() then + local success, err = utf8display.loadFont() + if not success then + error("自动初始化失败: " .. err) + end + end + return rawget(self, key) + end + return rawget(self, key) + end +}) + return utf8display \ No newline at end of file