Update README.md

README.md

@@ -1,11 +1,12 @@
 # MilkDrop3
 
-How to download and install : https://youtu.be/OQdZFlOHe5o<br/>
-All the new features explained : https://youtu.be/QBsDXPENe1I<br/>
-How to create a beautiful double-preset : https://youtu.be/AdcUPpp1O0k<br/>
+- How to download and install : https://youtu.be/OQdZFlOHe5o<br/>
+- All the new features explained : https://youtu.be/QBsDXPENe1I<br/>
+- How to create a beautiful double-preset : https://youtu.be/AdcUPpp1O0k<br/>
 
 MilkDrop 3.0 is a portable program that supports any audio source (Spotify, YouTube, SoundCloud, Winamp...)<br/>
-it's an evolution of my version of BeatDrop2077, based on BeatDrop.<br/>
+It is based on BeatDrop from Maxim Volskiy, so it's 100% compatible with any presets created with MilkDrop and projectM.<br/>
+MilkDrop3 does everything that MilkDrop2 can do, I will be only listing on this page the additional new features :)<br/><br/>
 It supports a new type of double-preset (.milk2 file) mixing 2 presets and displaying them both simultaneously.<br/>
 Here are a few double-preset: https://www.youtube.com/watch?v=6UXKyz4nOfI<br/>
 You can create new presets by pressing just a few keys, without knowing any lines of code<br/>
@@ -20,11 +21,11 @@ For some letters, the majuscule and minuscule matters.<br/>
 As an example, I'm using the lower-case "a" for the classic random mini-mash-up and<br/>
 upper-case "A" (shift+a) for another function: back to previous random preset.<br/>
 
--Support always on top window (F7)<br/>
+- Support always on top window (F7) and borderless mode.<br/>
 
 - Support multiple monitor stretching (ALT+SHIFT) thanks to milkdropper for the code.<br/>
 
--Real-time toggling FPS (F2) 60fps, 90fps, 120fps ect... (some presets may not work well on high fps)<br/>
+- Real-time toggling FPS (F2) 60fps, 90fps, 120fps ect... (some presets may not work well on high fps).<br/>
 
 - Real-time toggling seconds between auto transition to next preset (F3) 15sec, 30sec, 45sec ect...<br/>
 
@@ -34,24 +35,24 @@ Shapes are now exported with the '.shape' file extension in Milkdrop3\shapes\fil
 - Support of displaying 16 waves simultaneously instead of 4.<br/>
 Waves are now exported with the '.wave' file extension in Milkdrop3\waves\file.wave<br/>
 
--8 new simple waveform (total of 16)<br/>
+- 8 new simple waveform (total of 16).<br/>
 
 - The q1-q32 variables have been expanded; the range is now q1-q64.<br/>
 
--Support going back to previous generated preset when pressing the key 'A' (Shift+a)<br/>
+- Support going back to previous generated preset when pressing the key 'A' (Shift+a).<br/>
 I've waited 20 years for that function!<br/>
 
--Support deep-mash-up, not just warp and comp mashup, but all 5 bins (z)<br/>
-note: this is quite unstable, some presets will crash MilkDrop3. But the results can be really great.<br/>
+- Support deep-mash-up, not just warp and comp mashup, but all 5 bins (z).<br/>
+Note: this is quite unstable, some complex presets could crash MilkDrop3. But the results can be really great.<br/>
 
--Support going back to previous generated preset when pressing the key 'Z' (Shift+z)<br/>
+- Support going back to previous generated preset when pressing the key 'Z' (Shift+z).<br/>
 
 - Support randomize colors function, pressing the (c) key will change all the colors in the comp shader directly in the memory.<br/>
 Don't forget to save the preset if you like the new color.<br/>
 
--Support going back to previous generated color when pressing the key 'C' (Shift+c)<br/>
+- Support going back to previous generated color when pressing the key 'C' (Shift+c).<br/>
 
--Lots of new debug information pressing the letter 'n', very useful when you create new double-preset.<br/>
+- Lots of new debug information pressing the letter 'n', very useful if you want to create or mashup a double-preset.<br/>
 
 - Support auto-changing the presets based on beat detection (F8) ex: https://twitter.com/MilkDrop2077/status/1617405613960560641<br/>
 hardcut1 : load a new preset if bass > 1.5 with a minimum delay of 0.2 sec<br/>
@@ -61,31 +62,32 @@ hardcut4 : load a new preset if treb > 2.9 with a minimum delay of 3 sec but if
 hardcut5 : load a new preset if treb > 2.9 with a minimum delay of 5 sec<br/>
 hardcut6 : load a new preset if bass >1.5 + will load Bass/WHITE.milk if bass > 4.90<br/>
 
--Lots of new transition effects (when pressing the spacebar), the first old 4 were : "zoom", "side", "plasma", "cercle",<br/>
-new ones: "plasma2", "plasma3", "snail", "snail2", "snail3", "triangle", "donuts", "corner", "patches", "checkerboard", "bubbles", "stars", "cisor", "wave",  "curtain", "vertical", "horizontal", "linesvertical", "lineshorizontal"<br/>
+- Lots of new transition effects (when pressing the spacebar), the first old 4 were : "zoom", "side", "plasma", "cercle".<br/>
+New ones: "plasma2", "plasma3", "snail", "snail2", "snail3", "triangle", "donuts", "corner", "patches", "checkerboard", "bubbles", "stars", "cisor", "wave",  "curtain", "vertical", "horizontal", "linesvertical", "lineshorizontal".<br/>
+And since version 3.21, an extra 7 transitions: "square", "stars2", "clock", "nuclear", "arrow", "cross", "cross2".
 A few example here: https://www.youtube.com/watch?v=WXK-pzCPfYk<br/>
 
 - Improved search function:<br/>
-now we can search for anything in the presets list, not just one letter.<br/>
-you can type 'mar' for martin's presets.<br/>
-you can even type 'kings' if you search for 'martin - kings cross' for example.<br/>
+Now we can search for anything in the presets list, not just one letter.<br/>
+You can type 'mar' for martin's presets.<br/>
+You can even type 'kings' if you search for 'martin - kings cross' for example.<br/>
 
--bunch of optimized function with chatgpt<br/>
+- Bunches of optimized functions with chatgpt<br/>
 
 - PLAYER CONTROL:<br/>
 Pressing CTRL+right will load the next track (on any player, spotify, youtube if you're listening to a playlist of songs...)<br/>
-CTRL+left will load the previous track on any player<br/>
-CTRL+up will send a fastforward 5sec command to winamp only<br/>
-CTRL+down will send a fastrewind 5sec command to winamp only<br/>
+CTRL+left will load the previous track on any player.<br/>
+CTRL+up will send a fastforward 5sec command to winamp only.<br/>
+CTRL+down will send a fastrewind 5sec command to winamp only.<br/>
 
  - Pressing the key 'f' will filter the presets : showing (and loading) only normal .milk presets, only double .milk2 presets or ALL of them.<br/>
 When pressing the keys A,D,M,Z or F9, it will auto-switch to 'Show only classic-presets' to avoid any mash-up errors.<br/>
 
--double-preset (.milk2) https://www.youtube.com/watch?v=n37SbxfLK0k<br/>
+- Double-preset (.milk2) https://www.youtube.com/watch?v=n37SbxfLK0k<br/>
 Press F9 to enter double-preset mode. Now if you press the spacebar, you'll create a mix of 2 presets.<br/>
 You can save them with the key 's' like a normal preset, it will create a new milk2 file.<br/>
-Try the different types of blending pattern by pressing the key 'p' ("zoom", "side", "plasma" ect...)<br/>
-if you press the key 'P' (shift+p) you can force the blending progress (10%, 20%, 30% ect...)<br/>
+Try the different types of blending pattern by pressing the key 'p' ("zoom", "side", "plasma" ect...).<br/>
+If you press the key 'P' (shift+p) you can force the blending progress (10%, 20%, 30% ect...).<br/>
 Some blending pattern like plasma have a lots of random values,<br/>
 you can reload those values to see a different plasma effect by pressing the key 'o'.<br/>
 All of these random values are saved in the .milk2 file.<br/>
@@ -99,6 +101,7 @@ Also:<br/>
 - WARP_AMOUNT can now have 0-100 value<br/>
 - WARP_SCALE can now have 0-100 value<br/>
 - WARP_SPEED can now have 0-100 value<br/>
+- Max shape sides increased to 500 points (from 100 originally)<br/>
 
 I've setup up a patreon page, I've spend countless hours on MilkDrop3, if you would like to support this project and future updates:<br/>
 https://www.patreon.com/MilkDrop3<br/>
@@ -108,29 +111,51 @@ https://www.buymeacoffee.com/MilkDrop2077/<br/>
 
 History:<br/>
 
--20/07/2023 : Version 3.2<br/>
+★ 03/10/2023 : Version 3.21<br/>
+- 100 new presets (for total of +900!) + some new textures.<br/>
+- Options saved in the .ini file were completely rewritten.<br/>
+- You can now save any options available, save the exact window position, start MilkDrop in fullscreen...<br/>
+- New transition effects: square, stars2, clock, nuclear, arrow, cross, cross2.<br/>
+- New algorithm for saving presets: size is much smaller, load time will be a bit faster.<br/>
+  Only the wavecode and shapecode enabled will be saved.<br/>
+- Values were optimized for each pattern when displaying a double-preset.<br/>
+- When pressing 'P' to change the progress, it will increment the actual progress number and not start from 0.<br/>
+- Locked blending patterns / progress / directions are now displayed in red colour on the information screen (n).<br/>
+- New  algorithm for changing colors to avoid multiple ret /= float3 in the composite shader.<br/>
+- Pressing 'c' will search for //MilkDrop3 Color Mode: and replace the line underneath with the ret /= float.<br/>
+- New borderless mode, press F7 multiple times to toggle modes.<br/>
+"NoBorder + Resize ON" : you can resize the window to any size you want (but can't use the double-click to enter fullscreen).<br/>
+"NoBorder + Resize OFF" you can't resize but you can use the  double-click to enter fullscreen.<br/>
+- Better behaviour when using deepmash : dm menus will disappear when pressing 's' or 'shift+z'.<br/>
+- Corrected a few bugs : while saving a preset after using a blocked preset, while renaming some presets, exiting fullscreen, exiting AlwaysOnTop, I fixed some old legacy bugs from loading textures...<br/>
+- New menus and new GUI (MilkDropPanel), both are a bit empty at moment, but they will grow over time with lots of new functionalities coming!<br/>
+- Know bugs that need to be fixed : don't have a preset named 0.milk, it crashes MilkDrop3 when mashing presets.<br/><br/>
+
+★ 20/07/2023 : Version 3.2<br/>
 - Double-preset are now displayed correctly when entering/exiting full screen or resizing the window.<br/>
 - Live blending update: pressing the keys 'p' and 'P' will display directly pattern or progress, no more backspace/spacebar needed!<br/>
 - Reload a double-preset: pressing 'o' will reload a double-preset only with different random values,<br/> 
- very handy to see different plasma blend for example<br/>
--Flip presets: press 'u' to flip preset 1 and 2 (and keep the exact position)<br/>
+ very handy to see different plasma blends for example.<br/>
+- Flip presets: press 'u' to flip preset 1 and 2 (and keep the exact position).<br/>
 - Locked direction: press 'U' to force the direction of the blending,<br/> 
- ex: if you are using the cercle pattern, -1 = from the INSIDE, 1 = from the OUTSIDE<br/>
+ ex: if you are using the cercle pattern, -1 = from the INSIDE, 1 = from the OUTSIDE.<br/>
 - Block a preset: press 'b' to lock a preset, it will always load first when creating a double-preset (F9 and then SPACEBAR)<br/>
--Press 'B' to choose the blending time<br/>
--When pressing F4, you can now see both preset names if it's a double-preset<br/>
--New borderless mode with F7<br/>
+- Press 'B' to choose the blending time.<br/>
+- When pressing F4, you can now see both preset names if it's a double-preset.<br/>
+- New borderless mode with F7.<br/>
 - New delete mode: press CTRL+DELETE to start delete mode.<br/>
- Now you can delete any preset you see simply by pressing the DELETE key (no need to load the list and confirmation)<br/>
+ Now you can delete any preset you see simply by pressing the DELETE key (no need to load the list and confirmation).<br/>
  Very handy if you want to clean a large number of presets, be careful you can't restore a deleted preset!<br/>
 - When pressing the keys A,D,M,Z or F9, it will auto-switch to 'Show only classic-presets' to avoid any mash-up errors.<br/>
--added the Beginners Guide to MilkDrop Preset Writing in html and doc in the Milkdrop3\docs folder<br/><br/>
+- Added the Beginners Guide to MilkDrop Preset Writing in html and doc in the Milkdrop3\docs folder.<br/><br/>
 
--09/04/2023 : Version 3.12 :<br/> 
-10x faster way to load the presets list, can load 50.000 presets under 1 second!<br/>
-better way to display preset's names (F4) for milk and milk2 files<br/>
-new plasma3 transition effect (a bit crazier than plasma and plasma2)  
-corrected a few bugs while loading preset with textures<br/>
-I removed the V2M player in the installer to avoid any false-positive<br/><br/>
--19/03/2023 : Version 3.1 : stable<br/><br/>
--03/03/2023 : Version 3.0 : alpha, pretty unstable
+★ 09/04/2023 : Version 3.12 :<br/> 
+- 10x faster way to load the presets list, can load 50.000 presets under 1 second!<br/>
+- Better way to display preset names (F4) for milk and milk2 files.<br/>
+- New plasma3 transition effect (a bit crazier than plasma and plasma2).  
+- Corrected a few bugs while loading preset with textures.<br/>
+- I removed the V2M player in the installer to avoid any false-positive.<br/><br/>
+
+★ 19/03/2023 : Version 3.1 : stable.<br/><br/>
+
+★ 03/03/2023 : Version 3.0 : alpha, pretty unstable.