ComfyUI Node: Batch Shake (mtb)

Batch Shake (mtb):

The Batch Shake (mtb) node is designed to apply a dynamic shaking effect to batches of images, adding a sense of motion and randomness to your visual content. This node is particularly useful for AI artists looking to introduce variability and a more organic feel to their image sequences. By manipulating parameters such as position, rotation, and frequency, you can achieve a wide range of shaking effects, from subtle vibrations to intense, erratic movements. The node leverages a combination of transformations to ensure that the shaking effect is both visually appealing and customizable, making it a powerful tool for enhancing the dynamism of your image batches.

Batch Shake (mtb) Input Parameters:

images

This parameter accepts a batch of images that you want to apply the shaking effect to. The images should be in a format that the node can process, typically as tensors or arrays.

position_amount_x

This parameter controls the amount of horizontal movement applied to the images. It is a float value with a default of 1.0, allowing you to adjust the intensity of the shake along the x-axis. The minimum value is not explicitly defined, but it should be a positive number to ensure meaningful movement.

position_amount_y

This parameter controls the amount of vertical movement applied to the images. Similar to position_amount_x, it is a float value with a default of 1.0, allowing you to adjust the intensity of the shake along the y-axis. The minimum value is not explicitly defined, but it should be a positive number to ensure meaningful movement.

rotation_amount

This parameter determines the degree of rotation applied to the images during the shake. It is a float value with a default of 10.0, allowing you to control how much the images rotate. The rotation adds an additional layer of dynamism to the shaking effect.

frequency

This parameter sets the frequency of the shaking effect. It is a float value with a default of 1.0 and a minimum value of 0.005. Higher values result in more rapid shaking, while lower values produce a slower, more gradual shake.

frequency_divider

This parameter allows you to divide the frequency of the shaking effect, providing finer control over the timing of the shake. It is a float value with a default of 1.0 and a minimum value of 0.005. Adjusting this parameter can help you achieve the desired rhythm and pacing of the shake.

octaves

This parameter specifies the number of octaves used in the noise function that generates the shaking effect. It is an integer value with a default of 1 and a minimum value of 1. Increasing the number of octaves adds complexity and detail to the shaking pattern.

seed

This parameter sets the seed for the random number generator used in the shaking effect. It is an integer value with a default of 0. Changing the seed value will produce different shaking patterns, allowing for variability in the effect.

Batch Shake (mtb) Output Parameters:

image

This output parameter provides the batch of images with the shaking effect applied. The images are transformed based on the input parameters, resulting in a dynamic and visually engaging sequence.

pos_x

This output parameter provides the horizontal translation values applied to each image in the batch. These values represent the amount of movement along the x-axis for each frame.

pos_y

This output parameter provides the vertical translation values applied to each image in the batch. These values represent the amount of movement along the y-axis for each frame.

rot

This output parameter provides the rotation values applied to each image in the batch. These values represent the degree of rotation for each frame, adding to the overall shaking effect.

Batch Shake (mtb) Usage Tips:

• To achieve a subtle shaking effect, use lower values for position_amount_x, position_amount_y, and rotation_amount.
• Experiment with different frequency and frequency_divider values to find the right balance for your specific use case.
• Use the seed parameter to generate different shaking patterns and add variability to your image sequences.
• Increasing the octaves parameter can add more complexity to the shaking effect, making it appear more natural and less repetitive.

Batch Shake (mtb) Common Errors and Solutions:

"Invalid image format"

• Explanation: The input images are not in a format that the node can process.
• Solution: Ensure that the images are provided as tensors or arrays compatible with the node's requirements.

"Frequency value too low"

• Explanation: The frequency or frequency_divider value is below the minimum allowed value of 0.005. - Solution: Increase the frequency or frequency_divider value to at least 0.005.

"Octaves value too low"

• Explanation: The octaves parameter is set below the minimum value of 1. - Solution: Set the octaves parameter to 1 or higher to ensure proper functioning of the noise function.

"Seed value not an integer"

• Explanation: The seed parameter is not an integer.
• Solution: Ensure that the seed parameter is set to an integer value.