multirange Reference

Graphical function breakpoint editor

multirange

Description

multirange is designed to work with mc.evolve~ and mc.gradient to set their breakpoints

Arguments

None.

Attributes

bgcolor [4 floats]

Sets the background color of the multirange objects display panel in the RGBA format.

color [4 floats]

Sets the color of the breakpoint and bar elements in the RGBA format.

domain [float] (default: 1.)

Sets the maximum displayed X value, then modifies the X values of all breakpoints so that they remain in the same place given the new domain.

elementcolor [4 floats]

Sets the color of the regions between breakpoints and bar elements in the RGBA format.

legend [int] (default: 1)

Toggles the numerical display (legend) of the multirange object, displayed when a point is highlighted or updated.

parameter_enable [int]

Enables use of this object with Max for Live Parameters and allows for setting initial parameter values in the Max environment.

parameter_mappable [int] (default: 1)

When parameter_mappable is enabled, the object will be available for mapping to keyboard or MIDI input using the Mappings feature.

range [2 floats] (default: 0. 1.)

Sets the minimum and maximum display ranges for Y and phase values.

style [symbol] (default: )

Sets the style to be applied to the object. Styles can be set using the Format palette.

textcolor [4 floats]

Sets the display color for text in RGBA format.

Common Box Attributes

Parameter Attributes

Messages

bang

Outputs a series of multi-element lists out the middle-left outlet. The first three lists are the inital breakpoint's phase, y2 and y1 values. The next three contain the phase, y2 and y1 values for all subsequent breakpoints.

int

Arguments

lookup [int]
Sending a value within the multirange object's domain returns a list with the y1, y2 and phase at that x position.

float

Arguments

lookup [float]
Sending a value within the multirange object's domain returns a list with the y1, y2 and phase at that x position.

list

Arguments

x-value [number]
y2-value [number]
y1-value [number]
phase [number]
Creates a new breakpoint at the specified x-position. If the list contains only three values, the phase is set to the average of the y1 and y2 values. An optional 4th value can be used to speficy the phase value.

A list with 5 values modifies the breakpoint at the index specified by the first list element (beginning with 0).

clear

The word clear by itself erases all existing breakpoints. The word clear can also be followed by one or more breakpoint indices (starting at 0) to clear selected breakpoints.

dump

Arguments

receive-name [symbol]
Outputs a series of multiple element lists describing each break point out the multirange object's middle-right outlet. Each list contains the breakpoints X, Y1, Y2 and phase values. An optional symbol argument can be used to specify a receive objects as a destination.

listdump

Arguments

receive-name [symbol]
Outputs a single list which contains all X, Y and phase values for each of the breakpoints out the multirange object's middle-right outlet. An optional symbol argument can be used to specify a receive objects as a destination.

(mouse)

You can use the mouse to add breakpoints to the multirange function; the finished function can then be sent to a mc.evolve~ or mc.gradient~ object for use as a control signal in MSP. The X, Y1, Y2 and phase values of the breakpoint are displayed in the upper part of the object’s box.
Clicking on empty space in the function adds a breakpoint at the current X position, which you can begin to move immediately by dragging.
Clicking on the bar connecting the Y1 and Y2 nodes and dragging allows you to change the X position of the breakpoint.
Clicking on either y point of a breakpoint allows you to adjust the value by dragging.
Shift-clicking on a breakpoint deletes that point from the function. Command-clicking on Macintosh or Control-clicking on Windows on a breakpoint toggles the sustain property of the point. Sustain points are outlined in white. Whenever an editing operation with the mouse is completed, a bang is sent out the right outlet.
Points with a Y value of 0 are outlined circles; other points are solid. This allows you to see at a glance whether a function starts or ends at Y = 0.

See Also

Name Description
MC MC
mc.evolve~
mc.function
mc.gradient~
mc.range~
MC MC