          for idx, filename in enumerate(self.file_list):
              if idx in self._skip_list:
                  logger.trace("Skipping frame %s due to skip list")
                  continue
              image_read = read_image(filename, raise_error=False, with_hash=False)
              retval = filename, image_read
              if retval[1] is None:
                  logger.warning("Frame not loaded: '%s'", filename)
                  continue
              yield retval
 
</s> remove             image_read = read_image(filename, raise_error=False, with_hash=True)
 </s> add             image_read = read_image(filename, raise_error=False, with_metadata=True) </s> remove         sha1_hash: str
            The sha1 hash of the loaded image.
 </s> add         metadata: dict
            The Faceswap metadata associated with the loaded image. </s> remove             retval = (filename, idx)
 </s> add             retval = (item["current_filename"], item["face_index"]) </s> remove         seen_hash_dupes = set()
        for item in tqdm(self.items, desc=self.output_message):
            filename = item["face_fullname"]
            f_hash = item["face_hash"]
            frame_idx = list(self._alignments.hashes_to_frame[f_hash].items())

            if len(frame_idx) > 1:
                # If the same hash exists in multiple frames, select arbitrary frame
                # and add to seen_hash_dupes so it is not selected again
                logger.trace("Dupe hashes: %s", frame_idx)
                frame_idx = [f_i for f_i in frame_idx if f_i not in seen_hash_dupes][0]
                seen_hash_dupes.add(frame_idx)
                frame_idx = [frame_idx]

            frame_name, idx = frame_idx[0]
            if not self._alignments.frame_has_multiple_faces(frame_name):
 </s> add         for item in tqdm(self._items, desc=self.output_message):
            if not self._alignments.frame_has_multiple_faces(item["source_filename"]): </s> remove         for future in futures.as_completed(read_hashes):
            retval = (read_hashes[future],
                      *future.result()) if output_shape else (read_hashes[future], future.result())
 </s> add         for future in futures.as_completed(read_meta):
            retval = (read_meta[future], future.result())
            image_read = read_image(filename, raise_error=False)
          for idx, filename in enumerate(self.file_list):
              if idx in self._skip_list:
                  logger.trace("Skipping frame %s due to skip list")
                  continue
            image_read = read_image(filename, raise_error=False)
              retval = filename, image_read
              if retval[1] is None:
                  logger.warning("Frame not loaded: '%s'", filename)
                  continue
              yield retval
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