Skip to content
master
Switch branches/tags
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Orient an image based on its Exif orientation tag and draw it to a canvas for further processing.

See a demo.

Install from NPM or Bower:

npm install exif-orient --save
bower install exif-orient --save

Usage

This library exports a single function exifOrient (support UMD):

/**
 * @param {HTMLImageElement | HTMLCanvasElement | String} img - image, canvas, base64 string or URL.
 * @param {Number} orientation - the Exif orientation.
 * @param {Function} cb (optional) - the callback function.
 * @return {HTMLCanvasElement} a canvas object.
 */
exifOrient(img, orientation, cb)

Example

// 1. Read orientation tag using exif-js (https://github.com/exif-js/exif-js)
// Note: can use any Exif parsing library, exif-js is just an example
EXIF.getData(img, function () {
  var orientation = img.exifdata.Orientation

  // 2. Invoke `exifOrient` to orient the image and get back a canvas
  exifOrient(img, orientation, function (err, canvas) {

    // 3. Do whatever you want with the canvas, e.g. render it into an image
  })
})

Changes

v0.0.5

  • Enforce argument types and values
  • Allow canvas to be used as an argument of exifOrient

v0.0.4

  • Add semicolon at EOF to be friendly with minifiers

v0.0.3

  • Rename EXIF => Exif

v0.0.2

  • Update README

v0.0.1

  • Initial release

About

Library to orient images based on their Exif orientation

Resources

License

Sponsor this project

 

Packages

No packages published