      Example
      -------
      >>> image_file = "/path/to/image.png"
      >>> try:
      >>>    image = read_image(image_file, raise_error=True, with_hash=False)
      >>> except:
      >>>     raise ValueError("There was an error")
      """
      logger.trace("Requested image: '%s'", filename)
      success = True
 
</s> remove         If :attr:`with_hash` is ``False`` then returns a `numpy.ndarray` of the image in `BGR`
        channel order. If :attr:`with_hash` is ``True`` then returns a `tuple` of (`numpy.ndarray`"
        of the image in `BGR`, `str` of sha` hash of image)
 </s> add         If :attr:`with_metadata` is ``False`` then returns a `numpy.ndarray` of the image in `BGR`
        channel order. If :attr:`with_metadata` is ``True`` then returns a `tuple` of
        (`numpy.ndarray`" of the image in `BGR`, `dict` of face's Faceswap metadata) </s> remove     >>> image_hash = read_image_hash(image_file)
 </s> add     >>> metadata = read_image_meta(image_file)
    >>> width = metadata["width]
    >>> height = metadata["height"]
    >>> faceswap_info = metadata["itxt"] </s> remove     >>> for filename, hash in read_image_hash_batch(image_filenames):
 </s> add     >>> for filename, meta in read_image_meta_batch(image_filenames): </s> remove     str
        The :func:`hashlib.hexdigest()` representation of the `sha1` hash of the given image.
 </s> add     dict
        The output dictionary will contain the `width` and `height` of the png image as well as any
        `itxt` information. </s> remove     encoded_image = cv2.imencode(extension, image)[1]
    image_hash = sha1(cv2.imdecode(encoded_image, cv2.IMREAD_UNCHANGED)).hexdigest()
    return image_hash, encoded_image
 </s> add     pointer = png.find(b"iTXt") - 4
    if pointer < 0:
        logger.trace("No metadata in png")
        return None
    length = struct.unpack(">I", png[pointer:pointer + 4])[0]
    pointer += 8
    data = png[pointer:pointer + length].split(b"\0\0\0\0\0", 1)[-1]
    return eval(data)
    >>>    image = read_image(image_file, raise_error=True, with_metadata=False)
      Example
      -------
      >>> image_file = "/path/to/image.png"
      >>> try:
    >>>    image = read_image(image_file, raise_error=True, with_metadata=False)
      >>> except:
      >>>     raise ValueError("There was an error")
      """
      logger.trace("Requested image: '%s'", filename)
      success = True
keep keep keep keep replace keep keep keep keep keep
 Update extracted faces to use PNG EXIF data (#1123)

Documentation
  - Update Usage.md, align.rst and image.rst
lib.image.py
  - read_image - Remove hash return, add metadata return
  - Remove read_image_hash functions
  - Add read_image_meta functios
  - Replace encode_image_with_hash with encode_image (to store metadata)
  - Add png meta reading and writing functions
  - Update Image Loaders/Savers to handle metadata rather than hashes
lib.training_data
  - Naming updates to remove references to hashes
lib.align.Alignments
  - Add versioning notes
  - Increment alignments version to 2.1
  - Deprecate hashing lookup functions
  - Replace filter_hashes with filter_faces
lib.align.detected_face
  - DetectedFace
    - Remove hash property
    - Add png header data serializing/deserializing functions
  - Mask
    - Add png header data serializing/deserializing functions
  - add update_legacy_png_header function to update png meta data
lib.cli.args - Deprecate alignments files for training
- plugins.train.trainer
  - Update alignments/mask code to read png header data
- scripts.convert
  - Aligned images folder - read data from png headers
- scripts.extract
  - Write png header information and no longer store hash of face
- tools.alignments
  - remove leftover-faces, merge and update-hashes jobs
  - Update jobs to use png meta data rather than hashes
- tools.manual
  - Update extract code to output png meta data and don't store hashes
  - Perform check on launch that tool is not pointing at a faces folder
tools.mask
  - Update to use png meta data
tools.sort
  - Update to use png meta data 
lib/image.py