🧩 PhotoSteps Node Reference
PhotoSteps Help
Each node is a step in the pipeline. Steps are executed from top to bottom to produce the final image. If it affects the image, it exists as a node.
đź“Ą 1. ReadImage
Purpose
Loads the source image into the pipeline.
Type
Input node (must be first)
Parameters
| Parameter | Type | Description |
|---|---|---|
| source | string | Path or identifier of the image |
Notes
- There should typically be only one ReadImage
- All edits originate from this step
🎛 2. Adjust
Purpose
Basic tonal and color corrections. This is the most commonly used node.
Parameters
| Parameter | Range | Description |
|---|---|---|
| exposure | -2 → +2 | Overall brightness (log scale) |
| brightness | -1 → +1 | Linear brightness shift |
| contrast | 0 → 4 | Difference between dark and light |
| saturation | 0 → 2 | Color intensity |
| temperature | -1000 → +1000 | Warm (positive) / cool (negative) |
| tint | -100 → +100 | Green ↔ magenta shift |
🤖 CAT Examples (Adjust)
- “make it warmer” → increases temperature, may slightly increase saturation
- “make it brighter” → increases exposure
- “increase contrast” → increases contrast
- “make it less saturated” → decreases saturation
🌫 3. Blur
Purpose
Softens the image or creates motion effects.
Parameters
| Parameter | Description |
|---|---|
| type | gaussian, motion, zoom |
| radius | Strength of blur |
| center | Center point (for zoom blur) |
| angle | Direction (for motion blur) |
🤖 CAT Examples (Blur)
- “make it dreamy” → type: gaussian, moderate radius
- “add motion blur” → type: motion, sets angle and radius
- “zoom blur effect” → type: zoom, uses center
🎨 4. ColorTone
Purpose
Applies a global color style.
Parameters
| Parameter | Options | Description |
|---|---|---|
| style | warm, cool, cinematic, sepia, mono | Preset tone |
| intensity | 0 → 1 | Strength of effect |
| highlights | -1 → 1 | Tone bias in bright areas |
| shadows | -1 → 1 | Tone bias in dark areas |
🤖 CAT Examples (ColorTone)
- “make it cinematic” → style: cinematic, moderate intensity
- “make it black and white” → style: mono
- “sepia look” → style: sepia
✂️ 5. Crop
Purpose
Cuts the image to a region.
Parameters
| Parameter | Description |
|---|---|
| rect | {x, y, width, height} (normalized) |
| aspectRatio | e.g. 1:1, 16:9 |
🤖 CAT Examples (Crop)
- “crop to square” → aspectRatio: 1:1
🔄 6. Transform
Purpose
Applies geometric transformations.
Parameters
| Parameter | Description |
|---|---|
| rotation | Degrees |
| scaleX | Horizontal scale |
| scaleY | Vertical scale |
| translateX | Horizontal move |
| translateY | Vertical move |
| flipX | Mirror horizontally |
| flipY | Mirror vertically |
🤖 CAT Examples (Transform)
- “rotate slightly” → small rotation
- “flip horizontally” → flipX: true
✨ 7. Sharpen
Purpose
Enhances detail and edges.
Parameters
| Parameter | Description |
|---|---|
| amount | Strength of sharpening |
| radius | Area of influence |
| threshold | Edge sensitivity |
🤖 CAT Examples (Sharpen)
- “make it sharper” → increase amount
- “enhance details slightly” → small increase in amount
🌑 8. Vignette
Purpose
Darkens or lightens edges to draw focus.
Parameters
| Parameter | Description |
|---|---|
| intensity | Strength (positive = darker edges) |
| radius | Size of center region |
| softness | Edge falloff |
| center | Focus point |
🤖 CAT Examples (Vignette)
- “darken the edges” → increase intensity
- “draw focus to center” → increase intensity + adjust radius
🔀 9. Blend
Purpose
Combines two images (branches in the pipeline). This is how PhotoSteps supports graph-like behavior inside a list.
Inputs
| Input | Description |
|---|---|
| imageA | First image |
| imageB | Second image |
| mask | Optional mask |
Parameters
| Parameter | Options | Description |
|---|---|---|
| mode | normal, multiply, screen, overlay, softLight | Blend mode |
| opacity | 0 → 1 | Blend strength |
🤖 CAT Examples (Blend)
- “keep the original” → create branch, blend original with edited version
- “mix with original” → use Blend with moderate opacity
📤 10. ExportImage
Purpose
Outputs the final image.
Type
Output node (must be last)
Parameters
| Parameter | Options | Description |
|---|---|---|
| format | jpeg, png, webp | Output format |
| quality | 0 → 1 | Compression quality |
🧠How CAT Uses These Nodes
CAT (Collaborative Agent Transform) translates user intent into node operations.
Example
User:
“make it warmer and dreamy but keep the original”
CAT builds:
- Adjust → increase temperature
- Blur → add softness
- Blend → combine with original
🔄 Node Ordering (Recommended)
Typical pipeline order:
ReadImage → Crop → Transform → Adjust → Blur → ColorTone → Vignette → Sharpen → Blend → ExportImage
🧠Final Principle
Every node answers a simple question:
What transformation is applied at this step?
And together:
The pipeline tells the complete story of the image.