1.0.0 • Published 6 years ago
cyexifparser
Licence
ISC
Version
1.0.0
Deps
0
Size
5.7 MB
Vulns
0
Weekly
0
Image EXIF parser that conforms to EXIF V2.3 specifications
This Library is used to extract EXIF information in digital camera image files.
npm
This library is published on npm:
$ npm install --save cyexifparserOptions
| Option | Type | Description |
|---|---|---|
| debug | Boolean | Display Debug information when parsing an image |
| fullData | Boolean | Get Full exif data from image with each attribute returining printable, tag, fieldType, values , fieldOffset, fieldLength if true otherwise returning printable and values sub-attributes only |
| selectedKeys | Array | The array of string containing keys to extrtact from the Exif data alternate to fullData also printable and values sub-attributes only |
| contains | String | The partial string of keys to extrtact from the Exif data alternate to fullData and selectedKeys also printable and values sub-attributes only |
Example usage
One can use the exif parse in many ways
Promise with the parser to an image with exif data, with debug and fulldata on
var cyexifparser = require("cyexifparser");
//options to be considered
var parserOptions = {
debug: true,
fullData: true,
selectedKeys:['GPS GPSVersionID','GPS GPSTimeStamp'],
contains: 'GPS'
};
var base64Image = "this could be a huge base64 image";// or load data by using nodejs's var fs = require('fs').readFile
var data = Buffer.from(base64Image, 'base64');// and pass in the data from fs.readFile's callback function e.g fs.readFile('exif_with_gps.jpg', function (err, data) { ....
cyexifparser.CyExifParser(data, parserOptions).then((tags) => {
console.log(JSON.stringify(tags));
}).catch((err) => {
console.error(err);
});Callback with the parser to an image with exif data, with debug and fulldata on
var cyexifparser = require("cyexifparser");
//options to be considered
var parserOptions = {
debug: true,
fullData: true,
selectedKeys:['Image Make','Image Model'],
contains: 'Thumbnail'
};
var base64Image = "this could be a huge base64 image";// or load data by using nodejs's var fs = require('fs').readFile
var data = Buffer.from(base64Image, 'base64');// and pass in the data from fs.readFile's callback function e.g fs.readFile('exif_with_gps.jpg', function (err, data) { ....
cyexifparser..CyExifParser(data, parserOptions, function (calldata, callerr) {
if (calldata) {
console.log(JSON.stringify(calldata));
} else {
assert.fail(TestMessage);
}
});Angular Import
One can install the npm module in an anglar component :
import { CyExifParser } from 'cyexifparser';
@Component({
selector: 'imageexifchecker',
templateUrl: 'imageexifchecker.html',
})
export class ImageExifChecker {
......
base64toBlob(base64Data, contentType = '', sliceSize = 512) {
base64Data = base64Data.replace(/^data\:([^\;]+)\;base64,/gmi, '');
var byteCharacters = atob(base64Data);
var byteArrays = [];
for (var offset = 0; offset < byteCharacters.length; offset += sliceSize) {
var slice = byteCharacters.slice(offset, offset + sliceSize);
var byteNumbers = new Array(slice.length);
for (var i = 0; i < slice.length; ++i) {
byteNumbers[i] = slice.charCodeAt(i);
}
var byteArray = new Uint8Array(byteNumbers);
byteArrays.push(byteArray);
}
var blob = new Blob(byteArrays, { type: contentType });
return blob;
}
hasExif(base64Image) {
var blobImg = this.base64ToArrayBuffer(base64Image);
CyExifParser(blobImg,
{
debug: false,
fullData: false ,
selectedKeys:['GPS GPSLongitude','GPS GPSLatitude'],
contains: 'GPS'
}
).then((tags) => {
this.imageData[imgId].exif = tags;
let taghasgps = tags.hasOwnProperty('GPS GPSLongitude') && tags.hasOwnProperty('GPS GPSLatitude');
if (taghasgps) {
console.log("Latitude : " + tags['GPS GPSLatitude']);
console.log("Longitude : " + tags['GPS GPSLongitude']);
}
console.log(JSON.stringify(tags));
}).catch((err) => {
console.log(err.message);
});
}
}Running tests
Running and reviewing unit tests is a great way to get familiarized with a library and its API. You can install dependencies and run tests with the following command:
$ npm install && npm testAuthor
Cyril Adelekan twitter
Sample output on a successful extraction of EXIF data
{
"EXIF ColorSpace": {
"printable": "Uncalibrated",
"tag": 40961,
"fieldType": 3,
"values": [
65535
],
"fieldOffset": 442,
"fieldLength": 2
},
"EXIF CompressedBitsPerPixel": {
"printable": "4",
"tag": 37122,
"fieldType": 5,
"values": [
4
],
"fieldOffset": 722,
"fieldLength": 8
},
"EXIF Contrast": {
"printable": "Low",
"tag": 41992,
"fieldType": 3,
"values": [
1
],
"fieldOffset": 622,
"fieldLength": 2
},
"EXIF CustomRendered": {
"printable": "Normal process",
"tag": 41985,
"fieldType": 3,
"values": [
0
],
"fieldOffset": 538,
"fieldLength": 2
},
"EXIF DateTimeDigitized": {
"printable": "2003:11:23 18:07:37",
"tag": 36868,
"fieldType": 2,
"values": "2003:11:23 18:07:37",
"fieldOffset": 702,
"fieldLength": 20
},
"EXIF DateTimeOriginal": {
"printable": "2003:11:23 18:07:37",
"tag": 36867,
"fieldType": 2,
"values": "2003:11:23 18:07:37",
"fieldOffset": 682,
"fieldLength": 20
},
"EXIF DigitalZoomRatio": {
"printable": "1",
"tag": 41988,
"fieldType": 5,
"values": [
1
],
"fieldOffset": 812,
"fieldLength": 8
},
"EXIF ExifImageLength": {
"printable": "375",
"tag": 40963,
"fieldType": 4,
"values": [
375
],
"fieldOffset": 466,
"fieldLength": 4
},
"EXIF ExifImageWidth": {
"printable": "500",
"tag": 40962,
"fieldType": 4,
"values": [
500
],
"fieldOffset": 454,
"fieldLength": 4
},
"EXIF ExifVersion": {
"printable": "0,2,2,0",
"tag": 36864,
"fieldType": 7,
"values": [
48,
50,
50,
48
],
"fieldOffset": 262,
"fieldLength": 4
},
"EXIF ExposureBiasValue": {
"printable": "0",
"tag": 37380,
"fieldType": 10,
"values": [
0
],
"fieldOffset": 730,
"fieldLength": 8
},
"EXIF ExposureMode": {
"printable": "Auto exposure",
"tag": 41986,
"fieldType": 3,
"values": [
0
],
"fieldOffset": 550,
"fieldLength": 2
},
"EXIF ExposureProgram": {
"printable": "Aperture-priority AE",
"tag": 34850,
"fieldType": 3,
"values": [
3
],
"fieldOffset": 250,
"fieldLength": 2
},
"EXIF ExposureTime": {
"printable": "1/125",
"tag": 33434,
"fieldType": 5,
"values": [
"1/125"
],
"fieldOffset": 666,
"fieldLength": 8
},
"EXIF FNumber": {
"printable": "9/2",
"tag": 33437,
"fieldType": 5,
"values": [
"9/2"
],
"fieldOffset": 674,
"fieldLength": 8
},
"EXIF FileSource": {
"printable": "Digital Camera",
"tag": 41728,
"fieldType": 7,
"values": [
3
],
"fieldOffset": 502,
"fieldLength": 1
},
"EXIF Flash": {
"printable": "No",
"tag": 37385,
"fieldType": 3,
"values": [
0
],
"fieldOffset": 358,
"fieldLength": 2
},
"EXIF FlashPixVersion": {
"printable": "0,1,0,0",
"tag": 40960,
"fieldType": 7,
"values": [
48,
49,
48,
48
],
"fieldOffset": 430,
"fieldLength": 4
},
"EXIF FocalLength": {
"printable": "2333/100",
"tag": 37386,
"fieldType": 5,
"values": [
"2333/100"
],
"fieldOffset": 746,
"fieldLength": 8
},
"EXIF FocalLengthIn35mmFormat": {
"printable": "35",
"tag": 41989,
"fieldType": 3,
"values": [
35
],
"fieldOffset": 586,
"fieldLength": 2
},
"EXIF GainControl": {
"printable": "Low gain up",
"tag": 41991,
"fieldType": 3,
"values": [
1
],
"fieldOffset": 610,
"fieldLength": 2
},
"EXIF LightSource": {
"printable": "Unknown",
"tag": 37384,
"fieldType": 3,
"values": [
0
],
"fieldOffset": 346,
"fieldLength": 2
},
"EXIF MaxApertureValue": {
"printable": "3",
"tag": 37381,
"fieldType": 5,
"values": [
3
],
"fieldOffset": 738,
"fieldLength": 8
},
"EXIF MeteringMode": {
"printable": "Spot",
"tag": 37383,
"fieldType": 3,
"values": [
3
],
"fieldOffset": 334,
"fieldLength": 2
},
"EXIF RelatedSoundFile": {
"printable": " ",
"tag": 40964,
"fieldType": 2,
"values": " ",
"fieldOffset": 790,
"fieldLength": 13
},
"EXIF Saturation": {
"printable": "Normal",
"tag": 41993,
"fieldType": 3,
"values": [
0
],
"fieldOffset": 634,
"fieldLength": 2
},
"EXIF SceneCaptureType": {
"printable": "Standard",
"tag": 41990,
"fieldType": 3,
"values": [
0
],
"fieldOffset": 598,
"fieldLength": 2
},
"EXIF SceneType": {
"printable": "Directly Photographed",
"tag": 41729,
"fieldType": 7,
"values": [
1
],
"fieldOffset": 514,
"fieldLength": 1
},
"EXIF SensingMethod": {
"printable": "2",
"tag": 41495,
"fieldType": 3,
"values": [
2
],
"fieldOffset": 490,
"fieldLength": 2
},
"EXIF Sharpness": {
"printable": "Normal",
"tag": 41994,
"fieldType": 3,
"values": [
0
],
"fieldOffset": 646,
"fieldLength": 2
},
"EXIF SubSecTime": {
"printable": "63",
"tag": 37520,
"fieldType": 2,
"values": "63",
"fieldOffset": 394,
"fieldLength": 3
},
"EXIF SubSecTimeDigitized": {
"printable": "63",
"tag": 37522,
"fieldType": 2,
"values": "63",
"fieldOffset": 418,
"fieldLength": 3
},
"EXIF SubSecTimeOriginal": {
"printable": "63",
"tag": 37521,
"fieldType": 2,
"values": "63",
"fieldOffset": 406,
"fieldLength": 3
},
"EXIF SubjectDistanceRange": {
"printable": "Unknown",
"tag": 41996,
"fieldType": 3,
"values": [
0
],
"fieldOffset": 658,
"fieldLength": 2
},
"EXIF tag 41730": {
"printable": "0,2,0,2,1,2,0,1",
"tag": 41730,
"fieldType": 7,
"values": [
0,
2,
0,
2,
1,
2,
0,
1
],
"fieldOffset": 804,
"fieldLength": 8
},
"EXIF UserComment": {
"printable": "\u0000,\u0000,\u0000,\u0000,\u0000,\u0000,\u0000,\u0000,t,a,k,e,n, ,a,t, ,b,a,s,i,l,i,c,a, ,o,f, ,c,h,i,n,e,s,e",
"tag": 37510,
"fieldType": 7,
"values": [
0,
0,
0,
0,
0,
0,
0,
0,
116,
97,
107,
101,
110,
32,
97,
116,
32,
98,
97,
115,
105,
108,
105,
99,
97,
32,
111,
102,
32,
99,
104,
105,
110,
101,
115,
101
],
"fieldOffset": 754,
"fieldLength": 36
},
"EXIF WhiteBalance": {
"printable": "Auto white balance",
"tag": 41987,
"fieldType": 3,
"values": [
0
],
"fieldOffset": 562,
"fieldLength": 2
},
"GPS GPSDateStamp": {
"printable": "2003:11:23",
"tag": 29,
"fieldType": 2,
"values": "2003:11:23",
"fieldOffset": 982,
"fieldLength": 11
},
"GPS GPSLatitude": {
"printable": "395456",
"tag": 2,
"fieldType": 5,
"values": [
39,
54,
56
],
"fieldOffset": 910,
"fieldLength": 24
},
"GPS GPSLatitudeRef": {
"printable": "N",
"tag": 1,
"fieldType": 2,
"values": "N",
"fieldOffset": 842,
"fieldLength": 2
},
"GPS GPSLongitude": {
"printable": "1162327",
"tag": 4,
"fieldType": 5,
"values": [
116,
23,
27
],
"fieldOffset": 934,
"fieldLength": 24
},
"GPS GPSLongitudeRef": {
"printable": "E",
"tag": 3,
"fieldType": 2,
"values": "E",
"fieldOffset": 866,
"fieldLength": 2
},
"GPS GPSTimeStamp": {
"printable": "18737",
"tag": 7,
"fieldType": 5,
"values": [
18,
7,
37
],
"fieldOffset": 958,
"fieldLength": 24
},
"GPS GPSVersionID": {
"printable": "2200",
"tag": 0,
"fieldType": 1,
"values": [
2,
2,
0,
0
],
"fieldOffset": 830,
"fieldLength": 4
},
"Image DateTime": {
"printable": "2005:07:02 10:38:28",
"tag": 306,
"fieldType": 2,
"values": "2005:07:02 10:38:28",
"fieldOffset": 196,
"fieldLength": 20
},
"Image ExifOffset": {
"printable": "216",
"tag": 34665,
"fieldType": 4,
"values": [
216
],
"fieldOffset": 114,
"fieldLength": 4
},
"Image GPSInfo": {
"printable": "820",
"tag": 34853,
"fieldType": 4,
"values": [
820
],
"fieldOffset": 126,
"fieldLength": 4
},
"Image Make": {
"printable": "NIKON CORPORATION",
"tag": 271,
"fieldType": 2,
"values": "NIKON CORPORATION",
"fieldOffset": 134,
"fieldLength": 18
},
"Image Model": {
"printable": "NIKON D2H",
"tag": 272,
"fieldType": 2,
"values": "NIKON D2H",
"fieldOffset": 152,
"fieldLength": 10
},
"Image Orientation": {
"printable": "Horizontal (normal)",
"tag": 274,
"fieldType": 3,
"values": [
1
],
"fieldOffset": 42,
"fieldLength": 2
},
"Image ResolutionUnit": {
"printable": "Pixels/Inch",
"tag": 296,
"fieldType": 3,
"values": [
2
],
"fieldOffset": 78,
"fieldLength": 2
},
"Image Software": {
"printable": "Opanda PowerExif",
"tag": 305,
"fieldType": 2,
"values": "Opanda PowerExif",
"fieldOffset": 178,
"fieldLength": 17
},
"Image XResolution": {
"printable": "256",
"tag": 282,
"fieldType": 5,
"values": [
256
],
"fieldOffset": 162,
"fieldLength": 8
},
"Image YResolution": {
"printable": "256",
"tag": 283,
"fieldType": 5,
"values": [
256
],
"fieldOffset": 170,
"fieldLength": 8
},
"JPEGThumbnail": {
"type": "Buffer",
"data": [
255,
216,
255,
219
]
},
"Thumbnail Compression": {
"printable": "JPEG (old-style)",
"tag": 259,
"fieldType": 3,
"values": [
6
],
"fieldOffset": 1004,
"fieldLength": 2
},
"Thumbnail JPEGInterchangeFormat": {
"printable": "1088",
"tag": 513,
"fieldType": 4,
"values": [
1088
],
"fieldOffset": 1052,
"fieldLength": 4
},
"Thumbnail JPEGInterchangeFormatLength": {
"printable": "4034",
"tag": 514,
"fieldType": 4,
"values": [
4034
],
"fieldOffset": 1064,
"fieldLength": 4
},
"Thumbnail ResolutionUnit": {
"printable": "Pixels/Inch",
"tag": 296,
"fieldType": 3,
"values": [
2
],
"fieldOffset": 1040,
"fieldLength": 2
},
"Thumbnail XResolution": {
"printable": "72",
"tag": 282,
"fieldType": 5,
"values": [
72
],
"fieldOffset": 1072,
"fieldLength": 8
},
"Thumbnail YResolution": {
"printable": "72",
"tag": 283,
"fieldType": 5,
"values": [
72
],
"fieldOffset": 1080,
"fieldLength": 8
}
}