JLayeredPane中蒙版图像无法正常渲染的技术问题排查

你遇到的问题是**applyMask方法中对蒙版坐标做了重复缩放**，导致生成的蒙版绘制在错误位置，看起来像是消失了。

具体逻辑错误：

• maskPoints在addPoint方法中已经被转换为原始图像的坐标（基于原始图像尺寸和显示面板的比例换算）
• 但在applyMask里又对这些坐标再次执行缩放计算：int x = (int) (p.getX() * originalImage.getWidth() / imageLabel.getWidth());，这相当于把已经是原始尺寸的坐标又放大了一次，导致蒙版绘制到了图像范围之外。

1. 修正applyMask中的坐标计算 #

直接使用maskPoints中已转换好的原始图像坐标，无需二次缩放：

private void applyMask() {
    if (originalImage == null) return;

    BufferedImage maskedImage = new BufferedImage(originalImage.getWidth(), originalImage.getHeight(), BufferedImage.TYPE_INT_ARGB);
    Graphics2D g2d = maskedImage.createGraphics();

    g2d.drawImage(originalImage, 0, 0, null);
    g2d.setColor(MASK_COLOR);
    g2d.setComposite(AlphaComposite.getInstance(AlphaComposite.SRC_OVER, 0.1f));

    // 直接使用maskPoints中的原始图像坐标，无需二次转换
    for (Point p : maskPoints) {
        int x = p.x;
        int y = p.y;
        g2d.fill(new Ellipse2D.Double(x - BRUSH_SIZE/2.0, y - BRUSH_SIZE/2.0, BRUSH_SIZE, BRUSH_SIZE));
    }

    g2d.dispose();
    displayMaskedImage(maskedImage);
    
    // 合并后清空蒙版面板和点列表
    maskPanel.clearMask();
    maskPoints.clear();
}

2. 优化displayMaskedImage避免窗口闪烁 #

原方法中每次调用pack()会触发全局布局，导致窗口闪烁，建议直接更新组件尺寸并局部刷新：

private void displayMaskedImage(BufferedImage mImage) {
    if (mImage != null) {
        int newHeight = (int) ((double) TARGET_WIDTH / mImage.getWidth() * mImage.getHeight());
        Image scaledImg = mImage.getScaledInstance(TARGET_WIDTH, newHeight, Image.SCALE_SMOOTH);
        ImageIcon icon = new ImageIcon(scaledImg);
        imageLabel.setIcon(icon);
        
        // 直接设置组件边界，替代preferredSize+pack()
        imageLabel.setBounds(0, 0, TARGET_WIDTH, newHeight);
        maskPanel.setBounds(0, 0, TARGET_WIDTH, newHeight);
        layeredPane.setPreferredSize(new Dimension(TARGET_WIDTH, newHeight));
        
        // 局部刷新层级面板，避免全局重绘
        layeredPane.revalidate();
        layeredPane.repaint();
    }
}

3. 简化mouseReleased逻辑 #

现在applyMask末尾已经完成蒙版清空，无需在鼠标释放事件中重复处理：

@Override
public void mouseReleased(MouseEvent e) {
    if (originalImage != null) applyMask();
}

整合上述修改后的核心方法实现：

private void applyMask() {
    if (originalImage == null) return;

    BufferedImage maskedImage = new BufferedImage(originalImage.getWidth(), originalImage.getHeight(), BufferedImage.TYPE_INT_ARGB);
    Graphics2D g2d = maskedImage.createGraphics();

    g2d.drawImage(originalImage, 0, 0, null);
    g2d.setColor(MASK_COLOR);
    g2d.setComposite(AlphaComposite.getInstance(AlphaComposite.SRC_OVER, 0.1f));

    for (Point p : maskPoints) {
        int x = p.x;
        int y = p.y;
        g2d.fill(new Ellipse2D.Double(x - BRUSH_SIZE/2.0, y - BRUSH_SIZE/2.0, BRUSH_SIZE, BRUSH_SIZE));
    }

    g2d.dispose();
    displayMaskedImage(maskedImage);
    
    maskPanel.clearMask();
    maskPoints.clear();
}

private void displayMaskedImage(BufferedImage mImage) {
    if (mImage != null) {
        int newHeight = (int) ((double) TARGET_WIDTH / mImage.getWidth() * mImage.getHeight());
        Image scaledImg = mImage.getScaledInstance(TARGET_WIDTH, newHeight, Image.SCALE_SMOOTH);
        ImageIcon icon = new ImageIcon(scaledImg);
        imageLabel.setIcon(icon);
        imageLabel.setBounds(0, 0, TARGET_WIDTH, newHeight);
        maskPanel.setBounds(0, 0, TARGET_WIDTH, newHeight);
        layeredPane.setPreferredSize(new Dimension(TARGET_WIDTH, newHeight));
        layeredPane.revalidate();
        layeredPane.repaint();
    }
}

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