ComfyUI Node: Prompt Sequence Builder (Advanced)

Prompt Sequence Builder (Advanced):

The mbmPromptSequenceBuilderAdv node is an advanced tool designed to facilitate the creation of a sequence of prompts, specifically tailored for use in music visualization contexts. This node extends the capabilities of the basic PromptSequenceBuilder by incorporating additional features that allow for more complex and nuanced prompt sequences. It is particularly beneficial for AI artists looking to synchronize visual elements with musical cues, as it enables the integration of time-based data into the prompt sequence. By leveraging this node, you can create dynamic and responsive visualizations that evolve in tandem with the audio input, enhancing the overall artistic expression and engagement.

Prompt Sequence Builder (Advanced) Input Parameters:

positive_1

This parameter represents the primary set of positive conditioning data, which is crucial for defining the initial state of the prompt sequence. It accepts a list of lists containing either torch.Tensor objects or dictionaries with torch.Tensor values. This data influences the positive aspects of the generated prompts, shaping the visual output in a favorable direction. There are no explicit minimum, maximum, or default values provided, but it is essential to ensure that the data is structured correctly to avoid errors.

negative_1

Similar to positive_1, this parameter is used to input the primary set of negative conditioning data. It also accepts a list of lists containing torch.Tensor objects or dictionaries with torch.Tensor values. This data serves to counterbalance the positive conditioning, allowing for a more refined and controlled prompt sequence. Proper structuring of this data is crucial for achieving the desired visual effects.

timecode_1

This parameter is a float value representing the timecode associated with the first set of conditioning data. It is used to synchronize the prompt sequence with specific moments in the music track. The value must be greater than or equal to 0.0, as negative timecodes are not allowed. This parameter is essential for aligning visual changes with musical beats or transitions.

positive_2

This optional parameter allows for the inclusion of a secondary set of positive conditioning data, providing additional flexibility in shaping the prompt sequence. It follows the same format as positive_1 and can be used to introduce variations or transitions in the visual output. If not provided, the node will only utilize the primary conditioning data.

negative_2

This optional parameter functions similarly to positive_2, but for negative conditioning data. It provides an additional layer of control over the prompt sequence, enabling more complex visual dynamics. Like positive_2, it is optional and can be omitted if not needed.

timecode_2

This optional float parameter represents the timecode for the secondary set of conditioning data. It allows for further synchronization of the prompt sequence with the music track, enabling more intricate timing adjustments. The value must be greater than or equal to 0.0, and it defaults to 0.0 if not specified.

prompts

This optional parameter accepts a list of MbmPrompt objects, which represent pre-defined prompts to be included in the sequence. It provides a way to incorporate existing prompts into the sequence, offering additional customization options. If not provided, the node will generate prompts based on the conditioning data alone.

Prompt Sequence Builder (Advanced) Output Parameters:

PROMPTS

The output of this node is a list of MbmPrompt objects, collectively referred to as PROMPTS. This output represents the complete sequence of prompts generated by the node, each enriched with time-based data and conditioning influences. The PROMPTS output is crucial for driving the visual elements in a music visualization project, as it encapsulates the dynamic and responsive nature of the sequence.

Prompt Sequence Builder (Advanced) Usage Tips:

• Ensure that your conditioning data is well-structured and accurately reflects the visual elements you wish to emphasize or de-emphasize in your project.
• Utilize the timecode parameters to precisely align visual changes with key moments in your music track, enhancing the overall synchronization and impact of your visualization.
• Experiment with different combinations of positive and negative conditioning data to achieve a balanced and aesthetically pleasing visual output.

Prompt Sequence Builder (Advanced) Common Errors and Solutions:

ValueError: Timecodes must be >= 0.0.

• Explanation: This error occurs when one or both of the timecode parameters (timecode_1 or timecode_2) are set to a negative value.
• Solution: Ensure that all timecode values are non-negative, as negative timecodes are not supported by the node. Adjust your input values accordingly to resolve this issue.