ComfyUI Node: Audioreactive Dynamic Dilate Mask | Akatz

Audioreactive Dynamic Dilate Mask | Akatz:

The AK_AudioreactiveDynamicDilationMask node is designed to dynamically alter the size of a mask based on audio amplitude, creating a visually engaging effect that synchronizes with sound. This node is particularly useful for AI artists looking to integrate audio-reactive elements into their visual projects. By adjusting the dilation of a mask in response to audio input, it allows for the creation of dynamic visuals that pulse or expand in time with music or other audio sources. The node supports different shapes for dilation, such as circles or squares, and offers a range of customization options to fine-tune the effect, including maximum and minimum radius settings, and a quality factor that influences the smoothness and detail of the dilation. This functionality is ideal for creating immersive experiences where visual elements respond to audio cues, enhancing the overall impact of the artwork.

Audioreactive Dynamic Dilate Mask | Akatz Input Parameters:

mask

The mask parameter represents the initial mask that will be dynamically dilated based on the audio input. It is a required input and must be of type MASK. This mask serves as the base layer that will be modified, and its initial shape and size will influence the final visual output.

normalized_amp

The normalized_amp parameter is a list or array of normalized amplitude values derived from an audio source. These values dictate the degree of dilation applied to the mask, with higher amplitudes resulting in larger dilations. This parameter must be of type NORMALIZED_AMPLITUDE or FLOAT, and it is crucial for synchronizing the visual effect with the audio input.

shape

The shape parameter determines the geometric shape used for the dilation effect. It can be set to either circle or square, allowing you to choose the visual style that best fits your project. The choice of shape affects how the mask expands and can be used to create different aesthetic effects.

max_radius

The max_radius parameter sets the maximum radius to which the mask can be dilated. It is an integer value with a default of 25, and it defines the upper limit of the dilation effect. Adjusting this parameter allows you to control the extent of the visual expansion in response to audio input.

min_radius

The min_radius parameter specifies the minimum radius for the dilation effect. It is an integer value with a default of 0, ensuring that the mask does not shrink below a certain size. This parameter is useful for maintaining a baseline visual presence even when audio amplitudes are low.

quality_factor

The quality_factor parameter influences the smoothness and detail of the dilation effect. It is a float value ranging from 0.0 to 1.0, with a default of 0.25. A higher quality factor results in more detailed and smoother dilations, while a lower value may produce a more pixelated effect. This parameter allows you to balance performance and visual quality.

Audioreactive Dynamic Dilate Mask | Akatz Output Parameters:

MASK

The output of the AK_AudioreactiveDynamicDilationMask node is a modified MASK that has been dynamically dilated based on the input audio amplitude. This output mask reflects the changes in size and shape dictated by the audio input, providing a visually dynamic element that can be used in various creative projects. The output is crucial for integrating audio-reactive visuals into your artwork, allowing for a seamless blend of sound and imagery.

Audioreactive Dynamic Dilate Mask | Akatz Usage Tips:

• Experiment with different max_radius and min_radius settings to achieve the desired level of visual impact. Larger maximum radii can create more dramatic effects, while smaller minimum radii ensure the mask remains visible even during quieter audio segments.
• Adjust the quality_factor to find the right balance between performance and visual detail. Higher quality factors provide smoother transitions but may require more computational resources.
• Use the shape parameter to switch between circular and square dilations, depending on the aesthetic you wish to achieve. Circular shapes can create organic, flowing visuals, while square shapes offer a more structured and geometric appearance.

Audioreactive Dynamic Dilate Mask | Akatz Common Errors and Solutions:

"normalized_amp must be an NORMALIZED_AMPLITUDE or FLOAT type"

• Explanation: This error occurs when the normalized_amp input is not of the expected type. The node requires this parameter to be either a NORMALIZED_AMPLITUDE or FLOAT.
• Solution: Ensure that the input provided for normalized_amp is correctly formatted as a list or array of normalized amplitude values. Check the data type and convert it if necessary.

"mask must be a MASK type"

• Explanation: This error indicates that the input provided for the mask parameter is not of the required MASK type.
• Solution: Verify that the input for the mask parameter is correctly formatted and of the MASK type. If necessary, convert or preprocess the input to match the expected format.