Eve library

ISIS v2 VFX Element Pack Image-Conditioned Workflow Graph

Guide

Revision 1

On this page

Generated: 2026-08-02T18:33:39.601Z Checklist: MXA-0417 (ISIS2-00615) Asset Family: vfx-element-pack Phase: Phase 4 | Milestone: M3 Launch (2026-07-27 to 2026-10-30)

Objective#

Define an image-conditioned vfx-element-pack workflow graph that applies style/composition references through IPAdapter while preserving deterministic compositing readiness and effect profile defaults.

Deterministic Defaults#

Setting Value
checkpointModel sd_xl_base_1.0.safetensors
adapterModel ip-adapter_sdxl.safetensors
promptTemplateId vfx-element-pack-image-conditioned-v1
styleProfileId vfx-element-pack-style-anchor-v1
colorScript ember-orange emission core, neutral smoke mids, cool blue edge falloff for additive comp separation
lensProfile vfx-element-35mm-comp-plate
seed 2026111702
width 1920
height 1080
steps 34
cfgScale 5.6
samplerName dpmpp_2m_sde
scheduler karras
denoise 1
referenceStrength 0.76
compositionStrength 0.58
batchSize 1
outputFormat png
outputChannels 4

Input Contract#

Input Type Required Default
style_reference_image image yes n/a
composition_reference_image image no n/a
use_composition_reference boolean yes false
reference_strength float yes 0.76
composition_strength float yes 0.58
effect_type enum yes smoke-plume
style_profile enum yes photoreal-cinematic
shot_context enum yes mid-shot
lighting_interaction_profile enum yes backlit-volumetric
medium_profile enum yes dense-smoke
motion_profile enum yes directional-sweep
element_density_profile enum yes balanced
turbulence_profile enum yes medium
emission_color_profile enum yes warm-ember
alpha_background_mode enum yes transparent
render_resolution_class enum yes 1080p
camera_lens_profile enum yes standard-35mm
compositing_intent string yes foreground/mid/background layer separability with clean alpha edges and stable luminance for comp stack blending
prompt_template_id string yes vfx-element-pack-image-conditioned-v1
style_profile_id string yes vfx-element-pack-style-anchor-v1
color_script string yes ember-orange emission core, neutral smoke mids, cool blue edge falloff for additive comp separation
lens_profile string yes vfx-element-35mm-comp-plate
negative_prompt string no matte fringing, edge halos, chroma spill, clipping, noisy compression artifacts, duplicate ghost trails, banding, text, watermark, jpeg artifacts
seed integer yes 2026111702
width integer yes 1920
height integer yes 1080
steps integer yes 34
cfg_scale float yes 5.6

Graph Nodes#

Node ID Class Role Output Count
n1 LoadImage style-reference-load 2
n2 LoadImage composition-reference-load 2
n3 CheckpointLoaderSimple model-load 3
n4 IPAdapterLoader adapter-load 1
n5 IPAdapterApply style-condition 1
n6 IPAdapterApply composition-condition 1
n7 CLIPTextEncode positive-conditioning 1
n8 CLIPTextEncode negative-conditioning 1
n9 EmptyLatentImage latent-init 1
n10 KSampler latent-sample 1
n11 VAEDecode image-decode 1
n12 SaveImage artifact-output 0

Graph Edges#

Edge ID From To
e1 n3:0 n5.model
e2 n4:0 n5.ipadapter
e3 n1:0 n5.image
e4 n5:0 n6.model
e5 n4:0 n6.ipadapter
e6 n2:0 n6.image
e7 n3:1 n7.clip
e8 n3:1 n8.clip
e9 n6:0 n10.model
e10 n7:0 n10.positive
e11 n8:0 n10.negative
e12 n9:0 n10.latent_image
e13 n10:0 n11.samples
e14 n3:2 n11.vae
e15 n11:0 n12.images

Topological Node Order#

n1 -> n2 -> n3 -> n4 -> n5 -> n6 -> n7 -> n8 -> n9 -> n10 -> n11 -> n12

Research Alignment#

Workflow Path LoadImage Nodes IPAdapter Nodes
HDRI Environment Map Generator libs/isis/workflows/src/workflows/texture/environment-map.json 0 0
AI Style Transfer libs/isis/workflows/src/workflows/utility/style-transfer.json 2 0
3D Texture Generator libs/isis/workflows/src/workflows/texture/3d-texture.json 0 0

Acceptance Criteria#

  • Graph is acyclic and topologically sortable.
  • Image conditioning path is explicit and includes style + optional composition references.
  • All deterministic defaults are explicitly set (seed, sampler, scheduler, checkpoint, adapter).
  • Output contract aligns to MXA-0415 required output classes.

Traceability#

  • Checklist item: MXA-0417
  • Ticket key: ISIS2-00615
  • Source references:
    • docs/domains/isis/remediation-v2/ISIS_REMEDIATION_V2_TICKETS.json
    • docs/domains/isis/remediation-v2/ISIS_V2_VFX_ELEMENT_PACK_REQUIREMENTS_BRIEF.json
    • docs/domains/isis/remediation-v2/ISIS_V2_VFX_ELEMENT_PACK_BASELINE_WORKFLOW_GRAPH.json
    • libs/isis/workflows/src/workflows/texture/environment-map.json
    • libs/isis/workflows/src/workflows/utility/style-transfer.json
    • libs/isis/workflows/src/workflows/texture/3d-texture.json
    • docs/domains/isis/remediation-v2/ISIS_V2_CONTROL_TAXONOMY.json
    • docs/domains/isis/remediation-v2/ISIS_V2_WORKFLOW_AUTHORING_GUIDE.json
    • ISIS_TODOS_2.md