From bf17ee722cc185afcf022ebb003a9de18bf03560 Mon Sep 17 00:00:00 2001 From: adxsdknet <39844661+adxsdknet@users.noreply.github.com> Date: Fri, 26 Apr 2019 16:02:05 -0700 Subject: [PATCH] .NET SDK Resource Provider:'Face' (#5881) REST Spec PR 'https://github.com/Azure/azure-rest-api-specs/pull/5722' REST Spec PR Author 'lebronJ' REST Spec PR Last commit --- .../Face/Face/Generated/FaceListOperations.cs | 63 +++++++++++---- .../Generated/FaceListOperationsExtensions.cs | 63 +++++++++++---- .../Face/Face/Generated/FaceOperations.cs | 6 +- .../Generated/FaceOperationsExtensions.cs | 6 +- .../Face/Generated/IFaceListOperations.cs | 57 ++++++++++--- .../Face/Face/Generated/IFaceOperations.cs | 6 +- .../Generated/ILargeFaceListOperations.cs | 73 ++++++++++++----- .../Generated/ILargePersonGroupOperations.cs | 35 +++++--- .../Face/Generated/ILargePersonGroupPerson.cs | 50 ++++++++++-- .../Face/Generated/IPersonGroupOperations.cs | 40 ++++++---- .../Face/Face/Generated/IPersonGroupPerson.cs | 78 ++++++++++++++++-- .../Face/Generated/LargeFaceListOperations.cs | 80 ++++++++++++++----- .../LargeFaceListOperationsExtensions.cs | 80 ++++++++++++++----- .../Generated/LargePersonGroupOperations.cs | 39 +++++---- .../LargePersonGroupOperationsExtensions.cs | 39 +++++---- .../Face/Generated/LargePersonGroupPerson.cs | 49 ++++++++++-- .../LargePersonGroupPersonExtensions.cs | 49 ++++++++++-- .../Face/Generated/Models/FaceAttributes.cs | 4 +- .../Face/Face/Generated/Models/Gender.cs | 8 +- .../Face/Generated/PersonGroupOperations.cs | 36 +++++---- .../PersonGroupOperationsExtensions.cs | 36 +++++---- .../Face/Face/Generated/PersonGroupPerson.cs | 77 ++++++++++++++++-- .../Generated/PersonGroupPersonExtensions.cs | 77 ++++++++++++++++-- 23 files changed, 788 insertions(+), 263 deletions(-) diff --git a/src/SDKs/CognitiveServices/dataPlane/Vision/Face/Face/Generated/FaceListOperations.cs b/src/SDKs/CognitiveServices/dataPlane/Vision/Face/Face/Generated/FaceListOperations.cs index 72b4248b8f88..b8634da1ad21 100644 --- a/src/SDKs/CognitiveServices/dataPlane/Vision/Face/Face/Generated/FaceListOperations.cs +++ b/src/SDKs/CognitiveServices/dataPlane/Vision/Face/Face/Generated/FaceListOperations.cs @@ -59,7 +59,8 @@ public FaceListOperations(FaceClient client) /// Similar](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395237). /// <br /> After creation, user should use [FaceList - Add /// Face](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395250) - /// to import the faces. Faces are stored on server until [FaceList - + /// to import the faces. No image will be stored. Only the extracted face + /// features are stored on server until [FaceList - /// Delete](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f3039524f) /// is called. /// <br /> Find Similar is used for scenario like finding celebrity-like @@ -73,14 +74,20 @@ public FaceListOperations(FaceClient client) /// <br /> Please consider /// [LargeFaceList](/docs/services/563879b61984550e40cbbe8d/operations/5a157b68d2de3616c086f2cc) /// when the face number is large. It can support up to 1,000,000 faces. - /// 'recognitionModel' should be specified to associate with this face list. - /// The default value for 'recognitionModel' is 'recognition_01', if the latest - /// model needed, please explicitly specify the model you need in this - /// parameter. New faces that are added to an existing face list will use the - /// recognition model that's already associated with the collection. Existing - /// face features in a face list can't be updated to features extracted by - /// another version of recognition model. - /// + /// <br />'recognitionModel' should be specified to associate with this + /// face list. The default value for 'recognitionModel' is 'recognition_01', if + /// the latest model needed, please explicitly specify the model you need in + /// this parameter. New faces that are added to an existing face list will use + /// the recognition model that's already associated with the collection. + /// Existing face features in a face list can't be updated to features + /// extracted by another version of recognition model. + /// * 'recognition_01': The default recognition model for [FaceList- + /// Create](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f3039524b). + /// All those face lists created before 2019 March are bonded with this + /// recognition model. + /// * 'recognition_02': Recognition model released in 2019 March. + /// 'recognition_02' is recommended since its overall accuracy is improved + /// compared with 'recognition_01'. /// /// /// Id referencing a particular face list. @@ -616,8 +623,7 @@ public FaceListOperations(FaceClient client) } /// - /// Delete an existing face list according to faceListId. Persisted face images - /// in the face list will also be deleted. + /// Delete a specified face list. /// /// /// Id referencing a particular face list. @@ -922,8 +928,9 @@ public FaceListOperations(FaceClient client) } /// - /// Delete an existing face from a face list (given by a persistedFaceId and a - /// faceListId). Persisted image related to the face will also be deleted. + /// Delete a face from a face list by specified faceListId and persistedFaceId. + /// <br /> Adding/deleting faces to/from a same face list are processed + /// sequentially and to/from different face lists are in parallel. /// /// /// Id referencing a particular face list. @@ -1071,9 +1078,33 @@ public FaceListOperations(FaceClient client) } /// - /// Add a face to a face list. The input face is specified as an image with a - /// targetFace rectangle. It returns a persistedFaceId representing the added - /// face, and persistedFaceId will not expire. + /// Add a face to a specified face list, up to 1,000 faces. + /// <br /> To deal with an image contains multiple faces, input face can + /// be specified as an image with a targetFace rectangle. It returns a + /// persistedFaceId representing the added face. No image will be stored. Only + /// the extracted face feature will be stored on server until [FaceList - + /// Delete + /// Face](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395251) + /// or [FaceList - + /// Delete](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f3039524f) + /// is called. + /// <br /> Note persistedFaceId is different from faceId generated by + /// [Face - + /// Detect](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395236). + /// * Higher face image quality means better detection and recognition + /// precision. Please consider high-quality faces: frontal, clear, and face + /// size is 200x200 pixels (100 pixels between eyes) or bigger. + /// * JPEG, PNG, GIF (the first frame), and BMP format are supported. The + /// allowed image file size is from 1KB to 6MB. + /// * "targetFace" rectangle should contain one face. Zero or multiple faces + /// will be regarded as an error. If the provided "targetFace" rectangle is not + /// returned from [Face - + /// Detect](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395236), + /// there’s no guarantee to detect and add the face successfully. + /// * Out of detectable face size (36x36 - 4096x4096 pixels), large head-pose, + /// or large occlusions will cause failures. + /// * Adding/deleting faces to/from a same face list are processed sequentially + /// and to/from different face lists are in parallel. /// /// /// Id referencing a particular face list. diff --git a/src/SDKs/CognitiveServices/dataPlane/Vision/Face/Face/Generated/FaceListOperationsExtensions.cs b/src/SDKs/CognitiveServices/dataPlane/Vision/Face/Face/Generated/FaceListOperationsExtensions.cs index 5ad6adcdd472..4253913e5a5b 100644 --- a/src/SDKs/CognitiveServices/dataPlane/Vision/Face/Face/Generated/FaceListOperationsExtensions.cs +++ b/src/SDKs/CognitiveServices/dataPlane/Vision/Face/Face/Generated/FaceListOperationsExtensions.cs @@ -31,7 +31,8 @@ public static partial class FaceListOperationsExtensions /// Similar](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395237). /// <br /> After creation, user should use [FaceList - Add /// Face](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395250) - /// to import the faces. Faces are stored on server until [FaceList - + /// to import the faces. No image will be stored. Only the extracted face + /// features are stored on server until [FaceList - /// Delete](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f3039524f) /// is called. /// <br /> Find Similar is used for scenario like finding celebrity-like @@ -45,14 +46,20 @@ public static partial class FaceListOperationsExtensions /// <br /> Please consider /// [LargeFaceList](/docs/services/563879b61984550e40cbbe8d/operations/5a157b68d2de3616c086f2cc) /// when the face number is large. It can support up to 1,000,000 faces. - /// 'recognitionModel' should be specified to associate with this face list. - /// The default value for 'recognitionModel' is 'recognition_01', if the latest - /// model needed, please explicitly specify the model you need in this - /// parameter. New faces that are added to an existing face list will use the - /// recognition model that's already associated with the collection. Existing - /// face features in a face list can't be updated to features extracted by - /// another version of recognition model. - /// + /// <br />'recognitionModel' should be specified to associate with this + /// face list. The default value for 'recognitionModel' is 'recognition_01', if + /// the latest model needed, please explicitly specify the model you need in + /// this parameter. New faces that are added to an existing face list will use + /// the recognition model that's already associated with the collection. + /// Existing face features in a face list can't be updated to features + /// extracted by another version of recognition model. + /// * 'recognition_01': The default recognition model for [FaceList- + /// Create](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f3039524b). + /// All those face lists created before 2019 March are bonded with this + /// recognition model. + /// * 'recognition_02': Recognition model released in 2019 March. + /// 'recognition_02' is recommended since its overall accuracy is improved + /// compared with 'recognition_01'. /// /// /// The operations group for this extension method. @@ -127,8 +134,7 @@ public static partial class FaceListOperationsExtensions } /// - /// Delete an existing face list according to faceListId. Persisted face images - /// in the face list will also be deleted. + /// Delete a specified face list. /// /// /// The operations group for this extension method. @@ -170,8 +176,9 @@ public static partial class FaceListOperationsExtensions } /// - /// Delete an existing face from a face list (given by a persistedFaceId and a - /// faceListId). Persisted image related to the face will also be deleted. + /// Delete a face from a face list by specified faceListId and persistedFaceId. + /// <br /> Adding/deleting faces to/from a same face list are processed + /// sequentially and to/from different face lists are in parallel. /// /// /// The operations group for this extension method. @@ -191,9 +198,33 @@ public static partial class FaceListOperationsExtensions } /// - /// Add a face to a face list. The input face is specified as an image with a - /// targetFace rectangle. It returns a persistedFaceId representing the added - /// face, and persistedFaceId will not expire. + /// Add a face to a specified face list, up to 1,000 faces. + /// <br /> To deal with an image contains multiple faces, input face can + /// be specified as an image with a targetFace rectangle. It returns a + /// persistedFaceId representing the added face. No image will be stored. Only + /// the extracted face feature will be stored on server until [FaceList - + /// Delete + /// Face](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395251) + /// or [FaceList - + /// Delete](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f3039524f) + /// is called. + /// <br /> Note persistedFaceId is different from faceId generated by + /// [Face - + /// Detect](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395236). + /// * Higher face image quality means better detection and recognition + /// precision. Please consider high-quality faces: frontal, clear, and face + /// size is 200x200 pixels (100 pixels between eyes) or bigger. + /// * JPEG, PNG, GIF (the first frame), and BMP format are supported. The + /// allowed image file size is from 1KB to 6MB. + /// * "targetFace" rectangle should contain one face. Zero or multiple faces + /// will be regarded as an error. If the provided "targetFace" rectangle is not + /// returned from [Face - + /// Detect](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395236), + /// there’s no guarantee to detect and add the face successfully. + /// * Out of detectable face size (36x36 - 4096x4096 pixels), large head-pose, + /// or large occlusions will cause failures. + /// * Adding/deleting faces to/from a same face list are processed sequentially + /// and to/from different face lists are in parallel. /// /// /// The operations group for this extension method. diff --git a/src/SDKs/CognitiveServices/dataPlane/Vision/Face/Face/Generated/FaceOperations.cs b/src/SDKs/CognitiveServices/dataPlane/Vision/Face/Face/Generated/FaceOperations.cs index 259a3a56ee99..71e0b6559831 100644 --- a/src/SDKs/CognitiveServices/dataPlane/Vision/Face/Face/Generated/FaceOperations.cs +++ b/src/SDKs/CognitiveServices/dataPlane/Vision/Face/Face/Generated/FaceOperations.cs @@ -921,7 +921,7 @@ public FaceOperations(FaceClient client) /// * Optional parameters including faceId, landmarks, and attributes. /// Attributes include age, gender, headPose, smile, facialHair, glasses, /// emotion, hair, makeup, occlusion, accessories, blur, exposure and noise. - /// * The extracted face feature, instead of the actual image, will be stored + /// * No image will be stored. Only the extracted face feature will be stored /// on server. The faceId is an identifier of the face feature and will be used /// in [Face - /// Identify](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395239), @@ -945,8 +945,7 @@ public FaceOperations(FaceClient client) /// or being occluded, or wrong image orientation. /// * Attributes (age, gender, headPose, smile, facialHair, glasses, emotion, /// hair, makeup, occlusion, accessories, blur, exposure and noise) may not be - /// perfectly accurate. HeadPose's pitch value is a reserved field and will - /// always return 0. + /// perfectly accurate. /// * Different 'recognitionModel' values are provided. If follow-up operations /// like Verify, Identify, Find Similar are needed, please specify the /// recognition model with 'recognitionModel' parameter. The default value for @@ -955,7 +954,6 @@ public FaceOperations(FaceClient client) /// the detected faceIds will be associated with the specified recognition /// model. More details, please refer to [How to specify a recognition /// model](https://docs.microsoft.com/en-us/azure/cognitive-services/face/face-api-how-to-topics/specify-recognition-model) - /// /// /// /// Publicly reachable URL of an image diff --git a/src/SDKs/CognitiveServices/dataPlane/Vision/Face/Face/Generated/FaceOperationsExtensions.cs b/src/SDKs/CognitiveServices/dataPlane/Vision/Face/Face/Generated/FaceOperationsExtensions.cs index fc7d8ecaebfe..c0288c84e828 100644 --- a/src/SDKs/CognitiveServices/dataPlane/Vision/Face/Face/Generated/FaceOperationsExtensions.cs +++ b/src/SDKs/CognitiveServices/dataPlane/Vision/Face/Face/Generated/FaceOperationsExtensions.cs @@ -241,7 +241,7 @@ public static partial class FaceOperationsExtensions /// * Optional parameters including faceId, landmarks, and attributes. /// Attributes include age, gender, headPose, smile, facialHair, glasses, /// emotion, hair, makeup, occlusion, accessories, blur, exposure and noise. - /// * The extracted face feature, instead of the actual image, will be stored + /// * No image will be stored. Only the extracted face feature will be stored /// on server. The faceId is an identifier of the face feature and will be used /// in [Face - /// Identify](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395239), @@ -265,8 +265,7 @@ public static partial class FaceOperationsExtensions /// or being occluded, or wrong image orientation. /// * Attributes (age, gender, headPose, smile, facialHair, glasses, emotion, /// hair, makeup, occlusion, accessories, blur, exposure and noise) may not be - /// perfectly accurate. HeadPose's pitch value is a reserved field and will - /// always return 0. + /// perfectly accurate. /// * Different 'recognitionModel' values are provided. If follow-up operations /// like Verify, Identify, Find Similar are needed, please specify the /// recognition model with 'recognitionModel' parameter. The default value for @@ -275,7 +274,6 @@ public static partial class FaceOperationsExtensions /// the detected faceIds will be associated with the specified recognition /// model. More details, please refer to [How to specify a recognition /// model](https://docs.microsoft.com/en-us/azure/cognitive-services/face/face-api-how-to-topics/specify-recognition-model) - /// /// /// /// The operations group for this extension method. diff --git a/src/SDKs/CognitiveServices/dataPlane/Vision/Face/Face/Generated/IFaceListOperations.cs b/src/SDKs/CognitiveServices/dataPlane/Vision/Face/Face/Generated/IFaceListOperations.cs index 4f29ac4284e3..c9e5730375f3 100644 --- a/src/SDKs/CognitiveServices/dataPlane/Vision/Face/Face/Generated/IFaceListOperations.cs +++ b/src/SDKs/CognitiveServices/dataPlane/Vision/Face/Face/Generated/IFaceListOperations.cs @@ -32,7 +32,8 @@ public partial interface IFaceListOperations /// Similar](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395237). /// <br /> After creation, user should use [FaceList - Add /// Face](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395250) - /// to import the faces. Faces are stored on server until [FaceList - + /// to import the faces. No image will be stored. Only the extracted + /// face features are stored on server until [FaceList - /// Delete](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f3039524f) /// is called. /// <br /> Find Similar is used for scenario like finding @@ -47,15 +48,22 @@ public partial interface IFaceListOperations /// <br /> Please consider /// [LargeFaceList](/docs/services/563879b61984550e40cbbe8d/operations/5a157b68d2de3616c086f2cc) /// when the face number is large. It can support up to 1,000,000 - /// faces. 'recognitionModel' should be specified to associate with - /// this face list. The default value for 'recognitionModel' is + /// faces. + /// <br />'recognitionModel' should be specified to associate + /// with this face list. The default value for 'recognitionModel' is /// 'recognition_01', if the latest model needed, please explicitly /// specify the model you need in this parameter. New faces that are /// added to an existing face list will use the recognition model /// that's already associated with the collection. Existing face /// features in a face list can't be updated to features extracted by /// another version of recognition model. - /// + /// * 'recognition_01': The default recognition model for [FaceList- + /// Create](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f3039524b). + /// All those face lists created before 2019 March are bonded with this + /// recognition model. + /// * 'recognition_02': Recognition model released in 2019 March. + /// 'recognition_02' is recommended since its overall accuracy is + /// improved compared with 'recognition_01'. /// /// /// Id referencing a particular face list. @@ -136,8 +144,7 @@ public partial interface IFaceListOperations /// Task UpdateWithHttpMessagesAsync(string faceListId, string name = default(string), string userData = default(string), Dictionary> customHeaders = null, CancellationToken cancellationToken = default(CancellationToken)); /// - /// Delete an existing face list according to faceListId. Persisted - /// face images in the face list will also be deleted. + /// Delete a specified face list. /// /// /// Id referencing a particular face list. @@ -183,9 +190,11 @@ public partial interface IFaceListOperations /// Task>> ListWithHttpMessagesAsync(bool? returnRecognitionModel = false, Dictionary> customHeaders = null, CancellationToken cancellationToken = default(CancellationToken)); /// - /// Delete an existing face from a face list (given by a - /// persistedFaceId and a faceListId). Persisted image related to the - /// face will also be deleted. + /// Delete a face from a face list by specified faceListId and + /// persistedFaceId. + /// <br /> Adding/deleting faces to/from a same face list are + /// processed sequentially and to/from different face lists are in + /// parallel. /// /// /// Id referencing a particular face list. @@ -207,9 +216,33 @@ public partial interface IFaceListOperations /// Task DeleteFaceWithHttpMessagesAsync(string faceListId, System.Guid persistedFaceId, Dictionary> customHeaders = null, CancellationToken cancellationToken = default(CancellationToken)); /// - /// Add a face to a face list. The input face is specified as an image - /// with a targetFace rectangle. It returns a persistedFaceId - /// representing the added face, and persistedFaceId will not expire. + /// Add a face to a specified face list, up to 1,000 faces. + /// <br /> To deal with an image contains multiple faces, input + /// face can be specified as an image with a targetFace rectangle. It + /// returns a persistedFaceId representing the added face. No image + /// will be stored. Only the extracted face feature will be stored on + /// server until [FaceList - Delete + /// Face](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395251) + /// or [FaceList - + /// Delete](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f3039524f) + /// is called. + /// <br /> Note persistedFaceId is different from faceId + /// generated by [Face - + /// Detect](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395236). + /// * Higher face image quality means better detection and recognition + /// precision. Please consider high-quality faces: frontal, clear, and + /// face size is 200x200 pixels (100 pixels between eyes) or bigger. + /// * JPEG, PNG, GIF (the first frame), and BMP format are supported. + /// The allowed image file size is from 1KB to 6MB. + /// * "targetFace" rectangle should contain one face. Zero or multiple + /// faces will be regarded as an error. If the provided "targetFace" + /// rectangle is not returned from [Face - + /// Detect](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395236), + /// there’s no guarantee to detect and add the face successfully. + /// * Out of detectable face size (36x36 - 4096x4096 pixels), large + /// head-pose, or large occlusions will cause failures. + /// * Adding/deleting faces to/from a same face list are processed + /// sequentially and to/from different face lists are in parallel. /// /// /// Id referencing a particular face list. diff --git a/src/SDKs/CognitiveServices/dataPlane/Vision/Face/Face/Generated/IFaceOperations.cs b/src/SDKs/CognitiveServices/dataPlane/Vision/Face/Face/Generated/IFaceOperations.cs index 42e9c9986f2c..0059531ec2b8 100644 --- a/src/SDKs/CognitiveServices/dataPlane/Vision/Face/Face/Generated/IFaceOperations.cs +++ b/src/SDKs/CognitiveServices/dataPlane/Vision/Face/Face/Generated/IFaceOperations.cs @@ -261,7 +261,7 @@ public partial interface IFaceOperations /// Attributes include age, gender, headPose, smile, facialHair, /// glasses, emotion, hair, makeup, occlusion, accessories, blur, /// exposure and noise. - /// * The extracted face feature, instead of the actual image, will be + /// * No image will be stored. Only the extracted face feature will be /// stored on server. The faceId is an identifier of the face feature /// and will be used in [Face - /// Identify](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395239), @@ -285,8 +285,7 @@ public partial interface IFaceOperations /// angles (head-pose) or being occluded, or wrong image orientation. /// * Attributes (age, gender, headPose, smile, facialHair, glasses, /// emotion, hair, makeup, occlusion, accessories, blur, exposure and - /// noise) may not be perfectly accurate. HeadPose's pitch value is a - /// reserved field and will always return 0. + /// noise) may not be perfectly accurate. /// * Different 'recognitionModel' values are provided. If follow-up /// operations like Verify, Identify, Find Similar are needed, please /// specify the recognition model with 'recognitionModel' parameter. @@ -296,7 +295,6 @@ public partial interface IFaceOperations /// associated with the specified recognition model. More details, /// please refer to [How to specify a recognition /// model](https://docs.microsoft.com/en-us/azure/cognitive-services/face/face-api-how-to-topics/specify-recognition-model) - /// /// /// /// Publicly reachable URL of an image diff --git a/src/SDKs/CognitiveServices/dataPlane/Vision/Face/Face/Generated/ILargeFaceListOperations.cs b/src/SDKs/CognitiveServices/dataPlane/Vision/Face/Face/Generated/ILargeFaceListOperations.cs index 5da7e7de1c8b..cab20831132a 100644 --- a/src/SDKs/CognitiveServices/dataPlane/Vision/Face/Face/Generated/ILargeFaceListOperations.cs +++ b/src/SDKs/CognitiveServices/dataPlane/Vision/Face/Face/Generated/ILargeFaceListOperations.cs @@ -33,9 +33,10 @@ public partial interface ILargeFaceListOperations /// Add](/docs/services/563879b61984550e40cbbe8d/operations/5a158c10d2de3616c086f2d3) /// to import the faces and [LargeFaceList - /// Train](/docs/services/563879b61984550e40cbbe8d/operations/5a158422d2de3616c086f2d1) - /// to make it ready for [Face - - /// FindSimilar](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395237). - /// Faces are stored on server until [LargeFaceList - + /// to make it ready for [Face - Find + /// Similar](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395237). + /// No image will be stored. Only the extracted face features are + /// stored on server until [LargeFaceList - /// Delete](/docs/services/563879b61984550e40cbbe8d/operations/5a1580d5d2de3616c086f2cd) /// is called. /// <br /> Find Similar is used for scenario like finding @@ -47,19 +48,26 @@ public partial interface ILargeFaceListOperations /// [LargePersonGroup](/docs/services/563879b61984550e40cbbe8d/operations/599acdee6ac60f11b48b5a9d) /// and [Face - /// Identify](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395239). - /// <br /> - /// * Free-tier subscription quota: 64 large face lists. - /// * S0-tier subscription quota: 1,000,000 large face lists. - /// <br /> - /// 'recognitionModel' should be specified to associate with this large - /// face list. The default value for 'recognitionModel' is + /// <br/>'recognitionModel' should be specified to associate with + /// this large face list. The default value for 'recognitionModel' is /// 'recognition_01', if the latest model needed, please explicitly /// specify the model you need in this parameter. New faces that are /// added to an existing large face list will use the recognition model /// that's already associated with the collection. Existing face /// features in a large face list can't be updated to features /// extracted by another version of recognition model. + /// * 'recognition_01': The default recognition model for + /// [LargeFaceList- + /// Create](/docs/services/563879b61984550e40cbbe8d/operations/5a157b68d2de3616c086f2cc). + /// All those large face lists created before 2019 March are bonded + /// with this recognition model. + /// * 'recognition_02': Recognition model released in 2019 March. + /// 'recognition_02' is recommended since its overall accuracy is + /// improved compared with 'recognition_01'. /// + /// Large face list quota: + /// * Free-tier subscription quota: 64 large face lists. + /// * S0-tier subscription quota: 1,000,000 large face lists. /// /// /// Id referencing a particular large face list. @@ -139,8 +147,7 @@ public partial interface ILargeFaceListOperations /// Task UpdateWithHttpMessagesAsync(string largeFaceListId, string name = default(string), string userData = default(string), Dictionary> customHeaders = null, CancellationToken cancellationToken = default(CancellationToken)); /// - /// Delete an existing large face list according to faceListId. - /// Persisted face images in the large face list will also be deleted. + /// Delete a specified large face list. /// /// /// Id referencing a particular large face list. @@ -196,7 +203,7 @@ public partial interface ILargeFaceListOperations /// first item. /// * "top" parameter (int, optional) specifies the number of entries /// to return. A maximal of 1000 entries can be returned in one call. - /// To fetch more, you can specify "start" with the last retuned + /// To fetch more, you can specify "start" with the last returned /// entry’s Id of the current call. /// <br /> /// For example, total 5 large person lists: "list1", ..., "list5". @@ -247,9 +254,11 @@ public partial interface ILargeFaceListOperations /// Task TrainWithHttpMessagesAsync(string largeFaceListId, Dictionary> customHeaders = null, CancellationToken cancellationToken = default(CancellationToken)); /// - /// Delete an existing face from a large face list (given by a - /// persistedFaceId and a largeFaceListId). Persisted image related to - /// the face will also be deleted. + /// Delete a face from a large face list by specified largeFaceListId + /// and persistedFaceId. + /// <br /> Adding/deleting faces to/from a same large face list + /// are processed sequentially and to/from different large face lists + /// are in parallel. /// /// /// Id referencing a particular large face list. @@ -322,9 +331,37 @@ public partial interface ILargeFaceListOperations /// Task UpdateFaceWithHttpMessagesAsync(string largeFaceListId, System.Guid persistedFaceId, string userData = default(string), Dictionary> customHeaders = null, CancellationToken cancellationToken = default(CancellationToken)); /// - /// Add a face to a large face list. The input face is specified as an - /// image with a targetFace rectangle. It returns a persistedFaceId - /// representing the added face, and persistedFaceId will not expire. + /// Add a face to a specified large face list, up to 1,000,000 faces. + /// <br /> To deal with an image contains multiple faces, input + /// face can be specified as an image with a targetFace rectangle. It + /// returns a persistedFaceId representing the added face. No image + /// will be stored. Only the extracted face feature will be stored on + /// server until [LargeFaceList Face - + /// Delete](/docs/services/563879b61984550e40cbbe8d/operations/5a158c8ad2de3616c086f2d4) + /// or [LargeFaceList - + /// Delete](/docs/services/563879b61984550e40cbbe8d/operations/5a1580d5d2de3616c086f2cd) + /// is called. + /// <br /> Note persistedFaceId is different from faceId + /// generated by [Face - + /// Detect](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395236). + /// * Higher face image quality means better recognition precision. + /// Please consider high-quality faces: frontal, clear, and face size + /// is 200x200 pixels (100 pixels between eyes) or bigger. + /// * JPEG, PNG, GIF (the first frame), and BMP format are supported. + /// The allowed image file size is from 1KB to 6MB. + /// * "targetFace" rectangle should contain one face. Zero or multiple + /// faces will be regarded as an error. If the provided "targetFace" + /// rectangle is not returned from [Face - + /// Detect](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395236), + /// there’s no guarantee to detect and add the face successfully. + /// * Out of detectable face size (36x36 - 4096x4096 pixels), large + /// head-pose, or large occlusions will cause failures. + /// * Adding/deleting faces to/from a same face list are processed + /// sequentially and to/from different face lists are in parallel. + /// + /// Quota: + /// * Free-tier subscription quota: 1,000 faces per large face list. + /// * S0-tier subscription quota: 1,000,000 faces per large face list. /// /// /// Id referencing a particular large face list. diff --git a/src/SDKs/CognitiveServices/dataPlane/Vision/Face/Face/Generated/ILargePersonGroupOperations.cs b/src/SDKs/CognitiveServices/dataPlane/Vision/Face/Face/Generated/ILargePersonGroupOperations.cs index 22dcf157ebd5..22eed9c39d2b 100644 --- a/src/SDKs/CognitiveServices/dataPlane/Vision/Face/Face/Generated/ILargePersonGroupOperations.cs +++ b/src/SDKs/CognitiveServices/dataPlane/Vision/Face/Face/Generated/ILargePersonGroupOperations.cs @@ -27,33 +27,42 @@ public partial interface ILargePersonGroupOperations /// largePersonGroupId, name, an optional userData and /// recognitionModel. /// <br /> A large person group is the container of the uploaded - /// person data, including face images and face recognition feature, - /// and up to 1,000,000 people. + /// person data, including face recognition feature, and up to + /// 1,000,000 + /// people. /// <br /> After creation, use [LargePersonGroup Person - /// Create](/docs/services/563879b61984550e40cbbe8d/operations/599adcba3a7b9412a4d53f40) /// to add person into the group, and call [LargePersonGroup - /// Train](/docs/services/563879b61984550e40cbbe8d/operations/599ae2d16ac60f11b48b5aa4) /// to get this group ready for [Face - /// Identify](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395239). - /// <br /> The person face, image, and userData will be stored on - /// server until [LargePersonGroup Person - + /// <br /> No image will be stored. Only the person's extracted + /// face features and userData will be stored on server until + /// [LargePersonGroup Person - /// Delete](/docs/services/563879b61984550e40cbbe8d/operations/599ade5c6ac60f11b48b5aa2) /// or [LargePersonGroup - /// Delete](/docs/services/563879b61984550e40cbbe8d/operations/599adc216ac60f11b48b5a9f) /// is called. - /// <br /> - /// * Free-tier subscription quota: 1,000 large person groups. - /// * S0-tier subscription quota: 1,000,000 large person groups. - /// <br /> - /// 'recognitionModel' should be specified to associate with this large - /// person group. The default value for 'recognitionModel' is - /// 'recognition_01', if the latest model needed, please explicitly + /// <br/>'recognitionModel' should be specified to associate with + /// this large person group. The default value for 'recognitionModel' + /// is 'recognition_01', if the latest model needed, please explicitly /// specify the model you need in this parameter. New faces that are /// added to an existing large person group will use the recognition /// model that's already associated with the collection. Existing face /// features in a large person group can't be updated to features /// extracted by another version of recognition model. + /// * 'recognition_01': The default recognition model for + /// [LargePersonGroup - + /// Create](/docs/services/563879b61984550e40cbbe8d/operations/599acdee6ac60f11b48b5a9d). + /// All those large person groups created before 2019 March are bonded + /// with this recognition model. + /// * 'recognition_02': Recognition model released in 2019 March. + /// 'recognition_02' is recommended since its overall accuracy is + /// improved compared with 'recognition_01'. /// + /// Large person group quota: + /// * Free-tier subscription quota: 1,000 large person groups. + /// * S0-tier subscription quota: 1,000,000 large person groups. /// /// /// Id referencing a particular large person group. @@ -183,7 +192,7 @@ public partial interface ILargePersonGroupOperations /// Task> GetTrainingStatusWithHttpMessagesAsync(string largePersonGroupId, Dictionary> customHeaders = null, CancellationToken cancellationToken = default(CancellationToken)); /// - /// List all existing large person groups’s largePersonGroupId, name, + /// List all existing large person groups’ largePersonGroupId, name, /// userData and recognitionModel.<br /> /// * Large person groups are stored in alphabetical order of /// largePersonGroupId. @@ -193,7 +202,7 @@ public partial interface ILargePersonGroupOperations /// first item. /// * "top" parameter (int, optional) specifies the number of entries /// to return. A maximal of 1000 entries can be returned in one call. - /// To fetch more, you can specify "start" with the last retuned + /// To fetch more, you can specify "start" with the last returned /// entry’s Id of the current call. /// <br /> /// For example, total 5 large person groups: "group1", ..., "group5". diff --git a/src/SDKs/CognitiveServices/dataPlane/Vision/Face/Face/Generated/ILargePersonGroupPerson.cs b/src/SDKs/CognitiveServices/dataPlane/Vision/Face/Face/Generated/ILargePersonGroupPerson.cs index 6cd217ff7c1f..3eb3197ae467 100644 --- a/src/SDKs/CognitiveServices/dataPlane/Vision/Face/Face/Generated/ILargePersonGroupPerson.cs +++ b/src/SDKs/CognitiveServices/dataPlane/Vision/Face/Face/Generated/ILargePersonGroupPerson.cs @@ -83,8 +83,9 @@ public partial interface ILargePersonGroupPerson /// Task>> ListWithHttpMessagesAsync(string largePersonGroupId, string start = default(string), int? top = default(int?), Dictionary> customHeaders = null, CancellationToken cancellationToken = default(CancellationToken)); /// - /// Delete an existing person from a large person group. All stored - /// person data, and face features in the person entry will be deleted. + /// Delete an existing person from a large person group. The + /// persistedFaceId, userData, person name and face feature in the + /// person entry will all be deleted. /// /// /// Id referencing a particular large person group. @@ -106,8 +107,8 @@ public partial interface ILargePersonGroupPerson /// Task DeleteWithHttpMessagesAsync(string largePersonGroupId, System.Guid personId, Dictionary> customHeaders = null, CancellationToken cancellationToken = default(CancellationToken)); /// - /// Retrieve a person's information, including registered persisted - /// faces, name and userData. + /// Retrieve a person's name and userData, and the persisted faceIds + /// representing the registered person face feature. /// /// /// Id referencing a particular large person group. @@ -160,8 +161,11 @@ public partial interface ILargePersonGroupPerson /// Task UpdateWithHttpMessagesAsync(string largePersonGroupId, System.Guid personId, string name = default(string), string userData = default(string), Dictionary> customHeaders = null, CancellationToken cancellationToken = default(CancellationToken)); /// - /// Delete a face from a person. Relative feature for the persisted - /// face will also be deleted. + /// Delete a face from a person in a large person group by specified + /// largePersonGroupId, personId and persistedFaceId. + /// <br /> Adding/deleting faces to/from a same person will be + /// processed sequentially. Adding/deleting faces to/from different + /// persons are processed in parallel. /// /// /// Id referencing a particular large person group. @@ -243,8 +247,38 @@ public partial interface ILargePersonGroupPerson /// Task UpdateFaceWithHttpMessagesAsync(string largePersonGroupId, System.Guid personId, System.Guid persistedFaceId, string userData = default(string), Dictionary> customHeaders = null, CancellationToken cancellationToken = default(CancellationToken)); /// - /// Add a representative face to a person for identification. The input - /// face is specified as an image with a targetFace rectangle. + /// Add a face to a person into a large person group for face + /// identification or verification. To deal with an image contains + /// multiple faces, input face can be specified as an image with a + /// targetFace rectangle. It returns a persistedFaceId representing the + /// added face. No image will be stored. Only the extracted face + /// feature will be stored on server until [LargePersonGroup PersonFace + /// - + /// Delete](/docs/services/563879b61984550e40cbbe8d/operations/599ae2966ac60f11b48b5aa3), + /// [LargePersonGroup Person - + /// Delete](/docs/services/563879b61984550e40cbbe8d/operations/599ade5c6ac60f11b48b5aa2) + /// or [LargePersonGroup - + /// Delete](/docs/services/563879b61984550e40cbbe8d/operations/599adc216ac60f11b48b5a9f) + /// is called. + /// <br /> Note persistedFaceId is different from faceId + /// generated by [Face - + /// Detect](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395236). + /// * Higher face image quality means better recognition precision. + /// Please consider high-quality faces: frontal, clear, and face size + /// is 200x200 pixels (100 pixels between eyes) or bigger. + /// * Each person entry can hold up to 248 faces. + /// * JPEG, PNG, GIF (the first frame), and BMP format are supported. + /// The allowed image file size is from 1KB to 6MB. + /// * "targetFace" rectangle should contain one face. Zero or multiple + /// faces will be regarded as an error. If the provided "targetFace" + /// rectangle is not returned from [Face - + /// Detect](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395236), + /// there’s no guarantee to detect and add the face successfully. + /// * Out of detectable face size (36x36 - 4096x4096 pixels), large + /// head-pose, or large occlusions will cause failures. + /// * Adding/deleting faces to/from a same person will be processed + /// sequentially. Adding/deleting faces to/from different persons are + /// processed in parallel. /// /// /// Id referencing a particular large person group. diff --git a/src/SDKs/CognitiveServices/dataPlane/Vision/Face/Face/Generated/IPersonGroupOperations.cs b/src/SDKs/CognitiveServices/dataPlane/Vision/Face/Face/Generated/IPersonGroupOperations.cs index 521baf7cec68..fded8a0eb4b9 100644 --- a/src/SDKs/CognitiveServices/dataPlane/Vision/Face/Face/Generated/IPersonGroupOperations.cs +++ b/src/SDKs/CognitiveServices/dataPlane/Vision/Face/Face/Generated/IPersonGroupOperations.cs @@ -26,37 +26,45 @@ public partial interface IPersonGroupOperations /// Create a new person group with specified personGroupId, name, /// user-provided userData and recognitionModel. /// <br /> A person group is the container of the uploaded person - /// data, including face images and face recognition features. + /// data, including face recognition features. /// <br /> After creation, use [PersonGroup Person - /// Create](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f3039523c) /// to add persons into the group, and then call [PersonGroup - /// Train](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395249) /// to get this group ready for [Face - /// Identify](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395239). - /// <br /> The person's face, image, and userData will be stored - /// on server until [PersonGroup Person - + /// <br /> No image will be stored. Only the person's extracted + /// face features and userData will be stored on server until + /// [PersonGroup Person - /// Delete](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f3039523d) /// or [PersonGroup - /// Delete](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395245) /// is called. - /// <br /> - /// * Free-tier subscription quota: 1,000 person groups. Each holds up - /// to 1,000 persons. - /// * S0-tier subscription quota: 1,000,000 person groups. Each holds - /// up to 10,000 persons. - /// * to handle larger scale face identification problem, please - /// consider using - /// [LargePersonGroup](/docs/services/563879b61984550e40cbbe8d/operations/599acdee6ac60f11b48b5a9d). - /// <br /> - /// 'recognitionModel' should be specified to associate with this - /// person group. The default value for 'recognitionModel' is + /// <br/>'recognitionModel' should be specified to associate with + /// this person group. The default value for 'recognitionModel' is /// 'recognition_01', if the latest model needed, please explicitly /// specify the model you need in this parameter. New faces that are /// added to an existing person group will use the recognition model /// that's already associated with the collection. Existing face /// features in a person group can't be updated to features extracted /// by another version of recognition model. + /// * 'recognition_01': The default recognition model for [PersonGroup + /// - + /// Create](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395244). + /// All those person groups created before 2019 March are bonded with + /// this recognition model. + /// * 'recognition_02': Recognition model released in 2019 March. + /// 'recognition_02' is recommended since its overall accuracy is + /// improved compared with 'recognition_01'. /// + /// Person group quota: + /// * Free-tier subscription quota: 1,000 person groups. Each holds up + /// to 1,000 persons. + /// * S0-tier subscription quota: 1,000,000 person groups. Each holds + /// up to 10,000 persons. + /// * to handle larger scale face identification problem, please + /// consider using + /// [LargePersonGroup](/docs/services/563879b61984550e40cbbe8d/operations/599acdee6ac60f11b48b5a9d). /// /// /// Id referencing a particular person group. @@ -183,7 +191,7 @@ public partial interface IPersonGroupOperations /// Task> GetTrainingStatusWithHttpMessagesAsync(string personGroupId, Dictionary> customHeaders = null, CancellationToken cancellationToken = default(CancellationToken)); /// - /// List person groups’s personGroupId, name, userData and + /// List person groups’ personGroupId, name, userData and /// recognitionModel.<br /> /// * Person groups are stored in alphabetical order of personGroupId. /// * "start" parameter (string, optional) is a user-provided @@ -192,7 +200,7 @@ public partial interface IPersonGroupOperations /// item. /// * "top" parameter (int, optional) specifies the number of entries /// to return. A maximal of 1000 entries can be returned in one call. - /// To fetch more, you can specify "start" with the last retuned + /// To fetch more, you can specify "start" with the last returned /// entry’s Id of the current call. /// <br /> /// For example, total 5 person groups: "group1", ..., "group5". diff --git a/src/SDKs/CognitiveServices/dataPlane/Vision/Face/Face/Generated/IPersonGroupPerson.cs b/src/SDKs/CognitiveServices/dataPlane/Vision/Face/Face/Generated/IPersonGroupPerson.cs index f291bace2581..c69f79088441 100644 --- a/src/SDKs/CognitiveServices/dataPlane/Vision/Face/Face/Generated/IPersonGroupPerson.cs +++ b/src/SDKs/CognitiveServices/dataPlane/Vision/Face/Face/Generated/IPersonGroupPerson.cs @@ -83,8 +83,9 @@ public partial interface IPersonGroupPerson /// Task>> ListWithHttpMessagesAsync(string personGroupId, string start = default(string), int? top = default(int?), Dictionary> customHeaders = null, CancellationToken cancellationToken = default(CancellationToken)); /// - /// Delete an existing person from a person group. All stored person - /// data, and face features in the person entry will be deleted. + /// Delete an existing person from a person group. The persistedFaceId, + /// userData, person name and face feature in the person entry will all + /// be deleted. /// /// /// Id referencing a particular person group. @@ -160,8 +161,11 @@ public partial interface IPersonGroupPerson /// Task UpdateWithHttpMessagesAsync(string personGroupId, System.Guid personId, string name = default(string), string userData = default(string), Dictionary> customHeaders = null, CancellationToken cancellationToken = default(CancellationToken)); /// - /// Delete a face from a person. Relative feature for the persisted - /// face will also be deleted. + /// Delete a face from a person in a person group by specified + /// personGroupId, personId and persistedFaceId. + /// <br /> Adding/deleting faces to/from a same person will be + /// processed sequentially. Adding/deleting faces to/from different + /// persons are processed in parallel. /// /// /// Id referencing a particular person group. @@ -215,7 +219,37 @@ public partial interface IPersonGroupPerson /// Task> GetFaceWithHttpMessagesAsync(string personGroupId, System.Guid personId, System.Guid persistedFaceId, Dictionary> customHeaders = null, CancellationToken cancellationToken = default(CancellationToken)); /// - /// Update a person persisted face's userData field. + /// Add a face to a person into a person group for face identification + /// or verification. To deal with an image contains multiple faces, + /// input face can be specified as an image with a targetFace + /// rectangle. It returns a persistedFaceId representing the added + /// face. No image will be stored. Only the extracted face feature will + /// be stored on server until [PersonGroup PersonFace - + /// Delete](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f3039523e), + /// [PersonGroup Person - + /// Delete](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f3039523d) + /// or [PersonGroup - + /// Delete](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395245) + /// is called. + /// <br /> Note persistedFaceId is different from faceId + /// generated by [Face - + /// Detect](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395236). + /// * Higher face image quality means better recognition precision. + /// Please consider high-quality faces: frontal, clear, and face size + /// is 200x200 pixels (100 pixels between eyes) or bigger. + /// * Each person entry can hold up to 248 faces. + /// * JPEG, PNG, GIF (the first frame), and BMP format are supported. + /// The allowed image file size is from 1KB to 6MB. + /// * "targetFace" rectangle should contain one face. Zero or multiple + /// faces will be regarded as an error. If the provided "targetFace" + /// rectangle is not returned from [Face - + /// Detect](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395236), + /// there’s no guarantee to detect and add the face successfully. + /// * Out of detectable face size (36x36 - 4096x4096 pixels), large + /// head-pose, or large occlusions will cause failures. + /// * Adding/deleting faces to/from a same person will be processed + /// sequentially. Adding/deleting faces to/from different persons are + /// processed in parallel. /// /// /// Id referencing a particular person group. @@ -243,8 +277,38 @@ public partial interface IPersonGroupPerson /// Task UpdateFaceWithHttpMessagesAsync(string personGroupId, System.Guid personId, System.Guid persistedFaceId, string userData = default(string), Dictionary> customHeaders = null, CancellationToken cancellationToken = default(CancellationToken)); /// - /// Add a representative face to a person for identification. The input - /// face is specified as an image with a targetFace rectangle. + /// Add a face to a person into a large person group for face + /// identification or verification. To deal with an image contains + /// multiple faces, input face can be specified as an image with a + /// targetFace rectangle. It returns a persistedFaceId representing the + /// added face. No image will be stored. Only the extracted face + /// feature will be stored on server until [LargePersonGroup PersonFace + /// - + /// Delete](/docs/services/563879b61984550e40cbbe8d/operations/599ae2966ac60f11b48b5aa3), + /// [LargePersonGroup Person - + /// Delete](/docs/services/563879b61984550e40cbbe8d/operations/599ade5c6ac60f11b48b5aa2) + /// or [LargePersonGroup - + /// Delete](/docs/services/563879b61984550e40cbbe8d/operations/599adc216ac60f11b48b5a9f) + /// is called. + /// <br /> Note persistedFaceId is different from faceId + /// generated by [Face - + /// Detect](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395236). + /// * Higher face image quality means better recognition precision. + /// Please consider high-quality faces: frontal, clear, and face size + /// is 200x200 pixels (100 pixels between eyes) or bigger. + /// * Each person entry can hold up to 248 faces. + /// * JPEG, PNG, GIF (the first frame), and BMP format are supported. + /// The allowed image file size is from 1KB to 6MB. + /// * "targetFace" rectangle should contain one face. Zero or + /// multiple faces will be regarded as an error. If the provided + /// "targetFace" rectangle is not returned from [Face - + /// Detect](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395236), + /// there’s no guarantee to detect and add the face successfully. + /// * Out of detectable face size (36x36 - 4096x4096 pixels), large + /// head-pose, or large occlusions will cause failures. + /// * Adding/deleting faces to/from a same person will be processed + /// sequentially. Adding/deleting faces to/from different persons are + /// processed in parallel. /// /// /// Id referencing a particular person group. diff --git a/src/SDKs/CognitiveServices/dataPlane/Vision/Face/Face/Generated/LargeFaceListOperations.cs b/src/SDKs/CognitiveServices/dataPlane/Vision/Face/Face/Generated/LargeFaceListOperations.cs index ba5b545deb62..ba28ac4d17b9 100644 --- a/src/SDKs/CognitiveServices/dataPlane/Vision/Face/Face/Generated/LargeFaceListOperations.cs +++ b/src/SDKs/CognitiveServices/dataPlane/Vision/Face/Face/Generated/LargeFaceListOperations.cs @@ -60,9 +60,10 @@ public LargeFaceListOperations(FaceClient client) /// Add](/docs/services/563879b61984550e40cbbe8d/operations/5a158c10d2de3616c086f2d3) /// to import the faces and [LargeFaceList - /// Train](/docs/services/563879b61984550e40cbbe8d/operations/5a158422d2de3616c086f2d1) - /// to make it ready for [Face - - /// FindSimilar](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395237). - /// Faces are stored on server until [LargeFaceList - + /// to make it ready for [Face - Find + /// Similar](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395237). + /// No image will be stored. Only the extracted face features are stored on + /// server until [LargeFaceList - /// Delete](/docs/services/563879b61984550e40cbbe8d/operations/5a1580d5d2de3616c086f2cd) /// is called. /// <br /> Find Similar is used for scenario like finding celebrity-like @@ -73,18 +74,24 @@ public LargeFaceListOperations(FaceClient client) /// [LargePersonGroup](/docs/services/563879b61984550e40cbbe8d/operations/599acdee6ac60f11b48b5a9d) /// and [Face - /// Identify](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395239). - /// <br /> + /// <br/>'recognitionModel' should be specified to associate with this + /// large face list. The default value for 'recognitionModel' is + /// 'recognition_01', if the latest model needed, please explicitly specify the + /// model you need in this parameter. New faces that are added to an existing + /// large face list will use the recognition model that's already associated + /// with the collection. Existing face features in a large face list can't be + /// updated to features extracted by another version of recognition model. + /// * 'recognition_01': The default recognition model for [LargeFaceList- + /// Create](/docs/services/563879b61984550e40cbbe8d/operations/5a157b68d2de3616c086f2cc). + /// All those large face lists created before 2019 March are bonded with this + /// recognition model. + /// * 'recognition_02': Recognition model released in 2019 March. + /// 'recognition_02' is recommended since its overall accuracy is improved + /// compared with 'recognition_01'. + /// + /// Large face list quota: /// * Free-tier subscription quota: 64 large face lists. /// * S0-tier subscription quota: 1,000,000 large face lists. - /// <br /> - /// 'recognitionModel' should be specified to associate with this large face - /// list. The default value for 'recognitionModel' is 'recognition_01', if the - /// latest model needed, please explicitly specify the model you need in this - /// parameter. New faces that are added to an existing large face list will use - /// the recognition model that's already associated with the collection. - /// Existing face features in a large face list can't be updated to features - /// extracted by another version of recognition model. - /// /// /// /// Id referencing a particular large face list. @@ -619,8 +626,7 @@ public LargeFaceListOperations(FaceClient client) } /// - /// Delete an existing large face list according to faceListId. Persisted face - /// images in the large face list will also be deleted. + /// Delete a specified large face list. /// /// /// Id referencing a particular large face list. @@ -938,7 +944,7 @@ public LargeFaceListOperations(FaceClient client) /// set to empty to indicate return from the first item. /// * "top" parameter (int, optional) specifies the number of entries to /// return. A maximal of 1000 entries can be returned in one call. To fetch - /// more, you can specify "start" with the last retuned entry’s Id of the + /// more, you can specify "start" with the last returned entry’s Id of the /// current call. /// <br /> /// For example, total 5 large person lists: "list1", ..., "list5". @@ -1247,9 +1253,11 @@ public LargeFaceListOperations(FaceClient client) } /// - /// Delete an existing face from a large face list (given by a persistedFaceId - /// and a largeFaceListId). Persisted image related to the face will also be - /// deleted. + /// Delete a face from a large face list by specified largeFaceListId and + /// persistedFaceId. + /// <br /> Adding/deleting faces to/from a same large face list are + /// processed sequentially and to/from different large face lists are in + /// parallel. /// /// /// Id referencing a particular large face list. @@ -1737,9 +1745,37 @@ public LargeFaceListOperations(FaceClient client) } /// - /// Add a face to a large face list. The input face is specified as an image - /// with a targetFace rectangle. It returns a persistedFaceId representing the - /// added face, and persistedFaceId will not expire. + /// Add a face to a specified large face list, up to 1,000,000 faces. + /// <br /> To deal with an image contains multiple faces, input face can + /// be specified as an image with a targetFace rectangle. It returns a + /// persistedFaceId representing the added face. No image will be stored. Only + /// the extracted face feature will be stored on server until [LargeFaceList + /// Face - + /// Delete](/docs/services/563879b61984550e40cbbe8d/operations/5a158c8ad2de3616c086f2d4) + /// or [LargeFaceList - + /// Delete](/docs/services/563879b61984550e40cbbe8d/operations/5a1580d5d2de3616c086f2cd) + /// is called. + /// <br /> Note persistedFaceId is different from faceId generated by + /// [Face - + /// Detect](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395236). + /// * Higher face image quality means better recognition precision. Please + /// consider high-quality faces: frontal, clear, and face size is 200x200 + /// pixels (100 pixels between eyes) or bigger. + /// * JPEG, PNG, GIF (the first frame), and BMP format are supported. The + /// allowed image file size is from 1KB to 6MB. + /// * "targetFace" rectangle should contain one face. Zero or multiple faces + /// will be regarded as an error. If the provided "targetFace" rectangle is not + /// returned from [Face - + /// Detect](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395236), + /// there’s no guarantee to detect and add the face successfully. + /// * Out of detectable face size (36x36 - 4096x4096 pixels), large head-pose, + /// or large occlusions will cause failures. + /// * Adding/deleting faces to/from a same face list are processed sequentially + /// and to/from different face lists are in parallel. + /// + /// Quota: + /// * Free-tier subscription quota: 1,000 faces per large face list. + /// * S0-tier subscription quota: 1,000,000 faces per large face list. /// /// /// Id referencing a particular large face list. diff --git a/src/SDKs/CognitiveServices/dataPlane/Vision/Face/Face/Generated/LargeFaceListOperationsExtensions.cs b/src/SDKs/CognitiveServices/dataPlane/Vision/Face/Face/Generated/LargeFaceListOperationsExtensions.cs index a4cb0c8aeaa6..dc3de2e5e207 100644 --- a/src/SDKs/CognitiveServices/dataPlane/Vision/Face/Face/Generated/LargeFaceListOperationsExtensions.cs +++ b/src/SDKs/CognitiveServices/dataPlane/Vision/Face/Face/Generated/LargeFaceListOperationsExtensions.cs @@ -32,9 +32,10 @@ public static partial class LargeFaceListOperationsExtensions /// Add](/docs/services/563879b61984550e40cbbe8d/operations/5a158c10d2de3616c086f2d3) /// to import the faces and [LargeFaceList - /// Train](/docs/services/563879b61984550e40cbbe8d/operations/5a158422d2de3616c086f2d1) - /// to make it ready for [Face - - /// FindSimilar](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395237). - /// Faces are stored on server until [LargeFaceList - + /// to make it ready for [Face - Find + /// Similar](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395237). + /// No image will be stored. Only the extracted face features are stored on + /// server until [LargeFaceList - /// Delete](/docs/services/563879b61984550e40cbbe8d/operations/5a1580d5d2de3616c086f2cd) /// is called. /// <br /> Find Similar is used for scenario like finding celebrity-like @@ -45,18 +46,24 @@ public static partial class LargeFaceListOperationsExtensions /// [LargePersonGroup](/docs/services/563879b61984550e40cbbe8d/operations/599acdee6ac60f11b48b5a9d) /// and [Face - /// Identify](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395239). - /// <br /> + /// <br/>'recognitionModel' should be specified to associate with this + /// large face list. The default value for 'recognitionModel' is + /// 'recognition_01', if the latest model needed, please explicitly specify the + /// model you need in this parameter. New faces that are added to an existing + /// large face list will use the recognition model that's already associated + /// with the collection. Existing face features in a large face list can't be + /// updated to features extracted by another version of recognition model. + /// * 'recognition_01': The default recognition model for [LargeFaceList- + /// Create](/docs/services/563879b61984550e40cbbe8d/operations/5a157b68d2de3616c086f2cc). + /// All those large face lists created before 2019 March are bonded with this + /// recognition model. + /// * 'recognition_02': Recognition model released in 2019 March. + /// 'recognition_02' is recommended since its overall accuracy is improved + /// compared with 'recognition_01'. + /// + /// Large face list quota: /// * Free-tier subscription quota: 64 large face lists. /// * S0-tier subscription quota: 1,000,000 large face lists. - /// <br /> - /// 'recognitionModel' should be specified to associate with this large face - /// list. The default value for 'recognitionModel' is 'recognition_01', if the - /// latest model needed, please explicitly specify the model you need in this - /// parameter. New faces that are added to an existing large face list will use - /// the recognition model that's already associated with the collection. - /// Existing face features in a large face list can't be updated to features - /// extracted by another version of recognition model. - /// /// /// /// The operations group for this extension method. @@ -130,8 +137,7 @@ public static partial class LargeFaceListOperationsExtensions } /// - /// Delete an existing large face list according to faceListId. Persisted face - /// images in the large face list will also be deleted. + /// Delete a specified large face list. /// /// /// The operations group for this extension method. @@ -179,7 +185,7 @@ public static partial class LargeFaceListOperationsExtensions /// set to empty to indicate return from the first item. /// * "top" parameter (int, optional) specifies the number of entries to /// return. A maximal of 1000 entries can be returned in one call. To fetch - /// more, you can specify "start" with the last retuned entry’s Id of the + /// more, you can specify "start" with the last returned entry’s Id of the /// current call. /// <br /> /// For example, total 5 large person lists: "list1", ..., "list5". @@ -225,9 +231,11 @@ public static partial class LargeFaceListOperationsExtensions } /// - /// Delete an existing face from a large face list (given by a persistedFaceId - /// and a largeFaceListId). Persisted image related to the face will also be - /// deleted. + /// Delete a face from a large face list by specified largeFaceListId and + /// persistedFaceId. + /// <br /> Adding/deleting faces to/from a same large face list are + /// processed sequentially and to/from different large face lists are in + /// parallel. /// /// /// The operations group for this extension method. @@ -294,9 +302,37 @@ public static partial class LargeFaceListOperationsExtensions } /// - /// Add a face to a large face list. The input face is specified as an image - /// with a targetFace rectangle. It returns a persistedFaceId representing the - /// added face, and persistedFaceId will not expire. + /// Add a face to a specified large face list, up to 1,000,000 faces. + /// <br /> To deal with an image contains multiple faces, input face can + /// be specified as an image with a targetFace rectangle. It returns a + /// persistedFaceId representing the added face. No image will be stored. Only + /// the extracted face feature will be stored on server until [LargeFaceList + /// Face - + /// Delete](/docs/services/563879b61984550e40cbbe8d/operations/5a158c8ad2de3616c086f2d4) + /// or [LargeFaceList - + /// Delete](/docs/services/563879b61984550e40cbbe8d/operations/5a1580d5d2de3616c086f2cd) + /// is called. + /// <br /> Note persistedFaceId is different from faceId generated by + /// [Face - + /// Detect](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395236). + /// * Higher face image quality means better recognition precision. Please + /// consider high-quality faces: frontal, clear, and face size is 200x200 + /// pixels (100 pixels between eyes) or bigger. + /// * JPEG, PNG, GIF (the first frame), and BMP format are supported. The + /// allowed image file size is from 1KB to 6MB. + /// * "targetFace" rectangle should contain one face. Zero or multiple faces + /// will be regarded as an error. If the provided "targetFace" rectangle is not + /// returned from [Face - + /// Detect](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395236), + /// there’s no guarantee to detect and add the face successfully. + /// * Out of detectable face size (36x36 - 4096x4096 pixels), large head-pose, + /// or large occlusions will cause failures. + /// * Adding/deleting faces to/from a same face list are processed sequentially + /// and to/from different face lists are in parallel. + /// + /// Quota: + /// * Free-tier subscription quota: 1,000 faces per large face list. + /// * S0-tier subscription quota: 1,000,000 faces per large face list. /// /// /// The operations group for this extension method. diff --git a/src/SDKs/CognitiveServices/dataPlane/Vision/Face/Face/Generated/LargePersonGroupOperations.cs b/src/SDKs/CognitiveServices/dataPlane/Vision/Face/Face/Generated/LargePersonGroupOperations.cs index e35178be5cf6..b64ec960cc51 100644 --- a/src/SDKs/CognitiveServices/dataPlane/Vision/Face/Face/Generated/LargePersonGroupOperations.cs +++ b/src/SDKs/CognitiveServices/dataPlane/Vision/Face/Face/Generated/LargePersonGroupOperations.cs @@ -54,32 +54,39 @@ public LargePersonGroupOperations(FaceClient client) /// Create a new large person group with user-specified largePersonGroupId, /// name, an optional userData and recognitionModel. /// <br /> A large person group is the container of the uploaded person - /// data, including face images and face recognition feature, and up to - /// 1,000,000 people. + /// data, including face recognition feature, and up to 1,000,000 + /// people. /// <br /> After creation, use [LargePersonGroup Person - /// Create](/docs/services/563879b61984550e40cbbe8d/operations/599adcba3a7b9412a4d53f40) /// to add person into the group, and call [LargePersonGroup - /// Train](/docs/services/563879b61984550e40cbbe8d/operations/599ae2d16ac60f11b48b5aa4) /// to get this group ready for [Face - /// Identify](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395239). - /// <br /> The person face, image, and userData will be stored on server - /// until [LargePersonGroup Person - + /// <br /> No image will be stored. Only the person's extracted face + /// features and userData will be stored on server until [LargePersonGroup + /// Person - /// Delete](/docs/services/563879b61984550e40cbbe8d/operations/599ade5c6ac60f11b48b5aa2) /// or [LargePersonGroup - /// Delete](/docs/services/563879b61984550e40cbbe8d/operations/599adc216ac60f11b48b5a9f) /// is called. - /// <br /> + /// <br/>'recognitionModel' should be specified to associate with this + /// large person group. The default value for 'recognitionModel' is + /// 'recognition_01', if the latest model needed, please explicitly specify the + /// model you need in this parameter. New faces that are added to an existing + /// large person group will use the recognition model that's already associated + /// with the collection. Existing face features in a large person group can't + /// be updated to features extracted by another version of recognition model. + /// * 'recognition_01': The default recognition model for [LargePersonGroup - + /// Create](/docs/services/563879b61984550e40cbbe8d/operations/599acdee6ac60f11b48b5a9d). + /// All those large person groups created before 2019 March are bonded with + /// this recognition model. + /// * 'recognition_02': Recognition model released in 2019 March. + /// 'recognition_02' is recommended since its overall accuracy is improved + /// compared with 'recognition_01'. + /// + /// Large person group quota: /// * Free-tier subscription quota: 1,000 large person groups. /// * S0-tier subscription quota: 1,000,000 large person groups. - /// <br /> - /// 'recognitionModel' should be specified to associate with this large person - /// group. The default value for 'recognitionModel' is 'recognition_01', if the - /// latest model needed, please explicitly specify the model you need in this - /// parameter. New faces that are added to an existing large person group will - /// use the recognition model that's already associated with the collection. - /// Existing face features in a large person group can't be updated to features - /// extracted by another version of recognition model. - /// /// /// /// Id referencing a particular large person group. @@ -928,7 +935,7 @@ public LargePersonGroupOperations(FaceClient client) } /// - /// List all existing large person groups’s largePersonGroupId, name, userData + /// List all existing large person groups’ largePersonGroupId, name, userData /// and recognitionModel.<br /> /// * Large person groups are stored in alphabetical order of /// largePersonGroupId. @@ -937,7 +944,7 @@ public LargePersonGroupOperations(FaceClient client) /// comparison. "start" set to empty to indicate return from the first item. /// * "top" parameter (int, optional) specifies the number of entries to /// return. A maximal of 1000 entries can be returned in one call. To fetch - /// more, you can specify "start" with the last retuned entry’s Id of the + /// more, you can specify "start" with the last returned entry’s Id of the /// current call. /// <br /> /// For example, total 5 large person groups: "group1", ..., "group5". diff --git a/src/SDKs/CognitiveServices/dataPlane/Vision/Face/Face/Generated/LargePersonGroupOperationsExtensions.cs b/src/SDKs/CognitiveServices/dataPlane/Vision/Face/Face/Generated/LargePersonGroupOperationsExtensions.cs index b776942e57e5..bfc3bfd28e57 100644 --- a/src/SDKs/CognitiveServices/dataPlane/Vision/Face/Face/Generated/LargePersonGroupOperationsExtensions.cs +++ b/src/SDKs/CognitiveServices/dataPlane/Vision/Face/Face/Generated/LargePersonGroupOperationsExtensions.cs @@ -25,32 +25,39 @@ public static partial class LargePersonGroupOperationsExtensions /// Create a new large person group with user-specified largePersonGroupId, /// name, an optional userData and recognitionModel. /// <br /> A large person group is the container of the uploaded person - /// data, including face images and face recognition feature, and up to - /// 1,000,000 people. + /// data, including face recognition feature, and up to 1,000,000 + /// people. /// <br /> After creation, use [LargePersonGroup Person - /// Create](/docs/services/563879b61984550e40cbbe8d/operations/599adcba3a7b9412a4d53f40) /// to add person into the group, and call [LargePersonGroup - /// Train](/docs/services/563879b61984550e40cbbe8d/operations/599ae2d16ac60f11b48b5aa4) /// to get this group ready for [Face - /// Identify](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395239). - /// <br /> The person face, image, and userData will be stored on server - /// until [LargePersonGroup Person - + /// <br /> No image will be stored. Only the person's extracted face + /// features and userData will be stored on server until [LargePersonGroup + /// Person - /// Delete](/docs/services/563879b61984550e40cbbe8d/operations/599ade5c6ac60f11b48b5aa2) /// or [LargePersonGroup - /// Delete](/docs/services/563879b61984550e40cbbe8d/operations/599adc216ac60f11b48b5a9f) /// is called. - /// <br /> + /// <br/>'recognitionModel' should be specified to associate with this + /// large person group. The default value for 'recognitionModel' is + /// 'recognition_01', if the latest model needed, please explicitly specify the + /// model you need in this parameter. New faces that are added to an existing + /// large person group will use the recognition model that's already associated + /// with the collection. Existing face features in a large person group can't + /// be updated to features extracted by another version of recognition model. + /// * 'recognition_01': The default recognition model for [LargePersonGroup - + /// Create](/docs/services/563879b61984550e40cbbe8d/operations/599acdee6ac60f11b48b5a9d). + /// All those large person groups created before 2019 March are bonded with + /// this recognition model. + /// * 'recognition_02': Recognition model released in 2019 March. + /// 'recognition_02' is recommended since its overall accuracy is improved + /// compared with 'recognition_01'. + /// + /// Large person group quota: /// * Free-tier subscription quota: 1,000 large person groups. /// * S0-tier subscription quota: 1,000,000 large person groups. - /// <br /> - /// 'recognitionModel' should be specified to associate with this large person - /// group. The default value for 'recognitionModel' is 'recognition_01', if the - /// latest model needed, please explicitly specify the model you need in this - /// parameter. New faces that are added to an existing large person group will - /// use the recognition model that's already associated with the collection. - /// Existing face features in a large person group can't be updated to features - /// extracted by another version of recognition model. - /// /// /// /// The operations group for this extension method. @@ -168,7 +175,7 @@ public static partial class LargePersonGroupOperationsExtensions } /// - /// List all existing large person groups’s largePersonGroupId, name, userData + /// List all existing large person groups’ largePersonGroupId, name, userData /// and recognitionModel.<br /> /// * Large person groups are stored in alphabetical order of /// largePersonGroupId. @@ -177,7 +184,7 @@ public static partial class LargePersonGroupOperationsExtensions /// comparison. "start" set to empty to indicate return from the first item. /// * "top" parameter (int, optional) specifies the number of entries to /// return. A maximal of 1000 entries can be returned in one call. To fetch - /// more, you can specify "start" with the last retuned entry’s Id of the + /// more, you can specify "start" with the last returned entry’s Id of the /// current call. /// <br /> /// For example, total 5 large person groups: "group1", ..., "group5". diff --git a/src/SDKs/CognitiveServices/dataPlane/Vision/Face/Face/Generated/LargePersonGroupPerson.cs b/src/SDKs/CognitiveServices/dataPlane/Vision/Face/Face/Generated/LargePersonGroupPerson.cs index d488e5f32425..cebc91e5d1f0 100644 --- a/src/SDKs/CognitiveServices/dataPlane/Vision/Face/Face/Generated/LargePersonGroupPerson.cs +++ b/src/SDKs/CognitiveServices/dataPlane/Vision/Face/Face/Generated/LargePersonGroupPerson.cs @@ -444,8 +444,9 @@ public LargePersonGroupPerson(FaceClient client) } /// - /// Delete an existing person from a large person group. All stored person - /// data, and face features in the person entry will be deleted. + /// Delete an existing person from a large person group. The persistedFaceId, + /// userData, person name and face feature in the person entry will all be + /// deleted. /// /// /// Id referencing a particular large person group. @@ -593,8 +594,8 @@ public LargePersonGroupPerson(FaceClient client) } /// - /// Retrieve a person's information, including registered persisted faces, name - /// and userData. + /// Retrieve a person's name and userData, and the persisted faceIds + /// representing the registered person face feature. /// /// /// Id referencing a particular large person group. @@ -944,8 +945,11 @@ public LargePersonGroupPerson(FaceClient client) } /// - /// Delete a face from a person. Relative feature for the persisted face will - /// also be deleted. + /// Delete a face from a person in a large person group by specified + /// largePersonGroupId, personId and persistedFaceId. + /// <br /> Adding/deleting faces to/from a same person will be processed + /// sequentially. Adding/deleting faces to/from different persons are processed + /// in parallel. /// /// /// Id referencing a particular large person group. @@ -1448,8 +1452,37 @@ public LargePersonGroupPerson(FaceClient client) } /// - /// Add a representative face to a person for identification. The input face is - /// specified as an image with a targetFace rectangle. + /// Add a face to a person into a large person group for face identification or + /// verification. To deal with an image contains multiple faces, input face can + /// be specified as an image with a targetFace rectangle. It returns a + /// persistedFaceId representing the added face. No image will be stored. Only + /// the extracted face feature will be stored on server until [LargePersonGroup + /// PersonFace - + /// Delete](/docs/services/563879b61984550e40cbbe8d/operations/599ae2966ac60f11b48b5aa3), + /// [LargePersonGroup Person - + /// Delete](/docs/services/563879b61984550e40cbbe8d/operations/599ade5c6ac60f11b48b5aa2) + /// or [LargePersonGroup - + /// Delete](/docs/services/563879b61984550e40cbbe8d/operations/599adc216ac60f11b48b5a9f) + /// is called. + /// <br /> Note persistedFaceId is different from faceId generated by + /// [Face - + /// Detect](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395236). + /// * Higher face image quality means better recognition precision. Please + /// consider high-quality faces: frontal, clear, and face size is 200x200 + /// pixels (100 pixels between eyes) or bigger. + /// * Each person entry can hold up to 248 faces. + /// * JPEG, PNG, GIF (the first frame), and BMP format are supported. The + /// allowed image file size is from 1KB to 6MB. + /// * "targetFace" rectangle should contain one face. Zero or multiple faces + /// will be regarded as an error. If the provided "targetFace" rectangle is not + /// returned from [Face - + /// Detect](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395236), + /// there’s no guarantee to detect and add the face successfully. + /// * Out of detectable face size (36x36 - 4096x4096 pixels), large head-pose, + /// or large occlusions will cause failures. + /// * Adding/deleting faces to/from a same person will be processed + /// sequentially. Adding/deleting faces to/from different persons are processed + /// in parallel. /// /// /// Id referencing a particular large person group. diff --git a/src/SDKs/CognitiveServices/dataPlane/Vision/Face/Face/Generated/LargePersonGroupPersonExtensions.cs b/src/SDKs/CognitiveServices/dataPlane/Vision/Face/Face/Generated/LargePersonGroupPersonExtensions.cs index 74fa0c855d9b..a2b401eb1783 100644 --- a/src/SDKs/CognitiveServices/dataPlane/Vision/Face/Face/Generated/LargePersonGroupPersonExtensions.cs +++ b/src/SDKs/CognitiveServices/dataPlane/Vision/Face/Face/Generated/LargePersonGroupPersonExtensions.cs @@ -78,8 +78,9 @@ public static partial class LargePersonGroupPersonExtensions } /// - /// Delete an existing person from a large person group. All stored person - /// data, and face features in the person entry will be deleted. + /// Delete an existing person from a large person group. The persistedFaceId, + /// userData, person name and face feature in the person entry will all be + /// deleted. /// /// /// The operations group for this extension method. @@ -99,8 +100,8 @@ public static partial class LargePersonGroupPersonExtensions } /// - /// Retrieve a person's information, including registered persisted faces, name - /// and userData. + /// Retrieve a person's name and userData, and the persisted faceIds + /// representing the registered person face feature. /// /// /// The operations group for this extension method. @@ -149,8 +150,11 @@ public static partial class LargePersonGroupPersonExtensions } /// - /// Delete a face from a person. Relative feature for the persisted face will - /// also be deleted. + /// Delete a face from a person in a large person group by specified + /// largePersonGroupId, personId and persistedFaceId. + /// <br /> Adding/deleting faces to/from a same person will be processed + /// sequentially. Adding/deleting faces to/from different persons are processed + /// in parallel. /// /// /// The operations group for this extension method. @@ -226,8 +230,37 @@ public static partial class LargePersonGroupPersonExtensions } /// - /// Add a representative face to a person for identification. The input face is - /// specified as an image with a targetFace rectangle. + /// Add a face to a person into a large person group for face identification or + /// verification. To deal with an image contains multiple faces, input face can + /// be specified as an image with a targetFace rectangle. It returns a + /// persistedFaceId representing the added face. No image will be stored. Only + /// the extracted face feature will be stored on server until [LargePersonGroup + /// PersonFace - + /// Delete](/docs/services/563879b61984550e40cbbe8d/operations/599ae2966ac60f11b48b5aa3), + /// [LargePersonGroup Person - + /// Delete](/docs/services/563879b61984550e40cbbe8d/operations/599ade5c6ac60f11b48b5aa2) + /// or [LargePersonGroup - + /// Delete](/docs/services/563879b61984550e40cbbe8d/operations/599adc216ac60f11b48b5a9f) + /// is called. + /// <br /> Note persistedFaceId is different from faceId generated by + /// [Face - + /// Detect](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395236). + /// * Higher face image quality means better recognition precision. Please + /// consider high-quality faces: frontal, clear, and face size is 200x200 + /// pixels (100 pixels between eyes) or bigger. + /// * Each person entry can hold up to 248 faces. + /// * JPEG, PNG, GIF (the first frame), and BMP format are supported. The + /// allowed image file size is from 1KB to 6MB. + /// * "targetFace" rectangle should contain one face. Zero or multiple faces + /// will be regarded as an error. If the provided "targetFace" rectangle is not + /// returned from [Face - + /// Detect](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395236), + /// there’s no guarantee to detect and add the face successfully. + /// * Out of detectable face size (36x36 - 4096x4096 pixels), large head-pose, + /// or large occlusions will cause failures. + /// * Adding/deleting faces to/from a same person will be processed + /// sequentially. Adding/deleting faces to/from different persons are processed + /// in parallel. /// /// /// The operations group for this extension method. diff --git a/src/SDKs/CognitiveServices/dataPlane/Vision/Face/Face/Generated/Models/FaceAttributes.cs b/src/SDKs/CognitiveServices/dataPlane/Vision/Face/Face/Generated/Models/FaceAttributes.cs index 4f7ebf5849f3..4ffa47ef5dc5 100644 --- a/src/SDKs/CognitiveServices/dataPlane/Vision/Face/Face/Generated/Models/FaceAttributes.cs +++ b/src/SDKs/CognitiveServices/dataPlane/Vision/Face/Face/Generated/Models/FaceAttributes.cs @@ -33,7 +33,7 @@ public FaceAttributes() /// /// Age in years /// Possible gender of the face. Possible values - /// include: 'male', 'female', 'genderless' + /// include: 'male', 'female' /// Smile intensity, a number between [0,1] /// /// Properties describing facial hair @@ -90,7 +90,7 @@ public FaceAttributes() /// /// Gets or sets possible gender of the face. Possible values include: - /// 'male', 'female', 'genderless' + /// 'male', 'female' /// [JsonProperty(PropertyName = "gender")] public Gender? Gender { get; set; } diff --git a/src/SDKs/CognitiveServices/dataPlane/Vision/Face/Face/Generated/Models/Gender.cs b/src/SDKs/CognitiveServices/dataPlane/Vision/Face/Face/Generated/Models/Gender.cs index 382dd840dfdf..aacb19a6d1f8 100644 --- a/src/SDKs/CognitiveServices/dataPlane/Vision/Face/Face/Generated/Models/Gender.cs +++ b/src/SDKs/CognitiveServices/dataPlane/Vision/Face/Face/Generated/Models/Gender.cs @@ -24,9 +24,7 @@ public enum Gender [EnumMember(Value = "male")] Male, [EnumMember(Value = "female")] - Female, - [EnumMember(Value = "genderless")] - Genderless + Female } internal static class GenderEnumExtension { @@ -43,8 +41,6 @@ internal static string ToSerializedValue(this Gender value) return "male"; case Gender.Female: return "female"; - case Gender.Genderless: - return "genderless"; } return null; } @@ -57,8 +53,6 @@ internal static string ToSerializedValue(this Gender value) return Gender.Male; case "female": return Gender.Female; - case "genderless": - return Gender.Genderless; } return null; } diff --git a/src/SDKs/CognitiveServices/dataPlane/Vision/Face/Face/Generated/PersonGroupOperations.cs b/src/SDKs/CognitiveServices/dataPlane/Vision/Face/Face/Generated/PersonGroupOperations.cs index f20f085adc39..c07f29f38ac1 100644 --- a/src/SDKs/CognitiveServices/dataPlane/Vision/Face/Face/Generated/PersonGroupOperations.cs +++ b/src/SDKs/CognitiveServices/dataPlane/Vision/Face/Face/Generated/PersonGroupOperations.cs @@ -54,35 +54,41 @@ public PersonGroupOperations(FaceClient client) /// Create a new person group with specified personGroupId, name, user-provided /// userData and recognitionModel. /// <br /> A person group is the container of the uploaded person data, - /// including face images and face recognition features. + /// including face recognition features. /// <br /> After creation, use [PersonGroup Person - /// Create](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f3039523c) /// to add persons into the group, and then call [PersonGroup - /// Train](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395249) /// to get this group ready for [Face - /// Identify](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395239). - /// <br /> The person's face, image, and userData will be stored on - /// server until [PersonGroup Person - + /// <br /> No image will be stored. Only the person's extracted face + /// features and userData will be stored on server until [PersonGroup Person - /// Delete](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f3039523d) /// or [PersonGroup - /// Delete](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395245) /// is called. - /// <br /> + /// <br/>'recognitionModel' should be specified to associate with this + /// person group. The default value for 'recognitionModel' is 'recognition_01', + /// if the latest model needed, please explicitly specify the model you need in + /// this parameter. New faces that are added to an existing person group will + /// use the recognition model that's already associated with the collection. + /// Existing face features in a person group can't be updated to features + /// extracted by another version of recognition model. + /// * 'recognition_01': The default recognition model for [PersonGroup - + /// Create](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395244). + /// All those person groups created before 2019 March are bonded with this + /// recognition model. + /// * 'recognition_02': Recognition model released in 2019 March. + /// 'recognition_02' is recommended since its overall accuracy is improved + /// compared with 'recognition_01'. + /// + /// Person group quota: /// * Free-tier subscription quota: 1,000 person groups. Each holds up to 1,000 /// persons. /// * S0-tier subscription quota: 1,000,000 person groups. Each holds up to /// 10,000 persons. /// * to handle larger scale face identification problem, please consider using /// [LargePersonGroup](/docs/services/563879b61984550e40cbbe8d/operations/599acdee6ac60f11b48b5a9d). - /// <br /> - /// 'recognitionModel' should be specified to associate with this person group. - /// The default value for 'recognitionModel' is 'recognition_01', if the latest - /// model needed, please explicitly specify the model you need in this - /// parameter. New faces that are added to an existing person group will use - /// the recognition model that's already associated with the collection. - /// Existing face features in a person group can't be updated to features - /// extracted by another version of recognition model. - /// /// /// /// Id referencing a particular person group. @@ -927,7 +933,7 @@ public PersonGroupOperations(FaceClient client) } /// - /// List person groups’s personGroupId, name, userData and + /// List person groups’ personGroupId, name, userData and /// recognitionModel.<br /> /// * Person groups are stored in alphabetical order of personGroupId. /// * "start" parameter (string, optional) is a user-provided personGroupId @@ -935,7 +941,7 @@ public PersonGroupOperations(FaceClient client) /// set to empty to indicate return from the first item. /// * "top" parameter (int, optional) specifies the number of entries to /// return. A maximal of 1000 entries can be returned in one call. To fetch - /// more, you can specify "start" with the last retuned entry’s Id of the + /// more, you can specify "start" with the last returned entry’s Id of the /// current call. /// <br /> /// For example, total 5 person groups: "group1", ..., "group5". diff --git a/src/SDKs/CognitiveServices/dataPlane/Vision/Face/Face/Generated/PersonGroupOperationsExtensions.cs b/src/SDKs/CognitiveServices/dataPlane/Vision/Face/Face/Generated/PersonGroupOperationsExtensions.cs index 67dbeab38e13..46b59d755701 100644 --- a/src/SDKs/CognitiveServices/dataPlane/Vision/Face/Face/Generated/PersonGroupOperationsExtensions.cs +++ b/src/SDKs/CognitiveServices/dataPlane/Vision/Face/Face/Generated/PersonGroupOperationsExtensions.cs @@ -25,35 +25,41 @@ public static partial class PersonGroupOperationsExtensions /// Create a new person group with specified personGroupId, name, user-provided /// userData and recognitionModel. /// <br /> A person group is the container of the uploaded person data, - /// including face images and face recognition features. + /// including face recognition features. /// <br /> After creation, use [PersonGroup Person - /// Create](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f3039523c) /// to add persons into the group, and then call [PersonGroup - /// Train](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395249) /// to get this group ready for [Face - /// Identify](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395239). - /// <br /> The person's face, image, and userData will be stored on - /// server until [PersonGroup Person - + /// <br /> No image will be stored. Only the person's extracted face + /// features and userData will be stored on server until [PersonGroup Person - /// Delete](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f3039523d) /// or [PersonGroup - /// Delete](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395245) /// is called. - /// <br /> + /// <br/>'recognitionModel' should be specified to associate with this + /// person group. The default value for 'recognitionModel' is 'recognition_01', + /// if the latest model needed, please explicitly specify the model you need in + /// this parameter. New faces that are added to an existing person group will + /// use the recognition model that's already associated with the collection. + /// Existing face features in a person group can't be updated to features + /// extracted by another version of recognition model. + /// * 'recognition_01': The default recognition model for [PersonGroup - + /// Create](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395244). + /// All those person groups created before 2019 March are bonded with this + /// recognition model. + /// * 'recognition_02': Recognition model released in 2019 March. + /// 'recognition_02' is recommended since its overall accuracy is improved + /// compared with 'recognition_01'. + /// + /// Person group quota: /// * Free-tier subscription quota: 1,000 person groups. Each holds up to 1,000 /// persons. /// * S0-tier subscription quota: 1,000,000 person groups. Each holds up to /// 10,000 persons. /// * to handle larger scale face identification problem, please consider using /// [LargePersonGroup](/docs/services/563879b61984550e40cbbe8d/operations/599acdee6ac60f11b48b5a9d). - /// <br /> - /// 'recognitionModel' should be specified to associate with this person group. - /// The default value for 'recognitionModel' is 'recognition_01', if the latest - /// model needed, please explicitly specify the model you need in this - /// parameter. New faces that are added to an existing person group will use - /// the recognition model that's already associated with the collection. - /// Existing face features in a person group can't be updated to features - /// extracted by another version of recognition model. - /// /// /// /// The operations group for this extension method. @@ -167,7 +173,7 @@ public static partial class PersonGroupOperationsExtensions } /// - /// List person groups’s personGroupId, name, userData and + /// List person groups’ personGroupId, name, userData and /// recognitionModel.<br /> /// * Person groups are stored in alphabetical order of personGroupId. /// * "start" parameter (string, optional) is a user-provided personGroupId @@ -175,7 +181,7 @@ public static partial class PersonGroupOperationsExtensions /// set to empty to indicate return from the first item. /// * "top" parameter (int, optional) specifies the number of entries to /// return. A maximal of 1000 entries can be returned in one call. To fetch - /// more, you can specify "start" with the last retuned entry’s Id of the + /// more, you can specify "start" with the last returned entry’s Id of the /// current call. /// <br /> /// For example, total 5 person groups: "group1", ..., "group5". diff --git a/src/SDKs/CognitiveServices/dataPlane/Vision/Face/Face/Generated/PersonGroupPerson.cs b/src/SDKs/CognitiveServices/dataPlane/Vision/Face/Face/Generated/PersonGroupPerson.cs index 6337b7751c71..8716bffdb7e5 100644 --- a/src/SDKs/CognitiveServices/dataPlane/Vision/Face/Face/Generated/PersonGroupPerson.cs +++ b/src/SDKs/CognitiveServices/dataPlane/Vision/Face/Face/Generated/PersonGroupPerson.cs @@ -444,8 +444,9 @@ public PersonGroupPerson(FaceClient client) } /// - /// Delete an existing person from a person group. All stored person data, and - /// face features in the person entry will be deleted. + /// Delete an existing person from a person group. The persistedFaceId, + /// userData, person name and face feature in the person entry will all be + /// deleted. /// /// /// Id referencing a particular person group. @@ -944,8 +945,11 @@ public PersonGroupPerson(FaceClient client) } /// - /// Delete a face from a person. Relative feature for the persisted face will - /// also be deleted. + /// Delete a face from a person in a person group by specified personGroupId, + /// personId and persistedFaceId. + /// <br /> Adding/deleting faces to/from a same person will be processed + /// sequentially. Adding/deleting faces to/from different persons are processed + /// in parallel. /// /// /// Id referencing a particular person group. @@ -1273,7 +1277,37 @@ public PersonGroupPerson(FaceClient client) } /// - /// Update a person persisted face's userData field. + /// Add a face to a person into a person group for face identification or + /// verification. To deal with an image contains multiple faces, input face can + /// be specified as an image with a targetFace rectangle. It returns a + /// persistedFaceId representing the added face. No image will be stored. Only + /// the extracted face feature will be stored on server until [PersonGroup + /// PersonFace - + /// Delete](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f3039523e), + /// [PersonGroup Person - + /// Delete](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f3039523d) + /// or [PersonGroup - + /// Delete](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395245) + /// is called. + /// <br /> Note persistedFaceId is different from faceId generated by + /// [Face - + /// Detect](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395236). + /// * Higher face image quality means better recognition precision. Please + /// consider high-quality faces: frontal, clear, and face size is 200x200 + /// pixels (100 pixels between eyes) or bigger. + /// * Each person entry can hold up to 248 faces. + /// * JPEG, PNG, GIF (the first frame), and BMP format are supported. The + /// allowed image file size is from 1KB to 6MB. + /// * "targetFace" rectangle should contain one face. Zero or multiple faces + /// will be regarded as an error. If the provided "targetFace" rectangle is not + /// returned from [Face - + /// Detect](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395236), + /// there’s no guarantee to detect and add the face successfully. + /// * Out of detectable face size (36x36 - 4096x4096 pixels), large head-pose, + /// or large occlusions will cause failures. + /// * Adding/deleting faces to/from a same person will be processed + /// sequentially. Adding/deleting faces to/from different persons are processed + /// in parallel. /// /// /// Id referencing a particular person group. @@ -1448,8 +1482,37 @@ public PersonGroupPerson(FaceClient client) } /// - /// Add a representative face to a person for identification. The input face is - /// specified as an image with a targetFace rectangle. + /// Add a face to a person into a large person group for face identification or + /// verification. To deal with an image contains multiple faces, input face can + /// be specified as an image with a targetFace rectangle. It returns a + /// persistedFaceId representing the added face. No image will be stored. Only + /// the extracted face feature will be stored on server until [LargePersonGroup + /// PersonFace - + /// Delete](/docs/services/563879b61984550e40cbbe8d/operations/599ae2966ac60f11b48b5aa3), + /// [LargePersonGroup Person - + /// Delete](/docs/services/563879b61984550e40cbbe8d/operations/599ade5c6ac60f11b48b5aa2) + /// or [LargePersonGroup - + /// Delete](/docs/services/563879b61984550e40cbbe8d/operations/599adc216ac60f11b48b5a9f) + /// is called. + /// <br /> Note persistedFaceId is different from faceId generated by + /// [Face - + /// Detect](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395236). + /// * Higher face image quality means better recognition precision. Please + /// consider high-quality faces: frontal, clear, and face size is 200x200 + /// pixels (100 pixels between eyes) or bigger. + /// * Each person entry can hold up to 248 faces. + /// * JPEG, PNG, GIF (the first frame), and BMP format are supported. The + /// allowed image file size is from 1KB to 6MB. + /// * "targetFace" rectangle should contain one face. Zero or multiple faces + /// will be regarded as an error. If the provided "targetFace" rectangle is not + /// returned from [Face - + /// Detect](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395236), + /// there’s no guarantee to detect and add the face successfully. + /// * Out of detectable face size (36x36 - 4096x4096 pixels), large + /// head-pose, or large occlusions will cause failures. + /// * Adding/deleting faces to/from a same person will be processed + /// sequentially. Adding/deleting faces to/from different persons are processed + /// in parallel. /// /// /// Id referencing a particular person group. diff --git a/src/SDKs/CognitiveServices/dataPlane/Vision/Face/Face/Generated/PersonGroupPersonExtensions.cs b/src/SDKs/CognitiveServices/dataPlane/Vision/Face/Face/Generated/PersonGroupPersonExtensions.cs index 13897fefa05c..3ee6f8dc6d32 100644 --- a/src/SDKs/CognitiveServices/dataPlane/Vision/Face/Face/Generated/PersonGroupPersonExtensions.cs +++ b/src/SDKs/CognitiveServices/dataPlane/Vision/Face/Face/Generated/PersonGroupPersonExtensions.cs @@ -78,8 +78,9 @@ public static partial class PersonGroupPersonExtensions } /// - /// Delete an existing person from a person group. All stored person data, and - /// face features in the person entry will be deleted. + /// Delete an existing person from a person group. The persistedFaceId, + /// userData, person name and face feature in the person entry will all be + /// deleted. /// /// /// The operations group for this extension method. @@ -149,8 +150,11 @@ public static partial class PersonGroupPersonExtensions } /// - /// Delete a face from a person. Relative feature for the persisted face will - /// also be deleted. + /// Delete a face from a person in a person group by specified personGroupId, + /// personId and persistedFaceId. + /// <br /> Adding/deleting faces to/from a same person will be processed + /// sequentially. Adding/deleting faces to/from different persons are processed + /// in parallel. /// /// /// The operations group for this extension method. @@ -200,7 +204,37 @@ public static partial class PersonGroupPersonExtensions } /// - /// Update a person persisted face's userData field. + /// Add a face to a person into a person group for face identification or + /// verification. To deal with an image contains multiple faces, input face can + /// be specified as an image with a targetFace rectangle. It returns a + /// persistedFaceId representing the added face. No image will be stored. Only + /// the extracted face feature will be stored on server until [PersonGroup + /// PersonFace - + /// Delete](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f3039523e), + /// [PersonGroup Person - + /// Delete](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f3039523d) + /// or [PersonGroup - + /// Delete](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395245) + /// is called. + /// <br /> Note persistedFaceId is different from faceId generated by + /// [Face - + /// Detect](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395236). + /// * Higher face image quality means better recognition precision. Please + /// consider high-quality faces: frontal, clear, and face size is 200x200 + /// pixels (100 pixels between eyes) or bigger. + /// * Each person entry can hold up to 248 faces. + /// * JPEG, PNG, GIF (the first frame), and BMP format are supported. The + /// allowed image file size is from 1KB to 6MB. + /// * "targetFace" rectangle should contain one face. Zero or multiple faces + /// will be regarded as an error. If the provided "targetFace" rectangle is not + /// returned from [Face - + /// Detect](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395236), + /// there’s no guarantee to detect and add the face successfully. + /// * Out of detectable face size (36x36 - 4096x4096 pixels), large head-pose, + /// or large occlusions will cause failures. + /// * Adding/deleting faces to/from a same person will be processed + /// sequentially. Adding/deleting faces to/from different persons are processed + /// in parallel. /// /// /// The operations group for this extension method. @@ -226,8 +260,37 @@ public static partial class PersonGroupPersonExtensions } /// - /// Add a representative face to a person for identification. The input face is - /// specified as an image with a targetFace rectangle. + /// Add a face to a person into a large person group for face identification or + /// verification. To deal with an image contains multiple faces, input face can + /// be specified as an image with a targetFace rectangle. It returns a + /// persistedFaceId representing the added face. No image will be stored. Only + /// the extracted face feature will be stored on server until [LargePersonGroup + /// PersonFace - + /// Delete](/docs/services/563879b61984550e40cbbe8d/operations/599ae2966ac60f11b48b5aa3), + /// [LargePersonGroup Person - + /// Delete](/docs/services/563879b61984550e40cbbe8d/operations/599ade5c6ac60f11b48b5aa2) + /// or [LargePersonGroup - + /// Delete](/docs/services/563879b61984550e40cbbe8d/operations/599adc216ac60f11b48b5a9f) + /// is called. + /// <br /> Note persistedFaceId is different from faceId generated by + /// [Face - + /// Detect](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395236). + /// * Higher face image quality means better recognition precision. Please + /// consider high-quality faces: frontal, clear, and face size is 200x200 + /// pixels (100 pixels between eyes) or bigger. + /// * Each person entry can hold up to 248 faces. + /// * JPEG, PNG, GIF (the first frame), and BMP format are supported. The + /// allowed image file size is from 1KB to 6MB. + /// * "targetFace" rectangle should contain one face. Zero or multiple faces + /// will be regarded as an error. If the provided "targetFace" rectangle is not + /// returned from [Face - + /// Detect](/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395236), + /// there’s no guarantee to detect and add the face successfully. + /// * Out of detectable face size (36x36 - 4096x4096 pixels), large + /// head-pose, or large occlusions will cause failures. + /// * Adding/deleting faces to/from a same person will be processed + /// sequentially. Adding/deleting faces to/from different persons are processed + /// in parallel. /// /// /// The operations group for this extension method.