#ifndef OPENPOSE_FACE_FACE_EXTRACTOR_HPP #define OPENPOSE_FACE_FACE_EXTRACTOR_HPP #include #include #include namespace op { /** * Face keypoint extractor class. */ class OP_API FaceExtractorNet { public: /** * Constructor of the FaceExtractorNet class. * @param netInputSize Size at which the cropped image (where the face is located) is resized. * @param netOutputSize Size of the final results. At the moment, it must be equal than netOutputSize. */ explicit FaceExtractorNet(const Point& netInputSize, const Point& netOutputSize, const std::vector& heatMapTypes = {}, const ScaleMode heatMapScaleMode = ScaleMode::ZeroToOneFixedAspect); /** * Virtual destructor of the HandExtractor class. * Required to allow inheritance. */ virtual ~FaceExtractorNet(); /** * This function must be call before using any other function. It must also be called inside the thread in * which the functions are going to be used. */ void initializationOnThread(); /** * This function extracts the face keypoints for each detected face in the image. * @param faceRectangles location of the faces in the image. It is a length-variable std::vector, where * each index corresponds to a different person in the image. Internally, a op::Rectangle * (similar to cv::Rect for floating values) with the position of that face (or 0,0,0,0 if * some face is missing, e.g., if a specific person has only half of the body inside the image). * @param cvInputData Original image in Mat format and BGR format. */ virtual void forwardPass(const std::vector>& faceRectangles, const Matrix& inputData) = 0; Array getHeatMaps() const; /** * This function returns the face keypoins. VERY IMPORTANT: use getFaceKeypoints().clone() if the keypoints are * going to be edited in a different thread. * @return A Array with all the face keypoints. It follows the pose structure, i.e., the first dimension * corresponds to all the people in the image, the second to each specific keypoint, and the third one to * (x, y, score). */ Array getFaceKeypoints() const; bool getEnabled() const; void setEnabled(const bool enabled); protected: const Point mNetOutputSize; Array mFaceImageCrop; Array mFaceKeypoints; // HeatMaps parameters Array mHeatMaps; const ScaleMode mHeatMapScaleMode; const std::vector mHeatMapTypes; // Temporarily disable it std::atomic mEnabled; virtual void netInitializationOnThread() = 0; private: // Init with thread std::thread::id mThreadId; void checkThread() const; DELETE_COPY(FaceExtractorNet); }; } #endif // OPENPOSE_FACE_FACE_EXTRACTOR_HPP