README

ABOUT
Mixer-x.x.x is a Max package created by Jon Bellona (http://jpbellona.com). The package includes various objects, like channel strips, eqs, limiters, and aux sends, for audio mapping projects. Mixer.* objects provide GUI, modular design, and pattr binding for smooth integration into your Max/MSP workflow.

Some objects are built on existing effects and dynamics processing Max objects, like yafr2, a plate-reverb. Other objects are custom designed to aid your prototyping and audio work inside of Max. Project webpage at (http://jpbellona.com/work/mixer-maxmsp-package/)

INSTALLATION
To install, place the 'mixer-x.x.x' folder inside 'Max 6.1 > packages' directory. Then restart Max. 
You will then have access to all mixer.* objects.

HOW TO USE
Inside a Max window, you may type 'M' (that's shift-M) to quickly access these tools (bpatcher @name mixer.*), or create a new object, start typing "mixer" and let autocomplete help you do the rest. All mixer.* objects contain helpfiles, with attribute and methods reference, as well as links to other relevant objects in the package. All mixer objects are linked to pattr, which means channels, subgroups, and mixers can be easily stored and recalled with presets.

CHANGELOG
	v.0.0.3 -- added Ctrl-click when hovering over a fader to reset volume to 0.0dB.

	v.0.0.2 -- minor fixes.
		- mixer.8channel, Echo (Aux 1) was only feeding Left channel. Now is true mono on input and output. Incorporates stereo feed on L/R channels (use pan on aux return for mono)
		- mixer.echo.  Added comment to reference and helpfile to denote Echo can be mono, or stereo. On first look, two inlets/outlets can be confusing.
		- mixer.8channel, With all buttons that open windows (Aux, Echo, etc.) if user closes window, “close” message still appears on textbutton. Added closebang objects to EQ and Limiters to mirror user behavior. Added getSelf.js and closebang for Echo and Verb buttons, as well as adding this to the helpfiles of Echo and Verb.  
		- For mixer.aux, added closebang that sends 0 to parent::auxWindowToggle to close window control button in mixer.channel and mixer.channel.stereo, independently.
		- mixer.eq helpfile was showing as mixer.pan
		- mixer.mute helpfile was showing as mixer.bypass

	v.0.0.1 -- initial release

MIXER.* OBJECTS
	mixer.aux
	mixer.bypass
	mixer.channel
	mixer.channel.basic (no aux sends)
	mixer.channel.stereo
	mixer.echo
	mixer.eq
	mixer.peaklim
	mixer.mute
	mixer.pan
	mixer.pan.stereo
	mixer.verb-plate
	mixer.8channel
	mixer.group4
	mixer.group4.basic
	mixer.group4.stereo
	mixer.group8
	mixer.group8.basic

OTHER OBJECTS USED IN THIS LIBRARY
	yafr2, a plate reverb.	Main effect for mixer.verb-plate
	omx.peaklim~		Main object for mixer.peaklim
	cascade~		Main object for mixer.eq

TODO
* Acquire User feedback --> collect at jon @ jpbellona.com. Please send!

WISHLIST
• Add more example files.
• EQ - odd configuration for starting- maybe several equally distributed bandpass filters with a low and high pass at each end?
• Incorporate JS to connect/disconnect mixer objects automatically, especially dynamics processing units.
• Modularize the dynamics section, umenu, similar to ProTools.  This could solve wishlist item above.
• Look at incorporating other objects, like omx.comp~ into mixer.


License
----------------------------------------
All files are covered under the GPL v3 license.

Copyright (C) 2015 Jon Bellona. http://jpbellona.com/

	Released under the GNU General Public License, Version 3.0 (the "License");
	you may not use this file except in compliance with the License.
	You may obtain a copy of the License at

	  http://www.gnu.org/licenses/gpl.html

	Unless required by applicable law or agreed to in writing, software
	distributed under the License is distributed on an "AS IS" BASIS,
	WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
	See the License for the specific language governing permissions and
	limitations under the License.