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