Processing中PShape绘制透明球体渲染异常的排查与解决

现象说明 #

在Processing 4中，使用PShape绘制透明球体或带透明纹理的球体时出现渲染异常，但不透明场景及直接使用sphere()函数绘制的透明球体均正常：

• 不透明填充（正常）：
• 透明填充（异常）：
• 不透明纹理（正常）：
• 透明纹理（异常）：
• 使用sphere()实现透明填充（正常）：

测试代码 #

int which;
PImage img;
PShape sphere;

void setup() {
  size(500, 500, P3D);
  colorMode(RGB, 1.0);
  noStroke();
  hint(ENABLE_DEPTH_SORT);   // 修复case 5（用sphere()函数的透明填充）
  hint(DISABLE_DEPTH_TEST);  // 破坏case 0和2，对case1和3有一定改善但无法修复

  sphere = createShape(SPHERE, 150);
  
  which = 5;
  if (which == 0) {
    sphere.setFill(color(0, 0.55, 0.67, 1));
  } else if (which == 1) {
    sphere.setFill(color(0, 0.55, 0.67, 0.5));
  } else if (which == 2) {
    img = loadImage("opaque-checkerboard.png");
    sphere.setTexture(img);
  } else if (which == 3) {
    img = loadImage("transparent-checkerboard.png");
    sphere.setTexture(img);
  }
}

void draw() {
  background(0);
  lights();
  translate(width/2, height/2, 0);

  if (which <= 3) {
    shape(sphere);
  } else {
    if (which == 4) {
      fill(0, 0.55, 0.67, 1);
    } else if (which == 5) {
      fill(0, 0.55, 0.67, 0.5);
    }
    sphere(150);
  }
}

尝试过的方案 #

曾猜测问题与背面剔除有关，尝试添加OpenGL相关代码，但无论在setup()或draw()的哪个位置调用，修改PGL.BACK为PGL.FRONT，均无效果：

// import processing.opengl.*;

PGL pgl = beginPGL();
pgl.enable(PGL.CULL_FACE);
pgl.cullFace(PGL.BACK);
endPGL();

更新（2023.03.10） #

结合相关测试及参考资料，发现sphere()与PShape的渲染表现存在差异。由于需求是使用纹理填充，因此需要解决PShape的透明渲染问题。另外发现：禁用深度测试（DISABLE_DEPTH_TEST）绘制不透明球体时，会出现与透明球体类似的渲染瑕疵：

问题解答 #

原因分析 #

问题核心在于PShape生成的球体模型，顶点绘制顺序未按深度排序，且深度缓冲的处理逻辑与原生sphere()函数不同：

1. 透明渲染依赖OpenGL按“从远到近”的顺序绘制像素，才能正确混合颜色；
2. 原生sphere()函数内部已处理顶点排序和深度缓冲的配合，但createShape(SPHERE)生成的PShape模型，默认顶点顺序未做深度排序优化；
3. ENABLE_DEPTH_SORT提示仅对原生绘制函数生效，无法作用于PShape；
4. 你观察到的“禁用深度测试后不透明球体也出现瑕疵”，直接验证了这一点：深度测试失效时，后绘制的像素会覆盖先绘制的，而PShape球体的顶点绘制顺序不是按视线方向排序，导致背面像素错误覆盖正面，出现破面。

解决方法 #

方案1：调整OpenGL渲染状态（快速临时解决）

在绘制PShape透明球体前后，修改深度缓冲和混合模式：

void draw() {
  background(0);
  lights();
  translate(width/2, height/2, 0);

  if (which <= 3) {
    // 针对PShape透明渲染调整状态
    hint(DISABLE_DEPTH_MASK); // 禁用深度写入，只保留深度测试
    blendMode(BLEND); // 使用标准混合模式
    shape(sphere);
    hint(ENABLE_DEPTH_MASK); // 恢复深度写入
  } else {
    // 原生sphere()的绘制逻辑
    if (which == 4) {
      fill(0, 0.55, 0.67, 1);
    } else if (which == 5) {
      fill(0, 0.55, 0.67, 0.5);
    }
    sphere(150);
  }
}

原理：禁用深度写入后，透明像素不会覆盖深度缓冲，后续绘制的背面像素不会被错误遮挡；但如果场景中有多个透明物体，仍需手动按距离排序绘制。

方案2：替换为自定义排序后的球体模型（推荐）

放弃使用createShape(SPHERE)，改用手动生成带有序顶点的球体模型，或借助第三方库（如toxiclibs、peasycam附带工具）生成按深度排序的球体模型，从根源解决顶点顺序问题。

方案3：修正PShape的坐标空间渲染

确保PShape在正确的坐标空间中渲染，避免坐标变换导致的深度计算错误：

void draw() {
  background(0);
  lights();
  translate(width/2, height/2, 0);
  pushMatrix();
  shapeMode(MODEL);
  shape(sphere);
  popMatrix();
}

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