ComfyUI Node: OffsetMaskByNormalizedAmplitude

OffsetMaskByNormalizedAmplitude:

The OffsetMaskByNormalizedAmplitude node is designed to manipulate a mask image based on normalized amplitude values. This node is particularly useful for AI artists who want to create dynamic visual effects that respond to audio or other amplitude-based data. By adjusting the mask's position and rotation according to the amplitude values, you can achieve a variety of visual transformations that add a layer of interactivity and responsiveness to your artwork. The node ensures that the amplitude values are normalized within the range of 0 to 1, making it easier to control and predict the transformations. Whether you want to rotate the mask, shift it along the x or y axis, or both, this node provides a flexible and intuitive way to achieve these effects.

OffsetMaskByNormalizedAmplitude Input Parameters:

mask

The mask parameter is the input mask image that you want to transform. This image will be manipulated based on the normalized amplitude values to create the desired visual effect.

x

The x parameter controls the horizontal shift of the mask. It determines how much the mask will move along the x-axis based on the amplitude values. The value should be a float, with 0 meaning no shift and higher values resulting in more significant shifts.

y

The y parameter controls the vertical shift of the mask. It determines how much the mask will move along the y-axis based on the amplitude values. The value should be a float, with 0 meaning no shift and higher values resulting in more significant shifts.

angle_multiplier

The angle_multiplier parameter is used to scale the rotation angle of the mask. It multiplies the normalized amplitude values to determine the rotation angle in degrees. A higher multiplier will result in more significant rotations.

rotate

The rotate parameter is a boolean that determines whether the mask should be rotated based on the amplitude values. If set to True, the mask will be rotated; if set to False, no rotation will occur.

normalized_amp

The normalized_amp parameter is an array of normalized amplitude values within the range of 0 to 1. These values are used to control the transformations applied to the mask, such as shifting and rotating.

OffsetMaskByNormalizedAmplitude Output Parameters:

offsetmask

The offsetmask parameter is the transformed mask image. This output reflects the changes made based on the input parameters and normalized amplitude values, providing a dynamically altered mask that can be used in further processing or as a final visual element.

OffsetMaskByNormalizedAmplitude Usage Tips:

• To create subtle shifts in the mask, use small values for the x and y parameters.
• For more dramatic effects, increase the angle_multiplier to amplify the rotation based on the amplitude values.
• Combine both shifting and rotating by setting rotate to True and adjusting the x, y, and angle_multiplier parameters for complex transformations.
• Ensure your normalized_amp values are correctly normalized between 0 and 1 for predictable and controlled transformations.

OffsetMaskByNormalizedAmplitude Common Errors and Solutions:

"ValueError: normalized_amp values out of range"

• Explanation: This error occurs when the normalized_amp values are not within the range of 0 to 1. - Solution: Ensure that all values in the normalized_amp array are clipped or normalized to be within the range of 0 to 1 before passing them to the node.

"TypeError: mask is not a valid image tensor"

• Explanation: This error occurs when the mask parameter is not a valid image tensor.
• Solution: Verify that the mask input is a properly formatted image tensor before using it with the node.

"IndexError: batch size mismatch"

• Explanation: This error occurs when the batch size of the mask does not match the length of the normalized_amp array.
• Solution: Ensure that the batch size of the mask image tensor matches the length of the normalized_amp array to avoid this error.