ComfyUI Node
EzFlex-MotionContext
Motion Context
EzFlex-MotionContext
- positive
- latent
- context_latent
- context_video_latent
- context_audio_latent
- timeplan
- timeplan
- positive
- latent
◄context_length22►
◄context_audio_length24►
◄follow_plantrue►
◄pin_next_headfalse►
◄modekeyframe►
CategoryEzFlex
Inputs (11)
| Name | Type | Default | Description |
|---|---|---|---|
| positive | CONDITIONING | — | |
| latent | LATENT | This segment's AV latent to be sampled (used for frame_count / shape check). | |
| context_length | INT | 220–200 | Frames of video to pin (= overlap + tolerance from the plan). H3 valid values = 17k+5 (5 / 22 / 39 / 56 ...). |
| context_audio_length | INT | 240–400 | Frames of audio to pin (0 = follow context_length automatically). The official example pairs 24 with video 22. When follow_plan is on, TimePlan's audio_context_length controls this. |
| follow_plan | BOOLEAN | true | When the `timeplan` port is wired, take context_length from the plan (overlap + tolerance) instead of the box above. Keeps pinning in sync with EzFlex-TimePlan. |
| pin_next_head | BOOLEAN | false | Experimental: when TimeLine re-runs this segment, also pin the NEXT segment's saved head latent at this segment's tail. |
| mode | COMBO | keyframe | keyframe = the previous tail becomes conditioning rows (model may reshape it); masked = copy the previous tail into THIS latent's prefix and freeze it (mask 0), so only the future is generated. |
| context_latentopt | LATENT | PREVIOUS segment's AV latent (EzFlex-LoopStart.valueK) - the data that gets pinned. Not wired = nothing pinned (first segment). | |
| context_video_latentopt | * | Optional split video latent. Overrides the video half of context_latent (feed from a sampler-side AV latent split). | |
| context_audio_latentopt | * | Optional split audio latent. Overrides the audio half of context_latent. | |
| timeplanopt | EZFLEX_TIMEPLAN | Plan object (EzFlex-TimePlan.timeplan). With follow_plan on, context_length is taken from plan.cur.overlapFrames + toleranceFrames so pinning always matches the planner. |
Outputs (3)
| Name | Type | Description |
|---|---|---|
| timeplan | EZFLEX_TIMEPLAN | — |
| positive | CONDITIONING | — |
| latent | LATENT | — |