Doc reorganization, part 2

This commit is contained in:
asagi4
2025-05-30 22:17:56 +03:00
parent 75bced7d2b
commit a9c2487c0c
+3 -47
View File
@@ -6,8 +6,9 @@ A `Basic Text to Image` template is included with the extension, and can be load
## What can it do?
See [features](#features) below. Things you can control via the prompt:
- Prompt scheduling and filtering without noodle soup
You can use text prompts to control the following:
- Prompt scheduling and filtering without noodle soup.
- LoRA loading and scheduling via ComfyUI's hook system
- Masking, composition and area control (regional prompting) with an implementation of Attention Couple, also fully schedulable.
- Per-encoder prompts for models with multiple text encoders, such as SDXL and Flux
@@ -89,51 +90,6 @@ This node attaches masks to a `CLIP` model so that they can be referred to when
This node configures `PCTextEncode` default values for some functions by attaching the information to a `CLIP` model.
# Features
For all features, see the [syntax documentation](doc/syntax.md) for details.
## Scheduling and LoRA loading
Prompt control provides a way to easily schedule different prompts and control LoRA loading. The syntax is similar to the Automatic1111 WebUI.
### Note on how schedules work
ComfyUI does not use the step number to determine whether to apply conds; instead, it uses the sampler's timestep value which is affected by the scheduler you're using. This means that when the sampler scheduler isn't linear, the schedules generated by prompt control will not be either.
## Advanced text encoding
If you use `PCTextEncode`, advanced encodings are available automatically. Thanks to BlenderNeko for the original code.
Use the syntax `STYLE(weight_interpretation, normalization)` in a prompt to affect how prompts are interpreted.
The weight interpretations available are:
- comfy (default)
- comfy++
- compel
- down_weight
- A1111
- perp
Normalizations are:
- none (default)
- length
- mean
The normalization calculations are independent operations and you can combine them with `+`, eg `STYLE(A1111, length+mean)` or `STYLE(comfy, mean+length)`, or even something silly like `STYLE(perp, mean+length+mean+length)`
The style can be specified separately for each AND:ed prompt, but the first prompt is special; later prompts will "inherit" it as default. For example:
```
STYLE(A1111) a (red:1.1) cat with (brown:0.9) spots and a long tail AND an (old:0.5) dog AND a (green:1.4) (balloon:1.1)
```
will interpret everything as A1111, but
```
a (red:1.1) cat with (brown:0.9) spots and a long tail AND STYLE(A1111) an (old:0.5) dog AND a (green:1.4) (balloon:1.1)
```
Will interpret the first one using the default ComfyUI behaviour, the second prompt with A1111 and the last prompt with the default again
# Known issues
- ComfyUI's caching mechanism has an issue that makes it unnecessarily invalidate caches for certain inputs; you'll still get some benefit from the lazy nodes, but changing inputs that shouldn't affect downstream nodes (especially if using filtering) will still cause them to be recomputed because ComfyUI doesn't realize the inputs haven't changed.