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
• Daphne VLDP 32bit upgrade
• Daphne and Singe 4k M2V support
• Singe libretro emulation path integration
• Singe Joystick, Lightgun EV_ABS [mouse] support
• Psuedo Singe 2 support (details below)
• Sinden support in Singe games
• Daphne alternate overlay choices
• Advanced configuration and multi-joystick support: config
• Software 'lair/ace' original scoreboard: preview
• 64bit 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 information 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, fonts, 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.

Use the hypjsch utilities to help configuration.

Screenshots

(Click images for YouTube playlist)

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

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                        ]
-grabmouse                 [ Capture mouse in SDL window                   ]
-keymapfile <flight.ini>   [ Specify an alternate hypinput.ini file        ]
-nolinear_scale            [ Disable bilinear scaling                      ]
-novsync                   [ Disable VSYNC presentation on Renderer [crt]  ]
-original_overlay          [ Enable daphne style overlays (lair,ace,lair2) ]
-scalefactor               [ Scale video image [50-100]%                   ]
-scanlines                 [ Simulate scanlines [adjust: -scanline_shunt]  ]
-scanline_alpha <1-255>    [ Adjust scanline alpha blending                ]
-scanline_shunt <2-10>     [ Shunt scanline spacing [adjust: -x -y]        ]
-software_scoreboard       [ Enable software scoreboard in lair/ace/tq     ]
-tiphat                    [ Invert joystick SDL_HAT_UP and SDL_HAT_DOWN   ]

-blend_sprites             [ Restore BLENDMODE outline on Singe sprites    ]
-bootsilent                [ Mute sound during initVLDP() if possible      ]
-js_range <1-20>           [ Adjust Singe joystick sensitivity: [def:5]    ]
-manymouse                 [ Enable ABS mouse input [lightguns] [gungames] ]
-nocrosshair               [ Request game does not display crosshairs      ]
-oversize_overlay          [ Use with HD gungame m2v video sources         ]
-retropath                 [ Singe data path rewrites [.daphne]            ]
-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]    ]

Enforce SDL Window context when Renderer auto-detection fails (no further extensions enabled):

-opengl                    [ Enable OpenGL SDL Window context              ]
-vulkan                    [ Enable Vulkan SDL Window instance             ]

Switch SDL_TEXTUREACCESS ^*

-texturestream             [ Enable SDL_TEXTUREACCESS_STREAMING            ]
-texturetarget             [ Enable SDL_TEXTUREACCESS_TARGET (Default)     ]

^{* This can aid SBC's with SDL2 => 2.0.16}

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 expand the Hypseus project started by Jeffrey Clark. Many overlays were unimplemented in the original repository. Singe had also been removed.

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

A massive 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, Being Retro Orientated This Humble Emulator Regenerates
Copyright (C) 2021-2022 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

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.