Docs: Add original dimension normalization notes.

blueimp · blueimp · commit 09b15302a9d5 · 2020-05-04T03:55:09.000+09:00
diff --git a/README.md b/README.md
@@ -234,10 +234,17 @@ loadImage(
     console.log('Original image width: ', data.originalWidth)
     console.log('Original image height: ', data.originalHeight)
   },
-  { maxWidth: 600 }
+  { maxWidth: 600, meta: true }
 )
 ```
 
+**Please note:**  
+The original image dimensions reflect the natural width and height of the loaded
+image before applying any transformation.  
+For consistent values across browsers, [metadata](#metadata-parsing) parsing has
+to be enabled via `meta:true`, so `loadImage` can detect automatic image
+orientation and normalize the dimensions.
+
 #### Error handling
 
 Example code implementing error handling:
@@ -264,7 +271,7 @@ argument and the
 API is available, it returns a `Promise` object:
 
 ```js
-loadImage(fileOrBlobOrUrl, { maxWidth: 600 })
+loadImage(fileOrBlobOrUrl, { maxWidth: 600, meta: true })
   .then(function (data) {
     document.body.appendChild(data.image)
     console.log('Original image width: ', data.originalWidth)
@@ -284,6 +291,9 @@ The `Promise` resolves with an object with the following properties:
 - `originalWidth`: The original width of the image.
 - `originalHeight`: The original height of the image.
 
+Please also read the note about original image dimensions normalization in the
+[callback arguments](#callback-arguments) section.
+
 If [metadata](#metadata-parsing) has been parsed, additional properties might be
 present on the object.
 
