ComfyUI Node: 💜 Compositor Transforms Output (V3)

💜 Compositor Transforms Output (V3):

The CompositorTransformsOutV3 node is designed to extract and output specific transformation details from a given set of image transformations. This node is particularly useful for AI artists who need precise control over image manipulation and compositing tasks. By processing transformation data, it provides essential parameters such as position, dimensions, and rotation angle of the transformed image, as well as the bounding box details. This allows for accurate and consistent application of transformations across different images or layers, ensuring that the final composite image meets the desired specifications.

💜 Compositor Transforms Output (V3) Input Parameters:

transforms

This parameter expects a JSON string containing the transformation data. The data should include details about padding, transforms, and bounding boxes. The node will parse this string to extract the necessary transformation details. This parameter is required and must be provided for the node to function correctly.

channel

This integer parameter specifies which channel's transformation data to use. Channels are indexed starting from 1, and you can select any channel between 1 and 8. The default value is 1. Adjusting this parameter allows you to target specific channels for transformation extraction, which is useful when working with multi-channel images.

forceInt

This boolean parameter determines whether the output values should be forced to integers. When set to True, all output values will be converted to integers, ensuring that the transformation details are in whole numbers. The default value is True. This can be particularly useful when precise pixel values are required for further processing or when working with systems that do not handle floating-point values well.

💜 Compositor Transforms Output (V3) Output Parameters:

x

This output parameter represents the x-coordinate of the top-left corner of the transformed image, adjusted for padding. It indicates the horizontal position of the image after transformation.

y

This output parameter represents the y-coordinate of the top-left corner of the transformed image, adjusted for padding. It indicates the vertical position of the image after transformation.

width

This output parameter represents the width of the transformed image, calculated by multiplying the original width by the scale factor in the x-direction.

height

This output parameter represents the height of the transformed image, calculated by multiplying the original height by the scale factor in the y-direction.

angle

This output parameter represents the rotation angle of the transformed image. It indicates how much the image has been rotated from its original orientation.

bbox x

This output parameter represents the x-coordinate of the top-left corner of the bounding box, adjusted for padding. It indicates the horizontal position of the bounding box after transformation.

bbox y

This output parameter represents the y-coordinate of the top-left corner of the bounding box, adjusted for padding. It indicates the vertical position of the bounding box after transformation.

bbox width

This output parameter represents the width of the bounding box. It indicates the horizontal extent of the bounding box after transformation.

bbox height

This output parameter represents the height of the bounding box. It indicates the vertical extent of the bounding box after transformation.

💜 Compositor Transforms Output (V3) Usage Tips:

• Ensure that the transforms parameter is a correctly formatted JSON string to avoid parsing errors.
• Use the channel parameter to target specific channels when working with multi-channel images, allowing for precise control over individual transformations.
• Set the forceInt parameter to True if you need integer values for further processing or compatibility with other systems.

💜 Compositor Transforms Output (V3) Common Errors and Solutions:

Invalid JSON string in transforms

• Explanation: The transforms parameter contains a JSON string that is not correctly formatted.
• Solution: Verify that the JSON string is correctly formatted and includes all necessary fields such as padding, transforms, and bboxes.

Channel index out of range

• Explanation: The specified channel parameter is outside the valid range of 1 to 8. - Solution: Ensure that the channel parameter is set to a value between 1 and 8.

Missing required fields in transforms

• Explanation: The JSON string in the transforms parameter is missing required fields such as padding, transforms, or bboxes.
• Solution: Check the JSON string to ensure all required fields are present and correctly named.

TypeError when forceInt is True

• Explanation: The node encountered a type error when converting values to integers.
• Solution: Ensure that the transformation data contains numeric values that can be converted to integers.