163 lines
2.8 KiB
Markdown
163 lines
2.8 KiB
Markdown
|
# Image EXIF Reader
|
|||
|
|
|
|||
|
|
一个简单的图片 EXIF 数据读取器，支持读取 JPEG、TIFF 等格式图片的 EXIF 元数据。
|
|||
|
|
|
|||
|
|
## 功能特点
|
|||
|
|
|
|||
|
|
- 支持多种图片格式：JPEG/JPG、TIFF、HEIC/HEIF、PNG、WebP
|
|||
|
|
- 读取常见 EXIF 数据：相机信息、拍摄参数、镜头信息等
|
|||
|
|
- 简单易用的 API
|
|||
|
|
- 支持浏览器直接使用
|
|||
|
|
- 轻量级，无依赖
|
|||
|
|
|
|||
|
|
## 快速开始
|
|||
|
|
|
|||
|
|
### 1. 直接使用
|
|||
|
|
|
|||
|
|
html
|
|||
|
|
|
|||
|
|
<!-- 引入插件 -->
|
|||
|
|
<script src="dist/imageExifReader.min.js"></script>
|
|||
|
|
<!-- HTML -->
|
|||
|
|
<input type="file" id="imageInput" accept="image/jpeg,image/jpg">
|
|||
|
|
<div id="exifData"></div>
|
|||
|
|
<script>
|
|||
|
|
// 初始化读取器
|
|||
|
|
const reader = new ImageExifReader();
|
|||
|
|
// 处理文件选择
|
|||
|
|
document.getElementById('imageInput').addEventListener('change', function(e) {
|
|||
|
|
const file = e.target.files[0];
|
|||
|
|
if (!file) return;
|
|||
|
|
reader.readExifData(file, function(error, exifData) {
|
|||
|
|
if (error) {
|
|||
|
|
console.error('读取 EXIF 数据时出错:', error);
|
|||
|
|
return;
|
|||
|
|
}
|
|||
|
|
console.log('EXIF 数据:', exifData);
|
|||
|
|
});
|
|||
|
|
});
|
|||
|
|
</script>
|
|||
|
|
### 2. NPM 安装
|
|||
|
|
|
|||
|
|
bash
|
|||
|
|
|
|||
|
|
npm install image-exif-reader
|
|||
|
|
|
|||
|
|
javascript
|
|||
|
|
|
|||
|
|
import ImageExifReader from 'image-exif-reader';
|
|||
|
|
|
|||
|
|
const reader = new ImageExifReader();
|
|||
|
|
function handleImageUpload(file) {
|
|||
|
|
reader.readExifData(file, (error, exifData) => {
|
|||
|
|
if (error) {
|
|||
|
|
console.error('读取失败:', error);
|
|||
|
|
return;
|
|||
|
|
}
|
|||
|
|
console.log('EXIF 数据:', exifData);
|
|||
|
|
});
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
## API 文档
|
|||
|
|
|
|||
|
|
### ImageExifReader
|
|||
|
|
|
|||
|
|
#### readExifData(file, callback)
|
|||
|
|
|
|||
|
|
读取图片的 EXIF 数据。
|
|||
|
|
|
|||
|
|
参数：
|
|||
|
|
|
|||
|
|
- file: File - 图片文件对象
|
|||
|
|
- callback: Function(error, exifData)
|
|||
|
|
- error: Error | null - 错误信息
|
|||
|
|
- exifData: Object - EXIF 数据对象
|
|||
|
|
|
|||
|
|
返回数据示例：
|
|||
|
|
|
|||
|
|
javascript
|
|||
|
|
{
|
|||
|
|
Make: "Panasonic",
|
|||
|
|
Model: "DC-G9",
|
|||
|
|
DateTime: "2022-03-26 18:20:19",
|
|||
|
|
ExposureTime: "1/125",
|
|||
|
|
FNumber: "f/1.7",
|
|||
|
|
FocalLength: "25mm",
|
|||
|
|
ISOSpeedRatings: 400,
|
|||
|
|
LensModel: "LUMIX G 25mm F1.7"
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
## 支持的 EXIF 标签
|
|||
|
|
|
|||
|
|
### 基本信息
|
|||
|
|
|
|||
|
|
- Make: 相机制造商
|
|||
|
|
- Model: 相机型号
|
|||
|
|
- DateTime: 拍摄时间
|
|||
|
|
- Software: 软件信息
|
|||
|
|
|
|||
|
|
### 拍摄参数
|
|||
|
|
|
|||
|
|
- ExposureTime: 曝光时间
|
|||
|
|
- FNumber: 光圈值
|
|||
|
|
- ISOSpeedRatings: ISO 感光度
|
|||
|
|
- FocalLength: 焦距
|
|||
|
|
- ExposureMode: 曝光模式
|
|||
|
|
- WhiteBalance: 白平衡
|
|||
|
|
|
|||
|
|
### 镜头信息
|
|||
|
|
|
|||
|
|
- LensModel: 镜头型号
|
|||
|
|
- LensSerialNumber: 镜头序列号
|
|||
|
|
- FocalLengthIn35mmFilm: 35mm 等效焦距
|
|||
|
|
|
|||
|
|
### 图像信息
|
|||
|
|
|
|||
|
|
- XResolution: X 轴分辨率
|
|||
|
|
- YResolution: Y 轴分辨率
|
|||
|
|
- ResolutionUnit: 分辨率单位
|
|||
|
|
|
|||
|
|
## 开发
|
|||
|
|
|
|||
|
|
bash
|
|||
|
|
|
|||
|
|
安装依赖
|
|||
|
|
npm install
|
|||
|
|
构建项目
|
|||
|
|
npm run build
|
|||
|
|
运行示例
|
|||
|
|
npm run dev
|
|||
|
|
运行测试
|
|||
|
|
npm test
|
|||
|
|
|
|||
|
|
## 示例
|
|||
|
|
|
|||
|
|
查看 `examples` 目录中的完整示例代码。
|
|||
|
|
|
|||
|
|
## 浏览器兼容性
|
|||
|
|
|
|||
|
|
- Chrome 50+
|
|||
|
|
- Firefox 50+
|
|||
|
|
- Safari 11+
|
|||
|
|
- Edge 18+
|
|||
|
|
|
|||
|
|
## 许可证
|
|||
|
|
|
|||
|
|
MIT
|
|||
|
|
|
|||
|
|
## 作者
|
|||
|
|
|
|||
|
|
[你的名字]
|
|||
|
|
|
|||
|
|
## 贡献
|
|||
|
|
|
|||
|
|
欢迎提交 Issue 和 Pull Request。
|
|||
|
|
|
|||
|
|
## 更新日志
|
|||
|
|
|
|||
|
|
### 1.0.0
|
|||
|
|
|
|||
|
|
- 初始版本发布
|
|||
|
|
- 支持 JPEG/TIFF 格式
|
|||
|
|
- 基础 EXIF 数据读取
|