Method getLibImage

app/src/processing/app/Theme.java:546–595

Return an Image object from inside the Processing lib folder.

(String filename, Component who, int width,
                                  int height)

   * Return an Image object from inside the Processing lib folder.
   */
  static public Image getLibImage(String filename, Component who, int width,
                                  int height) {
    Image image = null;

    // Use vector image when available
    Resource vectorFile = getThemeResource(filename + ".svg");
    if (vectorFile.exists()) {
      try {
        image = imageFromSVG(vectorFile.getUrl(), width, height);
      } catch (Exception e) {
        System.err.println("Failed to load " + vectorFile + ": " + e.getMessage());
      }
    }

    Resource bitmapFile = getThemeResource(filename + ".png");
    
    // Otherwise fall-back to PNG bitmaps, allowing user-defined bitmaps to
    // override built-in svgs
    if (image == null || bitmapFile.getPriority() > vectorFile.getPriority()) {
      Resource bitmap2xFile = getThemeResource(filename + "@2x.png");

      Resource imageFile;
      if (((getScale() > 125 && bitmap2xFile.exists()) || !bitmapFile.exists())
          && (bitmapFile.isUserDefined() && bitmap2xFile.isUserDefined())) {
        imageFile = bitmap2xFile;
      } else {
        imageFile = bitmapFile;
      }
      Toolkit tk = Toolkit.getDefaultToolkit();
      image = tk.getImage(imageFile.getUrl());
    }

    MediaTracker tracker = new MediaTracker(who);
    try {
      tracker.addImage(image, 0);
      tracker.waitForAll();
    } catch (InterruptedException e) {
    }

    if (image.getWidth(null) != width || image.getHeight(null) != height) {
      image = image.getScaledInstance(width, height, Image.SCALE_SMOOTH);
      try {
        tracker.addImage(image, 1);
        tracker.waitForAll();
      } catch (InterruptedException e) {
      }
    }

    return image;
  }

  /**
   * Get an image associated with the current color theme.