Skip to content

Reasonable emulator for a steadily less shitty fantasy computer. ROM sources are in https://github.com/Kawa-oneechan/Asspull3X-roms

Notifications You must be signed in to change notification settings

Kawa-oneechan/Asspull3X

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Asspull IIIx

This is a fantasy computer that Kawa pulled out of his ass, inspired by an utter shitpost. That's really all there is to it; it's a joke gone way out of hand.

To actually use this, ROM files are included and more up-to-date copies can be gotten from the other repo.

First run

On first run, you must provide an A3X BIOS ROM (apb). One should be provided in the roms folder. Then you may load up any of the provided ap3 ROM files.

Controls

The emulator passes all presses of the left Control key to the A3X, while the right Control key controls the emulator itself.

Key Effect
Ctrl Q Turn the emulated machine on or off
Ctrl L Load ROM
Ctrl Shift L Load disk image
Ctrl U Unload ROM
Ctrl Shift U Unload disk image
Ctrl R Reset the emulation
Ctrl Alt R Reload last ROM, then reset emulation
Ctrl D Dump memory to wram.bin and vram.bin
Ctrl S Take a screenshot
Ctrl A Toggle aspect correction
Ctrk K Toggle keyboard gamepad control
Ctrl P Pause
Ctrl F10 Toggle fullscreen mode

Disk image hotkeys refer to the first attached disk drive (A:). You'll need the Devices window to change images for any other drives.

Clicking the middle mouse button toggles mouse controls, for those applications or games that can use one.

The keyboard gamepad control feature reassigns the arrow keys and certain letters to the first gamepad, in case you don't have one.

Key Button
Arrows Directional pad
Z A
X B
A X
S Y
C Start
V Select
D/F Shoulder buttons

The canonical (if nonexistant) A3X controller has the same ABXY layout as the Xbox, and any XInput gamepad should work (though the main author only has an old Logitech F310 to test with). Just in case, there's some ability to remap the buttons.

Command line

The following command line arguments can be passed, besides the path to an .ap3 ROM file:

Argument Effect
--fpscap Disables the FPS cap
--noreload Disables automatic reload of the last used .ap3 file
--noremount Disables automatic reload of the last used disk images
--nodiscord Disables Discord rich presence features
--fullscreen Start in full screen
--poweron Start powered on (implied if a starting .ap3 is given
--associate For internal use, associates .ap3 and .a3z files

Settings

By default, settings are stored in %LocalAppData%\Clunibus.ini. If such a file is present in the same folder as Clunibus.exe, that will be used instead.

As an .ini file, the settings stored are as follows:

Group Key Meaning
[misc] discord If true, enables Discord rich presence features
lang Specifies the UI language
reloadImg If true, remount disk images
reloadRom If true, reload the last .ap3 file on startup
rtcOffset How many seconds to add to the system time
theme 0 for light, 1 for dark, 2 to match Windows
[media] bios The path to the A3X BIOS ROM
rom The path to the last ROM file
[devices] 1-15 The type of device for a given slot
[audio] midiDevice Which device to use for MIDI output, by number
music If true, MIDI sound is enabled
sound If true, OPL3 and PCM sound is enabled
[video] fpsCap If true, goes no higher than 60 FPS
shader-num The name of the shader file in the chain
shaders The amount of shaders in the chain
showFps If true, shows the current FPS in the status bar
stretch200 If true, aspect-corrects 200 and 400 line modes
[input] key2joy If true, allows using the keyboard as a gamepad
button name Maps a given real gamepad button to an A3X one

For devices like disk drives, extra groups track which disk image is mounted for each.

Acknowledgments

  • French localization help by Thomas_⑨.
  • Hungarian localization help by Letrune.
  • Massive interrupt help by Invertego.
  • OpenGL shader thing based on an example by Augusto Ruiz.
  • PAL Composite shader by Viacheslav Slavinsky.
  • CRT shader by Timothy Lottes.
  • CRTView shaders by Mattias Gustavsson.
  • miniz library by Rich Geldreich.
  • SimpleIni library by Brodie Thiesfield.