JavaFX加载手机拍摄竖屏图片时方向识别异常问题求助

嗨，Tobyres！这个问题其实挺常见的——手机拍摄的竖屏图片通常会携带EXIF方向元数据，用来记录拍摄时的设备横竖屏状态，但JavaFX的Image类默认并不会自动读取并应用这个旋转信息。而你下载的网络图片一般已经在上传或处理时修正了这个元数据，所以能正常显示。

问题根源 #

手机拍摄图片时，为了节省存储和处理时间，并不会直接旋转图片像素，而是在EXIF信息里标记一个“方向值”，告诉查看器应该怎么旋转图片才能正确显示。但JavaFX的Image只会读取原始像素的宽高，忽略这个方向标记，导致竖屏图片看起来宽高互换。

解决方案：读取EXIF方向并应用旋转 #

我们可以用成熟的第三方库metadata-extractor来读取图片的EXIF方向信息，然后对ImageView应用对应的旋转变换。

1. 引入依赖

如果用Maven，在pom.xml里添加：

<dependency>
    <groupId>com.drewnoakes</groupId>
    <artifactId>metadata-extractor</artifactId>
    <version>2.18.0</version>
</dependency>

如果用Gradle，添加到build.gradle：

implementation 'com.drewnoakes:metadata-extractor:2.18.0'

2. 修改你的Picture类

更新代码来处理EXIF方向：

import com.drew.imaging.ImageMetadataReader;
import com.drew.metadata.Metadata;
import com.drew.metadata.exif.ExifIFD0Directory;
import javafx.scene.CacheHint;
import javafx.scene.image.Image;
import javafx.scene.image.ImageView;
import javafx.scene.transform.Rotate;

public class Picture {
    String name;
    String path;
    String res;
    String size;
    ImageView iv;
    Image image;

    public Picture(String name, String path) {
        this.image = new Image("file:" + path);
        this.name = name;
        this.path = path;
        
        // 获取EXIF方向并计算实际显示的宽高
        int orientation = getExifOrientation(path);
        double actualWidth = image.getWidth();
        double actualHeight = image.getHeight();
        
        // 旋转90/270度时，宽高会互换
        if (orientation == 6 || orientation == 8) {
            double temp = actualWidth;
            actualWidth = actualHeight;
            actualHeight = temp;
        }
        
        this.res = actualWidth + " x " + actualHeight;
        this.iv = new ImageView(image);
        
        // 对ImageView应用对应的旋转/翻转
        applyRotation(iv, orientation);
        
        this.iv.setFitHeight(180);
        this.iv.setFitWidth(180);
        this.iv.setPreserveRatio(true);
        this.iv.setCache(true);
        this.iv.setCacheHint(CacheHint.SPEED);
        this.iv.setStyle("-fx-effect: dropshadow(three-pass-box, rgba(0,0,0,0.8), 10, 0, 0, 0);");
    }

    // 读取图片的EXIF方向标记
    private int getExifOrientation(String imagePath) {
        try {
            Metadata metadata = ImageMetadataReader.readMetadata(new java.io.File(imagePath));
            ExifIFD0Directory directory = metadata.getFirstDirectoryOfType(ExifIFD0Directory.class);
            if (directory != null && directory.containsTag(ExifIFD0Directory.TAG_ORIENTATION)) {
                return directory.getInt(ExifIFD0Directory.TAG_ORIENTATION);
            }
        } catch (Exception e) {
            e.printStackTrace();
        }
        // 默认返回1（正常方向，无需旋转）
        return 1;
    }

    // 根据EXIF方向值对ImageView应用变换
    private void applyRotation(ImageView iv, int orientation) {
        Rotate rotate = new Rotate();
        switch (orientation) {
            case 2: // 水平翻转
                iv.setScaleX(-1);
                break;
            case 3: // 旋转180度
                rotate.setAngle(180);
                break;
            case 4: // 垂直翻转
                iv.setScaleY(-1);
                break;
            case 5: // 水平翻转后旋转90度
                rotate.setAngle(90);
                iv.setScaleX(-1);
                break;
            case 6: // 旋转90度（竖屏拍摄的常见情况）
                rotate.setAngle(90);
                break;
            case 7: // 水平翻转后旋转270度
                rotate.setAngle(270);
                iv.setScaleX(-1);
                break;
            case 8: // 旋转270度
                rotate.setAngle(270);
                break;
            default: // 正常方向，无需处理
                return;
        }
        // 设置旋转中心为图片的中心点
        rotate.setPivotX(iv.getImage().getWidth() / 2);
        rotate.setPivotY(iv.getImage().getHeight() / 2);
        iv.getTransforms().add(rotate);
    }
}

说明 #

• 这段代码会自动读取图片的EXIF方向，然后对ImageView应用对应的旋转或翻转，让手机拍摄的图片正确显示。
• 同时修正了res字段的宽高显示，让它和实际视觉上的宽高一致。
• 如果不想引入第三方库，也可以手动解析图片的EXIF数据，但过程会比较繁琐，推荐使用metadata-extractor这种成熟的工具库。

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