david0718 / viewfacecore

C# 超简单的离线人脸识别库。( 基于 SeetaFace6 )

ViewFaceCore

        

—— 🪧 关于  | ⭐ 快速开始  | 🔧 构建  | 📄 文档  | ❓ 常见问题  | 📦 使用许可 ——

🪧 关于

• 一个基于 SeetaFace6 的 .NET 人脸识别解决方案
• 本项目受到了 SeetaFaceEngine.Net 的启发
• 开源、免费、跨平台 (win/linux)

⭐ 快速开始

• 受支持的 .NET 框架 和 操作系统

  目标框架	最低版本	操作系统
  .NET Framework	4.0	win ( x64/x86 )
  .NET Standard	2.0	win ( x64/x86 )
  .NET / .NET Core	3.1	win ( x64/x86 )、linux ( arm/arm64/x64 )

• 简单的人脸信息检测

  • 以 Windows x64 为例

  1. 使用 nuget 安装依赖

     包名称	最小版本	生成文件夹	说明
     ViewFaceCore	0.3.5	——	ViewFaceCore .NET 核心库
     ViewFaceCore.model.face_detector	6.0.0	models	人脸检测的模型支持
     ViewFaceCore.runtime.win.x64	6.0.2	viewfacecore\win\x64	Windows-x64 的本机运行时

  2. 获取人脸信息

     using System;
     using System.Drawing;
     using ViewFaceCore.Sharp;
     
     namespace YourFaceProject
     {
         class Program
         {
             static void Main(string[] args)
             {
                 ViewFace face = new ViewFace();
                 string filename = @"[your face image file path]";
                 Bitmap bitmap = (Bitmap)Image.FromFile(filename);
                 var infos = face.FaceDetector(bitmap);
                 Console.WriteLine($"识别到的人脸数量：{infos.Length} 。人脸信息：\n");
                 Console.WriteLine($"No.\t人脸置信度\t位置信息");
                 for (int i = 0; i < infos.Length; i++)
                 {
                     Console.WriteLine($"{i}\t{infos[i].Score:f8}\t{infos[i].Location}");
                 }
                 Console.Read();
             }
         }
     }

🔧 构建

• 项目结构

  Bridges
  Models
  SeetaFace/index
  Simples
  Tests
  ViewFaceCore

• 开发环境

  • Visual Studio 2022 (17.0.2)
  • Windows 11 专业版 (21H2)
  • Ubuntu 20.04 (WSL)

• 编译过程

  使用 SeetaFace6 开发包 编译

  描述	后缀名	放置路径
  头文件	*.h	ViewFaceCore\SeetaFace\index\build\include\seeta\
  ——	——	——
  Windows 开发包 (x64)	*.dll	ViewFaceCore\SeetaFace\index\build\bin\x64\
  Windows 开发包 (x64)	*.lib	ViewFaceCore\SeetaFace\index\build\lib\x64\
  Windows 开发包 (x86)	*.dll	ViewFaceCore\SeetaFace\index\build\bin\x86\
  Windows 开发包 (x86)	*.lib	ViewFaceCore\SeetaFace\index\build\lib\x86\
  Ubuntu 开发包 (x64)	*.so	ViewFaceCore\SeetaFace\index\build\lib64\
  Ubuntu 开发包 (arm64)	*.so	ViewFaceCore\SeetaFace\index\build\lib\arm64\
  Ubuntu 开发包 (arm)	*.so	ViewFaceCore\SeetaFace\index\build\lib\arm\

  全部重新编译

  1. 配置 %VctPath% 环境变量 (即：vcvarsall.bat 脚本的路径)

     以 Visual Studio 2022 为例：
     C:\Program Files\Microsoft Visual Studio\2022\Community\VC\Auxiliary\Build

  2. 按照 SeetaFace 编译依赖 配置好依赖工具
     • 本项目使用 MSVC (win) / GCC (linux on wsl) 编译完成

     1. 编译工具
     2. For linux
        GNU Make 工具
        GCC 或者 Clang 编译器
     3. For windows
        MSVC 或者 MinGW.
        jom
     4. CMake
     5. 依赖架构
        CPU 支持 AVX 和 FMA [可选]（x86）或 NENO（ARM）支持

  3. 首先编译 OpenRoleZoo 、SeetaAuthorize、TenniS 三个项目
     • 在项目的 craft 文件夹下启动 shell

     powershell > ./build.win.vc14.all.cmd
linux shell(wsl) > ./build.linux.all.sh

  4. 然后编译其他项目 SeetaMaskDetector、FaceAntiSpoofingX6、FaceBoxes、FaceRecognizer6、FaceTracker6、Landmarker、OpenRoleZoo、PoseEstimator6、QualityAssessor3、SeetaAgePredictor、SeetaAuthorize、SeetaEyeStateDetector、SeetaGenderPredictor
     • 在项目的 craft 文件夹下启动 shell

     powershell > ./build.win.vc14.all.cmd
linux shell(wsl) > ./build.linux.all.sh

📄 文档

• ViewFaceCore API
• SeetaFace6 说明
• SeetaFace 入门教程
• SeetaFace 各接口说明

❓ 常见问题

📦 使用许可

MIT © 2021 View