JRuby-JavaFX（JRubyFX）：如何为按钮添加PNG图标？

Hey there! Let's break down those two errors you're hitting and get your PNG icon working smoothly in your JRuby+JavaFX project.

Why You're Seeing Those Errors #

Let's unpack each error first so you know exactly what went wrong:

• Error 1: failed to coerce javafx.scene.image.Image to javafx.scene.Node
  A javafx.scene.image.Image isn't a UI element (aka a Node) on its own. You can't add it directly to your scene graph—you need a container that wraps it, which is where ImageView comes in. ImageView is the actual Node subclass designed to display images.
• Error 2: TypeError: cannot convert instance of class org.jruby.RubyString to class javafx.scene.Node
  This happens when you try to pass a raw string (like your image file path) directly to a method that expects a Node. You need to convert that path into an Image first, then wrap it in an ImageView.

Correct Implementation Example #

Here's a complete, working example that loads a PNG icon properly. I'll include two common use cases: loading a resource from your project, and loading a file from the local filesystem.

require 'jrubyfx'

class IconLoaderApp < JRubyFX::Application
  def start(stage)
    stage.title = "JRubyFX PNG Icon Demo"

    # Option 1: Load an image from your project's resources (e.g., src/main/resources/icons/)
    # Note: Path is relative to your classpath
    image = javafx.scene.image.Image.new("icons/my_icon.png")
    
    # Option 2: Load an image from the local filesystem (use absolute path with file:// prefix)
    # image = javafx.scene.image.Image.new("file:///home/your_user/path/to/my_icon.png")

    # Wrap the Image in an ImageView (this is the Node you can add to your UI)
    image_view = javafx.scene.image.ImageView.new(image)

    # Optional: Resize the icon while preserving aspect ratio
    image_view.fit_width = 64
    image_view.fit_height = 64
    image_view.preserve_ratio = true

    # Create a layout and add the ImageView to it
    root = javafx.scene.layout.VBox.new
    root.children.add(image_view)

    # Set up the scene and show the stage
    scene = javafx.scene.Scene.new(root, 200, 200)
    stage.scene = scene
    stage.show
  end
end

IconLoaderApp.launch

Key Takeaways to Avoid Future Errors #

• Always wrap your Image in an ImageView before adding it to your UI—only ImageView is a valid Node for displaying images.
• When specifying paths:
  • For project resources, use a path relative to your classpath (no need for a prefix).
  • For local files, prefix the absolute path with file:/// (three slashes after file:).
• Never pass a raw string (file path) or a raw Image instance to methods that expect a Node (like children.add()).

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