ComfyUI Node: Prompt Sequence Builder

Prompt Sequence Builder:

The mbmPromptSequenceBuilder is a specialized node designed to facilitate the creation of a sequence of prompts, particularly useful in the context of music visualization. This node allows you to construct a series of prompts that can be used to guide the generation of visual content in response to musical inputs. By leveraging the capabilities of this node, you can define both positive and negative conditioning prompts, which are essential for shaping the output in a desired manner. The node is built to handle complex prompt sequences, ensuring that each prompt is associated with specific timecodes, which can be crucial for synchronizing visual elements with musical beats or changes. This functionality is particularly beneficial for artists and creators looking to produce dynamic and responsive visualizations that align with audio tracks.

Prompt Sequence Builder Input Parameters:

positive_1

This parameter represents the primary positive conditioning input, which is a list of lists containing either torch.Tensor objects or dictionaries with torch.Tensor values. It is used to define the positive aspects or features that should be emphasized in the generated visual content. There are no specific minimum, maximum, or default values, as it depends on the content you wish to highlight.

negative_1

Similar to positive_1, this parameter is a list of lists containing either torch.Tensor objects or dictionaries with torch.Tensor values. It is used to specify the negative conditioning, which helps in de-emphasizing or avoiding certain features in the output. This parameter allows you to refine the visual output by reducing unwanted elements.

positive_2

This optional parameter functions like positive_1 but is used for additional positive conditioning. It allows for more complex prompt sequences by providing a secondary set of positive conditions. If not provided, the node will only use positive_1 for positive conditioning.

negative_2

This optional parameter is similar to negative_1 and is used for additional negative conditioning. It provides a secondary set of negative conditions, allowing for more nuanced control over the visual output. If not provided, the node will rely solely on negative_1 for negative conditioning.

prompts

This optional parameter is a list of MbmPrompt objects that represent a sequence of prompts. It allows you to input a pre-defined sequence of prompts, which can be used to guide the visual generation process. This parameter is useful for artists who have specific prompt sequences in mind.

Prompt Sequence Builder Output Parameters:

PROMPTS

The output of the node is a list of MbmPrompt objects, which represent the constructed sequence of prompts. This output is crucial for generating visual content that is synchronized with musical inputs, as each MbmPrompt object contains the necessary data to guide the visual generation process. The output sequence can be used in subsequent nodes or processes to create dynamic and responsive visualizations.

Prompt Sequence Builder Usage Tips:

• Ensure that your positive and negative conditioning inputs are well-defined to achieve the desired visual output. Experiment with different combinations to see how they affect the results.
• Utilize the optional positive_2 and negative_2 parameters for more complex prompt sequences, especially if you need to create intricate visualizations that change over time.
• When using the prompts parameter, prepare your sequence of MbmPrompt objects in advance to streamline the process and ensure consistency in your visual output.

Prompt Sequence Builder 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. Double-check your input values to confirm they meet this requirement.