offer
Max Reference
Open Help

offer

Store one-time number pairs

Description

Store two ints as an x, y pair, and access them by x value. When a pair is retrieved, it is deleted from the collection.

Examples

A pair of numbers can be stored, then recalled a single time

Discussion

offer was designed for use with algorithms that transform the pitch of an incoming note stream. By storing the original and transformed note together (the transformed may be sent in the right inlet, immediately followed by the original, or they can be sent as a list) when the pitch of the note-on is changed, the transformed pitch can be retrieved when the note-off is received.

Arguments

None.

Attributes

Common Box Attributes

annotation [symbol]

Sets the text that will be displayed in the Clue window when the user moves the mouse over the object.

background [int] (default: 0)

Adds or removes the object from the patcher's background layer. background 1 adds the object to the background layer, background 0 removes it. Objects in the background layer are shown behind all objects in the default foreground layer.

color [4 floats]

Sets the color for the object box outline.

fontface [int]

Sets the type style used by the object. The options are:

plain
bold
italic
bold italic

Possible values:

0 = 'regular'
1 = 'bold'
2 = 'italic'
3 = 'bold italic'

fontname [symbol]

Sets the object's font.

fontsize [float]

Sets the object's font size (in points).

Possible values:

'8'
'9'
'10'
'11'
'12'
'13'
'14'
'16'
'18'
'20'
'24'
'30'
'36'
'48'
'64'
'72'

hidden [int] (default: 0)

Toggles whether an object is hidden when the patcher is locked.

hint [symbol]

Sets the text that will be displayed in as a pop-up hint when the user moves the mouse over the object in a locked patcher.

ignoreclick [int] (default: 0)

Toggles whether an object ignores mouse clicks in a locked patcher.

patching_rect [4 floats] (default: 0. 0. 100. 0.)

Sets the position and size of the object in the patcher window.

position [2 floats]

g/s(set)

Sets the object's x and y position in both patching and presentation modes (if the object belongs to its patcher's presentation), leaving its size unchanged.

presentation [int] (default: 0)

Sets whether an object belongs to the patcher's presentation.

presentation_rect [4 floats] (default: 0. 0. 0. 0.)

Sets the x and y position and width and height of the object in the patcher's presentation, leaving its patching position unchanged.

rect [4 floats]

g/s(set)

Sets the x and y position and width and height of the object in both patching and presentation modes (if the object belongs to its patcher's presentation).

size [2 floats]

g/s(set)

Sets the object's width and height in both patching and presentation modes (if the object belongs to its patcher's presentation), leaving its position unchanged.

textcolor [float]

Sets the color for the object's text in RGBA format.

textjustification [int]

Text Justification

Possible values:

0 = 'left'
1 = 'center'
2 = 'right'

varname [symbol]

Sets the patcher's scripting name, which can be used to address the object by name in pattr, scripting messages to thispatcher, and the js object.

Messages

bang

bang will cause offer to output every y-value received since the last clear message was received (or since the last initialization).

int

Arguments

x [int]
In left inlet: The number specifies the x value of an x,y pair. If a y value has been received in the right inlet, the two numbers are stored together in offer; otherwise, offer looks for an x value that matches the incoming number, sends out the corresponding y value, then deletes the stored pair. If there is no x value stored in offer that matches the number received, offer does nothing.

  (inlet1)

Arguments

y-value [int]
In right inlet: The number specifies a y value to be stored in offer. The next x value (int) received in the left inlet causes the two numbers to be stored together as an x,y pair.

clear

In left inlet: Deletes the entire contents of offer.

Output

int

If the number received in the left inlet matches the x value of an x,y pair stored in offer, the corresponding y value is sent out and the stored pair is deleted.

See Also

Name Description
coll Store and edit a collection of data
funbuff Store pairs of numbers
table Store and edit an array of numbers