Docs update 1.0.2661

cmajor-lang · Oct 3, 2024 · 00ffb38 · 00ffb38
1 parent 80c908f
commit 00ffb38
Show file tree

Hide file tree

Showing 17 changed files with 47 additions and 14 deletions.
diff --git a/assets/example_patches/808/cmaj_808.js b/assets/example_patches/808/cmaj_808.js
@@ -3,7 +3,7 @@
 //  This file contains a Javascript/Webassembly/WebAudio export of the Cmajor
 //  patch '808.cmajorpatch'.
 //
-//  This file was auto-generated by the Cmajor toolkit v1.0.2660
+//  This file was auto-generated by the Cmajor toolkit v1.0.2661
 //
 //  To use it, import this module into your HTML/Javascript code and call
 //  `createAudioWorkletNodePatchConnection()`. The AudioWorkletPatchConnection

diff --git a/assets/example_patches/CompuFart/cmaj_CompuFart.js b/assets/example_patches/CompuFart/cmaj_CompuFart.js
@@ -3,7 +3,7 @@
 //  This file contains a Javascript/Webassembly/WebAudio export of the Cmajor
 //  patch 'CompuFartSynth.cmajorpatch'.
 //
-//  This file was auto-generated by the Cmajor toolkit v1.0.2660
+//  This file was auto-generated by the Cmajor toolkit v1.0.2661
 //
 //  To use it, import this module into your HTML/Javascript code and call
 //  `createAudioWorkletNodePatchConnection()`. The AudioWorkletPatchConnection

diff --git a/assets/example_patches/ElectricPiano/cmaj_Electric_Piano.js b/assets/example_patches/ElectricPiano/cmaj_Electric_Piano.js
diff --git a/assets/example_patches/GuitarLSTM/cmaj_GuitarLSTM.js b/assets/example_patches/GuitarLSTM/cmaj_GuitarLSTM.js
diff --git a/assets/example_patches/HelloWorld/cmaj_Hello_World.js b/assets/example_patches/HelloWorld/cmaj_Hello_World.js
@@ -3,7 +3,7 @@
 //  This file contains a Javascript/Webassembly/WebAudio export of the Cmajor
 //  patch 'HelloWorld.cmajorpatch'.
 //
-//  This file was auto-generated by the Cmajor toolkit v1.0.2660
+//  This file was auto-generated by the Cmajor toolkit v1.0.2661
 //
 //  To use it, import this module into your HTML/Javascript code and call
 //  `createAudioWorkletNodePatchConnection()`. The AudioWorkletPatchConnection

diff --git a/assets/example_patches/Piano/cmaj_Piano.js b/assets/example_patches/Piano/cmaj_Piano.js
@@ -3,7 +3,7 @@
 //  This file contains a Javascript/Webassembly/WebAudio export of the Cmajor
 //  patch 'Piano.cmajorpatch'.
 //
-//  This file was auto-generated by the Cmajor toolkit v1.0.2660
+//  This file was auto-generated by the Cmajor toolkit v1.0.2661
 //
 //  To use it, import this module into your HTML/Javascript code and call
 //  `createAudioWorkletNodePatchConnection()`. The AudioWorkletPatchConnection

diff --git a/assets/example_patches/PirkleFilters/cmaj_vafilters.js b/assets/example_patches/PirkleFilters/cmaj_vafilters.js
diff --git a/assets/example_patches/Pro54/cmaj_Pro54.js b/assets/example_patches/Pro54/cmaj_Pro54.js
@@ -3,7 +3,7 @@
 //  This file contains a Javascript/Webassembly/WebAudio export of the Cmajor
 //  patch 'Pro54.cmajorpatch'.
 //
-//  This file was auto-generated by the Cmajor toolkit v1.0.2660
+//  This file was auto-generated by the Cmajor toolkit v1.0.2661
 //
 //  To use it, import this module into your HTML/Javascript code and call
 //  `createAudioWorkletNodePatchConnection()`. The AudioWorkletPatchConnection

diff --git a/assets/example_patches/Replicant/cmaj_Replicant.js b/assets/example_patches/Replicant/cmaj_Replicant.js
diff --git a/assets/example_patches/RingMod/cmaj_Ring_Mod_Demo.js b/assets/example_patches/RingMod/cmaj_Ring_Mod_Demo.js
@@ -3,7 +3,7 @@
 //  This file contains a Javascript/Webassembly/WebAudio export of the Cmajor
 //  patch 'RingMod.cmajorpatch'.
 //
-//  This file was auto-generated by the Cmajor toolkit v1.0.2660
+//  This file was auto-generated by the Cmajor toolkit v1.0.2661
 //
 //  To use it, import this module into your HTML/Javascript code and call
 //  `createAudioWorkletNodePatchConnection()`. The AudioWorkletPatchConnection

diff --git a/assets/example_patches/STunedBar6/cmaj_STunedBar6.js b/assets/example_patches/STunedBar6/cmaj_STunedBar6.js
diff --git a/assets/example_patches/SubtractOne/cmaj_SubtractOne.js b/assets/example_patches/SubtractOne/cmaj_SubtractOne.js
diff --git a/assets/example_patches/Tremolo/cmaj_Tremolo.js b/assets/example_patches/Tremolo/cmaj_Tremolo.js
@@ -3,7 +3,7 @@
 //  This file contains a Javascript/Webassembly/WebAudio export of the Cmajor
 //  patch 'Tremolo.cmajorpatch'.
 //
-//  This file was auto-generated by the Cmajor toolkit v1.0.2660
+//  This file was auto-generated by the Cmajor toolkit v1.0.2661
 //
 //  To use it, import this module into your HTML/Javascript code and call
 //  `createAudioWorkletNodePatchConnection()`. The AudioWorkletPatchConnection

diff --git a/assets/example_patches/ZitaReverb/cmaj_Zita_Reverb.js b/assets/example_patches/ZitaReverb/cmaj_Zita_Reverb.js
@@ -3,7 +3,7 @@
 //  This file contains a Javascript/Webassembly/WebAudio export of the Cmajor
 //  patch 'ZitaReverb.cmajorpatch'.
 //
-//  This file was auto-generated by the Cmajor toolkit v1.0.2660
+//  This file was auto-generated by the Cmajor toolkit v1.0.2661
 //
 //  To use it, import this module into your HTML/Javascript code and call
 //  `createAudioWorkletNodePatchConnection()`. The AudioWorkletPatchConnection

diff --git a/cmaj_api/cmaj-compiler-wasm.wasm b/cmaj_api/cmaj-compiler-wasm.wasm
diff --git a/docs/LanguageGuide/inputoutput-endpoint-declarations/renaming-hoisted-endpoints.md b/docs/LanguageGuide/inputoutput-endpoint-declarations/renaming-hoisted-endpoints.md
@@ -0,0 +1,8 @@
+---
+layout: default
+title: Renaming hoisted endpoints
+permalink: /docs/LanguageReference#renaming-hoisted-endpoints
+parent: Input/Output Endpoint Declarations
+grand_parent: Language Reference
+nav_order: 5
+---
diff --git a/docs/LanguageGuide/main.md b/docs/LanguageGuide/main.md
@@ -1311,6 +1311,31 @@ graph Parent
 }
 ```
 
+### Renaming hoisted endpoints
+
+It is possible to rename a hoisted enpoint, and to provide a pattern to rename wildcarded hoisted endpoints, e.g:
+
+```cpp
+graph Parent
+{
+    output child1.outL child1outL;      // Rename outL as child1outL
+    output child1.outR child1outR;      // Rename outR as child1outR;
+
+    output child2.* child2*;            // Hoist child2 outL and outR renamed as child2outL and child2outR
+
+    node child1 = Child;
+    node child2 = Child;
+}
+
+graph Child
+{
+    output stream float outL, outR;
+}
+
+```
+
+When renaming a wildcarded endpoint, unique names are generated by substituting the hoisted endpoint name into the provided name, replacing the `*` character.
+
 ## Writing to Outputs
 
 To write to any kind of output endpoint, use the left-arrow operator: