pjpg v0.1.1

pjpg - parse jpegs

A collection of functions for reading and parsing segments of bytes in JPEG files.

index:

• readAdobe
• readComment
• readIPTC
• readJFIF
• readMarkers
• readMicrosoftPadding
• readSegment
• exif
• util
• app1
• dict

Example Usage

//Sample code that loads a JPEG and console.logs some EXIF metadata if the file has any.

import fs from 'fs'
import pjpg from 'pjpg'

//load a JPEG file, make a buffer
const jpeg = fs.readFileSync('./IMG_0466.jpg')
const buffer = new ArrayBuffer(jpeg.byteLength)
new Uint8Array(buffer).set(jpeg)

//build a list of every JPEG marker in the file
const markers = pjpg.readMarkers(buffer)

markers.forEach(marker => {

	//APP1 segment (usually exif/adobe metadata)
	if (marker.byteMarker === 0xFFE1) {

		//get the ID of the APP1-segment to determine the type
		const id = pjpg.app1.readID(marker.offset, buffer)
		if (id === 'Exif') {

			//read the segment as EXIF metadata

			const exif = pjpg.exif.readExif(marker.offset, buffer)

			//console.log every tag in the first Image File Directory (IFD0)
			if (exif.hasOwnProperty('ifd0')) {
				exif.ifd0.tagList.forEach(tag => {
					const valueReadableByHumans = pjpg.dict.tiff.image.parseValue(tag)
					const tagName = pjpg.dict.tiff.image.getValue(tag.id, 'name')
					console.log(`${tagName}: ${valueReadableByHumans}`)
				})
			}
		}

	}
})

Dictionaries

there are a number of dictionary-like objects that can be used to convert raw tag values to something more legible.

dicts:

• dict.tiff.image (information about tags stored in IFD0/IFD1. General Image tags)
• dict.tiff.photo (information about tags stored in Exif sub-IFDs. Photography tags from digital cameras)
• dict.tiff.gps (information about tags stored in GPS sub-IFDs.)

• dict.tiff.iop (information about tags stored in IOP sub-IFDS (Interoperability information))

• dict.iptc.envelope (8BIM tag information)

• dict.iptc.application2 (8BIM tag information)

• dict.jpeg (names of JPEG bytemarkers)