Hypseus Pi - Revision history

Widge: /* Installation Guide */

2022-12-28T12:18:54Z

Installation Guide

Widge at 12:12, 28 December 2022

2022-12-28T12:12:51Z

Widge at 12:06, 28 December 2022

2022-12-28T12:06:22Z

Widge: Created page with "{{emuinfobox |title = Hypseus Singe |logo = hypseus_logo.png |category = Emulator |system = Hypseus Singe |download = [https://github.com/DirtBagXon/hypseus-singe DirtBagXon G..."

2022-12-28T11:59:04Z

Created page with "{{emuinfobox |title = Hypseus Singe |logo = hypseus_logo.png |category = Emulator |system = Hypseus Singe |download = [https://github.com/DirtBagXon/hypseus-singe DirtBagXon G..."

New page

{{emuinfobox
|title = Hypseus Singe
|logo = hypseus_logo.png
|category = Emulator
|system = Hypseus Singe
|download = [https://github.com/DirtBagXon/hypseus-singe DirtBagXon GitHub page]
|license = Free (GNU GPLv3)
|gameplayshot = actionmax_gameplay.png
|note =
}}
[[wikipedia:Action_Max|ActionMax]] is a home video game console using VHS tapes to play a set of lightgun games. It was manufactured in 1987 by Worlds of Wonder.

There were five games released: .38 Ambush Alley, Blue Thunder, Hydrosub: 2021, The Rescue of Pops Ghostly, and Sonic Fury

You can watch this [https://www.youtube.com/watch?v=mj498-wkOz4 YouTube video] providing insight into the original system.

== Retropie Details ==
ActionMax was ported to Singe, but up until now, it was unplayable on 32-bit Retropie.
DirtBagXon (of Hypseus Singe fame) has put together a Singe implementation that runs ActionMax on the 32-bit Retropie allowing all five games to be played.

== Video Setup Guide ==
This video guide was created by Wiggy808

<youtube>https://www.youtube.com/watch?v=bK6N6S5pBew</youtube>

== Installation ==
Installation files and steps for the ActionMax Pi emulator can be found in [https://github.com/DirtBagXon/actionmax-pi GitHub].

Note that if you are using [[Raspberry Pi Setup Guide|Barebones 9]] then ActionMax is already preinstalled and configured.

== Post-installation ==

=== Rom Location ===
Place your ROMs in <code>/home/pi/RetroPie/roms/daphne</code>

=== .Commands Files ===
In order to get the games working with your Sinden lightgun, you will need to create a <code>[GAMENAME].commands</code> file for each of the five games and place them in the <code>roms/daphne/actionmax</code> folder

the <code>-border</code> argument value can be adjusted to either thin or thicken the borders (accepted values are 1-10). the <code>-manymouse</code> argument enables ABS mouse input for lightgun usage and is automatically enabled when enabling <code>-border</code> If you are not getting a fullscreen display, you can try adding <code>-ignore_aspect_ratio</code> to the <code>.commands</code> files.

=== General guidance for creating <code>.commands</code> files: ===
Use the below command to create all 5 <code>.commands</code> files with the <code>-border 5</code> argument and value (this enables Sinden borders with a thickness of 5, which you can adjust to your liking):

<code>cd $HOME/RetroPie/roms/daphne/actionmax ; for x in 38ambushalley bluethunder hydrosub2021 popsghostly sonicfury ; do echo "-border 5" > $x.commands ; done</code>

=== Fullscreen Issues ===
If you are having issues getting the games to appear in fullscreen you can create <code>.commands</code> files with the <code>-ignore_aspect_ratio</code> argument via the following command:

<code>cd $HOME/RetroPie/roms/daphne/actionmax ; for x in 38ambushalley bluethunder hydrosub2021 popsghostly sonicfury ; do echo "-border 5 -ignore_aspect_ratio" > $x.commands ; done</code>

== Startup ==
When launching a game from Emulation Station (via the Daphne system), press a button to enter the runcommand menu (blue menu). Choose emulator for ROM - actionmax

== Additional guidance ==

=== Exit Keys ===
<code>ESC</code> on a keyboard exits an ActionMax game

You may want to map a way to exit the game via a gamepad by adjusting the 3rd value of <code>KEY_QUIT</code> in <code>/opt/retropie/emulators/actionmax/singeinput.ini</code>

example: for an 8bitdo SN30 wired, the following line would allow the left shoulder button to exit the game: <code>KEY_QUIT = 27 0 5</code>

There is also a hotkey combo, holding select/coin1 and pressing start. These buttons will also need to be assigned in the <code>singeinput.ini</code>.

=== Crosshairs ===
Crosshairs are on by default. It is not possible to remove these in-game, but you can replace <code>sprite_crosshair.png</code> in the <code>/roms/daphne/actionmax</code> directory with a transparent .png of the same resolution (11x11 pixels).

=== Gamepad Use ===
For those who prefer to play with a gamepad, you can also map the trigger by changing the 3rd value of <code>KEY_BUTTON3</code> in <code>/opt/retropie/emulators/actionmax/singeinput.ini</code>
example: for an 8bitdo SN30 wired, the following line would allow the left trigger button to start the game and shoot: <code>KEY_BUTTON3 = 32 0 7</code>

[[Category: Emulators Pi]]

@@ Line 20: / Line 20: @@
 * Rename the folder by adding <code>.daphne</code> after it and put that folder into your <code>/roms/daphne</code> folder.
 * Then add your <code>.m2v</code> and <code>.ogg</code> files into the <code>/cdrom</code> subfolder within the game folder. Make sure to check the <code><gamename>.txt</code> file to ensure you have the correct <code>.m2v</code> and <code>.ogg</code> files and path; the names & path should match.
-* Then create a <code><gamename>.commands</code> text file and add a single line with the parameters for the sinden gun & borders. Just add the line <code>-blend_sprites -manymouse -x 800 -y 600 -sinden 5 w</code>, or for HD versions of the games use <code>-blend_sprites -oversize_overlay -sinden 10 w</code> instead to prevent audio sync and crosshair alignment issues.
+* Then create a <code><gamename>.commands</code> text file and add a single line with the parameters for the sinden gun & borders. Just add the line <code>-blend_sprites -manymouse -x 800 -y 600 -sinden 5 w</code>,  or for HD versions of the games use <code>-blend_sprites -oversize_overlay -sinden 10 w</code> instead to prevent audio sync and crosshair alignment issues.
 * Save the file with the correct gamename (i.e. <code>maddog2.commands</code>) and add it to the game folder.
 * Then run from the daphne menu.
@@ Line 28: / Line 28: @@
 * Hypseus ports lack the 2-player features of the arcade originals
-Also note, platoon seems to be the only game where you need to convert the .mp4 file to separate .m2v & .ogg files with ffmgeg, see directions on the github. Platoon is also the only game where the <code>.m2v</code> & <code>.ogg</code> files are saved in the root gamefolder and not the <code>/cdrom</code> subfolder. Enjoy!
+Also note, platoon seems to be the only game where you need to convert the .mp4 file to separate .m2v & .ogg files with ffmgeg, see directions on the github. Platoon is also the only game where the <code>.m2v</code> & <code>.ogg</code> files are saved in the root gamefolder and not the <code>/cdrom</code> subfolder.
+Enjoy!
 == Post-installation ==

@@ Line 9: / Line 9: @@
 |note =
 }}
+'''Hypseus Singe''' is a fork and SDL2 version of Daphne and Singe.
-[[wikipedia:Action_Max|ActionMax]] is a home video game console using VHS tapes to play a set of lightgun games. It was manufactured in 1987 by Worlds of Wonder.
+A program to play laserdisc arcade games
-There were five games released: .38 Ambush Alley, Blue Thunder, Hydrosub: 2021, The Rescue of Pops Ghostly, and Sonic Fury
+== Installation Guide ==
-You can watch this [https://www.youtube.com/watch?v=mj498-wkOz4 YouTube video] providing insight into the original system.
+If you are using [[Raspberry Pi Setup Guide|Barebones 9]], then Hypseus is preinstalled and you need not follow this guide.
+* First install hypseus-singe per the github instructions (https://github.com/DirtBagXon/hypseus-singe/blob/master/src/3rdparty/retropie/RETROPIE.md)
-== Retropie Details ==
+* Then download the game folder from the hypseus_singe_data github (https://github.com/DirtBagXon/hypseus_singe_data/tree/master/00-singe1)
-ActionMax was ported to Singe, but up until now, it was unplayable on 32-bit Retropie.
+* Rename the folder by adding <code>.daphne</code> after it and put that folder into your <code>/roms/daphne</code> folder.
-DirtBagXon (of Hypseus Singe fame) has put together a Singe implementation that runs ActionMax on the 32-bit Retropie allowing all five games to be played.
+* Then add your <code>.m2v</code> and <code>.ogg</code> files into the <code>/cdrom</code> subfolder within the game folder. Make sure to check the <code><gamename>.txt</code> file to ensure you have the correct <code>.m2v</code> and <code>.ogg</code> files and path; the names & path should match.
+* Then create a <code><gamename>.commands</code> text file and add a single line with the parameters for the sinden gun & borders. Just add the line <code>-blend_sprites -manymouse -x 800 -y 600 -sinden 5 w</code>, or for HD versions of the games use <code>-blend_sprites -oversize_overlay -sinden 10 w</code> instead to prevent audio sync and crosshair alignment issues.
+* Save the file with the correct gamename (i.e. <code>maddog2.commands</code>) and add it to the game folder.
+* Then run from the daphne menu.
+* Left shoulder button on gamepad also exits game
-== Video Setup Guide ==
-This video guide was created by Wiggy808
+* Hypseus ports lack the 2-player features of the arcade originals
-<youtube>https://www.youtube.com/watch?v=bK6N6S5pBew</youtube>
+Also note, platoon seems to be the only game where you need to convert the .mp4 file to separate .m2v & .ogg files with ffmgeg, see directions on the github. Platoon is also the only game where the <code>.m2v</code> & <code>.ogg</code> files are saved in the root gamefolder and not the <code>/cdrom</code> subfolder. Enjoy!
-== Installation ==
-Installation files and steps for the ActionMax Pi emulator can be found in [https://github.com/DirtBagXon/actionmax-pi GitHub].
-Note that if you are using [[Raspberry Pi Setup Guide|Barebones 9]] then ActionMax is already preinstalled and configured.
 == Post-installation ==
@@ Line 33: / Line 34: @@
 === Rom Location ===
 Place your ROMs in <code>/home/pi/RetroPie/roms/daphne</code>
-=== .Commands Files ===
-In order to get the games working with your Sinden lightgun, you will need to create a <code>[GAMENAME].commands</code> file for each of the five games and place them in the <code>roms/daphne/actionmax</code> folder
-the <code>-border</code> argument value can be adjusted to either thin or thicken the borders (accepted values are 1-10). the <code>-manymouse</code> argument enables ABS mouse input for lightgun usage and is automatically enabled when enabling <code>-border</code> If you are not getting a fullscreen display, you can try adding <code>-ignore_aspect_ratio</code> to the <code>.commands</code> files.
-=== General guidance for creating <code>.commands</code> files: ===
-Use the below command to create all 5 <code>.commands</code> files with the <code>-border 5</code> argument and value (this enables Sinden borders with a thickness of 5, which you can adjust to your liking):
-<code>cd $HOME/RetroPie/roms/daphne/actionmax ; for x in 38ambushalley bluethunder hydrosub2021 popsghostly sonicfury ; do echo "-border 5" > $x.commands ; done</code>
-=== Fullscreen Issues ===
-If you are having issues getting the games to appear in fullscreen you can create <code>.commands</code> files with the <code>-ignore_aspect_ratio</code> argument via the following command:
-<code>cd $HOME/RetroPie/roms/daphne/actionmax ; for x in 38ambushalley bluethunder hydrosub2021 popsghostly sonicfury ; do echo "-border 5 -ignore_aspect_ratio" > $x.commands ; done</code>
-== Startup ==
-When launching a game from Emulation Station (via the Daphne system), press a button to enter the runcommand menu (blue menu).  Choose emulator for ROM - actionmax
-== Additional guidance ==
-=== Exit Keys ===
-<code>ESC</code> on a keyboard exits an ActionMax game
-You may want to map a way to exit the game via a gamepad by adjusting the 3rd value of <code>KEY_QUIT</code> in <code>/opt/retropie/emulators/actionmax/singeinput.ini</code>
-example: for an 8bitdo SN30 wired, the following line would allow the left shoulder button to exit the game: <code>KEY_QUIT = 27 0 5</code>
-There is also a hotkey combo, holding select/coin1 and pressing start. These buttons will also need to be assigned in the <code>singeinput.ini</code>.
-=== Crosshairs ===
-Crosshairs are on by default.  It is not possible to remove these in-game, but you can replace <code>sprite_crosshair.png</code> in the <code>/roms/daphne/actionmax</code> directory with a transparent .png of the same resolution (11x11 pixels).
-=== Gamepad Use ===
-For those who prefer to play with a gamepad, you can also map the trigger by changing the 3rd value of <code>KEY_BUTTON3</code> in <code>/opt/retropie/emulators/actionmax/singeinput.ini</code>
-example: for an 8bitdo SN30 wired, the following line would allow the left trigger button to start the game and shoot: <code>KEY_BUTTON3 = 32 0 7</code>
 [[Category: Emulators Pi]]

@@ Line 6: / Line 6: @@
 |download = [https://github.com/DirtBagXon/hypseus-singe DirtBagXon GitHub page]
 |license = Free (GNU GPLv3)
-|gameplayshot = actionmax_gameplay.png
+|gameplayshot = hypseus_gameplay.png
 |note =
 }}