Store and Recall Signal Values Associated with an Index The mc.chord~ object is something like a version of the Max coll object that generates audio signals. You can store lists (which you can think of as chords) of numbers associated with a unique index, then recall your lists with messages or signals. When recalled, list values are assigned to channels in a multi-channel signal according to one of several allocation modes. Cycling '74 MSP MC Input A signal connected to mc.chord~ recalls stored lists according to the current inputmode. You can also store or recall values using messages. TEXT_HERE List Values A multi-channel signal containing the values of the most recently recalled list. The assignment of list values to channels is set by the allocmode attribute. If offmode is set to zero, unused channels will be set to zero, otherwise they contain values from previously recalled lists. 1 if On, 0 if Off If a channel in the left outlet is currently allocated to a list value, the corresponding channel in the second outlet will be 1, otherwise it will be 0. Chord as a List When a stored list in mc.chord~ is recalled, it will be sent out the third outlet. The order of the list is the order the values were initially stored, which may not correpond to the order they appear in the channels of the left outlet depending on the current setting of allocmode. Last Index Recalled When a list is recalled, its index is sent out the right outlet. Channel Count An int supplied as an argument sets the initial output channel count. Output next chord bang outputs the next stored list as a multi-channel signal out the left outlet; repeated bang messages will cycle through all stored lists. Output list associated with index An int outputs the list associated with the number as a multi-channel signal out the left outlet. If no list was stored at this number, zero signals are output. Converted to int TEXT_HERE Store values list stores the items starting at the second value at an index specified by the first value. Example: 5 30 40 50 will store the list 30 40 50 at index 5. Clear all lists The clear message clears all lists stored in the object. To delete an individual list using its associated index, use delete. Delete a list associated with an index The word delete followed by an index deletes a list of values associated with that index. Replace all values When mc.chord~ receives a dictionary in the proper format, it will replace all stored lists with those in the dictionary. Data must be in the form of an array of dictionaries associated with the key data. Each dictionary has the key index with the index to associate with the list, followed by a list of values associated with the key values. Output matching lists based on signal values When inputmode is set to Lookup (0), the signal value is truncated to an integer. When this integer value changes, mc.chord~ checks whether it matches an index for a stored list; if so, it outputs the associated list as a multi-channel signal.
When inputmode is set to Increment Index (1), any change in the value of the input signal will cause the next stored list to be output in a cyclic fashion. Store values The word store followed by a list argument, stores the items in the list starting at the second value at an index specified by the first value. Example: store 5 30 40 50 will store the list 30 40 50 at index 5. Allocation Mode Determine how list values are allocated to channels Start at first channel WHen allocmode is set to Lowest (0), list items are output starting with the first item allocated to the first output channel. Start at last channel WHen allocmode is set to Highest (1), list items are output starting with the first item allocated to the last output channel, the second item to the second-to-last channel, etc. Assign to least recently used channels When allocmode is set to Cyclic (2), list items are assigned to least recently used channels in ascending order. Assign randomly When allocmode is set to Random (3), list items are assigned to randomly chosen channels. Busy Map Name Sets the name of a busy map (within an mc.noteallocator~ or mc.voiceallocator~ object)to use in determining channel allocation. When there is an active busy map (usebusymap is enabled), items will be assigned to channels accoding to the current allocmode but only non-busy channels will be used. The value none resets the busy map to the default busy map for the patcher. Output Channels Sets the number of channels in the two mc.chord~ multi-channel outputs. If the audio is on, the change will take place the next time the audio is restarted. Save data with patcher When embed is enabled, list and index data currently stored inside mc.chord~ will be saved in its patcher and recalled when the patcher is reopened. Extend (Missing Index) Mode Sets how non-existent indices are matched or ignored Match Nearest When an int is received that does not match an existing index, the list associated with the closest index will be output. Output zero When an int is received that does not match an existing index, zero signals will be output. Do nothing When an int is received that does not match an existing index, no change in the output occurs. Input Mode Determines how a signal value change is mapped to an output Treat signal value as index When inputmode is set to Lookup (0), the signal value is converted to an int by truncation. When the int value changes, the value is used to match a stored list. Signal changes output next When inputmode is set to Increment Index (1), any change in the input signal according to the current value of triggermode causes the next stored list to be output in a cyclic fashion. Off Mode Determines handling of output channels with inactive values Zero inactive outputs When offmode is set to Zero (0), inactive output channels are set to zero. TEXT_HERE When offmode is set to Hold (1), inactive output channels retain their previous value. You can determine which output channels are active by using the corresponding channel's signal value within the multi-channel signal output from the second outlet of mc.chord~. Trigger Mode Determines a signal change for increment index inputmode Trigger changes on zero to non-zero transitions When triggermode is set to Zero to Non-Zero (0), signal changes for incrementing the index of the output (when inputmode is set to Increment Index) are defined as the previous sample being zero and the current sample being non-zero. Any signal change When triggermode is set to Change (1), signal changes for incrementing the index of the output (when inputmode is set to Increment Index) are defined as any difference between the value of the previous and current samples in the input signal. Use Allocator Busy Map When usebusymap is enabled, mc.chord~ will only allocate output values to non-busy channels of the current busy map.