maxFaces
The maximum number of faces to index. The value of MaxFaces
must be greater than or equal to 1. IndexFaces
returns no more than 100 detected faces in an image, even if you specify a larger value for MaxFaces
.
If IndexFaces
detects more faces than the value of MaxFaces
, the faces with the lowest quality are filtered out first. If there are still more faces than the value of MaxFaces
, the faces with the smallest bounding boxes are filtered out (up to the number that's needed to satisfy the value of MaxFaces
). Information about the unindexed faces is available in the UnindexedFaces
array.
The faces that are returned by IndexFaces
are sorted by the largest face bounding box size to the smallest size, in descending order.
MaxFaces
can be used with a collection associated with any version of the face model.