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
|
||
|
||
## 作者
|
||
|
||
zhengice
|
||
|
||
## 贡献
|
||
|
||
欢迎提交 Issue 和 Pull Request。
|
||
|
||
## 更新日志
|
||
|
||
### 1.0.0
|
||
|
||
- 初始版本发布
|
||
- 支持 JPEG/TIFF 格式
|
||
- 基础 EXIF 数据读取
|