ComfyUI Node: 📑 CR Simple Prompt Scheduler

📑 CR Simple Prompt Scheduler:

The CR Simple Prompt Scheduler is designed to facilitate the scheduling of prompts in animation workflows, allowing you to define and manage prompt transitions over time. This node is particularly useful for AI artists who want to create dynamic and evolving animations by specifying different prompts at various keyframes. The scheduler can handle simple schedules and convert formats if necessary, ensuring that your prompts are applied correctly at the designated frames. By using this node, you can achieve smooth transitions and maintain control over the prompt changes throughout your animation sequence.

📑 CR Simple Prompt Scheduler Input Parameters:

mode

The mode parameter determines the operational mode of the scheduler. It can be set to "Default Prompt", "Keyframe List", or "Schedule". Each mode dictates how the scheduler processes the prompts and keyframes. For example, "Default Prompt" uses a single prompt throughout, while "Keyframe List" and "Schedule" modes allow for more complex scheduling based on provided keyframes or schedules. The default value is "Default Prompt".

keyframe_list

The keyframe_list parameter is a string containing keyframes, each on a new line. This list defines the specific frames and corresponding prompts to be used in the animation. If the keyframe_list is empty, the scheduler will not function correctly. This parameter is essential when the mode is set to "Keyframe List". There is no default value, and it must be provided by the user.

schedule

The schedule parameter is a list of tuples, each containing a schedule alias and a line defining the prompt and frame. This parameter is used when the mode is set to "Schedule". If the schedule is not provided, the scheduler will not function correctly. There is no default value, and it must be provided by the user.

schedule_format

The schedule_format parameter specifies the format of the schedule or keyframe list. It can be set to "Deforum" or "CR". This parameter ensures that the scheduler can correctly interpret and convert the provided schedule or keyframe list. The default value is "CR".

current_frame

The current_frame parameter is an integer representing the current frame of the animation. This parameter is used to determine which prompt should be applied at the current point in the animation. There is no default value, and it must be provided by the user.

prepend_text

The prepend_text parameter is a string that will be added to the beginning of each prompt. This allows for additional context or instructions to be included with each prompt. The default value is an empty string.

append_text

The append_text parameter is a string that will be added to the end of each prompt. This allows for additional context or instructions to be included with each prompt. The default value is an empty string.

interpolate_prompt

The interpolate_prompt parameter determines whether the prompts should be interpolated between keyframes. It can be set to "Yes" or "No". If set to "Yes", the scheduler will calculate a weighted prompt based on the current frame's position between keyframes. The default value is "No".

📑 CR Simple Prompt Scheduler Output Parameters:

current_prompt_out

The current_prompt_out parameter is the prompt that should be applied at the current frame. It includes any prepend or append text specified by the user. This output is crucial for ensuring that the correct prompt is used at each point in the animation.

next_prompt_out

The next_prompt_out parameter is the prompt that will be applied at the next keyframe. It includes any prepend or append text specified by the user. This output helps in understanding the upcoming prompt transition.

weight_out

The weight_out parameter is a float value representing the interpolation weight between the current and next keyframes. This value is used to blend prompts smoothly if interpolation is enabled. A weight of 1.0 indicates no interpolation.

show_help

The show_help parameter provides a URL to the documentation for the CR Simple Prompt Scheduler. This output is useful for users who need additional information or guidance on using the node.

📑 CR Simple Prompt Scheduler Usage Tips:

• Ensure that your keyframe_list or schedule is correctly formatted and non-empty to avoid errors.
• Use the prepend_text and append_text parameters to add consistent context or instructions to all prompts.
• Set the interpolate_prompt parameter to "Yes" for smooth transitions between prompts, especially in animations with gradual changes.
• Refer to the show_help URL for detailed documentation and examples to maximize the node's potential.

📑 CR Simple Prompt Scheduler Common Errors and Solutions:

No keyframe list found.

• Explanation: This error occurs when the keyframe_list parameter is empty or not provided.
• Solution: Ensure that you provide a non-empty keyframe_list with correctly formatted keyframes.

No schedule found.

• Explanation: This error occurs when the schedule parameter is not provided or is empty.
• Solution: Ensure that you provide a valid schedule with correctly formatted entries.

No prompt found for frame. Simple schedules must start at frame 0.

• Explanation: This warning indicates that there is no prompt defined for the current frame, and the schedule does not start at frame 0.
• Solution: Ensure that your schedule or keyframe_list includes a prompt for frame 0 to avoid this issue.

Invalid keyframe at frame <current_frame>

• Explanation: This warning occurs when the keyframe cannot be parsed correctly, possibly due to incorrect formatting.
• Solution: Check the formatting of your keyframes and ensure they are correctly specified according to the expected format.