Eve library

ISIS v2 Environment Tileset Pack Control-Conditioned Workflow Graph

Guide

Revision 1

On this page

Generated: 2026-02-28T11:59:13.564Z Checklist: MXA-0166 (ISIS2-00364) Asset Family: environment-tileset-pack Phase: Phase 4 | Milestone: M3 Launch (2026-07-27 to 2026-10-30)

Objective#

Define a control-conditioned workflow graph for environment-tileset-pack that supports depth/segmentation/canny constraints while preserving deterministic tile-atlas defaults.

Deterministic Defaults#

Setting Value
checkpointModel sd_xl_base_1.0.safetensors
seed 2026110404
width 2048
height 2048
steps 32
cfgScale 5.9
samplerName dpmpp_2m_sde
scheduler karras
denoise 1
depthControlModel control_v11f1p_sd15_depth.safetensors
segmentationControlModel control_v11p_sd15_seg.safetensors
cannyControlModel control_v11p_sd15_canny.safetensors
depthStrength 0.72
segmentationStrength 0.6
cannyStrength 0.66
batchSize 1
outputFormat png
outputChannels 4

Input Contract#

Input Type Required Default
depth_map image no n/a
segmentation_map image no n/a
canny_map image no n/a
use_depth_control boolean yes true
use_segmentation_control boolean yes false
use_canny_control boolean yes true
depth_strength float yes 0.72
segmentation_strength float yes 0.6
canny_strength float yes 0.66
tileset_theme enum yes temple-ruins
biome_context enum yes temperate-forest
architectural_style enum yes ornate-fantasy
tile_set_scope enum yes ground-wall-trim
tileable_axes enum yes xy
seam_blend_strategy enum yes hybrid-stitch
edge_transition_profile enum yes micro-detail-preserve
atlas_layout enum yes 4x4-2048
texel_density_class enum yes gameplay-standard
material_response_profile enum yes pbr-neutral
lighting_reference enum yes neutral-overcast
color_palette_profile string yes weathered sandstone, oxidized copper accents, muted moss greens, low-saturation neutrals
style_preset enum yes stylized
negative_prompt string no blurry, low resolution, visible seams, non-tileable motifs, broken edge continuity, stretched texels, noisy compression artifacts, duplicated structures, text, watermark, jpeg artifacts
seed integer yes 2026110404
width integer yes 2048
height integer yes 2048
steps integer yes 32
cfg_scale float yes 5.9

Graph Nodes#

Node ID Class Role Output Count
n1 LoadImage depth-control-input 2
n2 LoadImage segmentation-control-input 2
n3 LoadImage canny-control-input 2
n4 CheckpointLoaderSimple model-load 3
n5 ControlNetLoader depth-control-load 1
n6 ControlNetLoader segmentation-control-load 1
n7 ControlNetLoader canny-control-load 1
n8 CLIPTextEncode positive-conditioning 1
n9 CLIPTextEncode negative-conditioning 1
n10 ControlNetApply depth-control-apply 1
n11 ControlNetApply segmentation-control-apply 1
n12 ControlNetApply canny-control-apply 1
n13 EmptyLatentImage latent-init 1
n14 KSampler latent-sample 1
n15 VAEDecode image-decode 1
n16 SaveImage artifact-output 0

Graph Edges#

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

Topological Node Order#

n1 -> n13 -> n2 -> n3 -> n4 -> n5 -> n6 -> n7 -> n8 -> n10 -> n11 -> n12 -> n9 -> n14 -> n15 -> n16

Research Alignment#

Workflow Path Control Nodes
AnimateDiff with ControlNet libs/isis/workflows/src/workflows/video/animatediff-controlnet.json 3
HDRI Environment Map Generator libs/isis/workflows/src/workflows/texture/environment-map.json 0
3D Texture Generator libs/isis/workflows/src/workflows/texture/3d-texture.json 0

Acceptance Criteria#

  • Graph is acyclic and topologically sortable.
  • Depth/segmentation/canny control paths are explicitly represented through ControlNet loaders and apply nodes.
  • At least one control mode can be enabled per run without breaking deterministic sampler/model defaults.
  • Output contract aligns to MXA-0163 required output classes.
  • Tileset seam, atlas, and texel-density fields are first-class required inputs for controlled generation.

Traceability#

  • Checklist item: MXA-0166
  • Ticket key: ISIS2-00364
  • Source references:
    • docs/domains/isis/remediation-v2/ISIS_REMEDIATION_V2_TICKETS.json
    • docs/domains/isis/remediation-v2/ISIS_V2_ENVIRONMENT_TILESET_PACK_REQUIREMENTS_BRIEF.json
    • docs/domains/isis/remediation-v2/ISIS_V2_ENVIRONMENT_TILESET_PACK_BASELINE_WORKFLOW_GRAPH.json
    • docs/domains/isis/remediation-v2/ISIS_V2_ENVIRONMENT_TILESET_PACK_IMAGE_CONDITIONED_WORKFLOW_GRAPH.json
    • libs/isis/workflows/src/workflows/video/animatediff-controlnet.json
    • libs/isis/workflows/src/workflows/texture/environment-map.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_OUTPUT_PACKAGE_TAXONOMY.json
    • ISIS_TODOS_2.md