SC helpfiles

[gionogio]

Hi!

flucoma-sc/release-packaging/HelpSource/Classes at main · flucoma/flucoma-sc

In many files here the “automagically” conversion SC does on URLs points to non existent wikipedia pages such as " Mel scale) " or such.
The solution would be to either put a space between the end of the link and the parenthesis, or to find a way to link stuff formatting it (don’t know how it is done in SC helpfiles).

Plus, there are some suggestions on the actual content of the helpfiles, like adding more comments to better explain the code - I am not so familiar with the theory about the decomposition of signals; plus, I haven’t used SC in a whil so I feel quite slow in reading it… I might not be the only one.
Anyway, should I ask for clarification somewhere else in this forum?

(I created a branch in github but then I thought that it was better suggesting this here, right?)

[tremblap]

@jamesbradbury and @tedmoore are in full re-writing mode now, and if you check this thread you will see which one has been updated to the new style in the nightlies:

Announcement: Release (Not Release)

I’ve just uploaded a short-ish addendum to the original four part video series on creating a 2D corpus exploration tool. This video touches on dimension reduction, and how we might leverage it to compress lots of audio descriptors into a compact two-dimensional representation. Check it out: Building a 2D Corpus Explorer (Part 5) - YouTube

So comments and suggestions are welcome indeed, but probably more specific on the updated ones and more general on the old ones will be helpful at this time.

[tedmoore]

Hi @gionogio,

As @tremblap said, we’re in the middle of rewriting all this stuff! If you have any usage questions, please ask here on the forum and I can help. Your feedback will be super valuable for our rewriting process!

Thanks!

T

[gionogio]

Thanks a lot! When I saw that post I stopped right after the tldr sorry
So actually pulling a request on the SC would’ve been the right move, I should’ve just stated the version of the package I was using I guess.

Alright, I’ll get back to that in these days.
For now, thanks again!

[gionogio]

Hi again!
Sorry to bother but I am just a bit confused with a couple of things.
Now I switched back to Max, and I was revisiting a patch I made some months ago, and eventually I realized I forgot how bufampslice was working. Opening the helpfile and following the process step by step, I was also commenting the various passages to make sense out of it. I also used colors associated with which buffer the object is working. In doing this, I though it would just be easier and nicer to have a the actual patch arranged in this way also for other people, so it might be worth to change the tab itself? If so, how would you deal with the consisency over the whole documentation? Plus, am I supposed to open a pull request for such a small change, or should I maybe collect some changes in the documentation and then open one for a bigger change? (in that case might be a bit difficult to follow up with the nightly releases!)

{
	"boxes" : [ 		{
			"box" : 			{
				"maxclass" : "comment",
				"text" : "slice duration",
				"numinlets" : 1,
				"numoutlets" : 0,
				"id" : "obj-6",
				"patching_rect" : [ 15.0, 398.0, 79.0, 20.0 ],
				"textcolor" : [ 0.5, 0.5, 0.5, 1.0 ]
			}

		}
, 		{
			"box" : 			{
				"maxclass" : "newobj",
				"text" : "p \"pick a slice\"",
				"numinlets" : 1,
				"numoutlets" : 2,
				"id" : "obj-58",
				"patching_rect" : [ 81.0, 360.0, 88.0, 22.0 ],
				"outlettype" : [ "float", "" ],
				"patcher" : 				{
					"fileversion" : 1,
					"appversion" : 					{
						"major" : 8,
						"minor" : 2,
						"revision" : 1,
						"architecture" : "x64",
						"modernui" : 1
					}
,
					"classnamespace" : "box",
					"rect" : [ 34.0, 77.0, 1068.0, 713.0 ],
					"bglocked" : 0,
					"openinpresentation" : 0,
					"default_fontsize" : 12.0,
					"default_fontface" : 0,
					"default_fontname" : "Arial",
					"gridonopen" : 1,
					"gridsize" : [ 15.0, 15.0 ],
					"gridsnaponopen" : 1,
					"objectsnaponopen" : 1,
					"statusbarvisible" : 2,
					"toolbarvisible" : 1,
					"lefttoolbarpinned" : 0,
					"toptoolbarpinned" : 0,
					"righttoolbarpinned" : 0,
					"bottomtoolbarpinned" : 0,
					"toolbars_unpinned_last_save" : 0,
					"tallnewobj" : 0,
					"boxanimatetime" : 200,
					"enablehscroll" : 1,
					"enablevscroll" : 1,
					"devicewidth" : 0.0,
					"description" : "",
					"digest" : "",
					"tags" : "",
					"style" : "",
					"subpatcher_template" : "",
					"assistshowspatchername" : 0,
					"boxes" : [ 						{
							"box" : 							{
								"maxclass" : "comment",
								"text" : "start & stop in ms",
								"numinlets" : 1,
								"numoutlets" : 0,
								"id" : "obj-7",
								"patching_rect" : [ 111.0, 270.0, 101.0, 20.0 ],
								"textcolor" : [ 0.5, 0.5, 0.5, 1.0 ]
							}

						}
, 						{
							"box" : 							{
								"maxclass" : "comment",
								"text" : "start",
								"numinlets" : 1,
								"numoutlets" : 0,
								"id" : "obj-3",
								"patching_rect" : [ 180.0, 180.0, 32.0, 20.0 ],
								"textcolor" : [ 0.5, 0.5, 0.5, 1.0 ]
							}

						}
, 						{
							"box" : 							{
								"maxclass" : "comment",
								"text" : "stop (in samples)",
								"numinlets" : 1,
								"numoutlets" : 0,
								"id" : "obj-25",
								"patching_rect" : [ 59.0, 180.0, 100.0, 20.0 ],
								"textcolor" : [ 0.5, 0.5, 0.5, 1.0 ]
							}

						}
, 						{
							"box" : 							{
								"maxclass" : "newobj",
								"text" : "+ 1",
								"numinlets" : 2,
								"numoutlets" : 1,
								"id" : "obj-2",
								"patching_rect" : [ 45.0, 120.0, 29.5, 22.0 ],
								"outlettype" : [ "int" ]
							}

						}
, 						{
							"box" : 							{
								"maxclass" : "newobj",
								"text" : "info~ src",
								"numinlets" : 1,
								"numoutlets" : 9,
								"id" : "obj-1",
								"patching_rect" : [ 298.0, 155.0, 103.0, 22.0 ],
								"outlettype" : [ "float", "list", "float", "float", "float", "float", "float", "", "int" ],
								"textcolor" : [ 0.0, 0.0, 0.0, 1.0 ],
								"bgcolor" : [ 0.843137254901961, 0.741176470588235, 0.431372549019608, 1.0 ]
							}

						}
, 						{
							"box" : 							{
								"maxclass" : "newobj",
								"text" : "peek~ slicestarts",
								"numinlets" : 3,
								"numoutlets" : 1,
								"id" : "obj-17",
								"patching_rect" : [ 45.0, 155.0, 100.0, 22.0 ],
								"outlettype" : [ "float" ],
								"bgcolor" : [ 0.192156862745098, 0.63921568627451, 0.443137254901961, 1.0 ]
							}

						}
, 						{
							"box" : 							{
								"maxclass" : "newobj",
								"text" : "expr $f1 * 1000. / $f2",
								"numinlets" : 2,
								"numoutlets" : 1,
								"id" : "obj-6",
								"patching_rect" : [ 45.0, 240.0, 122.0, 22.0 ],
								"outlettype" : [ "" ]
							}

						}
, 						{
							"box" : 							{
								"maxclass" : "newobj",
								"text" : "sel 0",
								"numinlets" : 2,
								"numoutlets" : 2,
								"id" : "obj-72",
								"patching_rect" : [ 153.5, 396.0, 36.0, 22.0 ],
								"outlettype" : [ "bang", "" ]
							}

						}
, 						{
							"box" : 							{
								"maxclass" : "newobj",
								"text" : "t l l",
								"numinlets" : 1,
								"numoutlets" : 2,
								"id" : "obj-68",
								"patching_rect" : [ 45.0, 300.0, 58.5, 22.0 ],
								"outlettype" : [ "", "" ]
							}

						}
, 						{
							"box" : 							{
								"maxclass" : "newobj",
								"text" : "prepend start",
								"numinlets" : 1,
								"numoutlets" : 1,
								"id" : "obj-66",
								"patching_rect" : [ 84.5, 450.0, 81.0, 22.0 ],
								"outlettype" : [ "" ]
							}

						}
, 						{
							"box" : 							{
								"maxclass" : "newobj",
								"text" : "join 2 @triggers 1",
								"numinlets" : 2,
								"numoutlets" : 1,
								"id" : "obj-65",
								"patching_rect" : [ 84.5, 420.0, 105.0, 22.0 ],
								"outlettype" : [ "" ]
							}

						}
, 						{
							"box" : 							{
								"maxclass" : "newobj",
								"text" : "!- 0.",
								"numinlets" : 2,
								"numoutlets" : 1,
								"id" : "obj-58",
								"patching_rect" : [ 45.0, 345.0, 31.0, 22.0 ],
								"outlettype" : [ "float" ]
							}

						}
, 						{
							"box" : 							{
								"maxclass" : "newobj",
								"text" : "zl group 2",
								"numinlets" : 2,
								"numoutlets" : 2,
								"id" : "obj-53",
								"patching_rect" : [ 45.0, 270.0, 63.0, 22.0 ],
								"outlettype" : [ "", "" ]
							}

						}
, 						{
							"box" : 							{
								"maxclass" : "newobj",
								"text" : "t i i b",
								"numinlets" : 1,
								"numoutlets" : 3,
								"id" : "obj-50",
								"patching_rect" : [ 45.0, 75.0, 272.0, 22.0 ],
								"outlettype" : [ "int", "int", "bang" ]
							}

						}
, 						{
							"box" : 							{
								"maxclass" : "newobj",
								"text" : "peek~ slicestarts",
								"numinlets" : 3,
								"numoutlets" : 1,
								"id" : "obj-43",
								"patching_rect" : [ 171.5, 155.0, 100.0, 22.0 ],
								"outlettype" : [ "float" ],
								"bgcolor" : [ 0.192156862745098, 0.63921568627451, 0.443137254901961, 1.0 ]
							}

						}
, 						{
							"box" : 							{
								"maxclass" : "inlet",
								"numinlets" : 0,
								"numoutlets" : 1,
								"id" : "obj-54",
								"patching_rect" : [ 45.0, 15.0, 30.0, 30.0 ],
								"outlettype" : [ "" ],
								"comment" : "",
								"index" : 1
							}

						}
, 						{
							"box" : 							{
								"maxclass" : "outlet",
								"numinlets" : 1,
								"numoutlets" : 0,
								"id" : "obj-55",
								"patching_rect" : [ 45.0, 495.0, 30.0, 30.0 ],
								"comment" : "",
								"index" : 1
							}

						}
, 						{
							"box" : 							{
								"maxclass" : "outlet",
								"numinlets" : 1,
								"numoutlets" : 0,
								"id" : "obj-57",
								"patching_rect" : [ 84.5, 495.0, 30.0, 30.0 ],
								"comment" : "",
								"index" : 2
							}

						}
 ],
					"lines" : [ 						{
							"patchline" : 							{
								"source" : [ "obj-72", 1 ],
								"destination" : [ "obj-65", 1 ]
							}

						}
, 						{
							"patchline" : 							{
								"source" : [ "obj-68", 1 ],
								"destination" : [ "obj-65", 0 ]
							}

						}
, 						{
							"patchline" : 							{
								"source" : [ "obj-68", 0 ],
								"destination" : [ "obj-58", 0 ]
							}

						}
, 						{
							"patchline" : 							{
								"source" : [ "obj-66", 0 ],
								"destination" : [ "obj-57", 0 ]
							}

						}
, 						{
							"patchline" : 							{
								"source" : [ "obj-65", 0 ],
								"destination" : [ "obj-66", 0 ]
							}

						}
, 						{
							"patchline" : 							{
								"source" : [ "obj-6", 0 ],
								"destination" : [ "obj-53", 0 ]
							}

						}
, 						{
							"patchline" : 							{
								"source" : [ "obj-58", 0 ],
								"destination" : [ "obj-72", 0 ],
								"order" : 0
							}

						}
, 						{
							"patchline" : 							{
								"source" : [ "obj-58", 0 ],
								"destination" : [ "obj-55", 0 ],
								"order" : 1
							}

						}
, 						{
							"patchline" : 							{
								"source" : [ "obj-54", 0 ],
								"destination" : [ "obj-50", 0 ]
							}

						}
, 						{
							"patchline" : 							{
								"source" : [ "obj-53", 0 ],
								"destination" : [ "obj-68", 0 ]
							}

						}
, 						{
							"patchline" : 							{
								"source" : [ "obj-50", 1 ],
								"destination" : [ "obj-43", 0 ]
							}

						}
, 						{
							"patchline" : 							{
								"source" : [ "obj-50", 0 ],
								"destination" : [ "obj-2", 0 ]
							}

						}
, 						{
							"patchline" : 							{
								"source" : [ "obj-50", 2 ],
								"destination" : [ "obj-1", 0 ]
							}

						}
, 						{
							"patchline" : 							{
								"source" : [ "obj-43", 0 ],
								"destination" : [ "obj-6", 0 ]
							}

						}
, 						{
							"patchline" : 							{
								"source" : [ "obj-2", 0 ],
								"destination" : [ "obj-17", 0 ]
							}

						}
, 						{
							"patchline" : 							{
								"source" : [ "obj-17", 0 ],
								"destination" : [ "obj-6", 0 ]
							}

						}
, 						{
							"patchline" : 							{
								"source" : [ "obj-1", 0 ],
								"destination" : [ "obj-6", 1 ]
							}

						}
 ],
					"styles" : [ 						{
							"name" : "max6box",
							"default" : 							{
								"textcolor_inverse" : [ 0.0, 0.0, 0.0, 1.0 ],
								"accentcolor" : [ 0.8, 0.839216, 0.709804, 1.0 ],
								"bgcolor" : [ 1.0, 1.0, 1.0, 0.5 ]
							}
,
							"parentstyle" : "",
							"multi" : 0
						}
, 						{
							"name" : "max6inlet",
							"default" : 							{
								"color" : [ 0.423529, 0.372549, 0.27451, 1.0 ]
							}
,
							"parentstyle" : "",
							"multi" : 0
						}
, 						{
							"name" : "max6message",
							"default" : 							{
								"textcolor_inverse" : [ 0.0, 0.0, 0.0, 1.0 ],
								"bgfillcolor" : 								{
									"type" : "gradient",
									"color1" : [ 0.866667, 0.866667, 0.866667, 1.0 ],
									"color2" : [ 0.788235, 0.788235, 0.788235, 1.0 ],
									"color" : [ 0.290196, 0.309804, 0.301961, 1.0 ],
									"angle" : 270.0,
									"proportion" : 0.39,
									"autogradient" : 0
								}

							}
,
							"parentstyle" : "max6box",
							"multi" : 0
						}
, 						{
							"name" : "max6outlet",
							"default" : 							{
								"color" : [ 0.0, 0.454902, 0.498039, 1.0 ]
							}
,
							"parentstyle" : "",
							"multi" : 0
						}
 ]
				}
,
				"saved_object_attributes" : 				{
					"description" : "",
					"digest" : "",
					"globalpatchername" : "",
					"tags" : ""
				}

			}

		}
, 		{
			"box" : 			{
				"maxclass" : "bpatcher",
				"viewvisibility" : 1,
				"offset" : [ 0.0, 0.0 ],
				"lockeddragscroll" : 0,
				"clickthrough" : 0,
				"enablehscroll" : 0,
				"enablevscroll" : 0,
				"lockedsize" : 0,
				"bgmode" : 0,
				"border" : 0,
				"numinlets" : 0,
				"embed" : 1,
				"numoutlets" : 1,
				"id" : "obj-12",
				"patching_rect" : [ 15.0, 146.5, 286.0, 25.666656 ],
				"outlettype" : [ "" ],
				"patcher" : 				{
					"fileversion" : 1,
					"appversion" : 					{
						"major" : 8,
						"minor" : 2,
						"revision" : 1,
						"architecture" : "x64",
						"modernui" : 1
					}
,
					"classnamespace" : "box",
					"rect" : [ 59.0, 104.0, 640.0, 480.0 ],
					"bglocked" : 0,
					"openinpresentation" : 1,
					"default_fontsize" : 12.0,
					"default_fontface" : 0,
					"default_fontname" : "Arial",
					"gridonopen" : 1,
					"gridsize" : [ 15.0, 15.0 ],
					"gridsnaponopen" : 1,
					"objectsnaponopen" : 1,
					"statusbarvisible" : 2,
					"toolbarvisible" : 1,
					"lefttoolbarpinned" : 0,
					"toptoolbarpinned" : 0,
					"righttoolbarpinned" : 0,
					"bottomtoolbarpinned" : 0,
					"toolbars_unpinned_last_save" : 0,
					"tallnewobj" : 0,
					"boxanimatetime" : 200,
					"enablehscroll" : 1,
					"enablevscroll" : 1,
					"devicewidth" : 0.0,
					"description" : "",
					"digest" : "",
					"tags" : "",
					"style" : "",
					"subpatcher_template" : "",
					"assistshowspatchername" : 0,
					"boxes" : [ 						{
							"box" : 							{
								"maxclass" : "newobj",
								"text" : "loadmess path",
								"numinlets" : 1,
								"numoutlets" : 1,
								"id" : "obj-2",
								"patching_rect" : [ 6.0, 4.0, 89.0, 22.0 ],
								"outlettype" : [ "" ]
							}

						}
, 						{
							"box" : 							{
								"maxclass" : "outlet",
								"numinlets" : 1,
								"numoutlets" : 0,
								"id" : "obj-1",
								"patching_rect" : [ 130.5, 194.0, 30.0, 30.0 ],
								"comment" : "",
								"index" : 1
							}

						}
, 						{
							"box" : 							{
								"maxclass" : "newobj",
								"text" : "prepend replace",
								"numinlets" : 1,
								"numoutlets" : 1,
								"id" : "obj-48",
								"patching_rect" : [ 130.5, 167.833344000000011, 97.0, 22.0 ],
								"outlettype" : [ "" ]
							}

						}
, 						{
							"box" : 							{
								"maxclass" : "newobj",
								"text" : "prepend prefix",
								"numinlets" : 1,
								"numoutlets" : 1,
								"id" : "obj-45",
								"patching_rect" : [ 73.5, 113.833343999999997, 87.0, 22.0 ],
								"outlettype" : [ "" ]
							}

						}
, 						{
							"box" : 							{
								"maxclass" : "umenu",
								"presentation_rect" : [ 2.5, 2.833344, 282.0, 22.0 ],
								"numinlets" : 1,
								"items" : [ "Green-Box639.wav", ",", "Green-Box641.wav", ",", "Harker-DS-TenOboeMultiphonics-M.wav", ",", "Nicol-LoopE-M.wav", ",", "Olencki-TenTromboneLongTones-M.wav", ",", "Tremblay-AaS-AcBassGuit-Melo-M.wav", ",", "Tremblay-AaS-AcousticStrums-M.wav", ",", "Tremblay-AaS-SynthTwoVoices-M.wav", ",", "Tremblay-AaS-VoiceQC-B2K-M.wav", ",", "Tremblay-ASWINE-ScratchySynth-M.wav", ",", "Tremblay-BaB-HumDC-M.wav", ",", "Tremblay-BaB-SoundscapeGolcarWithDog.wav", ",", "Tremblay-beatRemember.wav", ",", "Tremblay-CEL-GlitchyMusicBoxMelo.wav", ",", "Tremblay-CF-ChurchBells.wav", ",", "Tremblay-FMTri-M.wav", ",", "Tremblay-FMTriDist-M.wav", ",", "Tremblay-Iterative-M.wav", ",", "Tremblay-SA-UprightPianoPedalWide.wav", ",", "Tremblay-SlideChoirAdd-M.wav", ",", "Tremblay-SlideChoirSin-M.wav", ",", "Tremblay-UW-ComplexDescent-M.wav" ],
								"presentation" : 1,
								"numoutlets" : 3,
								"id" : "obj-44",
								"patching_rect" : [ 73.5, 140.833344000000011, 133.0, 22.0 ],
								"outlettype" : [ "int", "", "" ],
								"prefix" : "C:/Users/giono/media/",
								"autopopulate" : 1,
								"types" : [ "WAVE", "AIFF" ],
								"parameter_enable" : 0
							}

						}
, 						{
							"box" : 							{
								"maxclass" : "newobj",
								"text" : "combine path /media/",
								"numinlets" : 2,
								"numoutlets" : 2,
								"id" : "obj-40",
								"patching_rect" : [ 73.5, 85.833343999999997, 125.0, 22.0 ],
								"outlettype" : [ "", "" ]
							}

						}
, 						{
							"box" : 							{
								"maxclass" : "newobj",
								"text" : "regexp (.+)/.+",
								"numinlets" : 1,
								"fontname" : "Arial",
								"numoutlets" : 5,
								"id" : "obj-37",
								"patching_rect" : [ 56.0, 57.833343999999997, 89.0, 23.0 ],
								"outlettype" : [ "", "", "", "", "" ],
								"fontsize" : 13.0
							}

						}
, 						{
							"box" : 							{
								"maxclass" : "newobj",
								"text" : "thispatcher",
								"numinlets" : 1,
								"numoutlets" : 2,
								"id" : "obj-23",
								"patching_rect" : [ 6.0, 32.0, 69.0, 22.0 ],
								"outlettype" : [ "", "" ],
								"save" : [ "#N", "thispatcher", ";", "#Q", "end", ";" ]
							}

						}
 ],
					"lines" : [ 						{
							"patchline" : 							{
								"source" : [ "obj-48", 0 ],
								"destination" : [ "obj-1", 0 ]
							}

						}
, 						{
							"patchline" : 							{
								"source" : [ "obj-45", 0 ],
								"destination" : [ "obj-44", 0 ]
							}

						}
, 						{
							"patchline" : 							{
								"source" : [ "obj-44", 1 ],
								"destination" : [ "obj-48", 0 ]
							}

						}
, 						{
							"patchline" : 							{
								"source" : [ "obj-40", 0 ],
								"destination" : [ "obj-45", 0 ]
							}

						}
, 						{
							"patchline" : 							{
								"source" : [ "obj-37", 1 ],
								"destination" : [ "obj-40", 0 ]
							}

						}
, 						{
							"patchline" : 							{
								"source" : [ "obj-23", 1 ],
								"destination" : [ "obj-37", 0 ]
							}

						}
, 						{
							"patchline" : 							{
								"source" : [ "obj-2", 0 ],
								"destination" : [ "obj-23", 0 ]
							}

						}
 ],
					"styles" : [ 						{
							"name" : "max6box",
							"default" : 							{
								"textcolor_inverse" : [ 0.0, 0.0, 0.0, 1.0 ],
								"accentcolor" : [ 0.8, 0.839216, 0.709804, 1.0 ],
								"bgcolor" : [ 1.0, 1.0, 1.0, 0.5 ]
							}
,
							"parentstyle" : "",
							"multi" : 0
						}
, 						{
							"name" : "max6inlet",
							"default" : 							{
								"color" : [ 0.423529, 0.372549, 0.27451, 1.0 ]
							}
,
							"parentstyle" : "",
							"multi" : 0
						}
, 						{
							"name" : "max6message",
							"default" : 							{
								"textcolor_inverse" : [ 0.0, 0.0, 0.0, 1.0 ],
								"bgfillcolor" : 								{
									"type" : "gradient",
									"color1" : [ 0.866667, 0.866667, 0.866667, 1.0 ],
									"color2" : [ 0.788235, 0.788235, 0.788235, 1.0 ],
									"color" : [ 0.290196, 0.309804, 0.301961, 1.0 ],
									"angle" : 270.0,
									"proportion" : 0.39,
									"autogradient" : 0
								}

							}
,
							"parentstyle" : "max6box",
							"multi" : 0
						}
, 						{
							"name" : "max6outlet",
							"default" : 							{
								"color" : [ 0.0, 0.454902, 0.498039, 1.0 ]
							}
,
							"parentstyle" : "",
							"multi" : 0
						}
 ]
				}

			}

		}
, 		{
			"box" : 			{
				"maxclass" : "comment",
				"text" : "loop current slice",
				"numinlets" : 1,
				"numoutlets" : 0,
				"id" : "obj-20",
				"patching_rect" : [ 352.0, 338.0, 101.0, 20.0 ],
				"textcolor" : [ 0.5, 0.5, 0.5, 1.0 ]
			}

		}
, 		{
			"box" : 			{
				"maxclass" : "newobj",
				"text" : "buffer~ src",
				"numinlets" : 1,
				"numoutlets" : 2,
				"id" : "obj-16",
				"patching_rect" : [ 15.0, 210.333327999999995, 67.0, 22.0 ],
				"outlettype" : [ "float", "bang" ],
				"textcolor" : [ 0.0, 0.0, 0.0, 1.0 ],
				"bgcolor" : [ 0.843137254901961, 0.741176470588235, 0.431372549019608, 1.0 ]
			}

		}
, 		{
			"box" : 			{
				"maxclass" : "comment",
				"text" : "select a source",
				"numinlets" : 1,
				"numoutlets" : 0,
				"id" : "obj-13",
				"patching_rect" : [ 47.5, 121.166655999999989, 91.0, 20.0 ],
				"textcolor" : [ 0.5, 0.5, 0.5, 1.0 ]
			}

		}
, 		{
			"box" : 			{
				"maxclass" : "textbutton",
				"hint" : "",
				"numinlets" : 1,
				"fontname" : "Arial Bold",
				"numoutlets" : 3,
				"ignoreclick" : 1,
				"id" : "obj-14",
				"rounded" : 60.0,
				"patching_rect" : [ 20.0, 121.166655999999989, 20.0, 20.0 ],
				"outlettype" : [ "", "", "int" ],
				"textcolor" : [ 0.34902, 0.34902, 0.34902, 1.0 ],
				"text" : "1",
				"legacytextcolor" : 1,
				"bgcolor" : [ 1.0, 0.788235, 0.470588, 1.0 ],
				"parameter_enable" : 0
			}

		}
, 		{
			"box" : 			{
				"maxclass" : "comment",
				"text" : "play source",
				"numinlets" : 1,
				"numoutlets" : 0,
				"id" : "obj-25",
				"patching_rect" : [ 271.0, 328.333344000000011, 72.0, 20.0 ],
				"textcolor" : [ 0.5, 0.5, 0.5, 1.0 ]
			}

		}
, 		{
			"box" : 			{
				"maxclass" : "textbutton",
				"hint" : "",
				"numinlets" : 1,
				"fontname" : "Arial Bold",
				"numoutlets" : 3,
				"ignoreclick" : 1,
				"id" : "obj-30",
				"rounded" : 60.0,
				"patching_rect" : [ 241.0, 325.333344000000011, 20.0, 20.0 ],
				"outlettype" : [ "", "", "int" ],
				"textcolor" : [ 0.34902, 0.34902, 0.34902, 1.0 ],
				"text" : "2",
				"legacytextcolor" : 1,
				"bgcolor" : [ 1.0, 0.788235, 0.470588, 1.0 ],
				"parameter_enable" : 0
			}

		}
, 		{
			"box" : 			{
				"maxclass" : "comment",
				"text" : "select a slice",
				"numinlets" : 1,
				"numoutlets" : 0,
				"id" : "obj-31",
				"patching_rect" : [ 124.833343999999997, 287.833312999999976, 79.0, 20.0 ],
				"textcolor" : [ 0.5, 0.5, 0.5, 1.0 ]
			}

		}
, 		{
			"box" : 			{
				"maxclass" : "comment",
				"text" : "slices found",
				"numinlets" : 1,
				"numoutlets" : 0,
				"id" : "obj-32",
				"patching_rect" : [ 335.0, 274.0, 74.0, 20.0 ],
				"textcolor" : [ 0.5, 0.5, 0.5, 1.0 ]
			}

		}
, 		{
			"box" : 			{
				"maxclass" : "comment",
				"text" : "trigger the process",
				"numinlets" : 1,
				"numoutlets" : 0,
				"id" : "obj-33",
				"patching_rect" : [ 415.666655999999989, 115.0, 110.0, 20.0 ],
				"textcolor" : [ 0.5, 0.5, 0.5, 1.0 ]
			}

		}
, 		{
			"box" : 			{
				"maxclass" : "textbutton",
				"hint" : "",
				"numinlets" : 1,
				"fontname" : "Arial Bold",
				"numoutlets" : 3,
				"ignoreclick" : 1,
				"id" : "obj-34",
				"rounded" : 60.0,
				"patching_rect" : [ 392.166655999999989, 115.0, 20.0, 20.0 ],
				"outlettype" : [ "", "", "int" ],
				"textcolor" : [ 0.34902, 0.34902, 0.34902, 1.0 ],
				"text" : "3",
				"legacytextcolor" : 1,
				"bgcolor" : [ 1.0, 0.788235, 0.470588, 1.0 ],
				"parameter_enable" : 0
			}

		}
, 		{
			"box" : 			{
				"maxclass" : "textbutton",
				"hint" : "",
				"numinlets" : 1,
				"fontname" : "Arial Bold",
				"numoutlets" : 3,
				"ignoreclick" : 1,
				"id" : "obj-36",
				"rounded" : 60.0,
				"patching_rect" : [ 102.833343999999997, 287.833312999999976, 20.0, 20.0 ],
				"outlettype" : [ "", "", "int" ],
				"textcolor" : [ 0.34902, 0.34902, 0.34902, 1.0 ],
				"text" : "4",
				"legacytextcolor" : 1,
				"bgcolor" : [ 1.0, 0.788235, 0.470588, 1.0 ],
				"parameter_enable" : 0
			}

		}
, 		{
			"box" : 			{
				"maxclass" : "message",
				"text" : "0",
				"numinlets" : 2,
				"numoutlets" : 1,
				"id" : "obj-37",
				"patching_rect" : [ 329.0, 244.0, 50.0, 22.0 ],
				"outlettype" : [ "" ]
			}

		}
, 		{
			"box" : 			{
				"maxclass" : "newobj",
				"text" : "getattr samps",
				"numinlets" : 1,
				"numoutlets" : 3,
				"id" : "obj-39",
				"patching_rect" : [ 360.0, 213.333313000000004, 83.0, 22.0 ],
				"outlettype" : [ "", "", "" ]
			}

		}
, 		{
			"box" : 			{
				"maxclass" : "button",
				"numinlets" : 1,
				"numoutlets" : 1,
				"id" : "obj-40",
				"patching_rect" : [ 360.0, 113.0, 24.0, 24.0 ],
				"outlettype" : [ "bang" ],
				"parameter_enable" : 0
			}

		}
, 		{
			"box" : 			{
				"maxclass" : "message",
				"text" : "stop",
				"numinlets" : 2,
				"numoutlets" : 1,
				"id" : "obj-41",
				"patching_rect" : [ 282.0, 356.333344000000011, 33.0, 22.0 ],
				"outlettype" : [ "" ]
			}

		}
, 		{
			"box" : 			{
				"maxclass" : "message",
				"text" : "start",
				"numinlets" : 2,
				"numoutlets" : 1,
				"id" : "obj-44",
				"patching_rect" : [ 247.0, 356.333344000000011, 34.0, 22.0 ],
				"outlettype" : [ "" ]
			}

		}
, 		{
			"box" : 			{
				"maxclass" : "ezdac~",
				"numinlets" : 2,
				"numoutlets" : 0,
				"id" : "obj-45",
				"patching_rect" : [ 149.0, 465.999968999999965, 45.0, 45.0 ],
				"local" : 1
			}

		}
, 		{
			"box" : 			{
				"maxclass" : "newobj",
				"text" : "play~ src 2",
				"numinlets" : 1,
				"numoutlets" : 3,
				"id" : "obj-46",
				"patching_rect" : [ 150.0, 420.0, 69.0, 22.0 ],
				"outlettype" : [ "signal", "signal", "bang" ],
				"textcolor" : [ 0.0, 0.0, 0.0, 1.0 ],
				"bgcolor" : [ 0.843137254901961, 0.741176470588235, 0.431372549019608, 1.0 ]
			}

		}
, 		{
			"box" : 			{
				"maxclass" : "newobj",
				"text" : "buffer~ slicestarts",
				"numinlets" : 1,
				"numoutlets" : 2,
				"id" : "obj-47",
				"patching_rect" : [ 392.0, 244.0, 105.0, 22.0 ],
				"outlettype" : [ "float", "bang" ],
				"bgcolor" : [ 0.192156862745098, 0.63921568627451, 0.443137254901961, 1.0 ]
			}

		}
, 		{
			"box" : 			{
				"maxclass" : "newobj",
				"text" : "fluid.bufampslice~ @source src @indices slicestarts @slowrampup 4410 @slowrampdown 4410 @onthreshold 10 @offthreshold 5 @fastrampup 10 @fastrampdown 2205 @minslicelength 4410 @highpassfreq 20 @floor -40",
				"linecount" : 3,
				"numinlets" : 1,
				"numoutlets" : 3,
				"id" : "obj-48",
				"patching_rect" : [ 360.0, 150.0, 411.0, 50.0 ],
				"outlettype" : [ "bang", "float", "" ],
				"bgcolor" : [ 0.352941176470588, 0.337254901960784, 0.52156862745098, 1.0 ]
			}

		}
, 		{
			"box" : 			{
				"maxclass" : "attrui",
				"numinlets" : 1,
				"text_width" : 49.0,
				"numoutlets" : 1,
				"id" : "obj-52",
				"patching_rect" : [ 360.0, 360.0, 78.0, 22.0 ],
				"outlettype" : [ "" ],
				"attr" : "loop",
				"attrfilter" : [ "loop" ],
				"menu_display" : 1,
				"lock" : 1
			}

		}
, 		{
			"box" : 			{
				"maxclass" : "jsui",
				"numinlets" : 1,
				"numoutlets" : 1,
				"border" : 0,
				"ignoreclick" : 1,
				"jsarguments" : [ "fluid.bufampslice~" ],
				"id" : "obj-5",
				"patching_rect" : [ 10.0, 10.0, 389.504058837890625, 57.600002288818359 ],
				"outlettype" : [ "" ],
				"filename" : "helpname.js",
				"parameter_enable" : 0
			}

		}
, 		{
			"box" : 			{
				"maxclass" : "message",
				"text" : "844.172336",
				"numinlets" : 2,
				"numoutlets" : 1,
				"id" : "obj-11",
				"patching_rect" : [ 26.0, 420.0, 74.0, 22.0 ],
				"outlettype" : [ "" ]
			}

		}
, 		{
			"box" : 			{
				"maxclass" : "number",
				"numinlets" : 1,
				"numoutlets" : 2,
				"id" : "obj-49",
				"patching_rect" : [ 81.0, 328.333312999999976, 50.0, 22.0 ],
				"outlettype" : [ "", "bang" ],
				"parameter_enable" : 0
			}

		}
, 		{
			"box" : 			{
				"maxclass" : "attrui",
				"numinlets" : 1,
				"numoutlets" : 1,
				"id" : "obj-1",
				"patching_rect" : [ 528.666655999999989, 120.0, 150.0, 22.0 ],
				"outlettype" : [ "" ],
				"attr" : "fastrampdown"
			}

		}
, 		{
			"box" : 			{
				"maxclass" : "attrui",
				"numinlets" : 1,
				"numoutlets" : 1,
				"id" : "obj-2",
				"patching_rect" : [ 528.666655999999989, 96.0, 150.0, 22.0 ],
				"outlettype" : [ "" ],
				"attr" : "fastrampup"
			}

		}
 ],
	"lines" : [ 		{
			"patchline" : 			{
				"source" : [ "obj-58", 1 ],
				"destination" : [ "obj-46", 0 ]
			}

		}
, 		{
			"patchline" : 			{
				"source" : [ "obj-58", 0 ],
				"destination" : [ "obj-11", 1 ]
			}

		}
, 		{
			"patchline" : 			{
				"source" : [ "obj-52", 0 ],
				"destination" : [ "obj-46", 0 ]
			}

		}
, 		{
			"patchline" : 			{
				"source" : [ "obj-49", 0 ],
				"destination" : [ "obj-58", 0 ]
			}

		}
, 		{
			"patchline" : 			{
				"source" : [ "obj-48", 0 ],
				"destination" : [ "obj-39", 0 ]
			}

		}
, 		{
			"patchline" : 			{
				"source" : [ "obj-46", 0 ],
				"destination" : [ "obj-45", 0 ]
			}

		}
, 		{
			"patchline" : 			{
				"source" : [ "obj-46", 1 ],
				"destination" : [ "obj-45", 1 ]
			}

		}
, 		{
			"patchline" : 			{
				"source" : [ "obj-44", 0 ],
				"destination" : [ "obj-46", 0 ]
			}

		}
, 		{
			"patchline" : 			{
				"source" : [ "obj-41", 0 ],
				"destination" : [ "obj-46", 0 ]
			}

		}
, 		{
			"patchline" : 			{
				"source" : [ "obj-40", 0 ],
				"destination" : [ "obj-48", 0 ]
			}

		}
, 		{
			"patchline" : 			{
				"source" : [ "obj-39", 1 ],
				"destination" : [ "obj-47", 0 ]
			}

		}
, 		{
			"patchline" : 			{
				"source" : [ "obj-39", 0 ],
				"destination" : [ "obj-37", 1 ]
			}

		}
, 		{
			"patchline" : 			{
				"source" : [ "obj-2", 0 ],
				"destination" : [ "obj-48", 0 ]
			}

		}
, 		{
			"patchline" : 			{
				"source" : [ "obj-12", 0 ],
				"destination" : [ "obj-16", 0 ]
			}

		}
, 		{
			"patchline" : 			{
				"source" : [ "obj-1", 0 ],
				"destination" : [ "obj-48", 0 ]
			}

		}
 ],
	"appversion" : 	{
		"major" : 8,
		"minor" : 2,
		"revision" : 1,
		"architecture" : "x64",
		"modernui" : 1
	}
,
	"styles" : [ 		{
			"name" : "max6box",
			"default" : 			{
				"textcolor_inverse" : [ 0.0, 0.0, 0.0, 1.0 ],
				"accentcolor" : [ 0.8, 0.839216, 0.709804, 1.0 ],
				"bgcolor" : [ 1.0, 1.0, 1.0, 0.5 ]
			}
,
			"parentstyle" : "",
			"multi" : 0
		}
, 		{
			"name" : "max6inlet",
			"default" : 			{
				"color" : [ 0.423529, 0.372549, 0.27451, 1.0 ]
			}
,
			"parentstyle" : "",
			"multi" : 0
		}
, 		{
			"name" : "max6message",
			"default" : 			{
				"textcolor_inverse" : [ 0.0, 0.0, 0.0, 1.0 ],
				"bgfillcolor" : 				{
					"type" : "gradient",
					"color1" : [ 0.866667, 0.866667, 0.866667, 1.0 ],
					"color2" : [ 0.788235, 0.788235, 0.788235, 1.0 ],
					"color" : [ 0.290196, 0.309804, 0.301961, 1.0 ],
					"angle" : 270.0,
					"proportion" : 0.39,
					"autogradient" : 0
				}

			}
,
			"parentstyle" : "max6box",
			"multi" : 0
		}
, 		{
			"name" : "max6outlet",
			"default" : 			{
				"color" : [ 0.0, 0.454902, 0.498039, 1.0 ]
			}
,
			"parentstyle" : "",
			"multi" : 0
		}
 ],
	"classnamespace" : "box"
}

(sorry for the code box but it wouldn’t let me upload a .maxhelp file!)
Hope this is helpful more than confusing!
Ciao and have a great saturday night
Giovanni

[weefuzzy]

Thanks for the suggestion! I think the older help files like this one are probably in line for quite a bit of redevelopment anyway, including reviewing some of these spatially disjointed chains of instructions. So, don’t worry about a PR for this: there’s too much of a moving target at the moment, and doing merges between max patche JSON is not completely reliable.

@gionogio

(sorry for the code box but it wouldn’t let me upload a .maxhelp file!)

We’ll look at that, but fwiw .maxpat would work, I think. When you copy max code, it can be made less huge by using ‘copy compressed’ on the edit menu.

[jamesbradbury]

Thanks for the feedback on the docs!

As Owen pointed out PRs right now might not be the best use of anyone’s time as things are being broke and reshaped as we speak. What you say does track though and I find colour is one of the best ways to point out the relationships between buffers and objects for example.

This is a new help file coming for example which is quite light on colour actually!