/hypseus-singe

Hypseus Singe is a SDL2 version of Daphne and Singe.

Primary LanguageC++GNU General Public License v3.0GPL-3.0

Hypseus Singe

Hypseus Singe

Hypseus is a fork of Matt Ownby's Daphne.

A program to play laserdisc arcade games on a PC, Mac or Raspberry Pi.

This version includes Singe support for Fan Made and American Laser Games.

Features:

  • SDL2 support
  • Updated MPEG2 decoder
  • cmake build tool
  • Singe libretro path integration
  • Singe Joystick/Lightgun [mouse] support
  • Psuedo Singe 2 support (details below)
  • Sinden borders for Singe games
  • Alternate overlay choices
  • Advanced multi joystick configuration
  • Software 'lair/ace' original scoreboard: preview
  • Simulated scan lines: preview
  • Windows and MacOS X Ports

Windows

Windows files and documentation can be found here

Compile

Minimum software requirements: gcc, cmake, autotools, zlib, SDL2, libtool, vorbis and ogg.

MacOS X

Use homebrew to install the following packages:

brew install cmake
brew install autoconf
brew install automake
brew install pkg-config
brew install sdl2
brew install sdl2_ttf
brew install sdl2_image
brew install libtool
brew install libvorbis
brew install libogg

Raspberry Pi

For Raspberry Pi clone the RetroPie branch via:

git clone --single-branch --branch RetroPie https://github.com/DirtBagXon/hypseus-singe.git

Further RetroPie and Raspberry Pi requirements can be found here

Compilation with CMake

Build:

mkdir build
cd build
cmake ../src
make -j

Install and Run

Ensure you have data in the following daphne HOME folders:

pics, ram, roms, sound, singe, (vldp and vldp_dl)

Run hypseus with daphne arguments on the command line: Also refer to additional arguments below

hypseus lair vldp -framefile "vldp_dl\lair\lair.txt" -fullscreen_window -software_scoreboard

hypseus singe vldp -framefile "singe\timegal\timegal.txt" -script "singe\timegal\timegal.singe"

In Windows you are able to create .bat files with arguments for specific games.

Example .bat files are provided within the Windows zip file.

Retro gaming systems will require adoption within the relevant emulation scripts.
The singe -retropath argument can ease integration into libretro style systems.
See RetroPie as an example.

bash scripts are provided for systems that support this shell.

Install bash scripts:

cp -R fonts ~/.daphne
cp doc/hypinput.ini doc/flightkey.ini ~/.daphne
sudo cp build/hypseus /usr/local/bin/hypseus.bin
sudo cp scripts/run.sh /usr/local/bin/hypseus
sudo cp scripts/singe.sh /usr/local/bin/singe
hypseus
singe

Configuration

Configuration of keycodes and joysticks should be made within hypinput.ini

Refer to keylist.txt for SDL2 keycode values.

Screenshots

(Click images for YouTube playlist)

Hypseus

singe

Altering Hypseus or Singe ROM locations in bash scripts

Edit run.sh and singe.sh, to reflect the location of your ROM folders:

HYPSEUS_SHARE=~/.daphne
HYPSEUS_SHARE=/home/pi/RetroPie/roms/daphne

Note: The default Hypseus home directory, created when run without -homedir:

~/.hypseus

Software Scoreboard

Enable the software external scoreboard panel in lair/ace: -software_scoreboard

Works in conjunction with -fullscreen_window or normal windowed mode.

Singe

For Singe, provide the following arguments to hypseus:

hypseus singe vldp -framefile ~/.daphne/singe/timegal/timegal.txt -script ~/.daphne/singe/timegal/timegal.singe -homedir ~/.daphne/ -datadir ~/.daphne/

Check for Singe anomalies and replacement files here.

Singe 2

Hypseus Singe now has psuedo support for Singe 2 games.

For current details see: Hypseus Singe 2 Data

Lightguns

Singe supports Sinden and DolphinBar based lightguns with the -manymouse argument.

This argument enables absolute (EV_ABS) mouse input event codes.

Note: -sinden automatically enables -manymouse

Singe joystick [mouse] support

Singe now automatically interprets joystick axis change as mouse movement (Gun Games).

Adjust sensitivity via -js_range <1-20> in Singe arguments.

Configure joystick controls in hypinput.ini

Extended arguments and keys

The following additional, and reimplemented, arguments have been added to Hypseus Singe:

-blank_searches            [ VLDP blanking [adjust: -min_seek_delay]       ]
-blank_skips               [ VLDP blanking [adjust: -min_seek_delay]       ]
-force_aspect_ratio        [ Force 4:3 aspect ratio                        ]
-keymapfile                [ Specify an alternate hypinput.ini file        ]
-nolinear_scale            [ Disable bilinear scaling [fullscreen]         ]
-original_overlay          [ Enable daphne style overlays (lair,ace,lair2) ]
-scalefactor               [ Scale video image [50-100]%                   ]
-scanlines                 [ Simulate scanlines [adjust: -x -y]            ]
-software_scoreboard       [ Enable software scoreboard in lair/ace/tq     ]

-blend_sprites             [ Restore BLENDMODE outline on Singe sprites    ]
-js_range <1-20>           [ Adjust Singe joystick sensitivity: [def:5]    ]
-manymouse                 [ Enable absolute mouse input [lightguns]       ]
-retropath                 [ Singe data path rewrites [libretro]           ]
-sinden <1-10> <color>     [ Enable software border for lightguns          ]
                           [ Color: (w)hite, (r)ed, (g)reen, (b)lue or (x) ]

Alt-Enter                  [ Toggle fullscreen                             ]
Alt-Backspace              [ Toggle scanlines                              ]
[KEY_BUTTON3]              [ Toggle scoreboard display in lair/ace         ]
[KEY_COIN1]=|[KEY_START1]  [ Joystick hotkey combination for [KEY_QUIT]    ]

Support

This software intended for educational purposes only. Please submit issues or pull requests directly to the project.

DO NOT submit issues or request support from the official Daphne forums!

About

Open development by the original author, Matt Ownby, ceased years ago.

Singe was created by Scott Duensing as a plugin to Daphne to allow the playing of American Laser Games.

This repository was created to build upon the Hypseus project created by Jeffrey Clark. Many overlays were still unimplemented in the original repository. Singe had also been removed.

The name was changed to Hypseus so the original authors of Daphne would not be burdened with requests for support.

A big thanks goes out to Matt Ownby, Scott Duensing, Jeffrey Clark, Manuel Alfayate, David Griffith and the many other developers who made their work available for me to build upon. Without them this project would not be possible.

License

Hypseus Singe, Super Multiple Arcade Laserdisc Emulator
Copyright (C) 2021 DirtBagXon

Hypseus, Multiple Arcade Laserdisc Emulator
Copyright (C) 2016 Jeffrey Clark

Daphne, the First Ever Multiple Arcade Laserdisc Emulator
Copyright (C) 1999-2013 Matt Ownby

GNU General Public License version 3

This program is free software: you can redistribute it and/or modify
it under the terms of the [GNU General Public License] as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
[GNU General Public License] for more details.

Trademark

The "Hypseus Singe" mark is used to uniquely identify this project as an Arcade Laserdisc Emulator. Any direct or indirect commercial use of the mark "Hypseus" is strictly prohibited without express permission.