ComfyUI Node: Integer Motion Controller 🕒🅡🅣🅝

Integer Motion Controller 🕒🅡🅣🅝:

The IntegerMotionController is a specialized node designed to process motion detection within regions of interest (ROIs) in real-time, outputting integer values based on detected motion. This node is particularly useful for applications where precise control and adjustments are needed in response to motion, such as interactive installations or dynamic visual effects. By converting motion data into integer values, it allows for seamless integration with systems that require discrete input values. The node's primary function is to detect motion and translate it into a controlled integer output, ensuring that the values remain within specified bounds and are adjusted according to a chosen rounding mode. This capability makes it an essential tool for artists and developers looking to incorporate motion-responsive elements into their projects.

Integer Motion Controller 🕒🅡🅣🅝 Input Parameters:

minimum_value

The minimum_value parameter sets the lowest possible integer output value that the node can produce. It ensures that the output does not fall below this threshold, providing a baseline for motion detection results. The default value is 0, and it can be adjusted to suit the specific needs of your project, ensuring that the output remains within a desired range.

maximum_value

The maximum_value parameter defines the highest possible integer output value. It acts as a ceiling for the output, preventing it from exceeding this limit. The default value is 100, allowing for a wide range of motion detection outputs. Adjusting this parameter can help tailor the node's response to the scale of motion you are working with.

starting_value

The starting_value parameter specifies the initial integer value that the node outputs before any motion is detected. This value serves as a starting point for the motion detection process, ensuring that the output begins from a known state. The default is set to 0, but it can be customized to align with your project's requirements.

rounding_mode

The rounding_mode parameter determines how floating-point results from motion detection are converted into integers. Options include rounding to the nearest integer, flooring (rounding down), ceiling (rounding up), or truncating (removing the decimal part). The default mode is ROUND, which rounds to the nearest integer. This parameter is crucial for controlling how precise or lenient the conversion from float to integer should be, impacting the smoothness and accuracy of the output.

Integer Motion Controller 🕒🅡🅣🅝 Output Parameters:

INT

The INT output represents the integer value derived from the motion detection process. This value is influenced by the detected motion within the specified ROIs and is adjusted according to the input parameters such as minimum and maximum values, as well as the rounding mode. It serves as a quantifiable measure of motion, which can be used to trigger or control other elements in your project.

MASK

The MASK output provides a binary mask that indicates the areas of the image where motion has been detected. This mask can be used for further processing or visualization, helping to identify which parts of the input image are contributing to the motion detection result. It is a valuable tool for debugging and refining the motion detection process.

Integer Motion Controller 🕒🅡🅣🅝 Usage Tips:

• To achieve smooth transitions in motion detection, carefully choose the rounding_mode that best fits your project's needs. For instance, using ROUND can provide a balanced approach, while FLOOR or CEIL might be more suitable for specific applications requiring consistent lower or upper bounds.
• Adjust the minimum_value and maximum_value parameters to match the scale of motion you expect in your project. This ensures that the output remains relevant and within a useful range, enhancing the responsiveness of your motion-based interactions.

Integer Motion Controller 🕒🅡🅣🅝 Common Errors and Solutions:

"ValueError: Invalid rounding mode"

• Explanation: This error occurs when an unsupported rounding mode is specified.
• Solution: Ensure that the rounding_mode parameter is set to one of the supported modes: ROUND, FLOOR, CEIL, or TRUNCATE.

"Output value out of bounds"

• Explanation: The calculated integer output exceeds the specified minimum_value or maximum_value.
• Solution: Verify that the minimum_value and maximum_value parameters are correctly set to encompass the expected range of motion detection results. Adjust them if necessary to prevent out-of-bounds errors.