寻求比JTextPane更快的带格式大体积ASCII文本显示方案

一、优化JTextPane渲染性能 #

JTextPane卡顿的核心原因是每次调用setText()会触发全量文档解析、样式计算和布局重排，尤其是大尺寸ASCII文本（256x192的双字符宽度，单帧文本量极大）。可以通过以下方式优化：

1. 改用PlainDocument减少样式开销
   JTextPane默认使用StyledDocument，即使仅设置对齐样式也会带来额外渲染计算，换成PlainDocument可大幅降低开销：

   JTextPane render = new JTextPane();
   render.setDocument(new PlainDocument()); // 替换为纯文本文档
   render.setEditable(false); // 禁用编辑，减少不必要的事件监听
   render.setLineWrap(false); // 关闭自动换行，避免换行计算
   render.setWrapStyleWord(false);
   

2. 增量更新而非全量替换
   避免每次调用setText()，改用Document的replace()方法更新内容，减少文档结构重建开销：

   PlainDocument doc = (PlainDocument) render.getDocument();
   try {
       doc.remove(0, doc.getLength());
       doc.insertString(0, Rendered_frame, null);
   } catch (BadLocationException e) {
       e.printStackTrace();
   }
   

3. 保留默认双缓冲
   手动设置render.setDoubleBuffered(false)可能导致闪烁，JTextPane本身已自带双缓冲机制，无需手动关闭。

二、正确实现BufferedImage+JPanel渲染方案 #

之前尝试的BufferedImage渲染出现不准确和闪烁，多是字体选择、渲染线程或双缓冲的问题，以下是正确实现方式：

自定义AsciiRenderPanel类 #

class AsciiRenderPanel extends JPanel {
    private BufferedImage frameImage;
    private Font asciiFont;

    public AsciiRenderPanel() {
        setDoubleBuffered(true); // 开启双缓冲
        try {
            InputStream fontIS = new FileInputStream("JetBrainsMonoNL-Regular.ttf");
            asciiFont = Font.createFont(Font.TRUETYPE_FONT, fontIS).deriveFont(3f);
        } catch (IOException | FontFormatException e) {
            e.printStackTrace();
            asciiFont = new Font("Monospaced", Font.PLAIN, 3); // 备用等宽字体
        }
    }

    public void updateFrame(String asciiFrame) {
        // 预渲染ASCII到BufferedImage
        if (frameImage == null || frameImage.getWidth() != getWidth() || frameImage.getHeight() != getHeight()) {
            frameImage = new BufferedImage(getWidth(), getHeight(), BufferedImage.TYPE_INT_RGB);
        }
        Graphics2D g2d = frameImage.createGraphics();
        g2d.setColor(Color.WHITE);
        g2d.fillRect(0, 0, getWidth(), getHeight());
        g2d.setColor(Color.BLACK);
        g2d.setFont(asciiFont);
        
        // 用等宽字体确保字符对齐准确
        FontMetrics metrics = g2d.getFontMetrics();
        int charWidth = metrics.charWidth('█');
        int charHeight = metrics.getHeight();
        
        String[] lines = asciiFrame.split("\n");
        int y = charHeight;
        for (String line : lines) {
            // 居中绘制每行文本
            g2d.drawString(line, (getWidth() - line.length() * charWidth) / 2, y);
            y += charHeight;
        }
        g2d.dispose();
        repaint(); // 触发重绘
    }

    @Override
    protected void paintComponent(Graphics g) {
        super.paintComponent(g);
        if (frameImage != null) {
            g.drawImage(frameImage, 0, 0, this);
        }
    }
}

替换原JTextPane使用该面板 #

// 替换原JTextPane代码
AsciiRenderPanel renderPanel = new AsciiRenderPanel();
JPanel MainPanel = new JPanel(new BorderLayout()); // 用BorderLayout让面板占满空间
MainPanel.add(renderPanel, BorderLayout.CENTER);

// 更新帧时调用
for (String Rendered_frame : Rendered) {
    renderPanel.updateFrame(Rendered_frame);
    Thread.sleep(300);
}

关键优化点：

• 强制使用等宽字体，避免ASCII字符错位
• 预渲染每帧到BufferedImage，减少实时计算开销
• 若视频帧处理在后台线程，需用SwingUtilities.invokeLater()包裹updateFrame调用，确保在EDT线程更新UI

三、CLI控制台正确刷新方案 #

\r仅能覆盖当前行，多帧文本需要清屏后重新打印，可使用ANSI控制码或系统清屏命令实现：

public static void clearConsole() {
    // 兼容Windows和Unix系统
    try {
        String os = System.getProperty("os.name").toLowerCase();
        if (os.contains("win")) {
            new ProcessBuilder("cmd", "/c", "cls").inheritIO().start().waitFor();
        } else {
            System.out.print("\033[H\033[2J");
            System.out.flush();
        }
    } catch (IOException | InterruptedException e) {
        e.printStackTrace();
    }
}

// 刷新帧时调用
for (String Rendered_frame : Rendered) {
    clearConsole();
    System.out.print(Rendered_frame);
    Thread.sleep(300);
}

额外建议 #

• 后台线程处理视频帧：不要在EDT线程中做视频解码和ASCII转换，用SwingWorker或独立线程处理，完成后再提交到EDT更新UI。
• 预生成帧缓存：提前生成所有帧的ASCII文本或预渲染BufferedImage，避免实时计算卡顿。
• 调整ASCII分辨率：若256x192分辨率过高，可适当降低，平衡画质与性能。

内容的提问来源于stack exchange，提问作者NightMare_V