Play vectrex in your browser

[drsnuggles]

Hi Vectrexians,

some of you will already know the JSVecX emulator for your favorite browser from this thread:
vectorgaming.proboards.com/thread/280/online-java-vectrex-emulator

I forked it and started with some changes that will only give you the display view without the machine and the box art next to it.

It's still the same emulator but looking different (better) because of higher resolution and different overlays.
From time to time i still like to play a vectrex game and now we can do, even at work (hint: use &sound=off parameter).

Play Vectrex games in your own website/forum with a simple iframe or link:

drsnuggles.github.io/jsvecx/?rom=rip-off

Source at: github.com/DrSnuggles/jsvecx/tree/dev

Use RMB and select one of many roms.
Please contact me if you think there is a copyright problem with one of the provided roms or if you want a specific rom listed.
My goal is to have most free roms and give proper credit.

Key Features:
- View chips
- Set Quality 1x, 2x (default), 3x (nice for UHD and/or pivot)
- Additional overlay set for higher resolutions (you can switch back or turn it off)
- Viewport scales on resize (and fits)
- Menu with RMB
- Touchscreen
- Gamepads, 2 players, two gamepads with 2x analog + 4x digital (swappable)
- Seamless integration into website/forum
- Small footprint, less files + size, loads faster
- No ads, no cookies, no counters

Credits and thanks:
- JavaScript port by raz0red
- original C code by Valavan Manohararajah
- Sound emulation based on various code snippets by Ville Hallik, Michael Cuddy, Tatsuyuki Satoh, Fabrice Frances, Nicola Salmoria
- 1080 Overlays by THK-Hyperspin and Gigapig-Hyperspin
- Prof. Peer and The Vectrex Academy (your roms are on top)
- All rom creators, can't name them all, but most are here in this forum. Thank you !!

Parameter list:

?rom=Accepts URL, filename or simple rom name
&sound=on | off : Nice for office playing and if you want to link to a rom with known audio problems (Berzerk)
&pause=on | off : Opens in paused mode
&menu=on | off : Opens menu with instructions
&rtm= on | off : Opens chips view
&aa=on |off : Toggles antialias
&overlay=1 | 2 : Numeric, how often ToggleOverlay is pressed when opened
&keys1=Up,Down,Left,Right,Button1,Button2,Button3,Button4
&keys2=Up,Down,Left,Right,Button1,Button2,Button3,Button4
&gp1=Up,Down,Left,Right,Button1,Button2,Button3,Button4
&gp2=Up,Down,Left,Right,Button1,Button2,Button3,Button4
&bios=B796 | 7931 | 7ADB (default)
&bopt=ori | fast (default) | skip
&vol=0.00...1.00 (default:0.3)
&lum=0.00...1.00 (default:0.5)
&gam=0.00...8.00 (default:2.2)


ZIP Files are supported:
    - Roms can be named *.rom, *.vec or *.bin.
    - Found *.png is used as overlay.
    - Found *.txt is displayed. Nice for game infos and copyright disclaimers.
    - __MACOSX dir is ignored.

Changelog:

### 03/16/20 (0.5.4) (DrSnuggles)
- Gamma slider. New parameter &gam=2.2

### 03/16/20 (0.5.3) (DrSnuggles)
- apply gamma 2.2 for CRT

### 03/13/20 (0.5.2) (DrSnuggles)
- switched ZIP lib to an stripped and RegPacked UZIP version (3,57kB)

### 02/16/20 (0.5.1) (DrSnuggles)
- if ZIP file is found load lib and parse content

### 02/15/20 (0.5.0) (DrSnuggles)
- display local found .txt files

### 02/15/20 (0.4.9) (DrSnuggles)
- look for overlay .png file in local dir

### 02/15/20 (0.4.8) (DrSnuggles)
- fixed display of linked roms

### 02/14/20 (0.4.7) (DrSnuggles)
- added and renamed roms

SPOILER: Click to show

### 02/10/20 (0.4.6) (DrSnuggles)
- added roms

### 02/06/20 (0.4.5) (DrSnuggles)
- Cocktail: default is now on, but only applied to BinaryStars Cocktail roms (MineStorm, StarCastle, SolarQuest)
- Moved Proxy to own repo
- MemMon now displays offset in hex and removed MineStorm specific cell colors
- Added roms

### 01/29/20 (0.4.4) (DrSnuggles)
- Added Del=Pause, Backspace=Reset

### 01/28/20 (0.4.3) (DrSnuggles)
- Bugfix for drag'n'drop caused by new interface
- Added proxy for loading roms via URL (bypass CORS and mixed content trouble)

### 01/27/20 (0.4.2) (DrSnuggles)
- Rom selection: Table instead of DropDown (ToDo: step by step rename roms, gamepad input)
- Cocktail: Flipped screen for MineStorm Cocktail rom
- CA1 interrupt (LightPen still not really working)
- showMem, Peek, Poke

### 01/14/20 (0.4.1) (DrSnuggles)
- volume slider parameter: &vol=0.25
- luminescence slider parameter: &lum=0.33

### 01/14/20 (0.4.0) (DrSnuggles)
- osint rework: dropped >80% code and went back to.... Vectors!
- PrintScreen now saves png and svg files

SPOILER: Click to show

### 01/13/20 (0.3.13) (DrSnuggles)
- automatic quality (no more button for this, attached to resize)
- analog touch input (known issue while using buttons)
- reduce amount of requests (manifest + favicon)

### 01/12/20 (0.3.12) (DrSnuggles)
- favIcon

### 01/11/20 (0.3.11) (DrSnuggles)
- improved mobile experience (manifest)
- a lot of tests... and roll-backs
- GFX (branch rAF-test):
- use reqAnimFrame everywhere: 50.0fps are hard to get
- try to use more canvas draw like routines instead of pixel stream: worked but had some flickering, felt different to play
- SFX (branch Audio-test): use Ayumi as audio renderer: sounded "colorful"

### 01/08/20 (0.3.10) (DrSnuggles)
- Idea by Vectrexer: load BIOS from URL (looks for // in bios parameter, take care of mixed content and CORS)
- Take care of bios options which default to fast. Better to set &bopt=ori
- drsnuggles.github.io/jsvecx/?bios=https://drsnuggles.github.io/jsvecx/bios/b796.bin&bopt=ori

### 01/07/20 (0.3.9) (DrSnuggles)
- Added BIOS versions via parameter &bios=B796 &bopt=skip
B796: v1 GCE
7931: v2 MB
7ADB: v3 MB EU (default) (fixed MineStorm)
options: ori, fast (default), skip (hack by Frank Chevassu)

### 01/03/20 (0.3.8) (DrSnuggles)
- Controller fixes after MineStorm day with Dani
- individual gamepad mappings (&gp1=12,13,14,15,2,3,0,1)
- default gamepad settings had up/down reversed
- 1st gamepad found is now player1 (you can use Toggle GP to use for player2)

### 12/31/19 (0.3.7) (DrSnuggles)
- Fixed Keyboard mappings (no longer case sensitive)
- Added parameter to map keys individually
default: &keys1=ArrowUp,ArrowDown,ArrowLeft,ArrowRight,KeyA,KeyS,KeyD,KeyF
&keys2=Numpad8,Numpad5,Numpad4,Numpad6,Numpad1,Numpad2,Numpad3,Numpad0
(playvectrex settings: &keys2=Digit8,KeyI,KeyU,KeyO,KeyQ,KeyW,KeyE,KeyR)
- removed double Player2 key settings

### 12/30/19 (0.3.6) (DrSnuggles)
- Idea by playvectrex: copy link to actual rom

### 12/30/19 (0.3.5) (DrSnuggles)
- Idea by Graham Toal: load roms from URL (looks for // in rom parameter, take care of mixed content and CORS)
- Also tries to load overlay from same URL but with extension .png

### 12/29/19 (0.3.4) (DrSnuggles)
- Idea by playvectrex: added 2nd player keyboard input. It's still possible to switch keys for Player1 <-> Player2 QWER8UIO and also on Numpad 85461230

### 12/24/19 (0.3.3) (DrSnuggles)
- added Binary Star Software roms. Thanks !!

### 12/20/19 (0.3.2) (DrSnuggles)
- pause on visibility change
- pause on menu
- show CRC (in console)
- save screenshots (PrintScr)

### 12/18/19 (0.3.1) (Malban Patches)
– corrected the SHIFT Bug
– implemented 48kB ROM support
– implemented IRQ/PB6 bankswitching
– implemented R/C law zero reference

### 12/17/19 (0.3.0) (DrSnuggles)
- Added Chip/PIN usage
- Added parameters: aa, pause, menu, rtm

### 12/09/19 (0.2.7) (DrSnuggles)
- Added ?sound= parameter

### 12/06/19 (0.2.6) (DrSnuggles)
- Added Touchscreen input (digital, don't get used to it)

### 12/05/19 (Build process)
- Using Gulp for build process
- Changed directory structure for quick dev and build

### 12/04/19 (0.2.5) (DrSnuggles)
- Added most roms from GoodVect1.06
- Added 2nd overlay set from github.com/libretro/overlay-borders
- Added Quality x1, x2, x3
- Compressed images

### 12/02/19 (0.2.4) (DrSnuggles)
- Added swap for keys and gamepads Player 1 <-> Player 2
Default: Keys = Player 1 and Gamepad 1 = Player 2

### 11/29/19 (0.2.3) (DrSnuggles)
- Added gamepad as input device (Xbox360)
- Added analog Stick input
- Added 2nd gamepad
- Added menu (RMB) with infos + settings
- New scaleable interface with vectrex + overlay only
- AntiAlias on/off
- Added querystring ?rom=rip-off

### 11/28/19 (0.2.2) (DrSnuggles)
- Load ROMS as binary from server
- Renamed roms to match images
- Hide mouse when overlay, then changed to crosshair
- Reduced file count to make it load quicker
- Fade via CSS
- Removed jQuery

[hcmffm]

Thank you for pointing us to your interesting Vectrex engine which runs in a webbrowser, drsnuggles. I've just tried it out in Mozilla Firefox and Rip Off worked like a charm. That's a good effort and I'll keep this easy way to play Vectrex games using your PC on my mind.

Key definitions are:
A = Button 1
S = Button 2
D = Button 3
F = Button 4
Cursor keys = Joystick

drsnuggles: I found links for Minestorm and Rip Off. Is there are general page with a list of all games available online using JSVec?

[TrekMD]

Really cool. Something to definitely try out.

[drsnuggles]

Thanks and sorry i forgot to explain the options 

Press right mouse button for Menu.
"Select a cartridge..." Includes most CoolVect roms + Academy 2016-2019.
Contact me if you want a rom listed or you think there is a rom in the list which is still under copyright protection.

Reset, Pause, Sound, Fullscreen is self explaining.
Antialias toggels the image-rendering. Off = Makes sharper lines but overlays do only look good in their native resolution.
Quality 1x (raz0red), 2x (new default), 3x sets the internal rendering resolution. original jsvecx port used 1x=330 x 410.
GP polling (on = default): You can switch off gamepad polling. maybe turn off for real slow browsers or if your activated joystick produces strange inputs.
Switch keys: keyboard controlls player 1 = default or player 2
Switch GP: gamepad controlls player 2 or 1
Overlays, toggles overlays on switches between jsvecx low resolution and 1080 overlays. Academy = 1 overlay
Show Chips: Have a try 

[Malban]

Hi,

I also did a "small" web version... althought I didn't do a fork.

I changed some things around ...:
– corrected the SHIFT Bug
– implemented 48kB ROM support
– implemented IRQ/PB6 bankswitching
– implemented R/C law zero reference

If interested in the changes, I suppose you do a "dif" :-( - it shouldn't be to many...

Vectorblade sort of runs ok... (low res):

vectrex.malban.de/vecxWeb/

Cheers

Malban

[drsnuggles]

Hi Malban and thank you very much !!

Of course i'm interested in your "small"  changes and i merged them asap.
Benefit: Vectorblade now runs in HiRes.
Sorry, but for overlay you have to switch twice (Off then to LowResOverlays). Soon (TM)
drsnuggles.github.io/jsvecx/?rom=Vectorblade&overlay=2

Thanks again! Help is always appreciated
   DrSnuggles

[hcmffm]

Thank you for the extra info, drsnuggles. I just had a quick look through the list of games which is quite impressive.

I see "Omega Chase" of Christopher Tumber. Omega Chase is copyrighted - did Christopher Tumber agree in making Omega Chase part of your game list? Please inform yourself on the copyright situation before making games public. If in doubt (i.e. you have no explicit agreement from the game author), you better remove the appropriate binary from your game list.

[drsnuggles]

Hi,

and thank you for your information.
I removed not only Omega Chase, i removed all roms from Chris Tumber because i found this thread: vectorgaming.proboards.com/thread/986/chris-tumber-back
My goal is to have free roms in list.
Be sure i try to gather information about the copyright situation of each rom.
Found the rom at archive.org and expected it to be OK to list it. I was wrong.

[hcmffm]

Thank you for your understanding and immediate removal of Christopher's games, drsnuggles. That's much appreciated.

[playvectrex]

Wow this is great! I didn't know there were so many games! Easy to test them all quickly as well Would be great if there were player 2 controls by default at maybe the G,H,J,K position? or even Q,W,E,R. Just for testing 2 player as a single player. So then maybe Q,W,E,R and for direction 8, U, I, O ?

[drsnuggles]

Dec 28, 2019 16:05:50 GMT -5 playvectrex said:

Wow this is great! I didn't know there were so many games! Easy to test them all quickly as well Would be great if there were player 2 controls by default at maybe the G,H,J,K position? or even Q,W,E,R. Just for testing 2 player as a single player. So then maybe Q,W,E,R and for direction 8, U, I, O ?

Your welcome !!
Tbh i had gamepad input in my focus because i wanted the analog stick inputs instead the digital keys.
For testing i used "switch keys" to swap inputs Player1 <-> Player2
Fact: When not at home i use keys...

Implemented your key config for Player2 and you can also use
Numpad
   8
4 5 6
1 2 3
0

[playvectrex]

Dec 29, 2019 11:20:11 GMT -5 drsnuggles said:

Dec 28, 2019 16:05:50 GMT -5 playvectrex said:

Wow this is great! I didn't know there were so many games! Easy to test them all quickly as well Would be great if there were player 2 controls by default at maybe the G,H,J,K position? or even Q,W,E,R. Just for testing 2 player as a single player. So then maybe Q,W,E,R and for direction 8, U, I, O ?

Your welcome !!
Tbh i had gamepad input in my focus because i wanted the analog stick inputs instead the digital keys.
For testing i used "switch keys" to swap inputs Player1 <-> Player2
Fact: When not at home i use keys...

Implemented your key config for Player2 and you can also use
Numpad
   8
4 5 6
1 2 3
0

Wow, that was fast!  Thanks!  I went looking for Chris Binarystar's Joystick test, or the Test Cart rev. 4 and couldn't find either, so I tried a 2 player Clean Sweep and Curling game.  The Curling game buttons seemed to work correctly and left and right were working without changing anything, but not what I would have expected (more later).  And from the Clean Sweep I think player 2 joystick keys don't seem to be recognized until you still click Switch Keys in the menu.  Player one keys (P, L, :, ') don't seem to be recognized anymore, but arrow keys work.

Like the arrow keys and WASD keys pattern, I would think 8=UP, U=LEFT, I=DOWN, O=RIGHT, but you have U and I swapped.  Not sure if this is the same for Player one keys (PL;') since I can't seem to test them.

[drsnuggles]

You are right i was using U=left, corrected.

Uhh Clean Sweep, maybe the hardest rom to emulate but 2 player works, at least the way Clean Sweep does 2 player.
Clean Sweep and other games like Scramble, Berzerk and others support 2 players but just one controller.

I use Rip-Off for testing 2 player simultaneous mode.
Another column i should add in my roms sheet (published soon™)

Facebook is in my ToDo list where i should search for more roms and spread the word about this fork.

Till my fb revival i can recommend using Test Rev. 4 rom
drsnuggles.github.io/jsvecx/?rom=test%20rev.%204

Edit: Forgot to mention that you can drop any rom into the emulator

[playvectrex]

Dec 30, 2019 3:15:09 GMT -5 drsnuggles said:

You are right i was using U=left, corrected.

Uhh Clean Sweep, maybe the hardest rom to emulate but 2 player works, at least the way Clean Sweep does 2 player.
Clean Sweep and other games like Scramble, Berzerk and others support 2 players but just one controller.

I use Rip-Off for testing 2 player simultaneous mode.
Another column i should add in my roms sheet (published soon™)

Facebook is in my ToDo list where i should search for more roms and spread the word about this fork.

Till my fb revival i can recommend using Test Rev. 4 rom
drsnuggles.github.io/jsvecx/?rom=test%20rev.%204

Edit: Forgot to mention that you can drop any rom into the emulator

Nice project you have here, and I love that it runs directly from github

Where exactly do all of the ROMs get loaded in from? I see some of them in various form BIN and JS but there are many more that are not in the github repo.

BTW, Player 1 keys (P L ; ') still don't seem to work. Not sure if I missed that Test Cart before of if you just added it Player 2 controls feel nice now, thanks!

FEAT REQ: Provide a share link in the ESC menu for the current game. I had a hard time figuring out the correct abbreviation for some games to share them.

[drsnuggles]

You will find all the roms in both of my githubs. github.io and jsvecx.
In jsvecx take care to switch to the dev branch.
Master branch is just a copy of raz0reds version. He loaded JS files, i load BINs.

I removed P L ; ' because i thought then there are too much keys in use for player controls and i hit P by mistake.
.. but have to change the instructions.

Feat. Req. accepted. Soon™