ComfyUI Node: FL YuE2 · Piano Roll

FL YuE2 · Piano Roll:

The FL_YuE2_ScoreEditor node is a powerful tool designed to facilitate the creation and editing of musical scores using a piano roll interface. This node allows you to draw, move, and resize melody notes, select chords, and preview melodies, making it an essential component for composing music in a user-friendly manner. It supports the import and editing of existing ABC scores, providing an advanced view for detailed score manipulation. The primary goal of this node is to streamline the music composition process by offering an intuitive interface that bridges the gap between traditional music notation and digital music production, enabling you to connect your compositions to further planning and rendering nodes within the FL YuE2 framework.

FL YuE2 · Piano Roll Input Parameters:

score_abc

The score_abc parameter is a string input that represents the musical score in YuE2-compatible ABC notation. This parameter allows you to input or edit the melody and chord structure of your composition using the piano roll interface. The default value is set to a predefined score, and it supports multiline input for complex compositions. This parameter is crucial for defining the musical content that will be processed and previewed by the node.

incoming_score_abc

The incoming_score_abc parameter is an optional string input that allows you to load a generated score for further editing. This parameter is particularly useful when you want to make adjustments to an existing composition without starting from scratch. It ensures that your edits persist until the upstream score changes, providing a seamless workflow for iterative music creation.

source_score_hash

The source_score_hash parameter is an optional string input that serves as a reference for the original score's hash. This parameter helps in verifying whether the incoming score has been altered, ensuring that any changes made are intentional and tracked. It is particularly useful for maintaining the integrity of the score during collaborative projects or when working with multiple versions of a composition.

FL YuE2 · Piano Roll Output Parameters:

score_abc

The score_abc output parameter is a string that represents the finalized musical score in ABC notation after editing. This output is crucial as it provides the updated composition that can be connected to other nodes for further processing, such as composing with full planning or rendering the music. It encapsulates all the modifications made during the editing session, ensuring that your creative input is accurately captured and ready for the next steps in the music production pipeline.

FL YuE2 · Piano Roll Usage Tips:

• Utilize the piano roll interface to experiment with different melodies and chord progressions, as it provides a visual and intuitive way to compose music.
• Take advantage of the ability to import existing ABC scores for editing, which can save time and provide a foundation for new compositions.
• Regularly preview your melody to ensure that the changes align with your creative vision and make adjustments as needed.

FL YuE2 · Piano Roll Common Errors and Solutions:

Expected a JSON object containing score_abc.

• Explanation: This error occurs when the input data is not formatted as a JSON object containing the score_abc key.
• Solution: Ensure that the input data is correctly structured as a JSON object with the score_abc key included.

Expected a score object.

• Explanation: This error arises when the input data does not conform to the expected structure for a score object.
• Solution: Verify that the input data is properly formatted as a score object, including all necessary keys and values.