tapin~
MSP Reference
Open Help

tapin~

Input to a delay line

Description

tapin~ receives a signal in and copies into a delay line. Using tapout~ objects, you can read from the delay line at various delay times. You must connect the outlet of a tapin~ object to the tapout~ objects you want to use with the delay line. Note that this is not a signal connection, since no signal travels between the objects. It is merely a way to indicate that the objects share the same delay memory.

Examples

tapin~ creates a delay buffer from which to tap delayed signal

Arguments

maximum-delay [number]

Optional
Unitsms

The maximum delay time in milliseconds. This determines the size of the delay line memory. If the sampling rate is increased after the object has been created, tapin~ will attempt to resize the delay line. If no argument is present, the default maximum delay time is 100 milliseconds.

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

int

Arguments

memory-size [int]
In left inlet: An int resizes the delay line memory with the new maximum delay time specified in milliseconds (this clears the memory of the delay line, which may produce a click in the output).

float

Arguments

memory-size [float]
In left inlet: A float resizes the delay line memory with the new maximum delay time specified in milliseconds (this clears the memory of the delay line, which may produce a click in the output).

clear

Clears the memory of the delay line (which may produce a click in the output).

freeze

Arguments

behavioral-flag (0 or nonzero) [int]
The word freeze followed by a non-zero number will cause tapin~ to freeze its buffer memory. This means the object will keep echoing out of its output what has already been recorded into its memory at the point of freezing and no further input will be recorded. The word freeze followed by a 0 will reset the object to its default state of constantly recording and rerecording any given input into its memory buffer and outputting it after the specified delay time.

signal

The signal is written into a delay line that can be read by the tapout~ object.

Output

tap

In order for the delay line to function, the outlet of tapin~ must be connected to the left inlet of tapout~. It cannot be connected to any other object.

See Also

Name Description
delay~ Delay a signal
tapout~ Output from a delay line
MSP Delay Tutorial 1: Delay Lines MSP Delay Tutorial 1: Delay Lines
MSP Delay Tutorial 2: Delay Lines with Feedback MSP Delay Tutorial 2: Delay Lines with Feedback
MSP Delay Tutorial 4: Flanging MSP Delay Tutorial 4: Flanging