Modify API Result Docs

docs/api/vision_results/README.md

@@ -6,5 +6,6 @@ FastDeploy根据视觉模型的任务类型，定义了不同的结构体(`csrcs
 | :----- | :--- | :---- | :------- |
 | ClassificationResult | [C++/Python文档](./classification_result.md) | 图像分类返回结果 | ResNet50、MobileNetV3等 |
 | DetectionResult | [C++/Python文档](./detection_result.md) | 目标检测返回结果 | PPYOLOE、YOLOv7系列模型等 |
-| FaceDetectionResult | [C++/Python文档](./face_detection_result.md) | 目标检测返回结果 | PPYOLOE、YOLOv7系列模型等 |
-| MattingResult | [C++/Python文档](./matting_result.md) | 目标检测返回结果 | PPYOLOE、YOLOv7系列模型等 |
+| FaceDetectionResult | [C++/Python文档](./face_detection_result.md) | 目标检测返回结果 | SCRFD、RetinaFace系列模型等 |
+| FaceRecognitionResult | [C++/Python文档](./face_recognition_result.md) | 目标检测返回结果 | ArcFace、CosFace系列模型等 |
+| MattingResult | [C++/Python文档](./matting_result.md) | 目标检测返回结果 | MODNet系列模型等 |

docs/api/vision_results/classification_result.md

@@ -2,7 +2,7 @@
 
 ClassifyResult代码定义在`csrcs/fastdeploy/vision/common/result.h`中，用于表明图像的分类结果和置信度。
 
-## C++ 结构体
+## C++ 定义
 
 `fastdeploy::vision::ClassifyResult`
 
@@ -20,7 +20,7 @@ struct ClassifyResult {
 - **Clear()**: 成员函数，用于清除结构体中存储的结果
 - **Str()**: 成员函数，将结构体中的信息以字符串形式输出（用于Debug）
 
-## Python结构体
+## Python 定义
 
 `fastdeploy.vision.ClassifyResult`
 

docs/api/vision_results/detection_result.md

@@ -2,7 +2,7 @@
 
 DetectionResult代码定义在`csrcs/fastdeploy/vision/common/result.h`中，用于表明图像检测出来的目标框、目标类别和目标置信度。
 
-## C++ 结构体
+## C++ 定义
 
 `fastdeploy::vision::DetectionResult`
 
@@ -22,10 +22,10 @@ struct DetectionResult {
 - **Clear()**: 成员函数，用于清除结构体中存储的结果
 - **Str()**: 成员函数，将结构体中的信息以字符串形式输出（用于Debug）
 
-## Python结构体
+## Python 定义
 
 `fastdeploy.vision.DetectionResult`
 
 - **boxes**(list of list(float)): 成员变量，表示单张图片检测出来的所有目标框坐标。boxes是一个list，其每个元素为一个长度为4的list， 表示为一个框，每个框以4个float数值依次表示xmin, ymin, xmax, ymax， 即左上角和右下角坐标
 - **scores**(list of float): 成员变量，表示单张图片检测出来的所有目标置信度
-- **label_ids(list of int): 成员变量，表示单张图片检测出来的所有目标类别
+- **label_ids**(list of int): 成员变量，表示单张图片检测出来的所有目标类别

docs/api/vision_results/face_detection_result.md

@@ -1,8 +1,8 @@
 # FaceDetectionResult 人脸检测结果
 
-FaceDetectionResult 代码定义在`csrcs/fastdeploy/vision/common/result.h`中，用于表明图像检测出来的目标框、目标类别和目标置信度。
+FaceDetectionResult 代码定义在`csrcs/fastdeploy/vision/common/result.h`中，用于表明人脸检测出来的目标框、人脸landmarks，目标置信度和每张人脸的landmark数量。
 
-## C++ 结构体
+## C++ 定义
 
 `fastdeploy::vision::FaceDetectionResult`
 
@@ -11,7 +11,6 @@ struct FaceDetectionResult {
   std::vector<std::array<float, 4>> boxes;
   std::vector<std::array<float, 2>> landmarks;
   std::vector<float> scores;
-  ResultType type = ResultType::FACE_DETECTION;
   int landmarks_per_face;
   void Clear();
   std::string Str();
@@ -25,10 +24,11 @@ struct FaceDetectionResult {
 - **Clear()**: 成员函数，用于清除结构体中存储的结果
 - **Str()**: 成员函数，将结构体中的信息以字符串形式输出（用于Debug）
 
-## Python结构体
+## Python 定义
 
 `fastdeploy.vision.FaceDetectionResult`
 
 - **boxes**(list of list(float)): 成员变量，表示单张图片检测出来的所有目标框坐标。boxes是一个list，其每个元素为一个长度为4的list， 表示为一个框，每个框以4个float数值依次表示xmin, ymin, xmax, ymax， 即左上角和右下角坐标
 - **scores**(list of float): 成员变量，表示单张图片检测出来的所有目标置信度
 - **landmarks**: 成员变量，表示单张图片检测出来的所有人脸的关键点
+- **landmarks_per_face**: 成员变量，表示每个人脸框中的关键点的数量。

docs/api/vision_results/face_recognition_result.md

@@ -0,0 +1,24 @@
+# FaceRecognitionResult 人脸识别结果
+
+FaceRecognitionResult 代码定义在`csrcs/fastdeploy/vision/common/result.h`中，用于表明人脸识别模型对图像特征的embedding。
+## C++ 定义
+
+`fastdeploy::vision::FaceRecognitionResult`
+
+```
+struct FaceRecognitionResult {
+  std::vector<float> embedding;
+  void Clear();
+  std::string Str();
+};
+```
+
+- **embedding**: 成员变量，表示人脸识别模型最终的提取的特征embedding，可以用来计算人脸之间的特征相似度。
+- **Clear()**: 成员函数，用于清除结构体中存储的结果
+- **Str()**: 成员函数，将结构体中的信息以字符串形式输出（用于Debug）
+
+## Python 定义
+
+`fastdeploy.vision.FaceRecognitionResult`
+
+- **embedding**: 成员变量，表示人脸识别模型最终提取的特征embedding，可以用来计算人脸之间的特征相似度。

docs/api/vision_results/matting_result.md

@@ -1,15 +1,15 @@
 # MattingResult 抠图结果
 
-MattingResult 代码定义在`csrcs/fastdeploy/vision/common/result.h`中，用于表明图像检测出来的目标框、目标类别和目标置信度。
+MattingResult 代码定义在`csrcs/fastdeploy/vision/common/result.h`中，用于表明模型预测的alpha透明度的值，预测的前景等。
 
-## C++ 结构体
+## C++ 定义
 
 `fastdeploy::vision::MattingResult`
 
 ```
 struct MattingResult {
-  std::vector<float> alpha;       // h x w
-  std::vector<float> foreground;  // h x w x c (c=3 default)
+  std::vector<float> alpha;
+  std::vector<float> foreground;
   std::vector<int64_t> shape;
   bool contain_foreground = false;
   void Clear();
@@ -25,7 +25,7 @@ struct MattingResult {
 - **Str()**: 成员函数，将结构体中的信息以字符串形式输出（用于Debug）
 
 
-## Python结构体
+## Python 定义
 
 `fastdeploy.vision.MattingResult`
 

examples/vision/README.md

@@ -8,6 +8,7 @@
 | Segmentation   | 语义分割，输入图像，给出图像中每个像素的分类及置信度          | [SegmentationResult](../../docs/api/vision_results/segmentation_result.md) |
 | Classification | 图像分类，输入图像，给出图像的分类结果和置信度             | [ClassifyResult](../../docs/api/vision_results/classification_result.md)   |
 | FaceDetection | 人脸检测，输入图像，检测图像中人脸位置，并返回检测框坐标及人脸关键点             | [FaceDetectionResult](../../docs/api/vision_results/face_detection_result.md)   |
+| FaceRecognition | 人脸识别，输入图像，返回可用于相似度计算的人脸特征的embedding            | [FaceRecognitionResult](../../docs/api/vision_results/face_recognition_result.md)   |
 | Matting | 抠图，输入图像，返回图片的前景每个像素点的Alpha值            | [MattingResult](../../docs/api/vision_results/matting_result.md)   |
 ## FastDeploy API设计