Merge pull request #56 from chkworks/update/6.1.2

Update/6.1.2
chkworks · Oct 6, 2024 · 47eecae · 47eecae
2 parents 8e9c62a + d4b37c8
commit 47eecae
Show file tree

Hide file tree

Showing 23 changed files with 261 additions and 285 deletions.
diff --git a/README.md b/README.md
@@ -70,9 +70,9 @@ When the package is successfully installed, hit F1 to open the Help Browser and
 Currently I am working on the last bits of this tutorial series. Please consider supporting the development, if this tutorial has helped you and your practice so far and you want to speed things up!
 
 ### Part V: The Origin of Life
-38. Operations ***WIP***
-39. Mutability vs. Immutability ***WIP***
-40. Object-Oriented Patching ***WIP***
+38. Object-Oriented Patching ***WIP***
+39. Operations ***WIP***
+40. Mutability vs. Immutability ***WIP***
 41. Records & Classes ***WIP***
 42. The Lifecycle of an Object ***WIP***
 
@@ -82,18 +82,17 @@ Currently I am working on the last bits of this tutorial series. Please consider
 45. Serialization ***WIP***
 46. Data Structures ***WIP***
 47. Networking ***WIP***
-48. ImGui ***WIP***
-49. State Management ***WIP***
-50. Useful Libraries ***WIP***
+48. Reactive Programming ***WIP***
+49. Channels ***WIP***
 
 ### Part VII: The Search for Extraterrestrial Intelligence
-51. Project Structure ***WIP***
-52. Reactive Programming ***WIP***
-53. Channels ***WIP***
-54. Mutable Collections ***WIP***
-55. Interfaces ***WIP***
-56. Design Patterns ***WIP***
-57. Creating a Library ***WIP**
+50. Project Structure ***WIP***
+51. State Management ***WIP***
+52. Building User Interfaces ***WIP***
+53. Libraries ***WIP***
+54. Interfaces ***WIP***
+55. Design Patterns ***WIP***
+56. Creating a Library ***WIP**
 
 [![ko-fi](https://ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/T6T3I9XX6)
 

diff --git a/deployment/VL.TheBigBang.nuspec b/deployment/VL.TheBigBang.nuspec
@@ -2,7 +2,7 @@
 <package xmlns="http://schemas.microsoft.com/packaging/2010/07/nuspec.xsd">
   <metadata>
     <id>VL.TheBigBang</id>
-    <version>6.1.1</version>
+    <version>6.1.2</version>
     <title>VL.TheBigBang</title>
     <authors>chk</authors>
     <projectUrl>https://www.3e8.studio/</projectUrl>

diff --git a/help/I. The Initial Singularity/Explanation 00. Introduction.vl b/help/I. The Initial Singularity/Explanation 00. Introduction.vl
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
-<Document xmlns:p="property" xmlns:r="reflection" Id="SSTW8S2OzPqMR3n258QwT8" LanguageVersion="2024.6.0-0224-g1141930e4a" Version="0.128">
-  <NugetDependency Id="UMoe9l8tI6dPh7545hvloL" Location="VL.CoreLib" Version="2024.6.0-0224-g1141930e4a" />
+<Document xmlns:p="property" xmlns:r="reflection" Id="SSTW8S2OzPqMR3n258QwT8" LanguageVersion="2024.6.7-0181-gdf16f593e1" Version="0.128">
+  <NugetDependency Id="UMoe9l8tI6dPh7545hvloL" Location="VL.CoreLib" Version="2024.6.7-0181-gdf16f593e1" />
   <Patch Id="KwSh7UM9sxiNLbciPo4zVS">
     <Canvas Id="UBsROYmZbNYOhlf9jNrHmH" DefaultCategory="Main" BordersChecked="false" CanvasType="FullCategory" />
     <!--
@@ -15,7 +15,7 @@
       </p:NodeReference>
       <Patch Id="KEiz3yQbQs3MyCgsgQDYqc">
         <Canvas Id="Cv1qPAMTAeYNCFAcrowdm0" CanvasType="Group">
-          <Pad Id="VdZCXszFlSON1HfgcESosE" Bounds="92,207,401,220" ShowValueBox="true" isIOBox="true" Value="Dear patcher - welcome to vvvv, a visual programming environment for technologists in creative coding, interaction design, software engineering, and the like! &#xD;&#xA;&#xD;&#xA;In this tutorial series, I would like to guide you step by step through the learning process of the basic principles and techniques to create your real-time applications. By the end of it, you will have seen all nodes in action, that I consider most important and you will have a solid base for going deeper into the endless possibilities of this environment. &#xD;&#xA;&#xD;&#xA;To get started, please first watch this official on-boarding video:&#xD;&#xA;&#xD;&#xA;&#xD;&#xA;&#xD;&#xA;">
+          <Pad Id="VdZCXszFlSON1HfgcESosE" Bounds="92,207,402,223" ShowValueBox="true" isIOBox="true" Value="Dear patcher - welcome to vvvv, a visual programming environment for technologists in creative coding, interaction design, software engineering, and the like! &#xD;&#xA;&#xD;&#xA;In this tutorial series, I would like to guide you step by step through the learning process of the basic principles and techniques to create your real-time applications. By the end of it, you will have seen all nodes in action, that I consider most important and you will have a solid base for going deeper into the endless possibilities of this environment. &#xD;&#xA;&#xD;&#xA;To get started, please first watch this official on-boarding video:&#xD;&#xA;&#xD;&#xA;&#xD;&#xA;&#xD;&#xA;">
             <p:TypeAnnotation LastCategoryFullName="Primitive" LastDependency="VL.CoreLib.vl">
               <Choice Kind="TypeFlag" Name="String" />
             </p:TypeAnnotation>
@@ -43,7 +43,7 @@
               <p:stringtype p:Assembly="VL.Core" p:Type="VL.Core.StringType">Comment</p:stringtype>
             </p:ValueBoxSettings>
           </Pad>
-          <Pad Id="OCFY2LwBgsGMs4mmP72QNO" Bounds="92,431,198,19" ShowValueBox="true" isIOBox="true" Value="https://youtu.be/JkCvVja4YlY">
+          <Pad Id="OCFY2LwBgsGMs4mmP72QNO" Bounds="92,432,198,19" ShowValueBox="true" isIOBox="true" Value="https://youtu.be/JkCvVja4YlY">
             <p:TypeAnnotation LastCategoryFullName="Primitive" LastDependency="VL.CoreLib.vl">
               <Choice Kind="TypeFlag" Name="String" />
             </p:TypeAnnotation>
@@ -124,7 +124,7 @@
               <p:stringtype p:Assembly="VL.Core" p:Type="VL.Core.StringType">Comment</p:stringtype>
             </p:ValueBoxSettings>
           </Pad>
-          <Pad Id="FfFJ9x3eTYQLqRuIQC4iRN" Bounds="1092,244,401,202" ShowValueBox="true" isIOBox="true" Value="This series tries to provide a path for you to learn vvvv and VL, but it is highly advised to also explore the environment on your own and play around! Many of the nodes come with dedicated help patches, which open when you select the node and hit F1. Also you should always check out the same category of the node which you are currently using in the Node Browser.&#xD;&#xA;&#xD;&#xA;The best resources to learn more right now are still the Help Browser, which comes with a huge amount of interactive examples and the Gray Book. This is the official documentation for vvvv and VL and is constantly growing and updated. ">
+          <Pad Id="FfFJ9x3eTYQLqRuIQC4iRN" Bounds="1092,244,401,206" ShowValueBox="true" isIOBox="true" Value="This series tries to provide a path for you to learn vvvv and VL, but it is highly advised to also explore the environment on your own and play around! Many of the nodes come with dedicated help patches, which open when you select the node and hit F1. Also you should always check out the same category of the node which you are currently using in the Node Browser.&#xD;&#xA;&#xD;&#xA;The best resources to learn more right now are still the Help Browser, which comes with a huge amount of interactive examples and the Gray Book. This is the official documentation for vvvv and VL and is constantly growing and updated. ">
             <p:TypeAnnotation LastCategoryFullName="Primitive" LastDependency="VL.CoreLib.vl">
               <Choice Kind="TypeFlag" Name="String" />
             </p:TypeAnnotation>
@@ -142,7 +142,7 @@
               <p:stringtype p:Assembly="VL.Core" p:Type="VL.Core.StringType">Comment</p:stringtype>
             </p:ValueBoxSettings>
           </Pad>
-          <Pad Id="NxE21otk9SCOhSSkD6jFVs" Bounds="1092,452,187,19" ShowValueBox="true" isIOBox="true" Value="https://thegraybook.vvvv.org/">
+          <Pad Id="NxE21otk9SCOhSSkD6jFVs" Bounds="1092,453,209,19" ShowValueBox="true" isIOBox="true" Value="https://thegraybook.vvvv.org/">
             <p:TypeAnnotation LastCategoryFullName="Primitive" LastDependency="VL.CoreLib.vl">
               <Choice Kind="TypeFlag" Name="String" />
             </p:TypeAnnotation>
@@ -160,7 +160,7 @@
               <p:stringtype p:Assembly="VL.Core" p:Type="VL.Core.StringType">Comment</p:stringtype>
             </p:ValueBoxSettings>
           </Pad>
-          <Pad Id="UH7jy4LQUHYNcBRmpqhpoQ" Bounds="1092,915,401,53" ShowValueBox="true" isIOBox="true" Value="And now let's jump right in! Have fun with the following 37 patches and if something is not clear enough or not working on your side, let me know on GitHub!">
+          <Pad Id="UH7jy4LQUHYNcBRmpqhpoQ" Bounds="1092,915,403,59" ShowValueBox="true" isIOBox="true" Value="And now let's jump right in! Have fun with the following 37 patches and if something is not clear enough or not working on your side, let me know on GitHub!">
             <p:TypeAnnotation LastCategoryFullName="Primitive" LastDependency="VL.CoreLib.vl">
               <Choice Kind="TypeFlag" Name="String" />
             </p:TypeAnnotation>

diff --git a/help/I. The Initial Singularity/Explanation 01. Types and IOBoxes.vl b/help/I. The Initial Singularity/Explanation 01. Types and IOBoxes.vl
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
-<Document xmlns:p="property" xmlns:r="reflection" Id="PHe2BKlTIvLLKwESjiFKa6" LanguageVersion="2024.6.0-0224-g1141930e4a" Version="0.128">
-  <NugetDependency Id="UMoe9l8tI6dPh7545hvloL" Location="VL.CoreLib" Version="2024.6.0-0224-g1141930e4a" />
+<Document xmlns:p="property" xmlns:r="reflection" Id="PHe2BKlTIvLLKwESjiFKa6" LanguageVersion="2024.6.7-0181-gdf16f593e1" Version="0.128">
+  <NugetDependency Id="UMoe9l8tI6dPh7545hvloL" Location="VL.CoreLib" Version="2024.6.7-0181-gdf16f593e1" />
   <Patch Id="KwSh7UM9sxiNLbciPo4zVS">
     <Canvas Id="UBsROYmZbNYOhlf9jNrHmH" DefaultCategory="Main" BordersChecked="false" CanvasType="FullCategory" />
     <!--
@@ -142,7 +142,7 @@
               <p:stringtype p:Assembly="VL.Core" p:Type="VL.Core.StringType">Comment</p:stringtype>
             </p:ValueBoxSettings>
           </Pad>
-          <Pad Id="Sfo1EZgdKn8Lbb8FE1TNbH" Bounds="92,596,401,54" ShowValueBox="true" isIOBox="true" Value="A boolean represents two states - true or false, also sometimes referred to 0 and 1. It can be represented by three different IOBoxes.">
+          <Pad Id="Sfo1EZgdKn8Lbb8FE1TNbH" Bounds="92,596,401,59" ShowValueBox="true" isIOBox="true" Value="A boolean represents two states - true or false, also sometimes referred to 0 and 1. It can be represented by three different IOBoxes.">
             <p:TypeAnnotation LastCategoryFullName="Primitive" LastDependency="VL.CoreLib.vl">
               <Choice Kind="TypeFlag" Name="String" />
             </p:TypeAnnotation>
@@ -169,7 +169,7 @@
               <p:stringtype p:Assembly="VL.Core" p:Type="VL.Core.StringType">Comment</p:stringtype>
             </p:ValueBoxSettings>
           </Pad>
-          <Pad Id="Vb3j6s64gOEO1UwGui7D9G" Bounds="161,766,332,36" ShowValueBox="true" isIOBox="true" Value="A Press outputs True as long it is pressed with the right mouse button.">
+          <Pad Id="Vb3j6s64gOEO1UwGui7D9G" Bounds="161,766,332,41" ShowValueBox="true" isIOBox="true" Value="A Press outputs True as long it is pressed with the right mouse button.">
             <p:TypeAnnotation LastCategoryFullName="Primitive" LastDependency="VL.CoreLib.vl">
               <Choice Kind="TypeFlag" Name="String" />
             </p:TypeAnnotation>
@@ -223,7 +223,7 @@
               <p:stringtype p:Assembly="VL.Core" p:Type="VL.Core.StringType">Comment</p:stringtype>
             </p:ValueBoxSettings>
           </Pad>
-          <Pad Id="EQyAlneUodBOvCjmpssbPb" Bounds="592,564,393,36" ShowValueBox="true" isIOBox="true" Value="RGBA represents a color data type, consisting of values for hue, saturation, value and alpha.">
+          <Pad Id="EQyAlneUodBOvCjmpssbPb" Bounds="592,564,393,38" ShowValueBox="true" isIOBox="true" Value="RGBA represents a color data type, consisting of values for hue, saturation, value and alpha.">
             <p:TypeAnnotation LastCategoryFullName="Primitive" LastDependency="VL.CoreLib.vl">
               <Choice Kind="TypeFlag" Name="String" />
             </p:TypeAnnotation>

diff --git a/help/I. The Initial Singularity/Explanation 02. Nodes and Pins.vl b/help/I. The Initial Singularity/Explanation 02. Nodes and Pins.vl
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
-<Document xmlns:p="property" xmlns:r="reflection" Id="GKW1venJYRdLn7PBnEEEkQ" LanguageVersion="2024.6.0-0224-g1141930e4a" Version="0.128">
-  <NugetDependency Id="UMoe9l8tI6dPh7545hvloL" Location="VL.CoreLib" Version="2024.6.0-0224-g1141930e4a" />
+<Document xmlns:p="property" xmlns:r="reflection" Id="GKW1venJYRdLn7PBnEEEkQ" LanguageVersion="2024.6.7-0181-gdf16f593e1" Version="0.128">
+  <NugetDependency Id="UMoe9l8tI6dPh7545hvloL" Location="VL.CoreLib" Version="2024.6.7-0181-gdf16f593e1" />
   <Patch Id="KwSh7UM9sxiNLbciPo4zVS">
     <Canvas Id="UBsROYmZbNYOhlf9jNrHmH" DefaultCategory="Main" BordersChecked="false" CanvasType="FullCategory" />
     <!--
@@ -247,7 +247,7 @@
             <Pin Id="GjCYbp9qympMJTVQU0YYIP" Name="Input 2" Kind="InputPin" />
             <Pin Id="N0sd2bdofK2PMPOmnmA77y" Name="Output" Kind="OutputPin" />
           </Node>
-          <Pad Id="Vj2VFrcywIKNySHd8J5hOH" Bounds="592,343,400,220" ShowValueBox="true" isIOBox="true" Value="While the data types for all pins of the LFO are defined, the + expects a type T for all inputs and outputs. Also the node is grayed out. &#xD;&#xA;&#xD;&#xA;This is one key concept of vvvv: grayed out nodes are so-called adaptive nodes and will come alive, once they are connected to IOBoxes or pins which are already set to a certain data type. Until then, they don't know which data type to process.&#xD;&#xA;&#xD;&#xA;Therefore, when exposing pins of the + node, you will get asked, which data type the IOBox should be. Try connecting an Integer, Float or a String and see the difference of the output.">
+          <Pad Id="Vj2VFrcywIKNySHd8J5hOH" Bounds="592,343,401,226" ShowValueBox="true" isIOBox="true" Value="While the data types for all pins of the LFO are defined, the + expects a type T for all inputs and outputs. Also the node is grayed out. &#xD;&#xA;&#xD;&#xA;This is one key concept of vvvv: grayed out nodes are so-called adaptive nodes and will come alive, once they are connected to IOBoxes or pins which are already set to a certain data type. Until then, they don't know which data type to process.&#xD;&#xA;&#xD;&#xA;Therefore, when exposing pins of the + node, you will get asked, which data type the IOBox should be. Try connecting an Integer, Float or a String and see the difference of the output.">
             <p:TypeAnnotation LastCategoryFullName="Primitive" LastDependency="VL.CoreLib.vl">
               <Choice Kind="TypeFlag" Name="String" />
             </p:TypeAnnotation>

diff --git a/help/I. The Initial Singularity/Explanation 07. Errors.vl b/help/I. The Initial Singularity/Explanation 07. Errors.vl
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
-<Document xmlns:p="property" xmlns:r="reflection" Id="S2nODuog75VQGprvemModq" LanguageVersion="2024.6.0-0224-g1141930e4a" Version="0.128">
-  <NugetDependency Id="UMoe9l8tI6dPh7545hvloL" Location="VL.CoreLib" Version="2024.6.0-0224-g1141930e4a" />
+<Document xmlns:p="property" xmlns:r="reflection" Id="S2nODuog75VQGprvemModq" LanguageVersion="2024.6.7-0181-gdf16f593e1" Version="0.128">
+  <NugetDependency Id="UMoe9l8tI6dPh7545hvloL" Location="VL.CoreLib" Version="2024.6.7-0181-gdf16f593e1" />
   <Patch Id="KwSh7UM9sxiNLbciPo4zVS">
     <Canvas Id="UBsROYmZbNYOhlf9jNrHmH" DefaultCategory="Main" BordersChecked="false" CanvasType="FullCategory" />
     <!--
@@ -155,7 +155,7 @@
               <p:stringtype p:Assembly="VL.Core" p:Type="VL.Core.StringType">Comment</p:stringtype>
             </p:ValueBoxSettings>
           </Pad>
-          <Pad Id="L9Rp8KT2HBsMalWvmVJVXE" Bounds="593,367,399,69" ShowValueBox="true" isIOBox="true" Value="The pin is receiving a wrong data type for the input pin of the node. Hover over the pin of the counter to see which data type it is actually expecting, in this case an Integer32 for the &quot;Increment&quot; value.">
+          <Pad Id="L9Rp8KT2HBsMalWvmVJVXE" Bounds="593,367,399,79" ShowValueBox="true" isIOBox="true" Value="The pin is receiving a wrong data type for the input pin of the node. Hover over the pin of the counter to see which data type it is actually expecting, in this case an Integer32 for the &quot;Increment&quot; value.">
             <p:TypeAnnotation LastCategoryFullName="Primitive" LastDependency="VL.CoreLib.vl">
               <Choice Kind="TypeFlag" Name="String" />
             </p:TypeAnnotation>

diff --git a/help/II. The Subatomic Particles/Explanation 08. 2D Rendering.vl b/help/II. The Subatomic Particles/Explanation 08. 2D Rendering.vl
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
-<Document xmlns:p="property" xmlns:r="reflection" Id="F88UCnOUJJVMfUrLlxILC3" LanguageVersion="2024.6.0-0224-g1141930e4a" Version="0.128">
-  <NugetDependency Id="UMoe9l8tI6dPh7545hvloL" Location="VL.CoreLib" Version="2024.6.0-0224-g1141930e4a" />
+<Document xmlns:p="property" xmlns:r="reflection" Id="F88UCnOUJJVMfUrLlxILC3" LanguageVersion="2024.6.7-0181-gdf16f593e1" Version="0.128">
+  <NugetDependency Id="UMoe9l8tI6dPh7545hvloL" Location="VL.CoreLib" Version="2024.6.7-0181-gdf16f593e1" />
   <Patch Id="KwSh7UM9sxiNLbciPo4zVS">
     <Canvas Id="UBsROYmZbNYOhlf9jNrHmH" DefaultCategory="Main" BordersChecked="false" CanvasType="FullCategory" />
     <!--
@@ -186,7 +186,7 @@
           <Overlay Id="FRwTfLYSQqHPrhWpDH8GhQ" Name="" Bounds="100,683,399,245">
             <p:ColorIndex p:Type="Int32">11</p:ColorIndex>
           </Overlay>
-          <Pad Id="MfLCIthV6jgLQwYQT2DlzC" Bounds="105,734,345,57" ShowValueBox="true" isIOBox="true" Value="Transforms the shape in 2D space. The coordinate system ranges vertically from -1.0 to 1.0, the horizontal range is dependent on the aspect ratio of the Renderer window.">
+          <Pad Id="MfLCIthV6jgLQwYQT2DlzC" Bounds="105,734,360,57" ShowValueBox="true" isIOBox="true" Value="Transforms the shape in 2D space. The coordinate system ranges vertically from -1.0 to 1.0, the horizontal range is dependent on the aspect ratio of the Renderer window.">
             <p:TypeAnnotation LastCategoryFullName="Primitive" LastDependency="VL.CoreLib.vl">
               <Choice Kind="TypeFlag" Name="String" />
             </p:TypeAnnotation>
@@ -678,7 +678,7 @@
           <Overlay Id="ExeKPRui4pLML6lyvoMMjb" Name="" Bounds="621,305,236,170">
             <p:ColorIndex p:Type="Int32">11</p:ColorIndex>
           </Overlay>
-          <Pad Id="OLkMh5Zy1BSN9iNXWF2xgm" Bounds="92,1551,400,55" ShowValueBox="true" isIOBox="true" Value="Use blend modes between the paint and the primitives to define how a layer will be blended over previously drawn layers. Check all available blend modes on the dropdown enum input.">
+          <Pad Id="OLkMh5Zy1BSN9iNXWF2xgm" Bounds="92,1551,399,63" ShowValueBox="true" isIOBox="true" Value="Use blend modes between the paint and the primitives to define how a layer will be blended over previously drawn layers. Check all available blend modes on the dropdown enum input.">
             <p:TypeAnnotation LastCategoryFullName="Primitive" LastDependency="VL.CoreLib.vl">
               <Choice Kind="TypeFlag" Name="String" />
             </p:TypeAnnotation>
@@ -1066,8 +1066,8 @@
       </Patch>
     </Node>
   </Patch>
-  <NugetDependency Id="NeDMqcIWGFlLlqBBXBkfKT" Location="VL.Skia" Version="2024.6.0-0224-g1141930e4a" />
-  <NugetDependency Id="G2axy3Z0lfbQHRawIzF8eE" Location="VL.CoreLib.Windows" Version="2024.6.0-0224-g1141930e4a" />
+  <NugetDependency Id="NeDMqcIWGFlLlqBBXBkfKT" Location="VL.Skia" Version="2024.6.7-0181-gdf16f593e1" />
+  <NugetDependency Id="G2axy3Z0lfbQHRawIzF8eE" Location="VL.CoreLib.Windows" Version="2024.6.7-0181-gdf16f593e1" />
   <DocumentDependency Id="VscR4LW1mDgOHDnP8K4jJW" Location="../../include/Nodes.vl" />
   <DocumentDependency Id="Emq50C06u5SMq1kn4ML1fC" Location="../../VL.TheBigBang.vl" />
 </Document>