clip Reference

Limit numbers to a certain range

clip

Examples

Numbers are always kept within the specified range

Arguments

minimum [number]

Optional

The minimum value is the lower limit to the range of output values allowed. If only one argument is present, it is used as both the minimum and maximum limit. If no argument is present, the minimum and maximum limit is 0.

maximum [number]

Optional

The maximum value is the upper limit to the range of output values allowed. If only one argument is present, it is used as both the minimum and maximum limit. If no argument is present, the minimum and maximum limit is 0.

Attributes

Common Box Attributes

Messages

int

Arguments

input [int]
The number is sent out the outlet, constrained within the minimum and maximum limits specified by the minimum and maximum limits. The clip object adapts the clipped output values to its input, so an integer input value will output an integer value regardless of the numeric type specified as an argument.

float

Arguments

input [float]
The number is sent out the outlet, constrained within the minimum and maximum limits. The clip object adapts the clipped output values to its input, so a floating point input value will output a floating point value regardless of the numeric type specified as an argument.

list

Arguments

input [list]
Each number in the list is constrained within the minimum and maximum limits, and the constrained numbers are sent out as a list.

set

Arguments

minimum/maximum [list]
The word set, followed by two numbers, resets the minimum and maximum limits.

Output

float

If the received number is a float, it is constrained within the specified minimum and maximum limits, then sent out the outlet as a float.

int

When an int is received in the inlet, it is constrained within the specified minimum and maximum limits, then sent out the outlet. If the received number is less than the minimum limit, the minimum value is sent out; if the received number is greater than the maximum limit, the maximum value is sent out.

list

When a list is received in the inlet, each number is constrained within the specified minimum and maximum limits, and the numbers are sent out as a list.

See Also

Name Description
Working with Video in Jitter Working with Video in Jitter
maximum
minimum
split
<
<=
>
>=