faceengine

README

face-engine

介绍

对虹软人脸识别试用版4.1的简单封装

Documentation

Index

• Constants
• func OnlineActivation(appID, sdkKey, activeKey string) (err error)
• type EngineError
  • func (err EngineError) Error() string
• type FaceEngine
  • func NewFaceEngine() (*FaceEngine, error)
  • func (engine *FaceEngine) Destroy() (err error)
  • func (engine *FaceEngine) DetectFaces(width int, height int, format C.MInt32, imgData []byte) (faceInfo FaceInfo, err error)
  • func (engine *FaceEngine) DetectFacesEx(imageData ImageData) (faceInfo FaceInfo, err error)
• type FaceInfo
• type ImageData
• type Rect

Constants

const (
	// DetectModeVideo 视频模式
	DetectModeVideo = C.ASF_DETECT_MODE_VIDEO
	// DetectModeImage 图片模式
	DetectModeImage = C.ASF_DETECT_MODE_IMAGE
	// OrientPriority0 不旋转
	OrientPriority0 = C.ASF_OP_0_ONLY
	// OrientPriority90 旋转90度
	OrientPriority90 = C.ASF_OP_90_ONLY
	// OrientPriority270 旋转270度
	OrientPriority270 = C.ASF_OP_270_ONLY
	// OrientPriority180 旋转180度
	OrientPriority180 = C.ASF_OP_180_ONLY
	// OrientPriorityAllOut 角度不限
	OrientPriorityAllOut = C.ASF_OP_ALL_OUT
	// EnableFaceDetect 开启人脸检测
	EnableFaceDetect = C.ASF_FACE_DETECT
	// EnableFaceRecognition 开启人脸识别
	EnableFaceRecognition = C.ASF_FACERECOGNITION
	// EnableLiveness 开启活体检测
	EnableLiveness = C.ASF_LIVENESS
	// EnableImageQuality 开启单人脸图片质量检测
	EnableImageQuality = C.ASF_IMAGEQUALITY
	// EnableMaskDetect 开启口罩检测
	EnableMaskDetect = C.ASF_MASKDETECT
	// EnableUpdateFaceData 开启人脸数据更新
	EnableUpdateFaceData = C.ASF_UPDATE_FACEDATA
	ColorFormatBGR24     = C.ASVL_PAF_RGB24_B8G8R8
)

Functions

func OnlineActivation

func OnlineActivation(appID, sdkKey, activeKey string) (err error)

OnlineActivation 在线激活接口

Types

type EngineError

type EngineError struct {
	Code int
	Text string
}

EngineError SDK错误码

func (EngineError) Error

func (err EngineError) Error() string

实现Error接口

type FaceEngine

type FaceEngine struct {
	// contains filtered or unexported fields
}

FaceEngine 引擎结构体

func NewFaceEngine

func NewFaceEngine() (*FaceEngine, error)

NewFaceEngine 创建一个新的引擎实例 如果调用初始化函数失败则返回一个错误

func (*FaceEngine) Destroy

func (engine *FaceEngine) Destroy() (err error)

Destroy 销毁引擎

func (*FaceEngine) DetectFaces

func (engine *FaceEngine) DetectFaces(
	width int,
	height int,
	format C.MInt32,
	imgData []byte,
) (faceInfo FaceInfo, err error)

DetectFaces 人脸检测，目前不支持IR图像数据检测

func (*FaceEngine) DetectFacesEx

func (engine *FaceEngine) DetectFacesEx(imageData ImageData) (faceInfo FaceInfo, err error)

DetectFacesEx 检测人脸信息 该接口与 DetectFaces 功能一致，但采用结构体的形式传入图像数据，对更高精度的图像兼容性更好。

type FaceInfo

type FaceInfo struct {
	FaceNum int32 // 检测到的人脸个数
	//下面都是第一个人信息
	FaceRect             Rect  // 人脸框信息
	WearGlasses          int32 // 戴眼镜状态, 0 未戴眼镜；1 戴眼镜；2 墨镜
	LeftEyeOpen          int32 // 左眼状态 0 闭眼；1 睁眼
	RightEyeOpen         int32 // 右眼状态 0 闭眼；1 睁眼
	MouthClose           int32 // 张嘴状态 0 张嘴；1 合嘴
	FaceIsWithinBoundary int32 // 人脸是否在边界内 0 人脸溢出；1 人脸在图像边界内
	Roll                 float32
	Yaw                  float32
	Pitch                float32
	IsLive               int32 // 0:非真人 1:真人 -1:不确定 -2:传入人脸数>1
	IsMask               int32 // 0代表没有带口罩 1代表带口罩 -1表示不确定
}

人脸信息结构体

type ImageData

type ImageData struct {
	PixelArrayFormat C.MUInt32
	Width            int
	Height           int
	ImageData        [4][]uint8
	WidthStep        [4]int
}

ImageData 对应ASVLOFFSCREEN结构体

type Rect

type Rect struct {
	Left   int32
	Top    int32
	Right  int32
	Bottom int32
}

Rect 人脸坐标结构体