<WRAP group>
<WRAP round box twothirds column>
{{ https://raw.githubusercontent.com/DirtBagXon/hypseus-singe/060535e3f1174e6d4d4286eddb5b40068b056dac/screenshots/hypsinge-logo.svg?nolink&h=320 }}

====== Hypseus Singe ======
[[https://kangaroopunch.com/view/ShowSoftware?id=7|SINGE]] (or Singe) is the **S**omewhat **I**nteractive **N**ostalgic **G**ame **E**ngine ((As quoted on their website)), a Lua-based scripting system that allows LaserDisc or any pre-recorded video source games to be simulated as a playable game. The [[https://github.com/DirtBagXon/hypseus-singe|Hypseus fork]], integrating compatibility with SINGE-based games, refers it simply as Hypseus Singe­.

This system scrapes metadata for the ''daphne, arcade'' group(s) and loads the ''singe'' set from the currently selected theme, if available.

</WRAP>

<WRAP third column>
{{ https://raw.githubusercontent.com/fabricecaruso/es-theme-carbon/master/art/consoles/daphne.png?nolink&350 |}}
{{ :systems:laserdisc.jpg?nolink&130 |}}
</WRAP>
</WRAP>

==== Quick reference ====

  * **Emulator:** [[#singe/hypseus|SINGE/Hypseus]]
  * **Folder:** ''/userdata/roms/singe/''
  * **Accepted ROM formats:** ''.daphne'' ''.squashfs''

===== BIOS =====

No Singe simulator in Batocera needs a BIOS file to run.

===== ROMs =====

<WRAP center round important 60%>
Since v40, Singe-based games (**not to be confused with [[systems:daphne|DAPHNE]]**) must be placed in ''/userdata/roms/singe/''. 

If you are on Batocera prior to v40, place your ROMs in ''/userdata/roms/daphne/'' instead.
</WRAP>

Place your Singe ROMs in ''/userdata/roms/singe/''. 

Depending on what assets you have, there are two versions of Singe: ''Singe 1.x'' from 2006 and ''Singe 2.x'' from 2020.

All Singe assets are available from the [[https://github.com/DirtBagXon/hypseus_singe_data/releases|Hypseus Singe data repository]].

==== Asset version per stable Batocera release ====

It is important to download the right asset version for your Batocera version. Newer asset version won't work for older versions of Hypseus SINGE.Refer to the following list:

^ Batocera version  ^ Hypseus SINGE version  ^ Link to asset version                                                                      ^ Notes                  ^
| Batocera v42      | Hypseus SINGE 2.11.5   | [[https://github.com/DirtBagXon/hypseus_singe_data/releases/tag/v2.11.5-1|Download link]]  |                        |
| Batocera v41      | Hypseus SINGE 2.11.3   | [[https://github.com/DirtBagXon/hypseus_singe_data/releases/tag/v2.11.3-1|Download link]]  |                        |
| Batocera v40      | Hypseus SINGE 2.11.2   | [[https://github.com/DirtBagXon/hypseus_singe_data/releases/tag/v2.11.2-9|Download link]]  |                        |
| Batocera v39      | Hypseus SINGE 2.11.1   | [[https://github.com/DirtBagXon/hypseus_singe_data/releases/tag/v2.11.1-3|Download link]]  |                        |
| Batocera v38      | Hypseus SINGE 2.11.1   | [[https://github.com/DirtBagXon/hypseus_singe_data/releases/tag/v2.11.1-3|Download link]]  |                        |
| Batocera v37      | Hypseus SINGE 2.10.4   | [[https://github.com/DirtBagXon/hypseus_singe_data/releases/tag/v2.10.4-5|Download link]]  |                        |
| Batocera v36      | Hypseus SINGE 2.10.2   | [[https://github.com/DirtBagXon/hypseus_singe_data/releases/tag/v2.10.2-1|Download link]]  |                        |
| Batocera v35      | Hypseus SINGE 2.8.3    | [[https://github.com/DirtBagXon/hypseus_singe_data/releases/tag/v2.10.1-2|Download link]]  | Singe 1.x assets only  |
| Batocera v34      | Hypseus SINGE 2.8.2    | [[https://github.com/DirtBagXon/hypseus_singe_data/releases/tag/v2.10.1-2|Download link]]  | Singe 1.x assets only  |
| Batocera v33      | Hypseus SINGE 2.8.0    | [[https://github.com/DirtBagXon/hypseus_singe_data/releases/tag/v2.10.1-2|Download link]]  | Singe 1.x assets only  |
| Batocera v32      | Hypseus SINGE 2.6.12   | [[https://github.com/DirtBagXon/hypseus_singe_data/releases/tag/v2.10.1-2|Download link]]  | Singe 1.x assets only  |

==== Singe 1.x ====

Singe 1.x are legacy assets mostly known and used with limited functionnalities.

The file structure consists of a directory with the ending ''.daphne'' (containing video, audio and text files) in the folder ''/roms/''. For example, ''freedomfighter'':

<code>
roms
|-- singe
|    |
|    |-- freedomfighter.daphne (contains all the assets at root level)
|    |    |-- cdrom folder (image and audio ROMs)
|    |    |-- ...
|    |    |-- freedomfighter.singe (LUA-script file)
|    |    |-- freedomfighter.txt (Framefile)
|    |    |-- ...
</code>

==== Singe 2.x ====

<WRAP center round important 60%>
**Many Singe 2 ROMs require ''Framework'' folder to work.**

It must be downloaded from the [[https://github.com/DirtBagXon/hypseus_singe_data/releases|Hypseus Singe data repository]].
</WRAP>

Singe 2.x are newer assets with some nice new features like animated spirtes and compatibility with HD upscaled games.

To install the newer assets, let's use ''Asterix'' ROM for example.:

{{:systems:asterix-1.png|}}`

As mentionned, we will download and extract ''singe2'' assets from the Hypseus Singe data repository.

First, navigate to ''/00-singe2/'' folder. You should find ''Asterix'' folder there:

{{:systems:asterix-3.png|}}

Rename the folder ''Asterix'' to ''Asterix.daphne'' and copy it into Batocera ''/userdata/roms/singe/'' along with ''Framework'' folder. 

{{:systems:asterix-4.png|}}

Upload ''asterix.m2v'' and ''asterix.ogg'' files into ''Video'' folder of the ROM asset (''/userdata/roms/singe/Asterix.daphne/Video/''):

{{:systems:asterix-5.png|}}

The file structure consists of a directory with the ending ''.daphne'' (containing video, audio and text files subdivided by folders) in the folder ''/roms/''. For example, ''Asterix'':

<code>
roms
|-- singe
|    |
|    |-- Asterix.daphne     
|    |    |-- Cfg
|    |    |-- Fonts
|    |    |-- Overlay
|    |    |-- Script
|    |    |-- Sounds
|    |    |-- Video (ROM files go into this folder)
|    |    |    |-- asterix.m2v  (image ROM)
|    |    |    |-- asterix.ogg  (audio ROM)
|    |
|    |-- Framework
</code>

===== Simulators =====

==== SINGE/Hypseus ==== 

SINGE is the most known simulator for video-based games. We use the [[https://github.com/DirtBagXon/hypseus-singe|Hypseus Singe]], a fork of the [[http://www.daphne-emu.com/|original DAPHNE emulator]].

=== SINGE/Hypseus configuration ===

Standardized features available to all cores of this emulator: ''daphne.videomode'', ''daphne.ratio'', ''daphne.padtokeyboard''

^ ES setting name ''batocera.conf_key'' ^ Description => ES option ''key_value'' ^
^ Settings that apply to all cores of this emulator ||
^ ES setting name ''batocera.conf_key'' ^ Description => ES option ''key_value'' ^
^ Settings that apply to all cores of this emulator ||
| **GRAPHICS API ''daphne.gfxbackend''** | Choose which graphics API library to use. Vulkan may not work on all hardware.\\ => OpenGL ''OpenGL'', Vulkan ''Vulkan''. |
| **ASPECT RATIO ''daphne.daphne_ratio''** | Not all games support stretching, depending on their video files.\\ => Original ''original'', Stretch ''stretch'', Force 4:3 ''force_ratio''. |
| **SCREEN ROTATION ''daphne.daphne_rotate''** | \\ => 0 degrees ''0'', 90 degrees ''90'', 270 degrees ''270''. |
| **SMOOTH GAMES (BILINEAR FILTERING) ''daphne.bilinear_filter''** | \\ => On ''0'', Off ''1''. |
| **SCANLINES ''daphne.daphne_scanlines''** | Use with the stretch aspect ratio and adjust joystick sensitivity as required.\\ => Off ''0'', On ''1''. |
| **BLEND SPRITES (SINGE) ''daphne.blend_sprites''** | Restore BLENDMODE outline on Singe sprites.\\ => Off ''0'', On ''1''. |
| **OVERLAY SIZE (SINGE) ''daphne.overlay_size''** | \\ => Standard ''0'', HD Gun Games ''oversize'', Singe 2 Full ''full'', Singe 2 Half ''half''. |
| **ABSOLUTE MOUSE INPUT ''daphne.abs_mouse_input''** | This option is required for some gun games when playing with a mouse.\\ => Off ''0'', On ''1''. |
| **INVERT AXIS ''daphne.invert_axis''** | Invert the vertical joystick axis on flight games.\\ => Off ''0'', On ''1''. |
| **JOYSTICK TO CURSOR SENSITIVITY ''daphne.singe_joystick_range''** | \\ => 5 ''5'', 10 ''10'', 15 ''15'', 20 ''20''. |
| **HIDE LIGHT GUN CROSSHAIRS ''daphne.singe_crosshair''** | Hide crosshairs in supported games e.g. ActionMax.\\ => Off ''0'', On ''1''. |
| **SDL TEXTURE ACCESS STREAMING ''daphne.daphne_texturestream''** | Can improve video performance. Do not use with ActionMax games or scanlines.\\ => Off ''0'', On ''1''. |
| **CUSTOM CONTROLLER ''daphne.daphne_joy''** | Use controller settings manually defined in custom.ini.\\ => Off ''0'', On ''1''. |

===== Controls =====

Here are the default Hypseus singe's controls shown on a [[:configure_a_controller|Batocera Retropad]]:

{{ https://raw.githubusercontent.com/batocera-linux/batocera-controller-overlays/master/solid-4k/daphne.png }}

^ Gamepad ^ Arcade ^
| SELECT | Input Coin |
| START | START Player 1 |
| A | Action Button |
| X | Singe Overlay |
| D-pad | Stick |

===== Troubleshooting =====

==== Further troubleshooting ====

For further troubleshooting, refer to the [[:support|generic support pages]].