如何向 JPanel 添加图像？

Question

我有一个 JPanel 我想添加我动态生成的 JPEG 和 PNG 图像。

到目前为止我在 Swing 教程 中看到的所有示例，特别是Swing 示例 使用 ImageIcon s。

我将这些图像生成为字节数组，并且通常比示例中使用的常见图标（640x480）大。

1. 使用 ImageIcon 类在 JPanel 中显示该尺寸的图像是否存在任何（性能或其他）问题？
2. “通常”的做法是什么？
3. 如何在不使用 ImageIcon 类的情况下将图像添加到 JPanel 中？

编辑：对教程和 API 进行更仔细的检查表明您无法将 ImageIcon 直接添加到 JPanel。 相反，它们通过将图像设置为 JLabel 的图标来实现相同的效果。 这感觉不太对劲...

Answer 1

如果您正在使用 JPanel，那么可能正在使用 Swing。 试试这个：

BufferedImage myPicture = ImageIO.read(new File("path-to-file"));
JLabel picLabel = new JLabel(new ImageIcon(myPicture));
add(picLabel);

图像现在是一个 swing 组件。 它像任何其他组件一样受到布局条件的影响。

Answer 2

这是我的做法（包含有关如何加载图像的更多信息）：

import java.awt.Graphics;
import java.awt.image.BufferedImage;
import java.io.File;
import java.io.IOException;
import java.util.logging.Level;
import java.util.logging.Logger;
import javax.imageio.ImageIO;
import javax.swing.JPanel;

public class ImagePanel extends JPanel{

    private BufferedImage image;

    public ImagePanel() {
       try {                
          image = ImageIO.read(new File("image name and path"));
       } catch (IOException ex) {
            // handle exception...
       }
    }

    @Override
    protected void paintComponent(Graphics g) {
        super.paintComponent(g);
        g.drawImage(image, 0, 0, this); // see javadoc for more info on the parameters            
    }

}

Answer 3

弗雷德·哈斯拉姆的方法效果很好。 不过，我在文件路径方面遇到了麻烦，因为我想引用我的 jar 中的图像。 为此，我使用了：

BufferedImage wPic = ImageIO.read(this.getClass().getResource("snow.png"));
JLabel wIcon = new JLabel(new ImageIcon(wPic));

由于我只需要使用此方法加载有限数量（大约 10 张）图像，因此它效果很好。 它无需具有正确的相对文件路径即可获取文件。

Answer 4

我认为没有必要对任何东西进行子类化。 只需使用 Jlabel 即可。 您可以将图像设置到 Jlabel 中。 因此，调整 Jlabel 的大小，然后用图像填充它。 没关系。 我就是这样做的。

Answer 5

您可以通过使用免费 SwingX 库中的 JXImagePanel 类来完全避免滚动自己的 Component 子类。

下载

Answer 6

JLabel imgLabel = new JLabel(new ImageIcon("path_to_image.png"));

Answer 7

您可以对 JPanel 进行子类化 - 这是我的 ImagePanel 的摘录，它将图像放置在 5 个位置中的任意一个位置：上/左、上/右、中/中、下/左或下/右：

protected void paintComponent(Graphics gc) {
    super.paintComponent(gc);

    Dimension                           cs=getSize();                           // component size

    gc=gc.create();
    gc.clipRect(insets.left,insets.top,(cs.width-insets.left-insets.right),(cs.height-insets.top-insets.bottom));
    if(mmImage!=null) { gc.drawImage(mmImage,(((cs.width-mmSize.width)/2)       +mmHrzShift),(((cs.height-mmSize.height)/2)        +mmVrtShift),null); }
    if(tlImage!=null) { gc.drawImage(tlImage,(insets.left                       +tlHrzShift),(insets.top                           +tlVrtShift),null); }
    if(trImage!=null) { gc.drawImage(trImage,(cs.width-insets.right-trSize.width+trHrzShift),(insets.top                           +trVrtShift),null); }
    if(blImage!=null) { gc.drawImage(blImage,(insets.left                       +blHrzShift),(cs.height-insets.bottom-blSize.height+blVrtShift),null); }
    if(brImage!=null) { gc.drawImage(brImage,(cs.width-insets.right-brSize.width+brHrzShift),(cs.height-insets.bottom-brSize.height+brVrtShift),null); }
    }

Answer 8

1. 应该不会有任何问题（除了非常大的图像可能遇到的任何一般问题）。
2. 如果您正在谈论向单个面板添加多个图像，我会使用 ImageIcon。 对于单个图像，我会考虑创建 JPanel 的自定义子类并重写其 paintComponent 方法来绘制图像。
3. （见2）

Answer 9

JPanel 几乎总是错误的子类。 为什么不继承 JComponent 呢？

ImageIcon 有一个小问题，构造函数会阻止读取图像。 从应用程序 jar 加载时这并不是真正的问题，但如果您可能通过网络连接进行读取，则可能会出现问题。 有大量使用 MediaTracker、ImageObserver 等 AWT 时代的示例，甚至在 JDK 演示中也是如此。

Answer 10

我正在从事的一个私人项目中做了一些非常类似的事情。 到目前为止，我已经生成了高达 1024x1024 的图像，没有任何问题（内存除外），并且可以非常快速地显示它们，并且没有任何性能问题。

重写 JPanel 子类的 Paint 方法是多余的，并且需要做的工作比您需要做的更多。

我这样做的方法是：

Class MapIcon implements Icon {...}

或者

Class MapIcon extends ImageIcon {...}

您用来生成图像的代码将在此类中。 我使用 BufferedImage 进行绘制，然后当调用 PaintIcon() 时，使用 g.drawImvge(bufferedImage); 这减少了生成图像时完成的闪烁量，并且您可以对其进行线程化。

接下来我扩展 JLabel：

Class MapLabel extends Scrollable, MouseMotionListener {...}

这是因为我想将图像放在滚动窗格上，即显示图像的一部分并让用户根据需要滚动。

然后我使用 JScrollPane 来保存 MapLabel，其中仅包含 MapIcon。

MapIcon map = new MapIcon (); 
MapLabel mapLabel = new MapLabel (map);
JScrollPane scrollPane = new JScrollPane();

scrollPane.getViewport ().add (mapLabel);

但对于你的场景（每次只显示整个图像）。 您需要将 MapLabel 添加到顶部 JPanel，并确保将它们全部调整为图像的完整大小（通过覆盖 GetPreferredSize()）。

Answer 11

这个答案是对 @shawalli 答案的补充...

我也想引用我的 jar 中的图像，但我没有使用 BufferedImage，而是简单地这样做了：

 JPanel jPanel = new JPanel();      
 jPanel.add(new JLabel(new ImageIcon(getClass().getClassLoader().getResource("resource/images/polygon.jpg"))));

Answer 12

在项目目录中创建一个源文件夹，在本例中我将其称为“Images”。

JFrame snakeFrame = new JFrame();
snakeFrame.setBounds(100, 200, 800, 800);
snakeFrame.setVisible(true);
snakeFrame.add(new JLabel(new ImageIcon("Images/Snake.png")));
snakeFrame.pack();

Answer 13

您可以避免使用自己的 Component 和 SwingX 库以及 ImageIO 类：

File f = new File("hello.jpg");
JLabel imgLabel = new JLabel(new ImageIcon(file.getName()));

Answer 14

我可以看到很多答案，但没有真正解决OP的三个问题。

1) 关于性能的一句话：字节数组可能效率低下，除非您可以使用与显示适配器当前分辨率和颜色深度相匹配的精确像素字节顺序。

要获得最佳绘图性能，只需将图像转换为 BufferedImage，该图像是使用与当前图形配置相对应的类型生成的。 请参阅 https://docs.oracle.com/javase/tutorial 处的 createCompatibleImage /2d/images/drawonimage.html

这些图像在绘制几次后会自动缓存在显卡内存中，无需任何编程工作（这是自 Java 6 以来 Swing 的标准），因此实际绘制将花费时间可以忽略不计 - 如果您没有更改图像。

更改图像会导致主内存和 GPU 内存之间进行额外的内存传输，速度很慢。 因此，避免将图像“重绘”到 BufferedImage 中，完全避免执行 getPixel 和 setPixel 操作。

例如，如果您正在开发一款游戏，与其将所有游戏角色绘制到 BufferedImage，然后绘制到 JPanel，不如将所有角色加载为较小的 BufferedImage，然后在 JPanel 代码中将它们一一绘制，速度要快得多。它们的正确位置 - 这样，除了用于缓存的图像的初始传输之外，主内存和 GPU 内存之间没有额外的数据传输。

ImageIcon 将在底层使用 BufferedImage - 但基本上使用正确的图形模式分配 BufferedImage 是关键，并且没有努力做到这一点。

2) 执行此操作的常用方法是在 JPanel 的重写的 PaintComponent 方法中绘制 BufferedImage。 尽管 Java 支持大量额外的功能，例如控制 GPU 内存中缓存的 VolatileImage 的缓冲链，但自从 Java 6 以来就没有必要使用其中任何一个，Java 6 在不暴露 GPU 加速的所有这些细节的情况下做得相当不错。

请注意，GPU 加速可能不适用于某些操作，例如拉伸半透明图像。

3) 不要添加。 只需按照上面提到的方式绘制它：

@Override
protected void paintComponent(Graphics g) {
    super.paintComponent(g);
    g.drawImage(image, 0, 0, this); 
}

如果图像是布局的一部分，“添加”就有意义。 如果您需要将其作为填充 JPanel 的背景或前景图像，只需在 PaintComponent 中绘制即可。 如果您更喜欢构建一个可以显示图像的通用 Swing 组件，那么情况也是一样（您可以使用 JComponent 并重写其 PaintComponent 方法） - 然后将 this 添加到 GUI 组件的布局中。

4) 如何将数组转换为 Bufferedimage

将字节数组转换为 PNG，然后加载它是相当资源密集型的。 更好的方法是将现有的字节数组转换为 BufferedImage。

为此：不要使用 for 循环并复制像素。 那是非常非常慢的。 相反：

• 学习 BufferedImage 的首选字节结构（现在可以安全地假设 RGB 或 RGBA，即每个像素 4 个字节）
• 学习使用的扫描线和扫描大小（例如，您可能有一个 142 像素宽的图像 - 但在真实情况下 ） life 将存储为 256 像素宽的字节数组，因为处理该数组并通过 GPU 硬件屏蔽未使用的像素会更快），
• 然后一旦根据这些原则构建了数组，BufferedImage 的 setRGB 数组方法就可以复制您的数组到 BufferedImage。