ComfyUI Node
JoyLTX Refs by Name
One reference photo per shot, picked by the character names in the prompts from input/<refs_root>/<name>/.
JoyLTX Refs by Name
- ref_images
- ref_mask
- report
- prompts
◄prompts►
◄refs_root▾►
◄pickone per character (by seed)►
◄seed0►
◄width960►
◄height544►
◄cropportrait (keep the person, drop the set)►
CategoryJoyLTX
Inputs (7)
| Name | Type | Default | Description |
|---|---|---|---|
| prompts | STRING | The writer's shot prompts (JSON or --- list). Normally wired from the writer or Prompts from File. | |
| refs_root | COMBO | Folder under ComfyUI/input holding one sub-folder per character (the folder NAME is the name the node looks for in each shot prompt, case-insensitive). Restart or refresh ComfyUI to see folders you just added. | |
| pick | COMBO | one per character (by seed) | one per character = the SAME photo for a character in every shot (best identity). |
| seed | INT | 00–2147483647 | — |
| width | INT | 96064–4096 | Render size (pass 1); the photos are fit to it. |
| height | INT | 54464–4096 | — |
| cropopt | COMBO | portrait (keep the person, drop the set) | portrait = the central upper part of each photo, so the reference carries the face and not the room (a full scene photo drags its set into the shot). |
Outputs (4)
| Name | Type | Description |
|---|---|---|
| ref_images | IMAGE | — |
| ref_mask | STRING | — |
| report | STRING | — |
| prompts | STRING | — |