
Read Me 07-07-25 Gravity Waaaves Release V1.01

- 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



SETTINGS PAGE:
- 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.
- there will yet be another update coming in the next week.  I know that there are some things going funky and that not everything promised in the release is totally working at the moment.  Please do feel free to report bugs using the support forms here https://videosynthesisecosphere.com/support tho!  