如何在 jEdit 中截取文本区域渲染图像并导出为 PNG

有人问：jEdit 里能不能把当前编辑区的内容，一键导出成清晰的图片？当然可以。而且这件事做起来，比想象中要简单得多。

jEdit 是一个基于 Ja va Swing 构建的文本编辑器，它的 UI 组件，包括我们日常面对的文本编辑区（textArea），本质上就是标准的 Swing 组件。这就意味着，我们可以直接利用 Ja va 的 AWT/Swing 绘图 API 来做“离屏渲染”——说白了，就是悄悄地在内存里画一张跟编辑区一模一样的图，然后保存成 PNG 文件。

核心思路非常直观：创建一个跟文本区域尺寸完全一致的 BufferedImage，拿到它的绘图上下文（Graphics），然后让 textArea 把自己“画”上去，最后用 ImageIO 写出 PNG。整个过程不需要什么黑科技，但确实解决了很多人“想把代码或文档截图保存成固定格式”的痛点。

下面就是一段完整可用的 BeanShell 脚本，保存成 .bsh 文件就能用：

import ja va.awt.image.BufferedImage;
import ja vax.imageio.ImageIO;
import ja va.io.File;
import ja vax.swing.JFileChooser;

// 获取当前活动文本区域（确保在编辑器上下文中运行）
if (textArea == null) {
    Macros.error(view, "No active text area found.");
    return;
}

// 可选：弹出文件保存对话框（增强交互性）
JFileChooser fc = new JFileChooser();
fc.setDialogTitle("Sa ve Text Area as PNG");
fc.setSelectedFile(new File("jedit-textarea-" + System.currentTimeMillis() + ".png"));
int result = fc.showSa veDialog(view);
if (result != JFileChooser.APPROVE_OPTION) return;
File outputFile = fc.getSelectedFile();
if (!outputFile.getName().toLowerCase().endsWith(".png")) {
    outputFile = new File(outputFile.getParent(), outputFile.getName() + ".png");
}

// 创建 ARGB 图像缓冲区（支持透明背景）
BufferedImage img = new BufferedImage(
    textArea.getWidth(),
    textArea.getHeight(),
    BufferedImage.TYPE_INT_ARGB
);

// 执行离屏渲染
Graphics g = img.getGraphics();
try {
    textArea.paint(g); // 注意：此调用依赖组件已布局完成且可见
} finally {
    g.dispose();
}

// 写入 PNG 文件
try {
    ImageIO.write(img, "png", outputFile);
    Macros.message(view, "Screenshot sa ved to: " + outputFile.getAbsolutePath());
} catch (Exception e) {
    Macros.error(view, "Failed to sa ve image: " + e.getMessage());
}

脚本写完，怎么用？简单几步：

• 把脚本保存为 snapshot-textArea.bsh，放到 jEdit 的 macros/ 目录下；
• 在 jEdit 里通过 Macros → Load Macros 加载，或者重启后就能在 Macros 菜单里看到它；
• 你也可以右键给它绑定快捷键（Utilities → Global Options → Shortcuts），效率更高；
• 如果愿意，还能从终端直接调用：jedit -run=/path/to/snapshot-textArea.bsh，但前提是 jEdit 已经在运行且打开了文档。

有几个细节值得留意：

第一，这个脚本只会捕获当前可视区域的内容。也就是说，如果编辑区里有滚动条、内容没完全显示，那只有当前屏幕里能看到的这部分会被截下来。想截全文档？那就得先调整视图，或者改用 JViewport 配合 scrollRectToVisible 来做。

第二，textArea.paint(g) 是“快照式”的绘制，不会触发任何事件或状态更新——安全，稳定，没什么副作用。

第三，这里用的图像格式是 TYPE_INT_ARGB，支持抗锯齿字体和编辑器主题配色。暗色模式下的语法高亮、字体渲染，都能原样保留。

万一导出后是黑屏？那多半是因为 textArea 还没初始化完成。建议在 View 或 Buffer 激活之后再执行脚本，通常就能正常工作了。

这个方法其实有很强的通用性——把代码里的 textArea 换成任意 JComponent 实例（比如 dockableWindow.getComponent()），你就能对侧边栏、控制台等各种 Swing 组件做同样的截图操作。对于自动化文档生成、UI 测试、教学演示来说，这确实是个实用的小技巧。