              A dictionary entry for a face from an alignments file containing the keys
              ``x``, ``w``, ``y``, ``h``, ``landmarks_xy``.
              Optionally the key ``thumb`` will be provided. This is for use in the manual tool and
              contains the compressed jpg thumbnail of the face to be allocated to :attr:`thumbnail.
              Optionally the key ``hash`` will be provided, but not all use cases will know the
              face hash at this time.
              Optionally the key ``mask`` will be provided, but legacy alignments will not have
              this key.
          image: numpy.ndarray, optional
              If an image is passed in, then the ``image`` attribute will
              be set to the cropped face based on the passed in bounding box co-ordinates
 
</s> remove             ``landmarks_xy``, ``mask``, ``hash``. The additional key ``thumb`` will be provided
            if the detected face object contains a thumbnail.
 </s> add             ``landmarks_xy``, ``mask``. The additional key ``thumb`` will be provided if the
            detected face object contains a thumbnail. </s> remove         alignment = dict()
        alignment["x"] = self.x
        alignment["w"] = self.w
        alignment["y"] = self.y
        alignment["h"] = self.h
        alignment["landmarks_xy"] = self.landmarks_xy
        alignment["hash"] = self.hash
        alignment["mask"] = {name: mask.to_dict() for name, mask in self.mask.items()}
 </s> add         alignment = dict(x=self.x,
                         w=self.w,
                         y=self.y,
                         h=self.h,
                         landmarks_xy=self.landmarks_xy,
                         mask={name: mask.to_dict() for name, mask in self.mask.items()}) </s> remove     with_hash: bool, optional
        If ``True`` then returns the image's sha1 hash with the image. Default: ``False``
 </s> add     with_metadata: bool, optional
        Only returns a value if the images loaded are extracted Faceswap faces. If ``True`` then
        returns the Faceswap metadata stored with in a Face images .png exif header.
        Default: ``False``
              A dictionary entry for a face from an alignments file containing the keys
              ``x``, ``w``, ``y``, ``h``, ``landmarks_xy``.
              Optionally the key ``thumb`` will be provided. This is for use in the manual tool and
              contains the compressed jpg thumbnail of the face to be allocated to :attr:`thumbnail.


              Optionally the key ``mask`` will be provided, but legacy alignments will not have
              this key.
          image: numpy.ndarray, optional
              If an image is passed in, then the ``image`` attribute will
              be set to the cropped face based on the passed in bounding box co-ordinates
keep keep keep keep replace 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/align/detected_face.py