69 lines
2.6 KiB
Markdown
69 lines
2.6 KiB
Markdown
|
|
# Custom CFG Keyframe 🎭🅐🅓
|
|
## Documentation
|
|
- Class name: ADE_CustomCFGKeyframe
|
|
- Category: Animate Diff 🎭🅐🅓/sample settings
|
|
- Output node: False
|
|
- Repo Ref: https://github.com/Kosinkadink/ComfyUI-AnimateDiff-Evolved.git
|
|
|
|
ADE_CustomCFGKeyframe节点旨在创建和管理Animate Diff框架内的自定义配置关键帧。它允许在动画时间线上指定各种动画参数，从而精确控制动画的行为和外观。
|
|
|
|
## Input types
|
|
### Required
|
|
- cfg_multival
|
|
- 定义关键帧的配置值，可以影响动画过程的各个方面。对于在特定时间段定制动画特性至关重要。
|
|
- Comfy dtype: MULTIVAL
|
|
- Python dtype: Union[float, torch.Tensor]
|
|
- start_percent
|
|
- 指定关键帧在动画时间线中的起始点，以百分比表示，允许精确的时间控制。
|
|
- Comfy dtype: FLOAT
|
|
- Python dtype: float
|
|
- guarantee_steps
|
|
- 确定应用关键帧配置的最小步数，确保一定的效果持续时间。
|
|
- Comfy dtype: INT
|
|
- Python dtype: int
|
|
|
|
### Optional
|
|
- prev_custom_cfg
|
|
- 通过指定先前的自定义配置组，允许自定义配置关键帧的链式连接，从而实现复杂的动画序列。
|
|
- Comfy dtype: CUSTOM_CFG
|
|
- Python dtype: CustomCFGKeyframeGroup or None
|
|
|
|
## Output types
|
|
- custom_cfg
|
|
- Comfy dtype: CUSTOM_CFG
|
|
- 输出一个封装了定义关键帧的自定义配置对象，准备集成到动画管道中。
|
|
- Python dtype: CustomCFGKeyframeGroup
|
|
|
|
## Usage tips
|
|
- Infra type: CPU
|
|
- Common nodes: unknown
|
|
|
|
## Source code
|
|
```python
|
|
class CustomCFGKeyframeNode:
|
|
@classmethod
|
|
def INPUT_TYPES(s):
|
|
return {
|
|
"required": {
|
|
"cfg_multival": ("MULTIVAL",),
|
|
"start_percent": ("FLOAT", {"default": 0.0, "min": 0.0, "max": 1.0, "step": 0.001}),
|
|
"guarantee_steps": ("INT", {"default": 1, "min": 0, "max": BIGMAX}),
|
|
},
|
|
"optional": {
|
|
"prev_custom_cfg": ("CUSTOM_CFG",),
|
|
}
|
|
}
|
|
|
|
RETURN_TYPES = ("CUSTOM_CFG",)
|
|
CATEGORY = "Animate Diff 🎭🅐🅓/sample settings"
|
|
FUNCTION = "create_custom_cfg"
|
|
|
|
def create_custom_cfg(self, cfg_multival: Union[float, Tensor], start_percent: float=0.0, guarantee_steps: int=1,
|
|
prev_custom_cfg: CustomCFGKeyframeGroup=None):
|
|
if not prev_custom_cfg:
|
|
prev_custom_cfg = CustomCFGKeyframeGroup()
|
|
prev_custom_cfg = prev_custom_cfg.clone()
|
|
keyframe = CustomCFGKeyframe(cfg_multival=cfg_multival, start_percent=start_percent, guarantee_steps=guarantee_steps)
|
|
prev_custom_cfg.add(keyframe)
|
|
return (prev_custom_cfg,) |