#include <imagerecognition/xqfacegroup.h>
Link against: faceplatform.lib
class XQFaceGroup |
Represents a group of XQFaceRegion objects belonging to the same person (Face-Id).
Public Member Enumerations | |
---|---|
enum | FaceRegionProperty { SourceId, ThumbnailPath, FaceRect, SourceSize } |
Public Member Functions | |
---|---|
XQFaceGroup(const XQFaceGroup &) | |
~XQFaceGroup() | |
QString | faceId() |
XQFaceRegion | faceRegion(const QString &) |
QAbstractItemModel * | faces() |
bool | isUnknown() |
XQFaceGroup & | operator=(const XQFaceGroup &) |
QString | representativeFaceThumbnail() |
void | setFaceId(const QString &) |
void | setRepresentativeFaceThumbnail(const QString &) |
An object to this can only be instantiated via a call to XQFaceDatabase::faceGroup() call.
This is used to index into the columns of the QAbstractItemModel returned by the call to faces()
SourceId - source id which contains the face ThumbnailPath - path of the thumbnail representing the face in this source FaceRect - ROI within the source where this face is found SourceSize - size of the source on which FaceRect was calculated
Enumerator | Value | Description |
---|---|---|
SourceId | 0 |
The source identifier (file name/ file id) that this face region belongs to |
ThumbnailPath |
The thumbnail-path or the thumbnail as supplied by XQFaceThumbnailer::faceThumbnailCreated() signal while processing this file | |
FaceRect |
The rectangle expressed relative to the image size in SourceSize column. | |
SourceSize |
The reference image size based on which the FaceRect column is based |
XQFaceGroup | ( | const XQFaceGroup & | other | ) |
Copy constructor for this class.
~XQFaceGroup | ( | ) |
Destructor.
QString | faceId | ( | ) | const |
XQFaceRegion | faceRegion | ( | const QString & | sourceId | ) |
QAbstractItemModel * | faces | ( | ) |
Instantiates a QAbstractItemModel containing one row for each occurance of the person that this XQFaceGroup object represents.
The ownership of this model is passed to the caller/application. The model needs to be explicitly destroyed as required by the caller/application.
bool | isUnknown | ( | ) | const |
Checks if the group is known.
If the group has been given a name in the past (by passing a non-null string to setFaceId()) then isUnknown() returns false (i.e. the face is known). If the group has never been given a name or the name has been removed (removing can be done by passing null Qstring to setFaceId()) then isUnknown() returns true.
XQFaceGroup & | operator= | ( | const XQFaceGroup & | other | ) |
Assignment operator for this class.
QString | representativeFaceThumbnail | ( | ) | const |
void | setFaceId | ( | const QString & | faceId | ) |
Sets the name/tag/identifier for this face group.
A non-null QString would cause the given string to be set as the face-id
A null QString would erase the existing face-id and reset it to the default ("Untitled")
Parameters | |
---|---|
faceId | The face-id that is desired to be set. |