Hypseus

*** #### :pushpin: _External Links_ :fire: Support the project via **_[itch.io](https://dirtbagxon.itch.io/hypseus)_** download. :fire: Grab _Widge's_ recommended **_[Borf](https://therealwidge.itch.io/borf-launcher-for-hypseus)_  Launcher** for Windows. :fire: Try the brand new **[Android](https://www.youtube.com/watch?v=z4TmGtvEcZI)** port of Hypseus _[v3.0.2]_: **_[Hypdroid](https://github.com/rhakka303/Hypdroid/releases )_  ** :fire: **Libretro cores** _[under independent maintenance]_ for Hypseus: **_[here.](https://github.com/beudbeud/hypseus-singe/releases )_  ** :fire: Create your own _laserdisc_ style games with zero tech knowledge: **_[LaserForge](https://github.com/Eggmansworld/EggmansLaserForge )_  ** *** **Retrospective news:** - Links to the _[Hypdroid](https://github.com/rhakka303/Hypdroid )_ Android app and _[libretro](https://github.com/beudbeud/hypseus-singe/releases )_ cores added to _'External Links'_. - Experimental _RetroPie 'hypseus-sdl3' scriptmodules_ now available for download. [observe installation order] - Don't forget the drive for [_community help_](https://www.youtube.com/playlist?list=PLD9sPMuaC4s4) with missing media for the [_final Hypseus Picmatic game_](https://img.youtube.com/vi/7aELjpGZ2nk/sddefault.jpg) release. *** [](https://github.com/DirtBagXon/hypseus-singe) This release changelog: Further SDL3 transitions. - Fine tune _vldp_audio_callback_ to utilize SDL3 streaming efficiently. - Added the ability to retrieve the number of connected "_relative mice_" in API - Altered example _.ini_ files so direct copies are sane for most users. - Removed misplaced `SDL_free` when detecting _MAX_GAMECONTROLLER_ joysticks. - Removed `-sound_buffer` to preserve new SDL3 audio stream timing. - Updated distributed _gamecontrollerdb.txt_ where appropriate. - Improved alignment in the _tms9128_ _Goal to Go_ play tactic menu. - Argument added to preserve video aspect ratio in non-standard displays. - Fixed an SDL3 caused buffer overflow in the DAC sound driver _[MACH3]_. - Blitting the game overlay on top of a game bezel is now supported. - Serialize the sound _CHIP_ updates via _Mutex_ lock_guards. - Add API call to flip bilinear scaling on the overlay. - Trim `[GLOBAL]` _.ini_ section in auto-generated files. - Add controlled _HINTING_ and _BLEND_ for _SDL3_TTF_ fonts. - Treat `//` in _ZipROM_, as on filesystem. - And more...   Comments: - This release fixes a long standing sound adjustment, speedup, issue in select game startup. - Bilinear scaling Service Menu options, in updated _Frameworks_, will become available in this release. - The `[GLOBAL]` section seemed to cause confusion, defaults are now simplified and enablements logged. - Added an argument and `[GLOBAL]` setting for aspect-ratio preservation on non-standard screen formats. `-preserve_aspect_ratio` argument and `PRESERVEASPECT` in `[GLOBALS]` This should allow better support for the `cops` bezel on _non-16:9_ displays. - Bilinear scale toggle on overlays is available via the toolbox macro: _ALT-B_ - `-overlaybezel` and `setOverlayOnTop()` _API_ allows overlay drawing over bezels. - Support the project via **_[itch.io](https://dirtbagxon.itch.io/hypseus)_** download. _Overlay over 16:9 bezel:_

*** #### :pushpin: _External Links_ :fire: Grab the **_[Borf](https://therealwidge.itch.io/borf-launcher-for-hypseus)_  Launcher** for Windows. :fire: Create your own _laserdisc_ style games with zero tech knowledge: **_[LaserForge](https://github.com/Eggmansworld/EggmansLaserForge )_  ** *** [](https://github.com/DirtBagXon/hypseus-singe) This release changelog: _SDL3_ transition. - Added ROM eshfix7, eshfix7alt & eshfix7alt2 - Level 7 fix by Shaun Wood & Matt Ownby - Utilize the new _SDL3_Mixer_ for multiple simultaneous music tracks and fading. - Added _SDL3 RelativeMouseMode_ across multiple mouse devices: `-relative-mice` - Fix transparency stacking issue when using _SDL_BlitSurfaceScaled( )_. - Allow customized "_non-standard_" MPEG2 framerates via LUA API - Provide detailed Joystick information in launch logs. - Removed annoying legacy _sdl2_ toggle restrictions. - Mono overlay now works with FullAlpha mode. - Fix music Resume from Pause in _SDL3_Mixer_. - Added `LINEARSCALE` to _.ini_ `[GLOBALS]` - Added _KMSDRM_ support. - Updated [`hypjsch`](https://github.com/DirtBagXon/hypjsch)

*** #### :pushpin: _External Links_ :fire: Grab the **_[Borf](https://therealwidge.itch.io/borf-launcher-for-hypseus)_  Launcher** for Windows. :fire: Create your own _laserdisc_ style games with zero tech knowledge: **_[LaserForge](https://github.com/Eggmansworld/EggmansLaserForge )_  ** *** [](https://github.com/DirtBagXon/hypseus-singe) This release changelog: _**Note:**_ This release contains a replacement `digital.ttf` font. If upgrading, ensure the new `.ttf` is copied to your existing `font` folder. This _v2.12.1_ release will be the last sdl2 version. It will be remain in the `sdl2` branch. `master` branch now contains _v3.0.0  [a current feature matched]_  **sdl3** version. Several efficiency, transparency, configuration and feature updates in this release. * Removed SDL subsystem loading. Resolves _[video]_  'reference count' issues. * _[GLOBAL]_ and _[MOUSE]_ assignments can now be made in config _.ini_ files. * Implemented speed optimizations in LUA game sprite blitting. * Implemented support for full transparency in LUA sprites. * Altered the Rumble step range for a more natural growth. * Redesign of `lair`,`ace`, `tq` _'overlay'_ based scoreboards. * Don't compile _DEFUNC_ drivers by default. * Improved _overlayPrint()_ API functionality. * Fixed some potential _-nosound_ crashes. * Removed many dangling prototypes. * Added _.srt_ support for LUA games. * Added _lpeg_ plugin for LUA. * Begin migration to _SDL3_. _Comments:_ - Enabling semi-transparency in LUA sprites is achieved via `-fullalpha` or `overlayFullAlpha()` API. In _v3.0.0_  it can be enabled via the `[GLOBAL]` section of the new _.ini_ configuration. Be aware that most current game sprites do not utilize transparency fully. Using this feature may improve game speed and lower CPU utilisation. - There will no longer be generic _.bat_ file zips in releases. **_[Borf](https://therealwidge.itch.io/borf-launcher-for-hypseus)_** can create these _[fully customized]_ for you. - Default `[MOUSE]` config, which replicates current behaviour, is: ``` [MOUSE] MOUSE_BUTTON1 = KEY_BUTTON3 MOUSE_BUTTON2 = KEY_BUTTON1 MOUSE_BUTTON3 = KEY_BUTTON2 END ``` - Available `[GLOBAL]` options are: ``` [GLOBAL] SCREEN = 0 VLDPVOLUME = 40 NONVLDPVOLUME = 10 ALWAYSONTOP = FALSE FULLSCREEN = TRUE MANYMOUSE = FALSE GAMEPAD = TRUE SCANLINES = FALSE FULLALPHA = FALSE GRAPHICAPI = AUTO END ``` `SCREEN` refers to the `-screen` argument. `GRAPHICAPI` can be enforced to `OPENGL` or `VULKAN`. **Important Note:** `[GLOBAL]` config will override counterpart command-line arguments ‡ ‡ However, the whole section [including individual settings] are optional and can be removed safely. _Full transparency example:_

[](https://github.com/DirtBagXon/hypseus-singe) This release changelog: "_Stuff Nobody Reported But Was Fixed Anyway_" **Borf Launcher**: https://therealwidge.itch.io/borf-launcher-for-hypseus Dedicated **Bezel** repo: https://github.com/gojidan/hypseus-singe-bezels _What changed? The honest answer: stuff. Specifically, the stuff that needed fixing while trying not to break other stuff. Since nobody ever reads these notes anyway, figured we’d save everyone some time and go with the most accurate release notes yet._ _Odds and ends:_ * Switched default SDL texture access to `SDL_TEXTUREACCESS_STREAMING` * Switched the LUA API _getPixel()_ calls to use a local _YUV buffer_ and remove `SDL_RenderReadPixels()` * Removing `SDL_TEXTUREACCESS_TARGET` has resulted in a significant lowering of CPU utilization. * On low resource SBC devices this now allows the _'pixel picking'_ games to be used successfully. * Switched to `SDL_OpenAudioDevice()` to alleviate sound device initialization issues. * Enforce correct usage of the misunderstood `-useoverlaysb` argument. * Modernized `rgb2yuv` to a high-performance C++ implementation. * Fixed a heap overflow in Thayer's Quest synthisized speech driver. * Added the ability to use `.` in `-usealt` arguments. _[Request]_ * Added ability to alter the Game Controller trigger threshold. * Redefine _"rom"_ order loading priority in Singe bash script. * _luasocket_ has been added for network socket support. * Improvement in SDL Relative mouse implementation. * Shifted _ZipLFS_ C++ globals from incorrect _extern "C"_ * Added API call for sprite "_grid_" and MPEG luma. * Renamed legacy `-retropath` to `-espath`. * Made libzippp call handling more robust. * Updated splash and icon graphics. * Lots of cleanup. *Comments:* - The previous default of `SDL_TEXTUREACCESS_TARGET` is gone, a revert argument remains for edge cases. - SBC's should now be able to run Video Driver, Captain Power & Action Max with the added bonus of no longer needing the `-texturestream` argument to bypass CPU load issues. - The move to `SDL_OpenAudioDevice()` resolves issues with `sdl2-compat` and Windows compiles. - A `-retropath` argument alias remains, but `-espath` now better reflects the purpose of the on-the-fly rewrites. - There will no longer be generic _.bat_ file zips in releases. _[Borf](https://therealwidge.itch.io/borf-launcher-for-hypseus)_ can create these, fully customized, for you*.   * _The `2.11.7` bat file zip is still available in the previous release, if you have a burning desire for them._

[](https://github.com/DirtBagXon/hypseus-singe) This release changelog: **Borf Launcher**: https://therealwidge.itch.io/borf-launcher-for-hypseus * An _MS_ Windows Game Controller _Rumble_ issue has been addressed. * Direct support for the _**Cliff O**verrun fi**X** v1.1_ ROM* by [_Shaun Wood_](https://www.wood1st.com/LaserCon/). * This is a minor release to accomodate frontend launcher development. * Announcing the MS Windows _'Borf Launcher for Hypseus'_ by [_Widge_](https://github.com/Widge-5):   * _Cliff Overrun fiX v1.1_ ROM is supported as `cliff_ox`

[](https://github.com/DirtBagXon/hypseus-singe) This release changelog: * Implement a _LUA_ `ziplfs` module to support _lfs_ operations directly inside Zip ROMs. * Analog Guns presenting via _Game Controller API_ can now act as _mice_ with [`-gamepad -manymouse`] * Fixed `toggle_fullscreen` misaligned _WindowFlag_ issue [_sdl2_compat_] * Bezels now display correctly on secondary screens: [`-screen`] * Enhanced ManyMouse Linux `evdev` mouse detection and selection [_SeongGino_] * Added ability to revert to legacy window teardown operation: [_legacy video drivers_] * Updated *SDL_FontCache*: Fixed font (_re_)loading issue introduced in previous release. * Fixed a ManyMouse "_repeating held button_" bug in `evdev` _INPUT_ controller logic. * Introduced a basic _linear blend deinterlacing_ algorithm via [`-blend`] * Added a LUA API function for screen _flash_ effect. [_lightguns_]. * Updated `bash` scripts to now use `.hypseus` as _homedir_. * Removed legacy `vldp_dl` Daphne references - folder alignments - Move `vldp_dl` contents to `vldp` for _BASH_ scripts. * Fixed potential buffer overflow in the _tms9128_ driver. * Fixed `-vulkan` usability in MS Windows. * Documentation cleanup. *Comments:* - "_Framework_" dependent games can now be created as Zip LUA ROMS. - `-teardown_window` reverts to the _pre-2.11.5_ startup behaviour [_legacy video drivers_]. - Added ability to filter _ABS mice_, aka _Lightguns_, in new `evdev` _ManyMouse_ detection. - Two Player Gun Games are now playable using multiple Game Controller Guns (_GamePads_). * This is no substitute, in _accuracy_, for devices that behave with _"real mouse"_ precision. * **Supported configurations**: 2 x Mouse devices || 2 x Analog Gun devices. _(In current games)_ * _Lichtknarre_ `vjoy2` and `ViGEm` plugins are confirmed working.             Lichtknarre demo:             [](https://youtu.be/uoO3I0af-rg&list=PLRLuhkf2c3OeRoXydn0upKyIBUXNMK13x)

[](https://github.com/DirtBagXon/hypseus-singe) This release changelog: **Note for Distributions:** The compile time default for LUA game path rewrites has changed from `.daphne` to `.hypseus`. If you use `-retropath` or `-singedir` this change will affect you. The change can be managed/reverted, in the `src/CMakeLists.txt` file at compile time. Distributions should address this change on update. **Note:** This release contains new files required within the `pics` folder. If upgrading, ensure the new files are copied to your existing folder setup. **Note:** The default config file for `-gamepad` has changed to `hypinput_gamepad.ini` Ensure you copy any existing config for Gamepads to the new file location. If the config file does not exist, a new default keymap file will be generated. This location can be overridden, as previously, with the `-keymapfile` argument. * Added `-ramdir` argument. * Improved `-romdir` checks. * Add transparency keying API calls. * Add LUA API VDLP audio switching. * Removed startup window teardown. * Portrait game display improvements. * Fix several required argument checks. * Add LUA API VLDP scale & rotate calls. * Removed all the old _nes_6502_ typedefs. * Fixed old video resolution switching issues. * Fixed Windows 11 launching issues [_opengl_] * Remove legacy _(char)cast_ assignments [_arm_]. * Removed _SDL_Renderer_ based overlay from `lair2` * `-zlua` now _'requires'_ a ZIP LUA file as an argument. * Added `TIME` graphic to `tq` scoreboard [_NeoKarnage_]. * Missing keymap files will auto generate default configs. * Scanlines now have correct orientation on portrait games. * ES path rewrite for `"singe/Framework"` is now checked at _index[0]_ * _VLDP_ and _LUA_ overlays support monochrome, via API and `-monochrome` *Comments:* - `-DABSTRACT_SINGE` _LUA ES_ rewrites to `.hypseus` (_not_ `.daphne`) are now **default**. - Removed obsolete `-bootsilent` from Singe argument list. (_Use_ `-startsilent`) - Alternate VLDP audio file switching now possible via LUA API calls. - You can now relocate the `ram` folder to a writable location, for Zip ROM LUA use. - `3:4` portrait games should auto fit vertical displays better when using `-vertical_screen` - The `-zlua` change allows file extensions to deviate from _.zip_ for frontend `ROM` detection. - It is now possible to use a "_Framework_" sub-folder in standalone games. * This release removes the _"reserved word_" status from `Framework`.

[](https://github.com/DirtBagXon/hypseus-singe) This release changelog: **Note:** This release contains a new folder required for MIDI operation. If upgrading, ensure the new `midi` sub-folder is copied to your existing folder setup. **Note:** The `SDL2_Mixer` libraries are now required for compilation. The libraries should contain support for MP3 and MIDI at run-time. **Note:** Linux based distributions may require native, _TiMidity++_ or _FluidSynth_ support for MIDI. * New `SDL2` library requirement: `SDL2_Mixer` libraries * New `midi` subfolder added with GPL SR2 soundfont: `TimGM6mb` * Clear Game Controller queue of `DEVICEADDED` on load. * `-romdir` arg for alternate path definition of `roms` folder. * `-nomanymouse` arg for disabling ManyMouse loading. * Fix _'relative'_ co-ordinates reported by ManyMouse subsystem. * Lower video width loading restriction for better portrait game support. * Isolate Sinden border drawing Rect from the YUV window - video scaling is now isolated. * Alter Sinden border drawing priority, now layers 'over' a main bezel. * Added `MP3` and `MIDI` music support to Singe API calls. * Fixed a heap overflow in GPWorld sprite drawing. * Added `JSON` support for LUA (_CJSON_) * Custom MIDI soundfont support available via sub-folder. * Remove '_register_' keyword deprecation warnings. * Address certain _libmpeg2_ build warnings on Mac. * Remove outstanding _sprintf_'s. * Update and tidy documentation. *Comments:* This release adds support for `MIDI` and `MP3` music in LUA games. It also addresses several edgecase fixes and enhancements suggested by Discord users. * `-romdir` specify an alternate location for the `roms` subfolder. * `-nomanymouse` provides a method to negate a previously defined ManyMouse requirement. * `-sinden` now allows `-scalefactor` resizing of the enclosed video window. The border is now fixed in _center_ position.

[](https://github.com/DirtBagXon/hypseus-singe) This release changelog: * Implement multiple Game controller support [See gamepad [_hypinput.ini_](https://github.com/DirtBagXon/hypseus-singe/blob/master/doc/hypinput_gamepad.ini) example] * Joystick API HAT is now attributed to a single Joystick [See also `-openhat`] * Compile time method to separate Daphne and Singe game types in _ES_. * Increased Scoreboard bezel positioning to cater for DQHD+ * Replaced some legacy Daphne overlay `video::` appendages. * _zlua_ enhancements. Support for alternate/multi game zip ROM [See `-usealt`] * Finally addressed the early SDL2 getPixel workaround/kludge. _[Widge]_ * `-screen` argument now allows placement in a multi screen setup. * `-bezeldir` specify an absolute path to the _'bezels'_ folder. * Peripheral overlay improvements in `gpworld` and `badlands` * Thayer's _"timer"_ scoreboard alpha level simplified. * Added a Window icon for taskbar enhancement. * YUV palette transparency functions improved. * Fix `-vertical_stretch` YUV stretching. [See `cliff`] * Added `-horizontal_stretch` YUV stretching. * Reduce VLDP flicker in `aceeuro` transition screens. * Fix obscure Thayer's positional toolbox bug. * Fix `-haptic 0` argument placement/behaviour. * Fix `rewriteStatus()` API call in zipped ROM's. * Added Singe API calls for volume, scale, focus/zoom and multiple Game Controllers. * Example _bash_ loader scripts for `actionmax` and `captainpower` running `-usealt`. * Update [_hypjsch_](https://github.com/DirtBagXon/hypjsch) to v1.21 * New logo *Comments:* * Users with _multiple_ Joysticks attached using HAT controls, may need to make config adjustments. * Game Controller configurations should be backwards compatible, use new [template](https://github.com/DirtBagXon/hypseus-singe/blob/master/doc/hypinput_gamepad.ini) for updates. * The _zlua_ `-usealt` argument removes the need for ES symlinking, in games such as _ActionMax_. * Added `-singedir` to force _absolute_ `singe/` folder path location in ES installations.

[](https://github.com/DirtBagXon/hypseus-singe) This release changelog: * [_Issues_] Random bezel loading (_MSWindows_) issue resolved. * Activating `-bezel` now enables `-fullscreen` automatically. * _Thayer's Quest_ keyboard bezel is now mouse interactive: `-tqkeys` * Added an authentic 'backlit' _Thayer's Quest_ keyboard bezel scan. * Atari/Sidam European ROMS are now supported. **Requires** EU PAL laserdisc content. * _GPWorld_ offers authentic steering strengths and includes autocenter via `-preset` * MacOS CMake linking issues have been resolved. In both _master_ and _libmpeg2_ branches. * Added SDL WINDOW_ALWAYS_ON_TOP argument: `-alwaysontop`. (_Addresses legacy issue in BigBox_) * Added Game Controller **Rumble** haptics and additional Singe API call: _controllerDoRumble()_ * LUA `os.clock()` calls have been aligned for Linux/Mac - corrects game timings in these OS with full overlays. * Singe "_zlua_" roms - Zipped LUA ROM files are now supported. * Singe games installations can now align with Daphne, using the "_rom_", "_ram_" and "_vldp_" folders. - The `singe` sub-folder is no longer required _"on-disk"_ with zipped LUA games. - The loading system will render the `-retropath` argument ineffectual on zipped ROM. * Added Singe 2 _Unload()_ API calls. These will help address a memory leak in many existing game LUA. * Aligned some Singe 2.10 API calls for sprite resizing, rotating and smoothing. Using `SDL2_gfx` * Animated gif support for Singe sprites is enabled if compiled against `SDL2_image` _v2.6.0+_ `(IMG_Animation)` * Additional `hypseus` API calls for animated PNG sprite sheets. Bypasses `IMG_Animation` requirement. * Fixes for forced aspect ratio arguments within new viewport: _ForceAspectRatio, IgnoreAspectRatio_ * A legacy Joystick/Game Controller Singe _PAUSE_ alignment issue is fixed. * _MSWindows_ should now correctly predict parsing percentage/time on large 4Gb+ files. * Added `esp32` support on USB scoreboard - flip serial RTS to default `off`. _(Prohibits forcing a programming mode.)_ * Scanlines on scaled, positioned and rotated video display fixed. * Backslash `\` allowed, in _MSWindows_, for `-bezel` path definitions * Sub-folders now allowed in `-keymapfile` path definitions * Splashscreen implemented reporting the running version. * _luars232_ serial support added (_Align with Singe 2_) Use on Arduino scoreboards? * AC_PROG_GCC_TRADITIONAL - obsolete MACRO removed from _libmpeg2_ * GitHub workflow will produce a _SteamDeck "AppImage"_. * Digital Leisure games _overlay_ scoreboard updates. * Rotation refactoring. _Comments:_ * `libzip` from `v1.3` is now required for compilation. * Added `Alt` positioning Toolkit using Keypad. * The Windows parsing % fix may cause a regeneration of `.dat` files. * Trialing NSIS installer, these can trigger false positive AV warnings.. (_Alt: zip_) * _"Double intro"_ shuck on `sae` and `dle21` with `-fastboot` * `-alwaysontop` enable WINDOW_ALWAYS_ON_TOP for main game window. * GPWorld `-preset 1` for spring-loaded style steering wheel: (_Gamepads_) * _[Daphne]_ Roadblaster has "random" start scenes disabled in default `-bank` settings. * Thayers has `-preset 1` argument for _timer/scoreboard_ switch. * `-zlua` for zipped LUA Singe files. `-script` will also work for backwards compatibility. - When `-zlua` files are loaded, the `-retropath` argument will be ignored. - LUA `lfs` calls will not work within zipped LUA ROMS. - https://github.com/DirtBagXon/hypseus_singe_data/tree/master/00-zip-roms * Singe`-enable_trace` attempts to print _lua_Debug_ on errors. _Argument change overview:_ * **Obsolete:** Arguments `-set_overlay` and `-oversize_overlay` are no longer valid in Singe. * **Replaced:** `-auxbezel_scale` and `-auxbezel_position` replace _annun_ variants. ``` -annunbezel_position => -auxbezel_position -annunbezel_alpha => -auxbezel_alpha -annunbezel_scale => -auxbezel_scale ``` Check the log for argument errors.

[](https://github.com/DirtBagXon/hypseus-singe) This release changelog: **Note:** The release contains new files **required** within the `pics` and `sound` folders. If upgrading, ensure the new files are copied to your existing folder setup. **Note (default setting change):** SDL linear scaling filter is now **off** by default with the new overlay system. This was commonly disabled by many users, the setting can give better results on certain overlays than others. User discretion advised. The previous display behaviour can be restored with `-linear_scale` **Note:** The release rewrites the logical viewport display functionality, allowing game window and bezel placement anywhere on the visable area. This gives better support for vertically orientated displays with full cabinet layout. It also provides several other benefits. **Note:** This release removes the legacy Singe overlay functions which will mean some early ported Singe games will require updated LUA and sprites from the partner [_data repo_](https://github.com/DirtBagXon/hypseus_singe_data). You can download the full _data repo_ via the [releases](https://github.com/DirtBagXon/hypseus_singe_data/releases) page. **If you experience Singe overlay alignment issues with this release, download the latest data from the above repo.** * Full logical viewport placement of the game window is now implemeted. * **Stern: Goal to Go (1983)** emulation is now supported via ROM `gtg`. * **GPWorld** has playability improvements including _[non authentic]_ samples. * Bilinear scaling is now **off by default**. Re-enable with `-linear_scale` * Singe legacy overlay functions have been removed from codebase: _(See notes)_. * `-shiftx` and `-shifty` can now use the whole logical viewport. * Badlands '_Shoot Lamp_' notification has changed from txt to sprite. * Daphne overlay _vertical_shift_ values are now observed. * Singe 2 `Framework` folder no longer needs `.daphne` extention when used with `-retropath`. * Scanlines with incremental shunt + value displayed, when using `Alt-Backspace`. * _screen_ number is displayed when using `-scorepanel` and `KEY_TILT` * `-fvalue` Singe argument added for game dev tools: [Frameviewer](https://github.com/DirtBagXon/hypseus_singe_data/blob/master/00-tools/FrameViewer.singe) * Usage information will be displayed if `hypseus` is run without arguments. * F4 is set, by default, for Singe 2 '_Save/Load_' config alignment. * 8bit overlay switching should be fixed... * '_Us vs Them_' attract mode fixed. * Various other overlay improvements. *Arguments change overview:* * `-linear_scale` - restore the linear filter on scaling _(previous default)_. * `-scale_shift[x|y]` renamed to `-shift[x|y]` and now have extended value outside `-scalefactor` * `-vertical_screen` flips calculations for usage on portrait orientated logical viewports. * `-set_overlay` has now been **removed** from Singe arguments. * `gtg` game specific `-compact` argument removes _TMS_ 256 to 320 pixel stretching. See also `-linear_scale` * `-annunlamps` alternate staggered conversion style lamp layout - `ace` annunciator bezel. * `-fvalue ` can be used to pass float values to LUA for game debug. _Video resolutions:_ In the new viewport, MPEG resolutions are _absolute_. SDL will no longer use `RenderSetLogicalSize()` to '_fit_' to screen. Video resolutions larger than those capable by the screen may have areas positioned outside the viewable area. To combat this issue, large video resolutions can be resized via `-x` and `-y` on displays with resolution issues. The Singe reworking should not require any re-encoding, or re-aquirement, of video/audio content. Only the `.singe` _( LUA)_ and other periphral game data requires updating. This is analagous to _ROM_ data upgrades. If you have updated game data from the repo recently, no further changes should be required. If you have deployed Singe games that use the `Framework` folder and are using the `-retropath` argument: You will need to remove the `.daphne` extension from the `Framework.daphne` folder. Simply calling it `Framework`, no other changes should be required.    Vertical Bezels demonstrating placement in the new viewport: [](https://youtu.be/4JZPyoFf_JE)

[](https://github.com/DirtBagXon/hypseus-singe) This release changelog: **Note:** This release contains changes that may alter existing _gamepad_ configurations. **Note:** MPEG `.dat` files will be updated, **on all games**, with this update. **Note:** The release contains new files **required** within the `pics` folder. If upgrading, ensure the new files are copied to your existing folder setup. * DAT_VERSION 3 `.dat` files. 4Gb+ UHD M2V files are now supported * Singe 2 dynamic 'overlay resolution switching' is now supported. * Singe API driven Active Scoreboards - Game LUA requires simple changes. * Singe Scoreboard API can use the hardware Arduino USB Scoreboard. * `.dat` file _(re)parsing_ video blanking bug, is now fixed. * Scaled video window is now positionable: `-scale_shiftx` and `-scale_shifty` * More accurate _(default)_ annunciator _'rank'_ graphics _(Updates in_ `pics` _folder)_. * Added _'dedicated cabinet'_ style annunciator bezel: `-dedannunbezel` _[NeoKarnage]_ * Score and annunciator bezels now have transparency level adjustments. * The independent Scorepanel can be initialized on a selectable secondary screen. * Game Controller trigger bug is fixed and HAT behaviour has changed _[walknight]_ * Overlay scoreboard can be disabled using _null_ scoreboard in `lair` and `ace`: `-noscoreboard` *Argument change overview:* * `-scorescreen` - Choose secondary screen for independent Score Panel display. * `-set_overlay` is no longer supported on updated games. * New bezel features are documented in: [bezels.txt](doc/bezels.txt) Gamepad `HAT(D-PAD)` _U-D-L-R_ behaviour has changed - Now provides 4 extra buttons for `hypinput.ini` ``` KEY_UP = SDLK_UP 0 BUTTON_DPAD_UP AXIS_LEFT_UP KEY_DOWN = SDLK_DOWN 0 BUTTON_DPAD_DOWN AXIS_LEFT_DOWN KEY_LEFT = SDLK_LEFT 0 BUTTON_DPAD_LEFT AXIS_LEFT_LEFT KEY_RIGHT = SDLK_RIGHT 0 BUTTON_DPAD_RIGHT AXIS_LEFT_RIGHT ```

[](https://github.com/DirtBagXon/hypseus-singe) This release changelog: **Note:** This release contains new files **required** within the `pics` folder. If upgrading, ensure the new files are copied to your existing folder setup. * `-scalefactor` now enables fullscreen resize of video window. * `-rotate` reworking, now all video sizes and overlays are enabled. * Faster booting for enhanced ROMS: `dle21` and `sae`, via `-fastboot` * A number of memory leaks have been addressed _[walknight]_ * *draw_LDP1450_overlay()* for `lair2` reworked for SBC efficiency. * Implement a scaleable active bezel `scoreboard` for _lair/ace/tq_: `-scorebezel` * Implement a scaleable active bezel `annunciator` for _ace_: `-annunbezel` ** * Implement a keyboard bezel for Thayer's Quest: `-tq_keyboard` * `-scorepanel` window can now use multiple displays. Switch with `KEY_TILT` * * Window Manager check to avoid segfault with `-scorepanel` on SBC platforms. *New bezel related arguments:* - `-annunbezel` - `-annunbezel_scale 1-25` - `-annunbezel_position ` - `-scorebezel` - `-scorebezel_alpha` _for background transparency_ - `-scorebezel_scale 1-25` - `-scorebezel_position ` alias for `-scorepanel_position` - `-tq_keyboard` - `-scalefactor 50-100` _%_ *Evolved arguments:* - `-rotate 1-359` - aspect ratios may be ignored   _*  `-scorepanel` should now be used in multiple screen, or windowed display, scenarios._ _** `-annunbezel` enabled:_ [](https://youtu.be/kZakwQsf-SM?t=677)

[](https://github.com/DirtBagXon/hypseus-singe) This release changelog: * Arduino based USB hardware LED *scoreboard/annunciator* for `lair`, `ace` and `tq` * See dedicated [repo](https://github.com/DirtBagXon/hypseus_scoreboard) - Uses common *(modern)* 7-segment [LED modules](https://www.youtube.com/playlist?list=PLRLuhkf2c3OfWXBjaeWMZKH3ejyk8eOgZ). * Aspect ratio header is now observed from MPEG M2V files* * Integrated *Bezel* support, using png, in new `bezels` sub-folder** * ManyMouse now supports differentiated mice input. Two player Gun Games... * Software Scoreboard *(now `scorepanel`)* altered for better bezel integration * Fixed the ability to take `screenshots` in fullscreen render (*with bezels*). * Added extended Singe API calls (*getRatio*). * MacOS startup error reporting improved * `-8bit_overlay` placement addressed * Allow `-` and `_` in `-keymapfile` filenames *Evolved arguments:* * `-software_scoreboard` renamed to `-scorepanel` *New arguments added:* * `-usbscoreboard ` - Enable USB serial support for Arduino scoreboard * `-bezel ` - Specify a `.png` file to use as bezel * `-ignore_aspect_ratio` - Ignore MPEG aspect ratio header *(restore previous behaviour)** * `-scorepanel_position ` - Position Software Scoreboard _** See `#bezels` channel in [Discord](https://discord.gg/dgCsCfmRfJ)_  [](https://www.youtube.com/playlist?list=PLRLuhkf2c3OfWXBjaeWMZKH3ejyk8eOgZ)

[](https://github.com/DirtBagXon/hypseus-singe) This release changelog: * SDL_GameController (*hotplug*) support * * Implements '_gamecontrollerdb.txt_' * 32bit (_True Color_) Overlays in Singe * 8bit sprite rendering fallback for schmaltz * Full resolution Overlays in Singe 2 games ** * Optimizations in sprite blitting on the new 32bit surfaces * Cleanup and tidy of main video rendering functions * Improved _Error_ reporting on startup _New arguments added_: * `-gamepad` - enable *GameController* API [config](https://github.com/DirtBagXon/hypseus-singe/blob/master/doc/hypinput_gamepad.ini) * `-overlay_set [half|full|oversize]` *(Singe)* * `-8bit_overlay` *(Singe)*   _* The Joystick API will remain default and offer more complex configurations_ _** Full resolution overlay:_

[](https://github.com/DirtBagXon/hypseus-singe) This release changelog: * `-vertical_stretch` reimplemented for `cliff` overlay. See [#78 ](https://github.com/DirtBagXon/hypseus-singe/discussions/78)* * `-blank_blue` enables `YUV#1DEB6B` (*blue*) blanking screens.** * `-manymouse` is now a global argument (*only Singe will currently utilize*). * Singe '_cursor drift_' bug fixed when using latest game LUA Misc news: * A [Discord](https://discord.gg/dgCsCfmRfJ) server has been created. * Windows binaries linked with `-subsystem,windows` are available. See [#81 ](https://github.com/DirtBagXon/hypseus-singe/discussions/81) _* `-vertical_stretch 24`_ completely removes letterbox overlay in `cliff`. \*\* YUV signal loss blanking: [demo](https://www.youtube.com/watch?v=Rho2rX8dZw8) and [here](https://www.youtube.com/watch?v=1FBYzgW7Agw)

[](https://github.com/DirtBagXon/hypseus-singe) This release changelog: - **Update:** Bugfix release. - Allow `TEXTUREACCESS` enumeration switching * - Add `-nocrosshair` argument for Gun Games ** - Improve 8bit indexed color palette. _* `-texturestream` and `-texturetarget`_ _** in-game support for `singeWantsCrosshairs()` required_

[](https://github.com/DirtBagXon/hypseus-singe) This release changelog: - Align integer type for video frames in 64bit - Expand Singe LUA sound controls * - Add `-grabmouse` to capture mouse in SDL Window _* Extend Singe 2 style sndHandle calls_ [](https://www.youtube.com/watch?v=iDAYF23JCuk)

[](https://github.com/DirtBagXon/hypseus-singe) This release changelog: - Daphne 16bit VLDP (_frame limit_) constraint has been removed * - Singe games exceeding 65535 frames are now supported ** - Enable 32bit RPi support for m2v _fseek()ing_ on files over _2Gb_ in size - Prevent potential Buffer Overflow in `RETROPATH` LUA resource definitions - Singe `-bootsilent` argument attempts to mute sound on _initVLDP()_ *** - LUA _lfs_ module now works correctly with `-retropath` _* Daphne VLDP 16 to 32bit upgrade_ _** Full Singe 2 game range is now portable_ _*** Game code dependant_ : [less prolonged than `-startsilent`]

[](https://github.com/DirtBagXon/hypseus-singe) This release enables: - `-novsync` argument, to disable _SDL_RENDERER_PRESENTVSYNC_ * - Implement LuaFileSystem '_lfs_' static module for latest Singe 2 game support ** - Update _libmpeg2-master.tgz_ to clear _-Wstringop-overflow_ warning in _-std=c++11_ - Bump Singe to _v1.50_ to cover all recent changes _* CRT support_ _** v3.31c game code_

[](https://github.com/DirtBagXon/hypseus-singe) This release enables: - Enforcement of SDL Window context (_aids Renderer index autodetection_) - Singe _cmdline_ arguments buffer extended - Update `plog` to _1.1.5_ - avoid MacOSX deprecated _syscall()_ - Revert recent [scanline](https://github.com/DirtBagXon/hypseus-singe/blob/master/screenshots/scanlines.png?raw=true) changes (_Fixed Windows build_) - Prevent _segfault_ on Singe font loading error

[](https://github.com/DirtBagXon/hypseus-singe) This release enables: - *ActionMax* game hardware acceleration in Windows with **SDL 2.0.16** library: `-nohwaccel` _is no longer required_. - `-blank_searches` and `-blank_skips` enforced laserdisc _search/skip_ delay simulation in Singe: Triggered against LUA events: ``` discSearch() discSkipBackward() discSkipForward() discSkipToFrame() ``` _Demonstration:_ [](https://www.youtube.com/watch?v=1FBYzgW7Agw&list=PLRLuhkf2c3OeRoXydn0upKyIBUXNMK13x&index=1)

[](https://github.com/DirtBagXon/hypseus-singe) This release adds support for Singe Gun Games with video resolution above _720x480_ + Use the `-oversize_overlay` argument with Singe on HD games. See: https://github.com/DirtBagXon/hypseus-singe/discussions/45    + Allows stretching of _4:3_ to _16:9_ while maintaining _hitbox_ locations. + _64bit_  [Windows Release](https://zigflag.net/images/hypseuswin.png) ``` [version] Hypseus Singe: v2.6.17_x64 [console] Windows 10 [console] SDL(CC): 2.0.14 [console] SDL(LD): 2.0.16 [console] 64bit Build: Nov 01 2021 20:00:00 ```