Conditioning Stretch (Inspire) Node Documentation

Overview

The Conditioning Stretch (Inspire) node is a feature from the ComfyUI-Inspire-Pack designed to assist in the process of image upscaling within the ComfyUI environment. When images are upscaled, it is crucial to appropriately expand the conditioning areas so that the adjustments in scale are consistent. This node modifies the conditioning areas of images by specifying both the original resolution and the new resolution intended to be applied. It ensures the conditioned areas preserve their proportional sizes relative to the image dimensions during the scaling process.

Functionality

What This Node Does

The Conditioning Stretch (Inspire) node adjusts the conditioning areas in an image to accommodate for changes in resolution when upscaling. It specifically recalculates the dimensions of these areas based on the original dimensions of the image and the desired new dimensions.

Input Parameters

Required Inputs

• conditioning: This input requires conditioning data typically generated or used in generative workflows.

• resolutionX: The original width (in pixels) of the image before upscaling. It should be an integer, with acceptable values typically ranging from 64 to the maximum resolution supported by the system, in steps of 64.

• resolutionY: The original height (in pixels) of the image before upscaling. As with resolutionX, this value should be an integer between 64 and the system's maximum resolution, with steps of 64.

• newWidth: The intended new width of the image (in pixels). This influences how the conditioning areas need to be expanded.

• newHeight: The intended new height of the image (in pixels), which also affects the resizing of the conditioning areas.

Output

• CONDITIONING: The node outputs conditioned data where the conditioning areas have been recalibrated to reflect the changes in image resolution due to upscaling. This output is designed to seamlessly integrate with subsequent nodes that utilize conditioning data as part of their processing.

Usage in ComfyUI Workflows

The Conditioning Stretch (Inspire) node is particularly useful in workflows where images are being scaled up but maintain specific conditioned areas, such as distinct parts of an image that require focused attention or adjustments in generative models. By adjusting the conditioning areas, users ensure that the conditioned sections are appropriately scaled, preventing distortions or loss of definition in those areas.

Example Use Case:

1. Start with a conditioned image: Use any nodes that provide conditioning data as input to this node.
2. Define current and target resolutions: Set resolutionX and resolutionY to the image's current dimensions and newWidth and newHeight to the desired dimensions.
3. Connect outputs: Send the adjusted conditioning output from this node to subsequent processing steps in the workflow that handle the final image generation or further upscaling steps.

Special Features and Considerations

• Precision and Scaling: The node works by recalculating dimensions based on precise mathematical scaling, ensuring the areas maintain consistency and proportion relative to their new settings.
• Automatic Adjustment: The node automates the recalibration of conditioning areas, removing the need for manual calculations and adjustments by users.
• Compatibility: Designed to integrate seamlessly with the Inspire Pack and other compatible ComfyUI nodes, ensuring flexibility across various workflows.
• Scalar Adjustment: While not directly modifiable in the inputs, a scalar can be applied internally to further scale up the newWidth and newHeight based on specific requirements.

The Conditioning Stretch (Inspire) node is a robust tool for managing conditioning area adjustments during upscaling tasks in ComfyUI, making it invaluable for tasks involving high-resolution image generation and modification workflows.