WanVideo UniAnimate DWPose Detector

节点功能:用于对输入图像进行 DWpose 姿态估计,提取人体关键点并生成可视化姿态图像,支持自动下载并加载 YOLOX 行人检测器与 DWpose 姿态估计器(TorchScript 格式)。适用于视频驱动、姿态引导类生成任务中的骨骼关键点提取。

输入参数

参数名称说明
pose_images输入图像序列,将在这些帧中进行人体姿态关键点检测。
reference_pose_image指定参考姿态图像,仅用于辅助后续模块或可视化(非必填)。

输出参数

参数名称说明
poses关键点可视化后的图像序列。
reference_pose输出的参考姿态图像,如未提供参考图像则返回全 0 图像。

控件参数

参数名称说明
score_threshold关键点检测的置信度阈值,低于该分数的点将被忽略。建议 0.2~0.5,分数过低会检测噪点,过高则漏检。
stick_width骨骼线条的宽度,影响可视化效果的粗细。
draw_body是否绘制躯干和四肢关键点。
body_keypoint_size躯干关键点的绘制尺寸(半径像素)。一般设为 3~5,值越大点越明显。
draw_feet是否绘制脚部关键点。
draw_hands是否绘制手部关键点。
hand_keypoint_size手部关键点的绘制尺寸(半径像素)。
colorspace输出图像的色彩通道顺序。
handle_not_detected对于未检测到人体的帧的处理策略。empty 表示全黑,repeat 表示使用上一个姿态图。建议用 repeat 保证视频帧连续性。

这里以输入的单张图片为例(一般是输入视频,以获取骨骼动图

score_threshold: 关键点置信度阈值,值越大,筛选越干净,但容易丢失信息,score_threshold=1.0的时候已经检测不到骨骼图了。

stick_width值越大,骨骼的线条越粗。

body_keypoint_size: 身体关键点圆圈大小,值越大,圆点越大,另外的hand_keypoint_size也是一样

colorspace: 设置输出图像色彩空间

输入reference_pose_image后,能同时输出参考图的姿势