mc.generate~ Reference

Generate Values for a Range of Channels

mc.generate~

Description

The mc.generate~ object allows signal-rate updating of MC Wrapper features such as deviate, spread, and harmonic as a trigger signal or parameter inputs change. One wrapper message is assigned as an operator.

Arguments

initial-parameter-1 [float]

Optional

Initial value for parameter 1

initial-parameter-2 [float]

Optional

Initial value for parameter 2

initial-parameter-3 [float]

Optional

Initial value for parameter 3

Attributes

chans [int]

The chans attribute sets the number of channels in the output multi-channel signal. If the chans attribute is changed while the audio is on, the number of channels will change when the audio is restarted.

op [symbol]

Use op to select the operator used to generate values. Possible values are deviate, increment, spread, spreadinclusive, spreadexclusive, spreadincludesecond, spreadincludefirst, harmonic, subharmonic, exponential, scaledexponential, and decide. For information on these operators, see the MC Wrapper Messages guide. Possible values:

'decide'
'deviate'
'ease.in_back'
'ease.in_bounce'
'ease.in_circular'
'ease.in_cubic'
'ease.in_elastic'
'ease.in_exponential'
'ease.in_out_back'
'ease.in_out_bounce'
'ease.in_out_circular'
'ease.in_out_cubic'
'ease.in_out_elastic'
'ease.in_out_exponential'
'ease.in_out_quadratic'
'ease.in_out_quartic'
'ease.in_out_quintic'
'ease.in_out_sine'
'ease.in_quadratic'
'ease.in_quartic'
'ease.in_quintic'
'ease.in_sine'
'ease.linear'
'ease.out_back'
'ease.out_bounce'
'ease.out_circular'
'ease.out_cubic'
'ease.out_elastic'
'ease.out_quadratic'
'ease.out_quartic'
'ease.out_quintic'
'ease.out_sine'
'exponential'
'harmonic'
'increment'
'randomrange'
'scaledexponential'
'smoothstep'
'spread'
'spreadexclusive'
'spreadincludefirst'
'spreadincludesecond'
'spreadinclusive'
'subharmonic'

p1 [float]

Sets the value of the first operator parameter

p2 [float]

Sets the value of the second operator parameter

p3 [float]

Sets the value of the third operator parameter

ramptime [float]

If the ramptime attribute is zero, the values of new operator calculations are output immediately and will be discontinuous with previous values. A non-zero ramptime specifies the number of milliseconds for the output signals to ramp to the newly calculated values. The new values are effectively delayed by the ramp time.

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.

jspainterfile [symbol]

JS Painter File

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 [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

Converted to float

float

A number in the second inlet sets value of the first parameter. A number in the third inlet sets the value of the second parameter. A number in the right inlet sets the third parameter.

signal

A signal in the left inlet triggers a calculation of the current operator. Signals in the other three inlets set parameter values.

See Also

Name Description
MC Messages to the Object Wrapper MC Messages to the Object Wrapper