summaryrefslogtreecommitdiff
path: root/mv_face/face/include/FaceExpressionRecognizer.h
blob: 496e407278759b20f1b64cd43e5a0fe5cb987ccf (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
/**
 * Copyright (c) 2015 Samsung Electronics Co., Ltd All Rights Reserved
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 * http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

#ifndef __MEDIA_VISION_FACE_EXPRESSION_RECOGNIZER_H__
#define __MEDIA_VISION_FACE_EXPRESSION_RECOGNIZER_H__

#include "mv_common_c.h"
#include "mv_face_open.h"

#include <opencv2/objdetect.hpp>
#include <string>

/**
 * @file FaceExpressionRecognizer.h
 * @brief This file contains the FaceExpressionRecognizer class which implements
 *        the facial expressions recognition functionality.
 */

namespace MediaVision {
namespace Face {
/**
 * @brief Face expression recognition configuration.
 *
 * @since_tizen 3.0
 */
struct FaceRecognizerConfig {
	FaceRecognizerConfig();
	std::string mHaarcascadeFilepath;
};

/**
 * @class FaceExpressionRecognizer
 * @brief The FaceExpressionRecognizer implements the facial expressions
 *        recognition functionality.
 *
 * @since_tizen 3.0
 */
class FaceExpressionRecognizer {
public:
	/**
	 * @brief Recognizes facial expression on the image with known face location.
	 *
	 * @since_tizen 3.0
	 * @param [in]     grayImage         The grayscale image with face
	 * @param [in]     faceLocation      The location of the face on the @a image
	 * @param [out]    faceExpression    Expression recognized for the face at
	 *                                   @a faceLocation
	 * @param [in]     config            The configuration will be used for
	 *                                   facial expression recognition
	 *
	 * @see MediaVision::Face::FaceRecognizerConfig
	 */
	static int recognizeFaceExpression(
					const cv::Mat& grayImage,
					const mv_rectangle_s& faceLocation,
					mv_face_facial_expression_e *faceExpression,
					const FaceRecognizerConfig& config = FaceRecognizerConfig());
};

} /* Face */
} /* MediaVision */

#endif /* __MEDIA_VISION_FACE_EXPRESSION_RECOGNIZER_H__ */