Function append_guide_attention_entry

iclora_attention.py:22–53

Append a new guide attention entry to conditioning metadata. Called by guide-adding nodes after appending tokens. Args: conditioning: ComfyUI conditioning list. pre_filter_count: Token count for this guide (before grid_mask filtering). latent_shape: [F, H, W] of the

(
    conditioning,
    pre_filter_count,
    latent_shape,
    attention_strength=1.0,
    attention_mask=None,
)

def append_guide_attention_entry(
    conditioning,
    pre_filter_count,
    latent_shape,
    attention_strength=1.0,
    attention_mask=None,
):
    """Append a new guide attention entry to conditioning metadata.

    Called by guide-adding nodes after appending tokens.

    Args:
        conditioning: ComfyUI conditioning list.
        pre_filter_count: Token count for this guide (before grid_mask filtering).
        latent_shape: [F, H, W] of the pre-dilation guide latent.
        attention_strength: Scalar in [0, 1]. 1.0 = full attention (default).
        attention_mask: Optional pixel-space mask tensor, shape (1, 1, F, H, W).

    Returns:
        Updated conditioning.
    """
    existing_entries = _get_guide_attention_entries(conditioning)
    entries = [*existing_entries]
    entries.append(
        {
            "pre_filter_count": pre_filter_count,
            "strength": attention_strength,
            "pixel_mask": attention_mask,
            "latent_shape": latent_shape,
        }
    )
    return _set_guide_attention_entries(conditioning, entries)


def normalize_mask(mask):