LivePortrait Cropper

节点功能:主要功能是处理面部图像裁剪、面部关键点提取、特征提取和相关处理。它将输入的图像通过裁剪器进行处理,提取图像中的面部区域,并对裁剪后的图像执行进一步的处理操作,包括关键点和特征提取。

输入参数

参数名称说明
pipeline已加载的 LivePortrait 推理管道。
cropper人脸裁剪器实例。用于定位人脸并裁剪为标准尺寸输入,通常来自外部初始化节点。
source_image输入图像,可为一张或多张。

输出参数

参数名称说明
cropped_image裁剪后的人脸标准图像序列。
crop_info裁剪和关键点提取结果结构体。

控件参数

参数名称说明
dsize裁剪输出图像的尺寸(宽高像素)。
scale人脸区域的裁剪放大比例。默认 2.3,控制裁剪框大小,数值越大包含背景越多。
vx_ratio横向偏移比例。用于微调裁剪框的水平偏移,0 为中心。
vy_ratio纵向偏移比例。
face_index当检测到多张脸时,选择第几张(从 0 开始)。
face_index_order多脸排序策略。可选值: large-small、left-right、top-bottom 等,决定 face_index 的含义。
rotate是否对图像进行自动旋转校正。

当scale系数为1时,只有脸部信息。

当裁剪图像中只有脸部时,在生成动画的时候也只有脸部细节在动。

当scale系数为1时,图像中包含脸部以外的信息。

当裁剪图像中包含脸部以外的信息时,生成的动画除脸部外也会动,如下图,动画中肩部也会动。

设置vx_ratio为0.5时,图像整体向左平移0.5*width像素

生成的动画中只有检测到的右半部分脸部在动。

rotate=false,生成图像脸部和原图方向一样

rotate=ture,生成图像脸部调整的更平直。

在检测多张人脸时,最好使用LivePortrait Load FaceAlignmentCropper节点。如下图,人物中包含两张人脸,当face_index_order选择left-right时,即对检测到的人脸从左到右依次排序,face_index=0代表左边的第一张人脸。

当face_index选择1时,则显示右边人脸。