From cfe55b3223f7b456521915c5b41948896a19939f Mon Sep 17 00:00:00 2001 From: Nathan Wolek Date: Wed, 30 Aug 2017 08:00:33 -0400 Subject: [PATCH] finished help patch for define_loudspeakers. see issue #6 --- help/define_loudspeakers.maxhelp | 353 +++++++++++++++++++++++++++---- 1 file changed, 316 insertions(+), 37 deletions(-) diff --git a/help/define_loudspeakers.maxhelp b/help/define_loudspeakers.maxhelp index 17c590e..980366e 100644 --- a/help/define_loudspeakers.maxhelp +++ b/help/define_loudspeakers.maxhelp @@ -5,7 +5,7 @@ "major" : 7, "minor" : 3, "revision" : 4, - "architecture" : "x86", + "architecture" : "x64", "modernui" : 1 } , @@ -38,17 +38,220 @@ "subpatcher_template" : "", "boxes" : [ { "box" : { - "fontname" : "Arial", + "fontface" : 2, + "id" : "obj-52", + "maxclass" : "comment", + "numinlets" : 1, + "numoutlets" : 0, + "patching_rect" : [ 12.0, 598.0, 427.0, 20.0 ], + "style" : "", + "text" : "original object by Ville Pulkki 1999-2003 / update by Nathan Wolek 2015, 2017", + "textcolor" : [ 0.32549, 0.345098, 0.372549, 1.0 ] + } + + } +, { + "box" : { + "bubble" : 1, + "bubblepoint" : 0.1, + "bubbleside" : 0, + "bubbletextmargin" : 10, + "fontname" : "Lato Regular", "fontsize" : 12.0, - "id" : "obj-20", - "linecount" : 2, + "id" : "obj-3", + "linecount" : 3, + "maxclass" : "comment", + "numinlets" : 1, + "numoutlets" : 0, + "patching_rect" : [ 529.033325, 524.5, 194.0, 79.0 ], + "presentation_rect" : [ 578.033325, 525.5, 0.0, 0.0 ], + "style" : "", + "text" : "Connecting to multiple vbap objects saves some computation at setup time.", + "textcolor" : [ 0.3, 0.3, 0.3, 1.0 ] + } + + } +, { + "box" : { + "bgcolor" : [ 1.0, 0.788235, 0.470588, 1.0 ], + "fontname" : "Arial Bold", + "hint" : "", + "id" : "obj-6", + "ignoreclick" : 1, + "legacytextcolor" : 1, + "maxclass" : "textbutton", + "numinlets" : 1, + "numoutlets" : 3, + "outlettype" : [ "", "", "int" ], + "parameter_enable" : 0, + "patching_rect" : [ 725.033325, 579.5, 20.0, 20.0 ], + "presentation_rect" : [ 556.033325, 525.5, 0.0, 0.0 ], + "rounded" : 60.0, + "style" : "", + "text" : "3", + "textcolor" : [ 0.34902, 0.34902, 0.34902, 1.0 ] + } + + } +, { + "box" : { + "border" : 0, + "filename" : "helpargs.js", + "id" : "obj-24", + "ignoreclick" : 1, + "jsarguments" : [ "define_loudspeakers" ], + "maxclass" : "jsui", + "numinlets" : 1, + "numoutlets" : 1, + "outlettype" : [ "" ], + "parameter_enable" : 0, + "patching_rect" : [ 650.0, 351.0, 247.942719, 54.0 ], + "presentation_rect" : [ 650.0, 351.0, 247.942719, 54.0 ] + } + + } +, { + "box" : { + "bubble" : 1, + "bubblepoint" : 0.7, + "bubbleside" : 2, + "bubbletextmargin" : 10, + "fontname" : "Lato Regular", + "fontsize" : 12.0, + "id" : "obj-10", + "linecount" : 3, + "maxclass" : "comment", + "numinlets" : 1, + "numoutlets" : 0, + "patching_rect" : [ 102.033325, 379.5, 105.0, 79.0 ], + "style" : "", + "text" : "The messages generated look like this:", + "textcolor" : [ 0.3, 0.3, 0.3, 1.0 ] + } + + } +, { + "box" : { + "bgcolor" : [ 1.0, 0.788235, 0.470588, 1.0 ], + "fontname" : "Arial Bold", + "hint" : "", + "id" : "obj-11", + "ignoreclick" : 1, + "legacytextcolor" : 1, + "maxclass" : "textbutton", + "numinlets" : 1, + "numoutlets" : 3, + "outlettype" : [ "", "", "int" ], + "parameter_enable" : 0, + "patching_rect" : [ 80.033325, 379.5, 20.0, 20.0 ], + "rounded" : 60.0, + "style" : "", + "text" : "2", + "textcolor" : [ 0.34902, 0.34902, 0.34902, 1.0 ] + } + + } +, { + "box" : { + "id" : "obj-9", + "maxclass" : "button", + "numinlets" : 1, + "numoutlets" : 1, + "outlettype" : [ "bang" ], + "patching_rect" : [ 271.0, 283.0, 24.0, 24.0 ], + "style" : "" + } + + } +, { + "box" : { + "bubble" : 1, + "bubblepoint" : 0.7, + "bubbleside" : 3, + "bubbletextmargin" : 10, + "fontname" : "Lato Regular", + "fontsize" : 12.0, + "id" : "obj-44", + "linecount" : 3, + "maxclass" : "comment", + "numinlets" : 1, + "numoutlets" : 0, + "patching_rect" : [ 169.0, 251.0, 103.0, 64.0 ], + "style" : "", + "text" : "Send bang messages to recalculate.", + "textcolor" : [ 0.3, 0.3, 0.3, 1.0 ] + } + + } +, { + "box" : { + "bgcolor" : [ 1.0, 0.788235, 0.470588, 1.0 ], + "fontname" : "Arial Bold", + "hint" : "", + "id" : "obj-45", + "ignoreclick" : 1, + "legacytextcolor" : 1, + "maxclass" : "textbutton", + "numinlets" : 1, + "numoutlets" : 3, + "outlettype" : [ "", "", "int" ], + "parameter_enable" : 0, + "patching_rect" : [ 147.0, 251.0, 20.0, 20.0 ], + "rounded" : 60.0, + "style" : "", + "text" : "1", + "textcolor" : [ 0.34902, 0.34902, 0.34902, 1.0 ] + } + + } +, { + "box" : { + "id" : "obj-5", + "maxclass" : "newobj", + "numinlets" : 5, + "numoutlets" : 5, + "outlettype" : [ "list", "float", "float", "float", "float" ], + "patching_rect" : [ 410.0, 512.0, 98.0, 22.0 ], + "style" : "", + "text" : "vbap" + } + + } +, { + "box" : { + "id" : "obj-4", "maxclass" : "message", "numinlets" : 2, "numoutlets" : 1, "outlettype" : [ "" ], - "patching_rect" : [ 346.0, 234.0, 248.0, 35.0 ], + "patching_rect" : [ 12.0, 463.0, 320.0, 22.0 ], + "style" : "" + } + + } +, { + "box" : { + "id" : "obj-2", + "maxclass" : "newobj", + "numinlets" : 5, + "numoutlets" : 5, + "outlettype" : [ "list", "float", "float", "float", "float" ], + "patching_rect" : [ 552.0, 484.0, 98.0, 22.0 ], "style" : "", - "text" : "ls-directions 3 -30 0 30 0 -90 0 90 0 0 0 -150 0 150 0 180 45 -45 45 45 45" + "text" : "vbap" + } + + } +, { + "box" : { + "id" : "obj-1", + "maxclass" : "newobj", + "numinlets" : 5, + "numoutlets" : 5, + "outlettype" : [ "list", "float", "float", "float", "float" ], + "patching_rect" : [ 439.0, 468.0, 98.0, 22.0 ], + "style" : "", + "text" : "vbap" } } @@ -56,26 +259,30 @@ "box" : { "fontname" : "Arial", "fontsize" : 12.0, - "id" : "obj-26", + "id" : "obj-20", + "linecount" : 2, "maxclass" : "message", "numinlets" : 2, "numoutlets" : 1, "outlettype" : [ "" ], - "patching_rect" : [ 334.0, 186.0, 184.0, 22.0 ], + "patching_rect" : [ 313.0, 200.0, 248.0, 35.0 ], "style" : "", - "text" : "ls-triplets 1 2 7 2 7 8 1 3 7" + "text" : "ls-directions 3 -30 0 30 0 -90 0 90 0 0 0 -150 0 150 0 180 45 -45 45 45 45" } } , { "box" : { - "id" : "obj-27", - "maxclass" : "button", - "numinlets" : 1, + "fontname" : "Arial", + "fontsize" : 12.0, + "id" : "obj-26", + "maxclass" : "message", + "numinlets" : 2, "numoutlets" : 1, - "outlettype" : [ "bang" ], - "patching_rect" : [ 315.0, 264.0, 15.0, 15.0 ], - "style" : "" + "outlettype" : [ "" ], + "patching_rect" : [ 492.471375, 260.0, 162.0, 22.0 ], + "style" : "", + "text" : "ls-triplets 1 2 7 2 7 8 1 3 7" } } @@ -88,7 +295,7 @@ "numinlets" : 1, "numoutlets" : 1, "outlettype" : [ "" ], - "patching_rect" : [ 334.0, 308.0, 335.0, 22.0 ], + "patching_rect" : [ 313.0, 348.0, 335.0, 22.0 ], "style" : "", "text" : "define_loudspeakers 2 -40 0 40 80 130 180 -130 -80" } @@ -98,14 +305,14 @@ "box" : { "fontname" : "Arial", "fontsize" : 12.0, - "id" : "obj-37", - "linecount" : 3, + "id" : "obj-39", + "linecount" : 2, "maxclass" : "comment", "numinlets" : 1, "numoutlets" : 0, - "patching_rect" : [ 142.0, 249.0, 161.0, 47.0 ], + "patching_rect" : [ 370.0, 313.0, 278.0, 33.0 ], "style" : "", - "text" : "Use define_loudspeakers to specify the number and layout of your speakers." + "text" : "Arguments can be used to define a default setup. This example sets up a 2D array with 8 speakers. " } } @@ -113,13 +320,14 @@ "box" : { "fontname" : "Arial", "fontsize" : 12.0, - "id" : "obj-39", + "id" : "obj-40", + "linecount" : 2, "maxclass" : "comment", "numinlets" : 1, "numoutlets" : 0, - "patching_rect" : [ 353.0, 289.0, 454.0, 20.0 ], + "patching_rect" : [ 313.0, 163.0, 482.0, 33.0 ], "style" : "", - "text" : "2-D setup -> only loudspeaker azimuths specified (2 azi1 azi2 azi3 azi4...)" + "text" : "The ls-directions message is formatted exactly like the define_loudspeakers message to vbap. For more details, see the help patch for vbap object." } } @@ -127,28 +335,31 @@ "box" : { "fontname" : "Arial", "fontsize" : 12.0, - "id" : "obj-40", + "id" : "obj-41", + "linecount" : 4, "maxclass" : "comment", "numinlets" : 1, "numoutlets" : 0, - "patching_rect" : [ 346.0, 215.0, 476.0, 20.0 ], + "patching_rect" : [ 656.471375, 225.0, 235.0, 60.0 ], "style" : "", - "text" : "3-D setup -> (azimuth elevation) pairs are specified (3 azi1 ele1 azi2 ele2 ...)" + "text" : "FOR EXPERTS ONLY - If you are not happy with triangle selections of define_loudspeakers, you can define your own using ls-triplets." } } , { "box" : { - "fontname" : "Arial", - "fontsize" : 12.0, - "id" : "obj-41", - "linecount" : 2, - "maxclass" : "comment", + "background" : 1, + "border" : 0, + "filename" : "helpdetails.js", + "id" : "obj-55", + "ignoreclick" : 1, + "jsarguments" : [ "define_loudspeakers" ], + "maxclass" : "jsui", "numinlets" : 1, - "numoutlets" : 0, - "patching_rect" : [ 335.0, 151.0, 400.0, 33.0 ], - "style" : "", - "text" : "If you are not happy with triangle selections of define_loudspeakers, you can define your own. (for experts only)" + "numoutlets" : 1, + "outlettype" : [ "" ], + "parameter_enable" : 0, + "patching_rect" : [ 12.0, 10.666672, 634.0, 119.0 ] } } @@ -163,24 +374,92 @@ , { "patchline" : { "destination" : [ "obj-28", 0 ], + "midpoints" : [ 501.971375, 300.0, 322.5, 300.0 ], "source" : [ "obj-26", 0 ] } + } +, { + "patchline" : { + "destination" : [ "obj-1", 0 ], + "order" : 1, + "source" : [ "obj-28", 0 ] + } + + } +, { + "patchline" : { + "destination" : [ "obj-2", 0 ], + "order" : 0, + "source" : [ "obj-28", 0 ] + } + + } +, { + "patchline" : { + "destination" : [ "obj-4", 1 ], + "order" : 3, + "source" : [ "obj-28", 0 ] + } + + } +, { + "patchline" : { + "destination" : [ "obj-5", 0 ], + "order" : 2, + "source" : [ "obj-28", 0 ] + } + } , { "patchline" : { "destination" : [ "obj-28", 0 ], - "source" : [ "obj-27", 0 ] + "midpoints" : [ 280.5, 319.0, 322.5, 319.0 ], + "source" : [ "obj-9", 0 ] } } ], "dependency_cache" : [ { + "name" : "helpdetails.js", + "bootpath" : "C74:/help/resources", + "type" : "TEXT", + "implicit" : 1 + } +, { + "name" : "helpargs.js", + "bootpath" : "C74:/help/resources", + "type" : "TEXT", + "implicit" : 1 + } +, { "name" : "define_loudspeakers.mxo", "type" : "iLaX" } +, { + "name" : "vbap.mxo", + "type" : "iLaX" + } ], - "autosave" : 0 + "autosave" : 0, + "styles" : [ { + "name" : "Audiomix", + "default" : { + "bgfillcolor" : { + "type" : "gradient", + "color1" : [ 0.376471, 0.384314, 0.4, 1.0 ], + "color2" : [ 0.290196, 0.309804, 0.301961, 1.0 ], + "color" : [ 0.290196, 0.309804, 0.301961, 1.0 ], + "angle" : 270.0, + "proportion" : 0.39 + } + + } +, + "parentstyle" : "", + "multi" : 0 + } + ] } }