{-# LANGUAGE DeriveGeneric #-}
{-# LANGUAGE DuplicateRecordFields #-}
{-# LANGUAGE NamedFieldPuns #-}
{-# LANGUAGE OverloadedStrings #-}
{-# LANGUAGE RecordWildCards #-}
{-# LANGUAGE StrictData #-}
{-# LANGUAGE NoImplicitPrelude #-}
{-# OPTIONS_GHC -fno-warn-unused-imports #-}
{-# OPTIONS_GHC -fno-warn-unused-matches #-}

-- Derived from AWS service descriptions, licensed under Apache 2.0.

-- |
-- Module      : Amazonka.Rekognition.Types.Face
-- Copyright   : (c) 2013-2023 Brendan Hay
-- License     : Mozilla Public License, v. 2.0.
-- Maintainer  : Brendan Hay
-- Stability   : auto-generated
-- Portability : non-portable (GHC extensions)
module Amazonka.Rekognition.Types.Face where

import qualified Amazonka.Core as Core
import qualified Amazonka.Core.Lens.Internal as Lens
import qualified Amazonka.Data as Data
import qualified Amazonka.Prelude as Prelude
import Amazonka.Rekognition.Types.BoundingBox

-- | Describes the face properties such as the bounding box, face ID, image
-- ID of the input image, and external image ID that you assigned.
--
-- /See:/ 'newFace' smart constructor.
data Face = Face'
  { -- | Bounding box of the face.
    Face -> Maybe BoundingBox
boundingBox :: Prelude.Maybe BoundingBox,
    -- | Confidence level that the bounding box contains a face (and not a
    -- different object such as a tree).
    Face -> Maybe Double
confidence :: Prelude.Maybe Prelude.Double,
    -- | Identifier that you assign to all the faces in the input image.
    Face -> Maybe Text
externalImageId :: Prelude.Maybe Prelude.Text,
    -- | Unique identifier that Amazon Rekognition assigns to the face.
    Face -> Maybe Text
faceId :: Prelude.Maybe Prelude.Text,
    -- | Unique identifier that Amazon Rekognition assigns to the input image.
    Face -> Maybe Text
imageId :: Prelude.Maybe Prelude.Text,
    -- | The version of the face detect and storage model that was used when
    -- indexing the face vector.
    Face -> Maybe Text
indexFacesModelVersion :: Prelude.Maybe Prelude.Text
  }
  deriving (Face -> Face -> Bool
forall a. (a -> a -> Bool) -> (a -> a -> Bool) -> Eq a
/= :: Face -> Face -> Bool
$c/= :: Face -> Face -> Bool
== :: Face -> Face -> Bool
$c== :: Face -> Face -> Bool
Prelude.Eq, ReadPrec [Face]
ReadPrec Face
Int -> ReadS Face
ReadS [Face]
forall a.
(Int -> ReadS a)
-> ReadS [a] -> ReadPrec a -> ReadPrec [a] -> Read a
readListPrec :: ReadPrec [Face]
$creadListPrec :: ReadPrec [Face]
readPrec :: ReadPrec Face
$creadPrec :: ReadPrec Face
readList :: ReadS [Face]
$creadList :: ReadS [Face]
readsPrec :: Int -> ReadS Face
$creadsPrec :: Int -> ReadS Face
Prelude.Read, Int -> Face -> ShowS
[Face] -> ShowS
Face -> String
forall a.
(Int -> a -> ShowS) -> (a -> String) -> ([a] -> ShowS) -> Show a
showList :: [Face] -> ShowS
$cshowList :: [Face] -> ShowS
show :: Face -> String
$cshow :: Face -> String
showsPrec :: Int -> Face -> ShowS
$cshowsPrec :: Int -> Face -> ShowS
Prelude.Show, forall x. Rep Face x -> Face
forall x. Face -> Rep Face x
forall a.
(forall x. a -> Rep a x) -> (forall x. Rep a x -> a) -> Generic a
$cto :: forall x. Rep Face x -> Face
$cfrom :: forall x. Face -> Rep Face x
Prelude.Generic)

-- |
-- Create a value of 'Face' with all optional fields omitted.
--
-- Use <https://hackage.haskell.org/package/generic-lens generic-lens> or <https://hackage.haskell.org/package/optics optics> to modify other optional fields.
--
-- The following record fields are available, with the corresponding lenses provided
-- for backwards compatibility:
--
-- 'boundingBox', 'face_boundingBox' - Bounding box of the face.
--
-- 'confidence', 'face_confidence' - Confidence level that the bounding box contains a face (and not a
-- different object such as a tree).
--
-- 'externalImageId', 'face_externalImageId' - Identifier that you assign to all the faces in the input image.
--
-- 'faceId', 'face_faceId' - Unique identifier that Amazon Rekognition assigns to the face.
--
-- 'imageId', 'face_imageId' - Unique identifier that Amazon Rekognition assigns to the input image.
--
-- 'indexFacesModelVersion', 'face_indexFacesModelVersion' - The version of the face detect and storage model that was used when
-- indexing the face vector.
newFace ::
  Face
newFace :: Face
newFace =
  Face'
    { $sel:boundingBox:Face' :: Maybe BoundingBox
boundingBox = forall a. Maybe a
Prelude.Nothing,
      $sel:confidence:Face' :: Maybe Double
confidence = forall a. Maybe a
Prelude.Nothing,
      $sel:externalImageId:Face' :: Maybe Text
externalImageId = forall a. Maybe a
Prelude.Nothing,
      $sel:faceId:Face' :: Maybe Text
faceId = forall a. Maybe a
Prelude.Nothing,
      $sel:imageId:Face' :: Maybe Text
imageId = forall a. Maybe a
Prelude.Nothing,
      $sel:indexFacesModelVersion:Face' :: Maybe Text
indexFacesModelVersion = forall a. Maybe a
Prelude.Nothing
    }

-- | Bounding box of the face.
face_boundingBox :: Lens.Lens' Face (Prelude.Maybe BoundingBox)
face_boundingBox :: Lens' Face (Maybe BoundingBox)
face_boundingBox = forall s a b t. (s -> a) -> (s -> b -> t) -> Lens s t a b
Lens.lens (\Face' {Maybe BoundingBox
boundingBox :: Maybe BoundingBox
$sel:boundingBox:Face' :: Face -> Maybe BoundingBox
boundingBox} -> Maybe BoundingBox
boundingBox) (\s :: Face
s@Face' {} Maybe BoundingBox
a -> Face
s {$sel:boundingBox:Face' :: Maybe BoundingBox
boundingBox = Maybe BoundingBox
a} :: Face)

-- | Confidence level that the bounding box contains a face (and not a
-- different object such as a tree).
face_confidence :: Lens.Lens' Face (Prelude.Maybe Prelude.Double)
face_confidence :: Lens' Face (Maybe Double)
face_confidence = forall s a b t. (s -> a) -> (s -> b -> t) -> Lens s t a b
Lens.lens (\Face' {Maybe Double
confidence :: Maybe Double
$sel:confidence:Face' :: Face -> Maybe Double
confidence} -> Maybe Double
confidence) (\s :: Face
s@Face' {} Maybe Double
a -> Face
s {$sel:confidence:Face' :: Maybe Double
confidence = Maybe Double
a} :: Face)

-- | Identifier that you assign to all the faces in the input image.
face_externalImageId :: Lens.Lens' Face (Prelude.Maybe Prelude.Text)
face_externalImageId :: Lens' Face (Maybe Text)
face_externalImageId = forall s a b t. (s -> a) -> (s -> b -> t) -> Lens s t a b
Lens.lens (\Face' {Maybe Text
externalImageId :: Maybe Text
$sel:externalImageId:Face' :: Face -> Maybe Text
externalImageId} -> Maybe Text
externalImageId) (\s :: Face
s@Face' {} Maybe Text
a -> Face
s {$sel:externalImageId:Face' :: Maybe Text
externalImageId = Maybe Text
a} :: Face)

-- | Unique identifier that Amazon Rekognition assigns to the face.
face_faceId :: Lens.Lens' Face (Prelude.Maybe Prelude.Text)
face_faceId :: Lens' Face (Maybe Text)
face_faceId = forall s a b t. (s -> a) -> (s -> b -> t) -> Lens s t a b
Lens.lens (\Face' {Maybe Text
faceId :: Maybe Text
$sel:faceId:Face' :: Face -> Maybe Text
faceId} -> Maybe Text
faceId) (\s :: Face
s@Face' {} Maybe Text
a -> Face
s {$sel:faceId:Face' :: Maybe Text
faceId = Maybe Text
a} :: Face)

-- | Unique identifier that Amazon Rekognition assigns to the input image.
face_imageId :: Lens.Lens' Face (Prelude.Maybe Prelude.Text)
face_imageId :: Lens' Face (Maybe Text)
face_imageId = forall s a b t. (s -> a) -> (s -> b -> t) -> Lens s t a b
Lens.lens (\Face' {Maybe Text
imageId :: Maybe Text
$sel:imageId:Face' :: Face -> Maybe Text
imageId} -> Maybe Text
imageId) (\s :: Face
s@Face' {} Maybe Text
a -> Face
s {$sel:imageId:Face' :: Maybe Text
imageId = Maybe Text
a} :: Face)

-- | The version of the face detect and storage model that was used when
-- indexing the face vector.
face_indexFacesModelVersion :: Lens.Lens' Face (Prelude.Maybe Prelude.Text)
face_indexFacesModelVersion :: Lens' Face (Maybe Text)
face_indexFacesModelVersion = forall s a b t. (s -> a) -> (s -> b -> t) -> Lens s t a b
Lens.lens (\Face' {Maybe Text
indexFacesModelVersion :: Maybe Text
$sel:indexFacesModelVersion:Face' :: Face -> Maybe Text
indexFacesModelVersion} -> Maybe Text
indexFacesModelVersion) (\s :: Face
s@Face' {} Maybe Text
a -> Face
s {$sel:indexFacesModelVersion:Face' :: Maybe Text
indexFacesModelVersion = Maybe Text
a} :: Face)

instance Data.FromJSON Face where
  parseJSON :: Value -> Parser Face
parseJSON =
    forall a. String -> (Object -> Parser a) -> Value -> Parser a
Data.withObject
      String
"Face"
      ( \Object
x ->
          Maybe BoundingBox
-> Maybe Double
-> Maybe Text
-> Maybe Text
-> Maybe Text
-> Maybe Text
-> Face
Face'
            forall (f :: * -> *) a b. Functor f => (a -> b) -> f a -> f b
Prelude.<$> (Object
x forall a. FromJSON a => Object -> Key -> Parser (Maybe a)
Data..:? Key
"BoundingBox")
            forall (f :: * -> *) a b. Applicative f => f (a -> b) -> f a -> f b
Prelude.<*> (Object
x forall a. FromJSON a => Object -> Key -> Parser (Maybe a)
Data..:? Key
"Confidence")
            forall (f :: * -> *) a b. Applicative f => f (a -> b) -> f a -> f b
Prelude.<*> (Object
x forall a. FromJSON a => Object -> Key -> Parser (Maybe a)
Data..:? Key
"ExternalImageId")
            forall (f :: * -> *) a b. Applicative f => f (a -> b) -> f a -> f b
Prelude.<*> (Object
x forall a. FromJSON a => Object -> Key -> Parser (Maybe a)
Data..:? Key
"FaceId")
            forall (f :: * -> *) a b. Applicative f => f (a -> b) -> f a -> f b
Prelude.<*> (Object
x forall a. FromJSON a => Object -> Key -> Parser (Maybe a)
Data..:? Key
"ImageId")
            forall (f :: * -> *) a b. Applicative f => f (a -> b) -> f a -> f b
Prelude.<*> (Object
x forall a. FromJSON a => Object -> Key -> Parser (Maybe a)
Data..:? Key
"IndexFacesModelVersion")
      )

instance Prelude.Hashable Face where
  hashWithSalt :: Int -> Face -> Int
hashWithSalt Int
_salt Face' {Maybe Double
Maybe Text
Maybe BoundingBox
indexFacesModelVersion :: Maybe Text
imageId :: Maybe Text
faceId :: Maybe Text
externalImageId :: Maybe Text
confidence :: Maybe Double
boundingBox :: Maybe BoundingBox
$sel:indexFacesModelVersion:Face' :: Face -> Maybe Text
$sel:imageId:Face' :: Face -> Maybe Text
$sel:faceId:Face' :: Face -> Maybe Text
$sel:externalImageId:Face' :: Face -> Maybe Text
$sel:confidence:Face' :: Face -> Maybe Double
$sel:boundingBox:Face' :: Face -> Maybe BoundingBox
..} =
    Int
_salt
      forall a. Hashable a => Int -> a -> Int
`Prelude.hashWithSalt` Maybe BoundingBox
boundingBox
      forall a. Hashable a => Int -> a -> Int
`Prelude.hashWithSalt` Maybe Double
confidence
      forall a. Hashable a => Int -> a -> Int
`Prelude.hashWithSalt` Maybe Text
externalImageId
      forall a. Hashable a => Int -> a -> Int
`Prelude.hashWithSalt` Maybe Text
faceId
      forall a. Hashable a => Int -> a -> Int
`Prelude.hashWithSalt` Maybe Text
imageId
      forall a. Hashable a => Int -> a -> Int
`Prelude.hashWithSalt` Maybe Text
indexFacesModelVersion

instance Prelude.NFData Face where
  rnf :: Face -> ()
rnf Face' {Maybe Double
Maybe Text
Maybe BoundingBox
indexFacesModelVersion :: Maybe Text
imageId :: Maybe Text
faceId :: Maybe Text
externalImageId :: Maybe Text
confidence :: Maybe Double
boundingBox :: Maybe BoundingBox
$sel:indexFacesModelVersion:Face' :: Face -> Maybe Text
$sel:imageId:Face' :: Face -> Maybe Text
$sel:faceId:Face' :: Face -> Maybe Text
$sel:externalImageId:Face' :: Face -> Maybe Text
$sel:confidence:Face' :: Face -> Maybe Double
$sel:boundingBox:Face' :: Face -> Maybe BoundingBox
..} =
    forall a. NFData a => a -> ()
Prelude.rnf Maybe BoundingBox
boundingBox
      seq :: forall a b. a -> b -> b
`Prelude.seq` forall a. NFData a => a -> ()
Prelude.rnf Maybe Double
confidence
      seq :: forall a b. a -> b -> b
`Prelude.seq` forall a. NFData a => a -> ()
Prelude.rnf Maybe Text
externalImageId
      seq :: forall a b. a -> b -> b
`Prelude.seq` forall a. NFData a => a -> ()
Prelude.rnf Maybe Text
faceId
      seq :: forall a b. a -> b -> b
`Prelude.seq` forall a. NFData a => a -> ()
Prelude.rnf Maybe Text
imageId
      seq :: forall a b. a -> b -> b
`Prelude.seq` forall a. NFData a => a -> ()
Prelude.rnf Maybe Text
indexFacesModelVersion