pong Reference

Range limiting

pong

Description

Use the pong object to clip, fold, or wrap its input within the range of a low value and a high value.

Examples

pong limits the range of an input by folding it or wrapping it around an upper and lower threshold level

Arguments

low-value [float]

Optional

Default low range boundary

high-value [float]

Optional

Default high range boundary

Attributes

mode [symbol] (default: none)

Behaviour of limiting when input exceeds range. Options are clip, wrap, and fold.

Possible values:

'none'
'clip'
'wrap'
'fold'

range [2 floats]

The range within which to keep values. Values outside of this range will be subject to a limiting algorithm chosen by the mode attribute.

Common Box Attributes

Messages

int

Arguments

input [int]
Converted to float.

float

Arguments

input [float]
In left inlet: All incoming signal or float values which exceed the high or low value ranges specified by arguments to the pong object are either folded back into this range (i.e., values greater than one are reduced by one plus the amount that they exceed one, and negative values are handled similarly) or wrapped (i.e., values greater than one are reduced by two, and negative values are increased by two), according to the mode of the pong object.

In center or right inlet: The pong objects accepts low and high range values for the range outside of which folding occurs.

list

Arguments

input [float]
In left inlet: Lists of numbers are processed together as per the float entry.

See Also

Name Description
clip
pong~