Shape Data:
XIS_ShapeData is a powerful node designed to aggregate shape properties from multiple input ports, facilitating the processing and manipulation of shape data in a streamlined manner. This node automatically calculates the number of outputs based on the maximum number of input values, ensuring efficient data handling and processing. It is particularly beneficial for AI artists who need to manage complex shape data, as it simplifies the aggregation process by handling various properties such as position, scale, and skew. By consolidating these properties, XIS_ShapeData enables users to focus on creative tasks without getting bogged down by the intricacies of data management.
Shape Data Input Parameters:
position_x
This parameter represents the x-coordinate of the shape's position. It accepts floating-point numbers and supports list inputs, allowing for the specification of multiple positions. The x-coordinate determines the horizontal placement of the shape within the canvas, impacting its alignment and overall layout. There are no explicit minimum, maximum, or default values provided, but it is essential to ensure that the values are within the canvas boundaries to avoid rendering issues.
position_y
Similar to position_x, this parameter specifies the y-coordinate of the shape's position. It also accepts floating-point numbers and supports list inputs. The y-coordinate affects the vertical placement of the shape, influencing its positioning relative to other elements. As with position_x, there are no specific constraints on the values, but they should be chosen carefully to maintain the desired layout.
scale_x
This parameter controls the horizontal scaling of the shape. It accepts floating-point numbers, allowing users to adjust the width of the shape. A value greater than 1 will increase the width, while a value less than 1 will decrease it. Proper scaling is crucial for maintaining the visual balance of the composition.
scale_y
This parameter manages the vertical scaling of the shape, similar to scale_x. It accepts floating-point numbers to adjust the height of the shape. Consistent scaling between scale_x and scale_y is important to preserve the shape's proportions unless a deliberate distortion is desired.
skew_x
This parameter defines the horizontal skew of the shape, allowing for the creation of a slanted effect. It accepts floating-point numbers, which determine the degree of skew along the x-axis. Skewing can add a dynamic and interesting visual element to the composition.
skew_y
This parameter specifies the vertical skew of the shape, functioning similarly to skew_x. It accepts floating-point numbers to adjust the skew along the y-axis. Combining skew_x and skew_y can result in complex and visually appealing transformations.
transparent_bg
This boolean parameter determines whether the shape's background is transparent. A value of true enables transparency, allowing the shape to blend seamlessly with other elements, while false maintains an opaque background. This parameter is crucial for achieving specific visual effects and ensuring the shape integrates well with the overall design.
Shape Data Output Parameters:
shape_data_list
This output parameter is a list containing the aggregated shape properties. Each entry in the list represents a set of properties for a shape, including position, scale, skew, and transparency. The shape_data_list is essential for further processing and rendering, as it provides a comprehensive overview of the shape's attributes, enabling users to apply transformations and adjustments as needed.
Shape Data Usage Tips:
- Ensure that all input parameters are within the expected range to avoid unexpected behavior or rendering issues.
- Utilize the list input capability for position and scale parameters to efficiently manage multiple shapes and streamline the data aggregation process.
- Experiment with skew parameters to create dynamic and visually interesting compositions, but be mindful of maintaining the overall balance of the design.
Shape Data Common Errors and Solutions:
"Invalid input value"
- Explanation: This error occurs when one or more input parameters are outside the acceptable range or format.
- Solution: Double-check the input values to ensure they are within the expected range and format, particularly for position and scale parameters.
"Shape data aggregation failed"
- Explanation: This error indicates an issue with the aggregation process, possibly due to inconsistent input lengths.
- Solution: Verify that all input lists have consistent lengths and that each parameter is properly defined to ensure successful aggregation.
