diff --git a/README.md b/README.md index 38d85cb..83051e8 100644 --- a/README.md +++ b/README.md @@ -19,11 +19,11 @@ inspect the exact setup. | Goal | How to set it up | | --- | --- | -| Put image 2's style onto image 1 | Image 1: `keep the same subject` at `0.80`. Image 2: `suggest the visual style` at `0.45` to `0.65`. | +| Put image 2's style onto image 1 | Image 1: `keep the same subject` at `0.80` to `0.90`. Image 2: `suggest the visual style` at `0.55` (its cap is `0.65`). | | Keep a product or character recognizable | Use `keep the same subject` for the identity image, then add lower-strength style, lighting, or material cards. | -| Borrow lighting without copying the subject | Use `copy lighting and mood` around `0.30` to `0.45`. | -| Borrow a surface or finish | Use `suggest material or texture` around `0.45` to `0.65`. | -| Follow a pose, crop, or composition | Use `copy pose and layout` or `copy big shapes only` at gentle to medium strength. | +| Borrow lighting without copying the subject | Use `copy lighting and mood` around `0.65`; push toward `0.90` for full drama. | +| Borrow a surface or finish | Use `suggest material or texture` at `0.55` (raise toward its `0.65` cap only when the object's exact form matters less). | +| Follow a pose, crop, or composition | Use `copy pose and layout` around `0.90`, or `copy big shapes only` around `0.90` for silhouette-only steering. | | Use a reference that contains text or logos | Add `avoid copying text/logos` at very low strength, usually around `0.03`. | ## How The Workflow Thinks @@ -155,14 +155,16 @@ so the Krea reference nodes are easy to inspect. | --- | --- | --- | | `0.00` | Off | Keep a card connected but inactive. | | `0.03` to `0.08` | Tiny nudge | Text/logo guard, shape hints, stubborn prompts. | -| `0.10` to `0.25` | Gentle guidance | Layout, material, mood-board influence. | -| `0.25` to `0.45` | Strong guidance | Lighting, texture, pose, broad style. | -| `0.50` to `0.90` | Very strong | Content anchor or deliberate style transfer. Watch for over-copying. | +| `0.20` to `0.50` | Gentle whisper | A hint of palette, mood, or material - deliberately subtle. | +| `0.55` to `0.90` | The working band | Style, palette, lighting, material, and mood land clearly here (many cap themselves at `0.65`-`0.9`). | +| `0.90` to `1.20` | Structure and identity | Content anchors, pose/layout, and big shapes. Watch for over-copying. | Tips: -- Start strengths low and raise slowly. -- Use `0.80` only when the main subject must stay stable. +- Start strengths low and raise slowly; appearance recipes whisper by design + below about `0.5`. +- Use `0.80`-`0.90` on `keep the same subject` when the main subject must + stay stable. - Lower `Image detail level` if a style image starts copying the wrong subject. - Raise `Written prompt strength` when the text prompt should win over references. - Use text/logo guard whenever a reference includes readable marks. diff --git a/custom_recipes/README.md b/custom_recipes/README.md index f4a3fd2..b79bf6a 100644 --- a/custom_recipes/README.md +++ b/custom_recipes/README.md @@ -61,10 +61,11 @@ nothing: | You want to borrow | Use treatment | Why it is safe | | --- | --- | --- | | colors / palette / mood | `palette wash` | the source's shapes are destroyed first, so its subject **cannot** leak into your image | + | style / medium / light mood | `strong blur` + a de-selecting `focus` + a cap | how the shipped style and lighting recipes work: the blur mutes detail, the focus skips the source's subject, layout, and the blur itself - copy their pattern | | layout / arrangement | `grayscale blur` | color is stripped, so placement arrives without recoloring | - | silhouette only | `shape wash` | everything but the big masses is removed | + | silhouette only | `shape wash` | everything but the big masses is removed (pair with a structure-heavy `layers` like the shipped shape recipe, or the gray study can mute your colors) | | the actual subject | `normal` | nothing is removed - the subject can and will copy in | - | subject + softness | `soft blur` / `strong blur` | **caution:** these keep the source's forms; at working strengths the source object itself tends to appear or reshape your subject | + | subject + softness | `soft blur` / `strong blur` alone | **caution:** without a focus and cap these keep the source's forms; at working strengths the source object itself tends to appear or reshape your subject | 2. **`shape` is the volume knob.** It scales the one conditioning channel that actually moves pixels on Krea 2. Render-calibrated anchors: diff --git a/docs/assets/krea-v10/demos/counter-example-away.png b/docs/assets/krea-v10/demos/counter-example-away.png index cb9de0a..b57968a 100644 Binary files a/docs/assets/krea-v10/demos/counter-example-away.png and b/docs/assets/krea-v10/demos/counter-example-away.png differ diff --git a/docs/assets/krea-v10/demos/counter-example-toward.png b/docs/assets/krea-v10/demos/counter-example-toward.png index c956f6c..31067ed 100644 Binary files a/docs/assets/krea-v10/demos/counter-example-toward.png and b/docs/assets/krea-v10/demos/counter-example-toward.png differ diff --git a/docs/assets/krea-v10/demos/full-showcase-balanced.png b/docs/assets/krea-v10/demos/full-showcase-balanced.png index e432840..2512b67 100644 Binary files a/docs/assets/krea-v10/demos/full-showcase-balanced.png and b/docs/assets/krea-v10/demos/full-showcase-balanced.png differ diff --git a/docs/assets/krea-v10/demos/full-showcase.png b/docs/assets/krea-v10/demos/full-showcase.png index 562b823..1a708af 100644 Binary files a/docs/assets/krea-v10/demos/full-showcase.png and b/docs/assets/krea-v10/demos/full-showcase.png differ diff --git a/docs/assets/krea-v10/demos/recipe-gallery.png b/docs/assets/krea-v10/demos/recipe-gallery.png index bdee80d..e53e735 100644 Binary files a/docs/assets/krea-v10/demos/recipe-gallery.png and b/docs/assets/krea-v10/demos/recipe-gallery.png differ diff --git a/docs/assets/krea-v10/demos/recipe-suggest-material-texture.png b/docs/assets/krea-v10/demos/recipe-suggest-material-texture.png index 209c408..12dc3b3 100644 Binary files a/docs/assets/krea-v10/demos/recipe-suggest-material-texture.png and b/docs/assets/krea-v10/demos/recipe-suggest-material-texture.png differ diff --git a/docs/assets/krea-v10/demos/timing-style-early-only.png b/docs/assets/krea-v10/demos/timing-style-early-only.png index d07dc7c..9683427 100644 Binary files a/docs/assets/krea-v10/demos/timing-style-early-only.png and b/docs/assets/krea-v10/demos/timing-style-early-only.png differ diff --git a/docs/assets/krea-v10/demos/timing-style-final-only.png b/docs/assets/krea-v10/demos/timing-style-final-only.png index a41efeb..fb8e839 100644 Binary files a/docs/assets/krea-v10/demos/timing-style-final-only.png and b/docs/assets/krea-v10/demos/timing-style-final-only.png differ diff --git a/docs/krea-v10-documentation-index.md b/docs/krea-v10-documentation-index.md index 87c0134..e179d87 100644 --- a/docs/krea-v10-documentation-index.md +++ b/docs/krea-v10-documentation-index.md @@ -1,11 +1,13 @@ # Krea 2 V10 Documentation Index This is the map for the V10 reference-stack nodes and workflows. V10 keeps -everything from V9 and adds four more quick recipes, user-defined recipes -(with an aspect `focus` field and three shipped starter recipes), the Recipe -Builder, guide direction (counter-examples), per-card timing, manual layer -dials, balance for hot stacks, a study cache, and two feedback outputs. The -[V9 index](krea-v9-documentation-index.md) remains the map for the V9 nodes. +everything from V9 and adds four more quick recipes, render-retuned V10-only +versions of the style, material, lighting, and big-shapes recipes, +user-defined recipes (with an aspect `focus` field and five shipped starter +recipes), the Recipe Builder, guide direction (counter-examples), per-card +timing, manual layer dials, balance for hot stacks, a study cache, and two +feedback outputs. The [V9 index](krea-v9-documentation-index.md) remains the +map for the V9 nodes. ![Synthetic reference images included with Krea Reference](../example_assets/krea-reference-examples/contact_sheet.png) @@ -34,7 +36,7 @@ dials, balance for hot stacks, a study cache, and two feedback outputs. The | Node | Details | | --- | --- | -| [KG Krea 2 Image Guide Card V10](nodes/kg-krea-2-image-guide-card-v10.md) | The four new recipes, custom recipes and `focus`, guide direction, per-card timing, and the manual layer dials. | +| [KG Krea 2 Image Guide Card V10](nodes/kg-krea-2-image-guide-card-v10.md) | The four new recipes, the V10 recipe overrides (style, material, lighting, big shapes), custom recipes and `focus`, guide direction, per-card timing, and the manual layer dials. | | [KG Krea 2 Reference Stack Encoder V10](nodes/kg-krea-2-reference-stack-encoder-v10.md) | Balance, study reuse, the stack report, and the prepared-references output. | | [Node documentation index](nodes/README.md) | Short index of all included node pages. | @@ -68,8 +70,9 @@ The V9 gallery lives at [assets/krea-v9/demos](assets/krea-v9/demos/). - A recipe's `focus` field targets **one named aspect** of its reference ("the clothing and garment style, not the person") - naming what to skip is render-verified to keep the rest behind. -- Three starter recipes ship enabled: `borrow the weather`, - `borrow the clothing style`, and `cinematic color grade`. +- Five starter recipes ship enabled: `borrow the weather`, + `borrow the clothing style`, `borrow drawing medium`, + `borrow photo finish`, and `cinematic color grade`. - `Guide direction` turns any card into a counter-example: not this style, not this palette, not this subject. - `When this card guides` gives every card its own timing without touching diff --git a/docs/krea-v10-user-guide.html b/docs/krea-v10-user-guide.html index 8779f05..d521322 100644 --- a/docs/krea-v10-user-guide.html +++ b/docs/krea-v10-user-guide.html @@ -319,7 +319,7 @@

Aspect focus

-

A recipe's focus field studies one named aspect of its image - "the clothing and garment style, not the person" - and demonstrably leaves the rest behind.

+

A recipe's focus field studies one named aspect of its image - "the clothing and garment style, not the person" - and demonstrably leaves the rest behind. The built-in style and lighting recipes ship focuses of their own (visible on the stack report).

Starter recipes + Builder

@@ -602,9 +602,10 @@ layers: [0.25, 0.35, 0.45, 0.6, 0.8,
Starter recipes included: custom_recipes/starter-pack.yaml - ships enabled with three render-validated examples - borrow the + ships enabled with five render-validated examples - borrow the weather, borrow the clothing style (a focus - recipe), and cinematic color grade. Copy from them, or delete + recipe), borrow drawing medium, borrow photo finish, + and cinematic color grade. Copy from them, or delete the file to remove them from your dropdown.

What each control really does (render-verified)

@@ -614,8 +615,10 @@ layers: [0.25, 0.35, 0.45, 0.6, 0.8, palette wash (structure-safe: the source's shapes are destroyed, so its subject cannot leak in). Layout: grayscale blur. Silhouette: shape wash. The actual subject: - normal. Careful with soft/strong blur - the - source's forms survive and tend to appear at working strengths. + normal. Careful with soft/strong blur alone - + the source's forms survive and tend to appear at working strengths; + the shipped style and lighting recipes tame strong blur with a cap + plus a de-selecting focus - copy their pattern. 2. shape is the volume knob - the one channel that moves pixels on Krea 2 (anchors in the table above). 3. layers fine-tunes WHICH bands are @@ -925,6 +928,7 @@ Studies: 7 encoder passes this run; A card seems to do nothing.Read its stack report line: the feel curve, a recipe cap, or the guard is usually named there. Appearance recipes are tuned to land from about strength 0.6 - below that they whisper by design. A custom recipe does nothing at any strength.Its shape is too low (below ~0.5 the card is effectively off on Krea 2) or its study too fine. Raise shape toward 0.7-1.0; raising global will not help on this model. A focus seems ignored.The stack report prints each card's focus - confirm it arrived. Focus is strongest on object-bound aspects (clothing, props); broad moods ride the image itself. Rephrase to name what to skip - de-selection is the reliable move. + Style results look soft or out of focus.Make sure you are on the current tuning: suggest the visual style ships an anti-blur focus (printed on its stack-report line) that stops the recipe's deliberate reference-softening from being copied as the style. If soft-medium references (watercolor, hazy photos) still read soft, that is the medium arriving - lower the card below 0.6 or add crispness words to the prompt. Away card makes the image muddy or empty.Lower it below 0.30 and make sure something positive says what you do want. Many cards fight each other.Turn on gentle balance, or lower the two strongest cards. The report shows the applied scale. Style card drags its subject in.Check the prepared-references preview; if the subject is visible there, lower detail or strengthen the treatment. In manual mode, lower Structure layers pull. diff --git a/docs/krea-v10-user-guide.md b/docs/krea-v10-user-guide.md index 2589762..fc8bbe8 100644 --- a/docs/krea-v10-user-guide.md +++ b/docs/krea-v10-user-guide.md @@ -81,7 +81,7 @@ V10 controls). Saved V9 workflows keep working unchanged. | `copy the camera framing` | card | Framing-only quick recipe (was manual-only in V9). | | `mood board only` | card | Loose-inspiration quick recipe (was manual-only in V9). | | Custom recipes | card | Your own YAML/JSON recipe files appear in `Use image for` as first-class choices. | -| `focus` recipe field | recipe file | A recipe can study **one named aspect** of its image - clothing, props, a setting - and skip the rest. | +| `focus` recipe field | recipe file | A recipe can study **one named aspect** of its image - clothing, props, a setting - and skip the rest. The built-in style and lighting recipes ship focuses of their own. | | Starter recipes | shipped | `borrow the weather`, `borrow the clothing style`, and `cinematic color grade` load out of the box from [starter-pack.yaml](../custom_recipes/starter-pack.yaml). | | Recipe Builder | `web/` | A single HTML page that turns three plain-language questions into a validated recipe file. | | `Guide direction` | card | `toward this image` (V9 behavior) or `away from this image` (counter-example). | @@ -129,7 +129,7 @@ and seed are directly comparable - the only change between them is the card. | `copy the camera framing` | slot6 pose/layout | `0.30` | `972103` | [PNG](assets/krea-v10/demos/copy-camera-framing.png) | Camera distance, crop, and viewpoint - subject and palette stay the prompt's. | | `avoid copying text/logos` | slot5 text/logo guard | `0.50` (clamps to `0.03`) | `972116` | [PNG](assets/krea-v10/demos/recipe-avoid-text-logos.png) | Nothing readable: the guard clamps the card and rewrites the prompt toward blank surfaces. | | `suggest the color palette` | slot2 style reference | `0.65` | `972101` | [PNG](assets/krea-v10/demos/suggest-color-palette.png) | The reference's color relationships, as soft color fields - composition identical to the no-card baseline. | -| `suggest the visual style` | slot2 style reference | `0.65` | `972101` | [PNG](assets/krea-v10/demos/recipe-suggest-visual-style.png) | Same inputs and seed as the palette row: a broader, softer overall grade - the look, not the source's shapes. | +| `suggest the visual style` | slot2 style reference | `0.65` | `972101` | [PNG](assets/krea-v10/demos/recipe-suggest-visual-style.png) | Same inputs and seed as the palette row: true style transfer - the medium, palette, and finish energy arrive with the subject kept crisp (an anti-blur focus keeps the recipe's own softening out of the result). | | `copy lighting and mood` | slot4 lighting/mood | `0.65` | `972113` | [PNG](assets/krea-v10/demos/recipe-copy-lighting-mood.png) | The reference's light color and tonal mood as a scene-wide cast. | | `suggest material or texture` | slot3 material/texture | `0.55` | `972114` | [PNG](assets/krea-v10/demos/recipe-suggest-material-texture.png) | The material's surface finish and pattern energy, with source structure kept quiet. | | `use the background/setting` | slot8 background/environment | `0.65` | `972102` | [PNG](assets/krea-v10/demos/use-background-setting.png) | The setting's palette and room mood; the model builds a coherent place around the prompt's subject. | @@ -396,13 +396,18 @@ guarantees - keep `subject: avoid` and a job-appropriate treatment, and render-check like everything else. The stack report prints each card's focus so you can confirm it reached the encoder. -One built-in uses it too: `suggest the visual style` ships an anti-blur -focus ("...not the image's blurriness or soft focus, and not its subject or -scene layout"). The recipe softens the reference before study on purpose - -that is its safety guarantee - and the focus keeps that deliberate blur from -being read back as the style, so subjects stay crisp while the palette, -medium, and brushwork arrive. You will see it on the card's stack-report -line; that is expected. +Two built-ins use it too, and their focus lines appear on the stack report - +that is expected: + +- `suggest the visual style` ships an anti-blur focus ("...not the image's + blurriness or soft focus, and not its subject or scene layout"). The + recipe softens the reference before study on purpose - that is its safety + guarantee - and the focus keeps that deliberate blur from being read back + as the style, so subjects stay crisp while the palette, medium, and + brushwork arrive. +- `copy lighting and mood` ships a de-place focus ("...not the place, + objects, or scene layout"), so a dramatic sky's mood arrives without the + reference's location taking over. A complete example (the shipped template - render-validated values): diff --git a/docs/nodes/kg-krea-2-image-guide-card-v10.md b/docs/nodes/kg-krea-2-image-guide-card-v10.md index 82f206a..6b18e64 100644 --- a/docs/nodes/kg-krea-2-image-guide-card-v10.md +++ b/docs/nodes/kg-krea-2-image-guide-card-v10.md @@ -14,7 +14,12 @@ Guide packets stay V9-compatible: a V10 card plugs into a V9 stack (which ignore ## Everything The V9 Card Has -The first fifteen rows repeat the [V9 card](kg-krea-2-image-guide-card-v9.md) exactly: strength, `Use image for`, and the manual tuning levers behave identically. +The first fifteen rows repeat the [V9 card](kg-krea-2-image-guide-card-v9.md) exactly: strength, `Use image for`, and the manual tuning levers work the same way. Four of the shared recipe labels, however, resolve to **V10-only retuned bundles** on this card (the V9 card keeps its own tuning): + +- `suggest the visual style`: true style transfer - strong-blur prep with a finish-heavy layer table and an anti-blur `focus` so the medium, palette, and brushwork character arrive while subjects stay crisp and the source's scene stays out. Capped at `0.65`; lands clearly from about `0.55`. +- `suggest material or texture`: surface character (weave, glaze, relief energy) rather than a recolor; capped at `0.65`, and `0.55` is the safe point when the object's form must not move. +- `copy lighting and mood`: strong-blur prep with a de-place `focus`, so dramatic light and sky moods actually land (a storm reference delivers the storm, not a flat sunny field) without the reference's location taking over. +- `copy big shapes only`: a structure-only layer table, so the silhouette guides the composition without the recipe's gray study muting your colors. ## New Quick Recipes diff --git a/docs/testing.md b/docs/testing.md index 629a1e9..263ae1f 100644 --- a/docs/testing.md +++ b/docs/testing.md @@ -46,8 +46,9 @@ Then load the example workflows and replace placeholder Load Image filenames wit - The prepared-references contact sheet (Preview Image) shows one treated frame per active card. - A second queue with only a strength change reports zero new encoder passes when `Reuse image studies` is on. - The counter-example workflow's away card is marked in the report with negative targets. -- The three starter recipes (`borrow the weather`, `borrow the clothing style`, `cinematic color grade`) appear in `Use image for` out of the box, and the starter-recipe workflow queues cleanly. -- A recipe with a `focus` prints `Focus: ...` on its report card line. +- The five starter recipes (`borrow the weather`, `borrow the clothing style`, `borrow drawing medium`, `borrow photo finish`, `cinematic color grade`) appear in `Use image for` out of the box, and the starter-recipe workflow queues cleanly. +- A recipe with a `focus` prints `Focus: ...` on its report card line - including the built-in `suggest the visual style` and `copy lighting and mood` cards, which ship focuses of their own. +- The V10 recipe overrides resolve on the V10 card: `copy lighting and mood` resolves to `strong blur` (not the V9 palette wash) and `copy big shapes only` resolves the structure-only layer table. - The Recipe Builder is served at `/extensions//recipe-builder.html` and its downloaded files validate (drop one in `custom_recipes/`, refresh node definitions, confirm it appears). ## V10 Demo Renders (release checklist) diff --git a/web/recipe-builder.html b/web/recipe-builder.html index b022bcd..85a47d6 100644 --- a/web/recipe-builder.html +++ b/web/recipe-builder.html @@ -230,13 +230,16 @@