Inputs
| Parameter | Description | Data Type | Required | Range |
|---|---|---|---|---|
driving_track_data | SAM3 track of the driving pose video. Will be rendered into the pose_video_mask output. | SAM3_TRACK_DATA | Yes | - |
ref_track_data | SAM3 track of the reference image(s) (one identity per object, colored in batch order), or a plain MASK of the reference subject (rendered as a single identity). | SAM3_TRACK_DATA or MASK | No | - |
object_indices | Comma-separated list of person indices to include (e.g. ‘0,2,3’). Applied to both reference and pose video masks. Empty = all. (default: "") | STRING | Yes | - |
sort_by | Order in which palette colors are assigned to the tracked objects (applied to both reference and pose video so each identity keeps the same color). Objects that appear in earlier frames always come first; within a frame, left_to_right = leftmost object (by centroid at first appearance) gets the first color, area = biggest object (by mask area at first appearance) gets the first color; none = keep SAM3’s order. (default: “left_to_right”) | COMBO | Yes | "none""left_to_right""area" |
replacement_mode | False = Animation Mode (pose_video_mask has black background, reference_image_mask has white background). True = Replacement Mode (pose_video_mask has white background, reference_image_mask has black background). (default: False) | BOOLEAN | Yes | False True |
Outputs
| Output Name | Description | Data Type |
|---|---|---|
pose_video_mask | Colored mask rendered from the driving pose video tracking data. Background color follows replacement_mode setting. | IMAGE |
reference_image_mask | Colored mask rendered from the reference image tracking data. Background is black in Replacement Mode, white in Animation Mode. If no reference data is provided, returns a solid fill matching the reference background color. | IMAGE |
This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! Edit on GitHub
Source fingerprint (SHA-256):
ce0669ad0ed3c76cc18ef0ee7b620f5aa6eaa1e5b96c189941c0a5b744c3351f