163 lines
4.1 KiB
Markdown
163 lines
4.1 KiB
Markdown
# Text-to-Image Node v1.7 - Quick Reference
|
||
|
||
## What's New
|
||
|
||
### 🔧 Fixed
|
||
- **Reference Images**: Now properly analyzed and incorporated into prompts
|
||
- Analyzes: dimensions, brightness, color tones
|
||
- LLM receives detailed characteristics to match
|
||
|
||
### ✨ New Controls
|
||
|
||
#### Prompt Length
|
||
Control the output size:
|
||
- `very_short` - 20-40 tokens (minimal)
|
||
- `short` - 40-80 tokens (SDXL)
|
||
- `medium` - 80-150 tokens (Flux)
|
||
- `long` - 150-250 tokens (complex)
|
||
- `very_long` - 250-400 tokens (maximum detail)
|
||
|
||
#### Genre/Style
|
||
Infuse prompts with specific mood:
|
||
- Creative: `surreal`, `cinematic`, `dramatic`, `action`, `artistic`
|
||
- Horror: `horror`, `noir`
|
||
- Tech: `scifi`, `cyberpunk`
|
||
- Mood: `humorous`, `romantic`, `indie`
|
||
- Era: `vintage`, `modern`
|
||
- Content: `pg`, `x-rated`
|
||
- Aesthetic: `minimalist`, `maximalist`, `documentary`
|
||
|
||
#### Subject Framing
|
||
Control the shot composition:
|
||
- `extreme close-up` - Facial details
|
||
- `close-up` - Face and shoulders
|
||
- `medium shot` - Waist up
|
||
- `wide shot` - Full body with environment
|
||
- `full body` - Complete subject
|
||
- `cowboy shot` - Mid-thigh up
|
||
- Plus: `bust shot`, `head and shoulders`, `three-quarter`
|
||
|
||
#### Subject Pose
|
||
Control character positioning:
|
||
- Static: `standing`, `sitting`, `lying down`, `kneeling`
|
||
- Dynamic: `action pose`, `walking`, `running`, `jumping`, `dancing`
|
||
- Portrait: `portrait pose`, `contrapposto`, `asymmetric`
|
||
- Energy: `relaxed`, `tense`, `dynamic`, `static`
|
||
|
||
---
|
||
|
||
## Quick Examples
|
||
|
||
### Example 1: Cinematic Portrait
|
||
```
|
||
Prompt: "woman in evening dress"
|
||
Genre: cinematic
|
||
Length: medium
|
||
Framing: close-up
|
||
Pose: contrapposto
|
||
```
|
||
→ Film-quality portrait, dramatic lighting, classic pose
|
||
|
||
### Example 2: Horror Scene
|
||
```
|
||
Prompt: "abandoned mansion"
|
||
Genre: horror
|
||
Length: long
|
||
Framing: wide shot
|
||
```
|
||
→ Detailed atmospheric horror with ominous mood
|
||
|
||
### Example 3: Action Shot
|
||
```
|
||
Prompt: "superhero"
|
||
Genre: action
|
||
Length: short
|
||
Framing: wide shot
|
||
Pose: dynamic
|
||
```
|
||
→ Fast-paced, energetic, movement-focused
|
||
|
||
### Example 4: Cyberpunk Character
|
||
```
|
||
Prompt: "{male|female} hacker"
|
||
Genre: cyberpunk
|
||
Length: medium
|
||
Framing: medium shot
|
||
Pose: asymmetric
|
||
```
|
||
→ Neon, tech, gritty urban dystopia aesthetic
|
||
|
||
---
|
||
|
||
## Pro Tips
|
||
|
||
### Reference Images
|
||
- Use clear, well-lit references for best results
|
||
- Color/lighting characteristics transfer well
|
||
- Works with any ComfyUI-compatible image format
|
||
|
||
### Combining Features
|
||
- Alternation `{a|b|c}` + Emphasis `(keyword:1.5)` + Genre + Framing = powerful control
|
||
- All features work together seamlessly
|
||
- Random options provide variety across generations
|
||
|
||
### Platform Specific
|
||
- **SDXL**: Use `short` length, works with all genres
|
||
- **Flux**: `medium` length, natural language excels
|
||
- **Pony**: Any length converts to tags, genres adapt
|
||
- **Chroma**: `long` or `very_long` for complex scenes
|
||
|
||
### Length vs Detail
|
||
- **Shorter** = focused, concise, faster to generate
|
||
- **Longer** = complex scenes, multiple subjects, rich atmosphere
|
||
- Match length to scene complexity
|
||
|
||
---
|
||
|
||
## All New Inputs
|
||
|
||
| Input | Options | Default |
|
||
|-------|---------|---------|
|
||
| `genre_style` | 22 options | `auto` |
|
||
| `prompt_length` | 6 options | `auto` |
|
||
| `subject_framing` | 14 options | `auto` |
|
||
| `subject_pose` | 17 options | `auto` |
|
||
|
||
All support:
|
||
- `auto` - Intelligent defaults
|
||
- `random` - Variety across generations
|
||
- `none` - Disable the control
|
||
- Specific values for precise control
|
||
|
||
---
|
||
|
||
## Testing Checklist
|
||
|
||
- [ ] Reference image incorporated (check output mentions image characteristics)
|
||
- [ ] Prompt length matches target (count tokens ~words × 1.3)
|
||
- [ ] Genre style reflected (vocabulary/tone matches)
|
||
- [ ] Framing mentioned (shot type present)
|
||
- [ ] Pose described (body position clear)
|
||
- [ ] All features work together
|
||
- [ ] Platform formatting correct
|
||
- [ ] Emphasis syntax preserved `(keyword:1.5)`
|
||
- [ ] Alternation processed `{a|b|c}`
|
||
- [ ] No settings leakage in output
|
||
|
||
---
|
||
|
||
## Restart Required
|
||
|
||
**After update, restart ComfyUI completely to load new controls!**
|
||
|
||
---
|
||
|
||
## Files Updated
|
||
- `text_to_image_node.py` - Core functionality
|
||
- `UPDATE_V17_ENHANCED_CONTROLS.md` - Full documentation
|
||
- This file - Quick reference
|
||
|
||
**Version:** 1.7
|
||
**Status:** ✅ Ready to use
|
||
**Compatibility:** ✅ All existing workflows work
|