纯Java8环境PApplet结合Unfolding保存地图为本地图片黑屏问题

输出纯黑/空白图片的核心是PApplet初始化和渲染时序错误：

• 手动调用init()仅会完成PApplet的基础参数初始化，不会自动执行setup()配置逻辑，也不会启动渲染线程触发draw()绘制，此时调用保存方法，画布没有任何渲染内容，自然输出空白。
• Unfolding的地图瓦片为异步网络加载，即使触发了绘制，没有留够瓦片加载时间直接保存，也会出现内容缺失。

方案1：使用官方标准启动方式（兼容原生save/saveFrame） #

不要手动实例化PApplet调用init，改用Processing官方提供的启动方法，将保存逻辑放到第一帧渲染完成后执行。
修改主类代码：

import processing.core.PApplet;

public class Main {
    public static void main(String args[]) {
        PApplet.main("ChoroplethMap", args);
    }
}

在ChoroplethMap类中增加保存标记，修改draw方法，保证渲染完成后再保存：

// 类成员变量，标记是否已完成保存，避免循环执行
boolean saved = false;

public void draw() {
    background(255);
    map.draw();

    if (!saved) {
        // 等待3秒保证地图瓦片异步加载完成，可根据网络情况调整时长
        try {
            Thread.sleep(3000);
        } catch (InterruptedException e) {
            Thread.currentThread().interrupt();
        }
        // 瓦片加载完成后重绘一次，保证所有内容都绘制到画布
        background(255);
        map.draw();
        // 保存文件
        save("test.jpg");
        saved = true;
        // 停止draw循环
        noLoop();
        // 保存完成后退出程序
        exit();
    }
}

说明：注释掉事件分发器代码不会影响渲染和保存逻辑，无交互场景下可以保持该配置。

方案2：离屏渲染导出（无窗口模式） #

如果不需要显示程序窗口，仅需导出图片文件，可以通过PGraphics离屏渲染，直接获取画布内容写入文件：

1. 在ChoroplethMap类中增加离屏画布对象，修改setup方法绑定离屏渲染目标：

PGraphics offscreenCanvas;
// 其余原有成员变量保持不变

public void setup() {
    size(800, 600);
    // 创建同尺寸的离屏OpenGL画布
    offscreenCanvas = createGraphics(800, 600, OPENGL);
    smooth();

    offscreenCanvas.beginDraw();
    // 初始化地图时绑定离屏画布
    map = new UnfoldingMap(this, offscreenCanvas, 50, 50, 700, 500);
    map.zoomToLevel(2);
    map.setBackgroundColor(240);

    // 原有GeoJSON加载、人口数据加载、国家着色逻辑保持不变
    List<Feature> countries = GeoJSONReader.loadData(this, "data/countries.geo.json");
    countryMarkers = MapUtils.createSimpleMarkers(countries);
    map.addMarkers(countryMarkers);
    dataEntriesMap = loadPopulationDensityFromCSV("data/countries-population-density.csv");
    shadeCountries();
    offscreenCanvas.endDraw();
}

2. 修改draw方法，等待资源加载完成后直接从离屏画布导出图片：

boolean saved = false;
public void draw() {
    background(255);
    image(offscreenCanvas, 0, 0);
    map.draw();

    if (!saved) {
        try {
            Thread.sleep(3000);
        } catch (InterruptedException e) {
            Thread.currentThread().interrupt();
        }
        offscreenCanvas.beginDraw();
        map.draw();
        offscreenCanvas.endDraw();
        // 从离屏画布获取图像保存
        PImage outputImg = offscreenCanvas.get();
        outputImg.save("test.png");
        saved = true;
        noLoop();
        exit();
    }
}

• 不推荐手动调用init()的启动方式，该方式不会自动初始化OpenGL渲染上下文，很容易出现渲染异常、画面空白的问题。
• 异步瓦片加载等待时长可根据本地网络情况调整，如果保存后仍有部分底图缺失，可适当延长等待时间。
• saveFrame()方法和save()方法逻辑一致，只要保证在渲染完成、资源加载完毕后调用，都可以正常输出图片。

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