Toggle menu
Toggle personal menu
Not logged in
Your IP address will be publicly visible if you make any edits.

KEGS-X Xbox: Difference between revisions

From GameBrew
m (Text replacement - "| licence" to "| license")
No edit summary
Line 1: Line 1:
{{Infobox XBOX Homebrews
{{Infobox XBOX Homebrews
| title      = KEGS-X
| title      = KEGS-X
| image      = [[image:kegsx.png|250px]]
| image      = kegsx2.png/kegsx3.png
| type        = Computer
| type        = Computer
| version    = v5b5
| version    = 5b5
| license    = Mixed
| license    = Mixed
| author      = xport/Madmab
| description = Apple IIgs/e/c/+ emulator port. Original by XPort.
| website    = http://www.emuxtras.net/forum/viewtopic.php?f=76&t=2382
| lastupdated = 2017/07/27
| download    = media:KegsX_v5b5.zip
| format      = XBE
| author      = XPort, Madmab
| website    = https://www.emuxtras.net/forum/viewtopic.php?f=76&t=2382
| download    = https://www.emuxtras.net/forum/viewtopic.php?f=76&t=2382
| source      =  
| source      =  
}}
}}
<youtube>1_mMc3ZZQkM</youtube>
KEGS-X is an Apple IIgs/e/c/+ emulator port for the Xbox. Original by XPort.


==Features==
==Features==
*Emulates Apple IIgs/e/c/+.
*Excellent compatibility - ported from KEGS.
*USB Keyboard support.
*ZIP support.
*Cheat system - Search/Create your own cheat codes (see notes).
*Favorites list.
*Netplay.
*Resizable game screen.
*480p, 720p, 1080i support.
*Virtual Keyboard.
*Skin-able.
*Music Control Menu.
*Save Game management - Delete save game files.
*Save States (see notes).
*Samba/NetBIOS sharing support (read roms from your PC).
*Relax Network Sharing (read roms from your PC).
*Play MP3 or M3U playlists in the background (can also read MP3/M3U from across Samba/Relax shares).
*User definable save directory.
*Take in-game screenshots and display them on the game selection list.
*Auto-screenshot capture mode.
*Hardware filtering options.
*Graphics filters.
*Record/Playback feature. Record up to 10 minutes of gameplay.
*Every single in-game command is fully customizable on any of the four joypad controllers.
*Map any emulator or UI command to a single button or a combination of two buttons.
*Autofire capabilities for any emulator button on any controller.
*One-button combos.
*Traverse any directory on any drive.
*All UI commands (save state, load state, screenshot, etc) can be invoked from the Options/Pause menu as well as in-game via your customized joypad mappings.
*Can be invoked from a command-line to directly run a game from a front-end or dashboard and bypass the user-selection screens. (Only if the frontend or dashboard supports this feature).
*Can return to the launching program *if* the launching program supports this feature.


- Emulates Apple IIgs/e/c/+
==Media==
'''KEGSOSX''' ([https://www.youtube.com/watch?v=QH7Jlu0hB0c KEGSOSX]) <br>
<youtube>QH7Jlu0hB0c</youtube>


- Excellent compatibility - ported from KEGS
==Changelog==
'''v5b5'''
* Updated to madmab edition interface CFv1b29. See "Interface Changelog.txt".
* Starting speed of "8.0 mhz" was not displaying when selected in the game configuration screen.
* Fixed an issue where moving the mouse up (prodos) was causing the mouse to disappear if the mouse acceleration was higher than 1.


- USB Keyboard support
'''v5b4'''
* Updated to madmab edition interface CFv1b20. See "Interface Changelog.txt".
* Disabled the internal configuration menu. Pressing F4 to bring up the emulators configuration options was causing the emulation (not the emulator) to get caught in a loop. You can set a games configuration by pressing "x" when selecting the game and you can change/rotate disks in the "in game" menu".


- ZIP support
'''v5b3'''
* Updated to madmab edition interface CFv1b17. See "Interface Changelog.txt".


- Cheat system - Search/Create your own cheat codes (see notes)
'''v5b2'''
* Updated to madmab edition interface CFv1b14. See "Interface Changelog.txt".
- Favorites list


- Netplay
'''v5b1'''
* Updated to madmab edition interface CFv1b08. See "Interface Changelog.txt".


- Resizable game screen
'''v5'''
 
- 480p, 720p, 1080i support
 
- Virtual Keyboard - go to Controller Configuration / UI Mappings to select
  the button combo that will bring up the Virtual Keyboard while in-game.
 
 
- Skin-able :
    - Backgrounds
    - Sounds
    - Background Music
    - Sprites
    - Text position (right/left/center, top/bottom/center)
    - Text color, select bar color
    - Font
    - Fading speed
    - Screenshot position
    - Can specify 2 sprites to surround the selected menu option
    - Option to have a transparent select-bar color (from select-color menu)
    - Can flip sprites horizontally/vertically
    - Can set motion_x and motion_y variables for sprites
    - Sprites can loop continuously or just once
    - If you want to change the way something looks in this new UI,
      chances are that you can change it via the Configuration menu.
 
 
- Music Control Menu - press LTHUMB anywhere to bring up the music control menu.
  This is also a customizable controller action while in-game.  Configure it
  via the Controller Configuration -> UI Mappings menu.
 
- Save Game management - delete save game files
 
- Save States (see notes)
 
- Samba/NetBIOS sharing support (read roms from your PC)
 
- Relax Network Sharing (read roms from your PC)
 
- Play MP3 or M3U playlists in the background
  (Can also read MP3/M3U from across Samba/Relax shares.)
 
- User definable save directory.  If you don't like the default of
  E:\SAVES\KEGSX you can change it via the KEGSX.INI file
 
- Take in-game screenshots and display them on the game selection list
 
- New UI feature - auto-screenshot capture mode.  When enabled, the emu
  will start taking screenshots at a user-defined interval.  Useful for
  ripping sprites/animation.
 
- Hardware filtering options : Point, Bilinear, Trilinear, Anisotropic
 
- Graphics filters :
    + 2xSai
    + Super 2xSai
    + Eagle
    + Super Eagle
    + SuperScale
    + AdvanceMame 2x
    + Simple 2x
    + 2xSai Scanline
    + Super 2xSai Scanline
    + Eagle Scanline
    + Super Eagle Scanline
    + SuperScale Scanline
 
 
- Record/Playback feature - record your gameplay in the emu and then
  play it back again.  Record up to 10 minutes of gameplay.
 
- Every single in-game command is fully customizable on any of the
  four joypad controllers.
 
- Map any emulator or UI command to a single button or a combination of
  two buttons.  (e.g. RTrigger+LTrigger = Save State)
 
- Autofire capabilities for any emulator button on any controller
 
- One-button combos (define a series of emulator commands to be played
  back when you press a user-definable XBox controller combination.)
  (E.g. Press RTrigger+LTrigger to execute the command string
  A,B,A,B,Up,Down,Left,Right)
 
- Traverse any directory on any drive ( Continue selecting the parent
  directory entry on the file selection list to get the drive selection
  list.  Selectable drives are C, D, E, F, R, X, Y, Z, and SMB.
  R is the CDROM drive.  SMB is the samba share you have defined in your
  KEGSX.ini file.)  Press Y from any file-listing screen to go up one
  directory level.
 
- All UI commands (save state, load state, screenshot, etc) can be
  invoked from the Options/Pause menu as well as in-game via your
  customized joypad mappings.
 
- Can be invoked from a command-line to directly run a game from a front-end
  or dashboard and bypass the user-selection screens. (Only if the frontend
  or dashboard supports this feature.)
 
- Can return to the launching program *if* the launching program supports this
  feature.  For example, if the custom-launch routines are incorporated into
  a new frontend, that frontend could launch KEGSX and when you exit
  KEGSX, that frontend can be automatically reloaded. 
 
 
==What's News==
 
* Core updated to v0.90
 
* Savestates are kinda wonky (and questionable at best).  The original x-port version has some (v0.71) but I have no idea where it came from because it is not part of the original source.  A cursory glance at it reveals many potential "issues" that could crop up from using them.  Here is a quote from the readme for the v1 release of this emu.  "Save states only work reliably while you are playing the same game without restarting it.  This means that while you are playing a game, you can save/load states all you want, but as soon as you reset the emulator or exit the game, those save states will probably not work anymore".  My two cents on savestates.  As long as you are playing a game that does NOT write to the disk and you have the right disks inserted in the right drives then odds are you will be safe.


Changes To KegsX Core:
* Core updated to v0.90.
* Savestates are kinda wonky (and questionable at best). The original x-port version has some (v0.71) but I have no idea where it came from because it is not part of the original source. A cursory glance at it reveals many potential "issues" that could crop up from using them. Here is a quote from the readme for the v1 release of this emu. "Save states only work reliably while you are playing the same game without restarting it. This means that while you are playing a game, you can save/load states all you want, but as soon as you reset the emulator or exit the game, those save states will probably not work anymore". My two cents on savestates. As long as you are playing a game that does NOT write to the disk and you have the right disks inserted in the right drives then odds are you will be safe.
* Given the full "Madmab Edition" treatment.
* Given the full "Madmab Edition" treatment.
 
* Sorry. No dual-preview skin to support Xtra's. Not that there are any atm.
* Sorry. No dual-preview skin to support Xtra's. Not that there are any atm.
 
* Keys "caps lock" issue should be fixed (for those with real keyboards).
* Keys "caps lock" issue should be fixed (for those with real keyboards).
 
* New option "Start With Caps Lock - On/Off". This will hopefully help resolve any issues with mapping the xbox controller to keyboard keys. See next comment. Currently defaults to "On". Let me know if it would be better as "Off".
* New option "Start With Caps Lock - On/Off". This will hopefully help resolve any issues with mapping the xbox controller to keyboard keys. See next comment. Currently defaults to "On". Let me know if it would be better as "Off".
* Xbox controller mapping to keyboard keys may need re-evaluating due to the weird nature of how the apple's "capslock" key works. If anyone with better knowledge of the Apple wants to help me on this just send me a PM.
 
* User can now mount a disk in drives 1 and 2. Game loading is alot more fluid now. Emulator remembers which disks were loaded at game boot time. Press X on game load if you want to change these. This included a new menu option to display the disks in drives 1 & 2, rotate and change disks.
* Xbox controller mapping to keyboard keys may need re-evaluating due to the weird nature of how the apple's "capslock" key works. If anyone with better knowledge of the Apple wants to help me on this just send me a PM.
* Bram now stored in seperate files whose name is based on the ROM used (1 or 3) AND the slot the disks are inserted in. This allows you to set seperate "startup slots" for 140k, 800k, and disk images without having to worry about constantly reseting the "startup" slot from within the "control panel". See below on how to setup the "startup" slot in the "control panel". The easiest thing to do is copy the include BRAM??.ram files into your saves directory (usually "e:\saves\kegs\"). Or if you are a real masochist you can manually set them all yourself.
 
* In game "configuration" computer speed is changed based on disk size. Anything less than 140k will autoset to 1mhz. The rest will be 2.5. Border clipping is auto set as well based on the recommendations in the Kegs documentation. This can be manually changed if need be.
* User can now mount a disk in drives 1 and 2. Game loading is alot more fluid now. Emulator remembers which disks were loaded at game boot time.   Press X on game load if you want to change these. This included a new menu option to display the disks in drives 1 & 2, rotate and change disks.
* New selectable speed added to game configuration menu "8.0mhz" works great for some of the slower games "Silpheed", "Out Of This World". Use at own risk.  
 
* Bram now stored in separate files whose name is based on the ROM used (1 or 3) AND the slot the disks are inserted in. This allows you to set seperate "startup slots" for 140k, 800k, and disk images without having to worry about constantly reseting the "startup" slot from within the "control panel". See below on how to setup the "startup" slot in the "control panel". The easiest thing to do is copy the include BRAM??.ram files into your saves directory (usually "e:\saves\kegs\"). Or if you are a real masochist you can manually set them all yourself!  :P
 
* In game "configuration" computer speed is changed based on disk size. Anything less than 140k will autoset to 1mhz. The rest will be 2.5. Border clipping is auto set as well based on the recommendations in the Kegs documentation. This can be manually changed if need be.
 
* New selectable speed added to game configuration menu "8.0mhz" works great for some of the slower games "Silpheed", "Out Of This World". Use at own risk. :P
 
* Controller setup stuff moved into it's own menu and also added to the "in-game" menu so that you can adjust the trim and "center" positions more easily.
* Controller setup stuff moved into it's own menu and also added to the "in-game" menu so that you can adjust the trim and "center" positions more easily.
* Added in trim adjustment for joystick X and Y axis. This is needed if you are running games at "8.0mhz" speed. For example "Silpheed" needs X and Y trim set to "-100" for the joystick to work right when running the game at "8.0mhz".
* Controller type can now be changed to "Analog Joystick". Currently mapped to the left analog stick.
* Added new config option "Joystick Center Position". Most games work with the default (127). However some prefer a different "center" position. Silpheed (139), Skate Or Die (101).
* Sound MUCH improved now. Stuttering should be gone now.


* Added in trim adjustment for joystick X and Y axis.  This is needed if you are running games at "8.0mhz" speed. For example "Silpheed" needs X and Y trim set to "-100" for the joystick to work right when running the game at "8.0mhz".
Interface Related Changes:
 
* Added a new "Dummy/Lockdown Mode Setting".. "Remove 'Shutdown Xbox' From Main Menu?" Yes/No. For those of you who are driven crazy because this option is there.  
* Controller type can now be changed to "Analog Joystick". Currently mapped to the left analog stick.


* Added new config option "Joystick Center Position". Most games work with the default (127). However some prefer a different "center" position. Silpheed (139), Skate Or Die (101).
==Credits==
Special thanks:
*X-port for porting a great collection of emu's over to the xbox, releasing the source code, and answering my questions.
*Surreal CE team - Just because they are cool.
*Atariage (Albert in particular) - For providing a place for me to ramble on. For encouragement in general.
*Wimpy and Perr - For also providing a place for me to ramble and to make my goods available.
*Shout out to Hyper_Eye, SPPV, hcf, A600, Destronger, +T+, Neobomb, incrediclint, YRUSirius, Surreal CE team and all those who are honourable and keep the xbox-scene alive.
*Comments of support from various interested parties.


* Sound MUCH improved now!  Stuttering should be gone now.
==External links==
*EmuXtras - https://www.emuxtras.net/forum/viewtopic.php?f=76&t=2382

Revision as of 01:01, 29 November 2022

KEGS-X
File:Kegsx2.png/kegsx3.png
General
AuthorXPort, Madmab
TypeComputer
Version5b5
LicenseMixed
Last Updated2017/07/27
Links
Download
Website

KEGS-X is an Apple IIgs/e/c/+ emulator port for the Xbox. Original by XPort.

Features

  • Emulates Apple IIgs/e/c/+.
  • Excellent compatibility - ported from KEGS.
  • USB Keyboard support.
  • ZIP support.
  • Cheat system - Search/Create your own cheat codes (see notes).
  • Favorites list.
  • Netplay.
  • Resizable game screen.
  • 480p, 720p, 1080i support.
  • Virtual Keyboard.
  • Skin-able.
  • Music Control Menu.
  • Save Game management - Delete save game files.
  • Save States (see notes).
  • Samba/NetBIOS sharing support (read roms from your PC).
  • Relax Network Sharing (read roms from your PC).
  • Play MP3 or M3U playlists in the background (can also read MP3/M3U from across Samba/Relax shares).
  • User definable save directory.
  • Take in-game screenshots and display them on the game selection list.
  • Auto-screenshot capture mode.
  • Hardware filtering options.
  • Graphics filters.
  • Record/Playback feature. Record up to 10 minutes of gameplay.
  • Every single in-game command is fully customizable on any of the four joypad controllers.
  • Map any emulator or UI command to a single button or a combination of two buttons.
  • Autofire capabilities for any emulator button on any controller.
  • One-button combos.
  • Traverse any directory on any drive.
  • All UI commands (save state, load state, screenshot, etc) can be invoked from the Options/Pause menu as well as in-game via your customized joypad mappings.
  • Can be invoked from a command-line to directly run a game from a front-end or dashboard and bypass the user-selection screens. (Only if the frontend or dashboard supports this feature).
  • Can return to the launching program *if* the launching program supports this feature.

Media

KEGSOSX (KEGSOSX)

Changelog

v5b5

  • Updated to madmab edition interface CFv1b29. See "Interface Changelog.txt".
  • Starting speed of "8.0 mhz" was not displaying when selected in the game configuration screen.
  • Fixed an issue where moving the mouse up (prodos) was causing the mouse to disappear if the mouse acceleration was higher than 1.

v5b4

  • Updated to madmab edition interface CFv1b20. See "Interface Changelog.txt".
  • Disabled the internal configuration menu. Pressing F4 to bring up the emulators configuration options was causing the emulation (not the emulator) to get caught in a loop. You can set a games configuration by pressing "x" when selecting the game and you can change/rotate disks in the "in game" menu".

v5b3

  • Updated to madmab edition interface CFv1b17. See "Interface Changelog.txt".

v5b2

  • Updated to madmab edition interface CFv1b14. See "Interface Changelog.txt".

v5b1

  • Updated to madmab edition interface CFv1b08. See "Interface Changelog.txt".

v5

Changes To KegsX Core:

  • Core updated to v0.90.
  • Savestates are kinda wonky (and questionable at best). The original x-port version has some (v0.71) but I have no idea where it came from because it is not part of the original source. A cursory glance at it reveals many potential "issues" that could crop up from using them. Here is a quote from the readme for the v1 release of this emu. "Save states only work reliably while you are playing the same game without restarting it. This means that while you are playing a game, you can save/load states all you want, but as soon as you reset the emulator or exit the game, those save states will probably not work anymore". My two cents on savestates. As long as you are playing a game that does NOT write to the disk and you have the right disks inserted in the right drives then odds are you will be safe.
  • Given the full "Madmab Edition" treatment.
  • Sorry. No dual-preview skin to support Xtra's. Not that there are any atm.
  • Keys "caps lock" issue should be fixed (for those with real keyboards).
  • New option "Start With Caps Lock - On/Off". This will hopefully help resolve any issues with mapping the xbox controller to keyboard keys. See next comment. Currently defaults to "On". Let me know if it would be better as "Off".
  • Xbox controller mapping to keyboard keys may need re-evaluating due to the weird nature of how the apple's "capslock" key works. If anyone with better knowledge of the Apple wants to help me on this just send me a PM.
  • User can now mount a disk in drives 1 and 2. Game loading is alot more fluid now. Emulator remembers which disks were loaded at game boot time. Press X on game load if you want to change these. This included a new menu option to display the disks in drives 1 & 2, rotate and change disks.
  • Bram now stored in seperate files whose name is based on the ROM used (1 or 3) AND the slot the disks are inserted in. This allows you to set seperate "startup slots" for 140k, 800k, and disk images without having to worry about constantly reseting the "startup" slot from within the "control panel". See below on how to setup the "startup" slot in the "control panel". The easiest thing to do is copy the include BRAM??.ram files into your saves directory (usually "e:\saves\kegs\"). Or if you are a real masochist you can manually set them all yourself.
  • In game "configuration" computer speed is changed based on disk size. Anything less than 140k will autoset to 1mhz. The rest will be 2.5. Border clipping is auto set as well based on the recommendations in the Kegs documentation. This can be manually changed if need be.
  • New selectable speed added to game configuration menu "8.0mhz" works great for some of the slower games "Silpheed", "Out Of This World". Use at own risk.
  • Controller setup stuff moved into it's own menu and also added to the "in-game" menu so that you can adjust the trim and "center" positions more easily.
  • Added in trim adjustment for joystick X and Y axis. This is needed if you are running games at "8.0mhz" speed. For example "Silpheed" needs X and Y trim set to "-100" for the joystick to work right when running the game at "8.0mhz".
  • Controller type can now be changed to "Analog Joystick". Currently mapped to the left analog stick.
  • Added new config option "Joystick Center Position". Most games work with the default (127). However some prefer a different "center" position. Silpheed (139), Skate Or Die (101).
  • Sound MUCH improved now. Stuttering should be gone now.

Interface Related Changes:

  • Added a new "Dummy/Lockdown Mode Setting".. "Remove 'Shutdown Xbox' From Main Menu?" Yes/No. For those of you who are driven crazy because this option is there.

Credits

Special thanks:

  • X-port for porting a great collection of emu's over to the xbox, releasing the source code, and answering my questions.
  • Surreal CE team - Just because they are cool.
  • Atariage (Albert in particular) - For providing a place for me to ramble on. For encouragement in general.
  • Wimpy and Perr - For also providing a place for me to ramble and to make my goods available.
  • Shout out to Hyper_Eye, SPPV, hcf, A600, Destronger, +T+, Neobomb, incrediclint, YRUSirius, Surreal CE team and all those who are honourable and keep the xbox-scene alive.
  • Comments of support from various interested parties.

External links

Advertising: