Read Me 11-20-25 Gravity Waaaves Release V1.19

IF You are updating from a previous version of GWDSK i recommend installing this to a different folder and copying over your previously registered reg.json file and presets folders over to the gravity waaaves v1.19 version.  you'll probably be updating again in early december AND this is kind of a beta release so try not to shoot yourself in the foot here.  

FOr installing on OSX:
1. you have to first run the pkg, this will create a folder called "gravity_waaaves_DSKv1_19" in applications (or wherever else you choose to install) and install "gravity_waaaves_DSKv1_19.app" inside of that folder.  
2. copy the enclosed "data" folder alongside the .app inside the "gravity_waaaves_DSKv1_19" folder
3. if you've already got a registered copy of GWDSK somewheres on this same computer, just copy the reg.json file over the existing reg.json file inside the data folder you just copied.


big new addition
Media player
we have 2 extra inputs available in BLOCK 1 and BLOCK 2 called media player 1 and media player 2.
media players can play video clips (.mp4 extensions only, h.264 supported for sure on all platforms, inconsistent support for other codecs)
or images (jpg or png)
you can add your own images and .mp4s into /data/images and /data/movies.  these will be scanned on start up and refreshed if you hit 'rescan media' button while GWDSK is running

videos are muted by default, you can unmute and control volume in the settings panel as well.  there is no fancy nothing handling audio mixing so if you are playing audio from 2 clips at the same time set to max its quite likely that there'll be some clipping and it's up to you to handle this kind of stuff on your own.

videos and images are automatically scaled to fill whatever processing resolution you have selected.  further tweaking to configure letterboxing/pillarboxing formats can be handled manually case by case using the ch1/ch2/block2input adjust pages.

if you have issues with a video clip playing i recommend using Handbrake (free software) to re-encode the clip using any of the default settings.  

scaling and geometry stuff can get pretty funky on OSX if you are using videos with anamorphic (non square) pixels.  this is also something you can fix in handbrake by making sure to set pixel aspect ratios at 1:1


MEDIA PLAYER internal settings are not currently saved in presets, this will come in the next update.


smaller addition
- i hope that the issue with duplicate video devices in menus and incorrect video device id's being assigned has been fixed


//important readme shits from previous versions.  This has a lot of important supplmental info that isn't in the manual yet, and at times actually contradicts things in the manuals.  

- number one thing to keep in mind is that this is, first and foremost, a Video Mixer built around the UVC standard.  If you have no video devices (either hardware usb or virtualcam softwares) working on your system, you shouldn't expect to see anything happen right away.  if you have a lot of video devices working you'll want to use the settings page to choose which ones in particular you want to run.  you should have at least 2 hardware or virtualcam video inputs working and ready to use before starting GWDSK

- otherwise if you insist on not using video inputs for some reason, try searching through the presets and you'll find stuff pretty quickly that works fine with zero inputs.

- there are really kind of a lot of free 'virtualcam' softwares out there that you can use to get video from your desktop into .  try using a search engine that isn't google to find one that works best for you.  OBS virtual cam actually isn't really the best one unless you really, seriously, know what you are doing.

- please use the normal old Gravity Waaaves Manual found at https://andreijaycreativecoding.com/VSEJET-Manuals
for now until i can finish up the DSK version.  nearly everything important is the same, except for the stuff in the SETTINGS PAGE

- mouse pointer: the mouse pointer dissapears when its over the output window.  this is normal and expected behavior


PASSWORDS AND REGISTRATION
- you must enter your 
	- username (email address with which you bought GWDSK)
	- the machine you are registering on (i.e windows11AcerLaptop, osx14macbookPro2021, enough information to identify this specific version you are registering)
	- and your password to verify your version of gravity waaaves
- no whitespaces anywhere
- you can only run your purchase of GWDSK on up to 3 different machines.  if you absolutely need to run things all the time on a larger number of computers for some reason, contact andrei directly via email.
- if you ever need a support ticket you'll also need to make sure you've registered your purchase online with your username and registered machine before any support can be given. (this point is kind of moot for all of you kickstarter people for now until i've got the official registration forms ready)
- if you are updating GWDSK and want to keep your registration and save states, simply install to a different folder, and copy the reg.json file and your entire presets folder.  i recommend backing up any presets you are saving for now somewhere separate too b/c each new update will come with more presets




- most of these things are fairly self explanatory and will result in obvious visible changes if you mess around with them.  The most important thing is that you can Save the majority of things you tweak on this page.  you do have to manually save them yourself, and choose whether or not any particular one is default.  nothing gets auto-saved.

INPUTS
you cannot assign the same UVC source to both input1 and input2.  you will be prevented from changing inputs or saving init settings if you've selected the same source for both input1 and input 2. 
- you should be able to change the PROCESSING resolution on the fly.  note that this won't change anything about the output resolution, that is controlled by the window size.  it will make a difference tho if your processing resolution and the output window are different aspect ratios, either stuff will get cropped width wise or there'll be pillarboxing.
- if input video and processing resolutions aren't the same aspect ratio then the default is to center input video and fill the processing buffers with video.  you will notice that if you move the input video using 'x <->' controls in the relevant adjust menu that nothing is actually cropped, and if you prefer letterboxing to cropping thats just a matter of tweaking 'z <->'

OUTPUT VIDEO
- drag and resize the screen, the output will resize to automatically maximize height.  it should only pillarbox, never letterbox.  stuff will get cropped width wise but never height wise
- you can also manually change the position and size of output screen (and gui) from the settings page and save these in init files. multiple displays are treated as one continuous virtual display here, so if you've got a laptop and an external monitor, both with 1920x1080 resolutions, and you want to put the output video on the 
-fullscreening: make sure the output window is on the correct screen you want it to full screen on.  you can either press the fullscreenToggle button on the gui or click anywhere on the output window and press the 'f' key.  If you went and fullscreened your output window over the gui (try not to do this), click back on it (potentially difficult b/c you can't see yr mouse pointer on the output window) and press the 'f' key again.  


PRESETS
- rename files when you save them every time for now, unless you are just saving the exact same preset in the exact same slot with the exact same name.  just do it!
- for now i recommend not editing any presets in 01-basics and saving new ones to 02-users
- the preset queue is set up so you can have a bunch of presets ready to roll at any point.  say if you wanted to have a 'fade to black' preset made you don't need to search thru everything to load it up right away.  the main thing to keep in mind is that the preset queue points to specific slots in directories, so if you a working on a preset thats currently in the queue and save it in a different slot, the queue won't point to the new slot you saved in.


KNOWN THINGS
- changing anything about inputs takes like 2 seconds to complete and involves said input freezing, then blanking.  this is why the inputs only will actively change if you hit the button, not just from any random messing around with resolutions or sources.
- changing processing resolution takes about 1 second or less but is noticeable
- saving/loading input2 in initFiles doesn't work at the moment
- if you move or resize either window, the output video freezes.
- macro controls:  either you can control them via nk2 set to the usual VSERPI/VSEJET scene setting (visit website for instructions on that) with the 'macros on' checkbox on or via mouse/keypad/keyboard with 'macros on' checkbox off.
- gui text size loads really small for the first couple seconds then gets larger.
- Please do feel free to report bugs using the support forms here https://videosynthesisecosphere.com/support.  please remember that 'bro why don't you support spout' isn't a bug and that i'm not actually the kind of person who is more likely do take action because folks nag me about it.