Package MSP

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.

Arguments

maximum-delay[number]ms
optional

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

Below is a list of attributes shared by all objects. If you want to change one of these attributes for an object based on the object box, you need to place the word sendbox in front of the attribute name, or use the object's Inspector.

annotation[symbol]

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

background[int]: 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]: 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]: 0

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

jspainterfile[symbol]

You can override the default appearance of a user interface object by assigning a JavaScript file with code for painting the object. The file must be in the search path.

patching_rect[4 floats]: 0. 0. 100. 0.

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

position[2 floats]
write-only

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]: 0

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

presentation_rect[4 floats]: 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]
write-only

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]
write-only

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[4 floats]

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

textjustification[int]

Sets the justification for the object's text. 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

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).

Arguments:
  • memory-size [int]

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).

Arguments:
  • memory-size [float]

clear

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

freeze

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.

Arguments:
  • behavioral-flag (0 or nonzero) [int]

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