TTP_CoordinateSplitter Node Documentation

Overview

The TTP_CoordinateSplitter node is a component within the broader ComfyUI ecosystem, specifically designed for use with the TTPlanetPig Comfyui_TTP_Toolset. This node is categorized under "TTP/Conditioning" and is integral to workflows where the manipulation and understanding of image or canvas positions are needed.

The primary function of this node is to convert position information from other nodes into a structured list of coordinates. These coordinates are then used by subsequent processing steps to define areas of interest or sections for further manipulation.

Features

• Coordinate Conversion: This node takes position data, breaking it down into easily usable coordinates.
• Output Format: The coordinates are provided in a tuple format comprising x, y, width, and height.
• Error Handling: It ensures each set of input data contains exactly four values, raising an error if this condition is not met.

Inputs

The TTP_CoordinateSplitter node accepts the following input:

• Positions: A list of position tuples. Each tuple should consist of four integer or float values representing the top-left and bottom-right corners of a rectangle: (x, y, x2, y2).

Outputs

This node generates the following output:

• Coordinates: A list of tuples, where each tuple contains four elements: (x, y, width, height). These tuples are derived from the input positions, with width calculated as the difference between x2 and x, and height as the difference between y2 and y.

Usage in ComfyUI Workflows

The TTP_CoordinateSplitter node is particularly useful in workflows that involve:

• Image Tiling and Reconstruction: It aids in dividing an image or a canvas into sections that can be processed independently and possibly reconstructed later.
• Region-Based Processing: By delineating specific areas of an image or canvas, further processing steps can be applied selectively.
• Conditioning Application: When certain processing conditions need to be applied to distinct areas within a ComfyUI workflow, this node helps in setting the exact boundaries for those conditions.

Special Features and Considerations

• Exact Input Validation: The node is robust in handling its inputs. It checks to ensure that each position set contains precisely four numbers, providing a safeguard against malformed data.
• Flexible Application: The node's output can be fed into other complex nodes, such as those that apply unique processing or effects to different sections of an image.

By incorporating the TTP_CoordinateSplitter node, users can more efficiently manage spatial data within the ComfyUI environment, allowing for enhanced control over image and data manipulation in creative workflows.