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.