167 lines
3.2 KiB
Markdown
167 lines
3.2 KiB
Markdown
# Image EXIF Reader
|
||
|
||
一个简单的图片 EXIF 数据读取器，支持读取 JPEG、TIFF 等格式图片的 EXIF 元数据。
|
||
|
||
## 功能特点
|
||
|
||
- **支持多种图片格式**：JPEG/JPG、TIFF、HEIC/HEIF、PNG、WebP。
|
||
- **读取常见 EXIF 数据**：相机信息、拍摄参数、镜头信息等。
|
||
- **简单易用的 API**。
|
||
- **支持浏览器直接使用**。
|
||
- **轻量级，无依赖**。
|
||
|
||
## 快速开始
|
||
|
||
### 直接使用
|
||
|
||
```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>
|
||
```
|
||
|
||
### 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 数据读取。
|