Hoxs64 v1.1.2.3 (c) 2023 David Horrocks ======================================== Hoxs64 is an attempt to accurately emulate the Commodore 64 computer. Features ======== A cycle exact emulation. Pixel exact VIC emulation of a C64C (the grey dot bug is not emulated). 1541 floppy disk drive (read and write). Tape player (read only). State save. Debugger. Full screen display. Cartridge support is as follows: Commodore REU 1750 (512K) Action Reply Retro Reply Easy Flash (1MB) Ocean System 3 Dinamic Magic Desk Super Games Zaxxon Fun Play Simons Basic Host PC Requirements ==================== Windows 10 or Windows 7 DirectX 11.1 Microsoft Visual C++ 2022 runtime installation. Intel or AMD 3 GHz (4.0 to 5.0 GHz recommended for some features.) 4 GB RAM. DirectX 11 graphics card with pixel shader 4.0. [For 64 bit Hoxs64] Microsoft Visual C++ 2015-2022 Redistributable (x64) - 14.34.31938 Name: VC_redist.x64.exe Size: (25,490,328 bytes) MD5: 119dde89a20674349a51893114eae5ed SHA1: 4de9f6681f0f213b132def3af88a3c68483f5f32 SHA256: 26c2c72fba6438f5e29af8ebc4826a1e424581b3c446f8c735361f1db7beff72 CRC32: 6c5a78c2 [For 32 bit Hoxs64] Microsoft Visual C++ 2015-2022 Redistributable (x86) - 14.34.31938 Name: VC_redist.x86.exe Size: (13,838,816 bytes) MD5: ca8c521c30f57c0c199d526b9a23fc4a SHA1: 663399541a7d3bb1b5ea0e57a00c024e50d8506c SHA256: 8ae59d82845159db3a70763f5cb1571e45ebf6a1adfecc47574ba17b019483a0 CRC32: 1c9e87d0 Installation ============ Install Microsoft Visual C++ 2022 runtime. Both 64 bit and 32 bit version of Microsoft Visual C++ 2022 may be installed on 64 bit Windows. Copy all files in the Hoxs64 zip folder to the same directory. How to use Hoxs64 ================= Use File / Auto Load to load a game file. Toggle full screen mode with the [Alt Enter] key combination. You need to be in windowed mode to access the menu. NVidia G-Sync ============= For best results, set host CPU usage to "aggressive". Use "Line Sync". Use a monitor refresh rate that is substantially higher than 50 Hz. If you have a high refresh rate monitor then use the 100Hz frame rate doubler option where possible to prevent IPS LCD pixel burn. The CPU "friendly" mode causes the application to over sleep and miss its frame time slot. The application will try to catch up with fast frames that may exceed the user selected G-Sync frame cap and cause either tearing or stutter. Command Line Options ==================== Parameters including path names can optionally be double quoted. Double quotes are required when path names include embedded spaces or double quotes. -autoload {@ | # | : } Loads a disk, cartridge or tape file and runs a C64 program. The host PC file name. Supported files are D64 G64 P64 FDI CRT TAP PRG. A zero based number that specifies which file in a 1541 disk to load. A zero based number filtered on just PRG files that specifies which PRG in a 1541 disk to load. The CBM DOS name. A colon must precede the name with no space. Example hoxs64 -autoload D:\NoDoubleQuoteNeeded\demo.D64 This will load and run the default file in demo.D64 Example hoxs64 -autoload "D:\My Demos\demo.D64" This will load and run the default file in demo.D64 Example hoxs64 -autoload "D:\My Demos\demo.D64" #3 This will load and run the 4th PRG file in demo.D64 Example hoxs64 -autoload "D:\My Demos\demo.D64" @3 This will load and run the 4th file in demo.D64 Example hoxs64 -autoload "D:\My Demos\demo.D64" ":chess" This will load and run the file called CHESS in demo.D64 Uppercase A-Z will refer to C64 shifted graphical glyphs. -mountdisk Mounts a host PC disk file called but does not automatically load any programs. -quickload Memory injects the PRG file. This currently does not simulate the exact memory pattern that would be caused by real load from tape or disk. -reu512k Enable 1750 RAM Expansion Cartridge (512K). -fullscreen Start with a full screen display. -cia-new Use new CIA. -cia-old Use old CIA. -alignd64tracks Align D64 tracks. -debugcart Enable the debug cart. A write to IO $D7FF will cause the application to return an exit code. The first byte written to $D7FF becomes the exit code. The actual time of exit is deferred till the end of the current frame. -exitscreenshot Write a screen shot PNG file just before the application exits. is the name of the file. Existing files are overwritten! Example hoxs64 -exitscreenshot D:\Pictures\Test.png -defaultsettings Load emulation defaults before applying other options. Drive enabled. New CIA. D64 track skew. Track zero sensor. SID resample. Default keyboard layout. Pepto colour palette. No Extra SID chips; one SID chip at D400. -window-hide Do not show an application Window and do not show message boxes. Runs in the background. -nomessagebox Prevent Windows message boxes. -nosound No SID sound will be sent to the sound driver. -limitcycles Cause the application to exit after number (a 32 bit number) of clock cycles with exit code 1. -hlt-reset Reset the CPU upon freezing with HLT such as opcode $02 etc. -hlt-exit Main CPU HLT exits with exit code 255. -runfast Run at the fastest possible speed. Disables sound. -configfile Loads settings from an INI config file specified by which can either be a full path or a path relative to the application folder. Double dot ".." and single dot "." path elements are not supported. If the -configfile option is missing it will look for a file hoxs64.ini within the application folder. If the hoxs64.ini file is missing it will load settings from the registry. Examples hoxs64 -configfile D:\myconfigs\someconfig.ini hoxs64 -configfile appconfig.ini