Package cz.fidentis.analyst.engines.face
Interface FaceStateServices
- All Known Implementing Classes:
FaceStateServicesImpl
public interface FaceStateServices
Services for managing a state (internal elements) of a single human face.
-
Nested Class Summary
Nested Classes -
Method Summary
Static MethodsModifier and TypeMethodDescriptionstatic MeshDistances
measureSymmetry
(HumanFace face, int precision) Measures the symmetry by reflecting the mesh over the symmetry plane, (optionally) registering the reflected mesh to the original surface, and then measuring distances of the original mesh towards the reflected mesh (excluding non-overlapping areas).static void
updateBoundingBox
(HumanFace face, FaceStateServices.Mode mode) Manages bounding box of the given human face.static void
updateCurvature
(HumanFace face, FaceStateServices.Mode mode) Manages curvature values of the given human face.static void
Manages face frontal direction.static void
updateGlyphs
(HumanFace face, FaceStateServices.Mode mode, PointSamplingConfig.Method method, int maxSamples) Manages glyphs of the given human face.static void
updateKdTree
(HumanFace face, FaceStateServices.Mode mode) Manages a k-d tree storing the mesh of given human face.static void
updateLandmarksVicinity
(HumanFace face, FaceStateServices.Mode mode) Manages vicinity of all landmarks of the given human face.static void
updateLeftBalancedKdTree
(HumanFace face, FaceStateServices.Mode mode) Manages the left-balanced k-d tree storing the mesh of given human face.static void
updateOctree
(HumanFace face, FaceStateServices.Mode mode) Manages an octree storing the mesh of given human face.static void
updateSymmetryPlane
(HumanFace face, FaceStateServices.Mode mode, SymmetryConfig meshSymmetryConfig) Computes symmetry plane from mesh or landmarks.
-
Method Details
-
updateKdTree
Manages a k-d tree storing the mesh of given human face.- Parameters:
face
- Human facemode
- Operation to be performed
-
updateLeftBalancedKdTree
Manages the left-balanced k-d tree storing the mesh of given human face.- Parameters:
face
- Human facemode
- Operation to be performed
-
updateOctree
Manages an octree storing the mesh of given human face.- Parameters:
face
- Human facemode
- Operation to be performed
-
updateBoundingBox
Manages bounding box of the given human face.- Parameters:
face
- Human facemode
- Operation to be performed
-
updateGlyphs
static void updateGlyphs(HumanFace face, FaceStateServices.Mode mode, PointSamplingConfig.Method method, int maxSamples) Manages glyphs of the given human face.- Parameters:
face
- Human facemode
- Operation to be performedmethod
- Sub-sampling method. Used only if new glyphs are computed.maxSamples
- Maximum number of glyphs. Used only if new glyphs are computed.
-
updateCurvature
Manages curvature values of the given human face.- Parameters:
face
- Human facemode
- Operation to be performed
-
updateLandmarksVicinity
Manages vicinity of all landmarks of the given human face.- Parameters:
face
- Human facemode
- Operation to be performed
-
updateSymmetryPlane
static void updateSymmetryPlane(HumanFace face, FaceStateServices.Mode mode, SymmetryConfig meshSymmetryConfig) Computes symmetry plane from mesh or landmarks.- Parameters:
face
- Human facemode
- Operation to be performedmeshSymmetryConfig
- Configuration of the mesh symmetry calculation (when needed). Ifnull
, then the symmetry plane is computed from landmarks.
-
measureSymmetry
Measures the symmetry by reflecting the mesh over the symmetry plane, (optionally) registering the reflected mesh to the original surface, and then measuring distances of the original mesh towards the reflected mesh (excluding non-overlapping areas).- Parameters:
face
- Human face with symmetry plane already computedprecision
- A value between 0 and 100. Zero means fast measurement when no registration is performed (only reflection of the mesh). 100 means slow but precise measurement when ICP registration is used without subsampling. The values between use ICP registration with certain level of subsampling.*- Returns:
- Measured distances between the original mesh and its clone reflected over the symmetry plane and optionally registered using ICP. Non-overlapping areas are excluded from the measurement.
-
updateFaceFrontalDirection
Manages face frontal direction.- Parameters:
face
- Human facemode
- Operation to be performed
-