Hoxs64 v1.1.2.6 (c) 2024 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 with option for 16MB Action Reply Retro Reply Easy Flash (1MB) Ocean System 3 Dinamic Magic Desk Super Games Zaxxon Fun Play Simons Basic Host PC Requirements ==================== Windows 11, Windows 10 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 which can occur when viewing interlaced pictures that flicker between two repeating images at 50Hz. 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. Automatically load and run C64 file -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. Quickly load a PRG from a 1541 disk -quickload Memory injects a PRG file from an auto loaded D64 file whose disk image is specified by -autoload. This currently does not simulate the exact memory pattern that would be caused by real load from tape or disk. Example hoxs64 -quickload -autoload "D:\My Games\SEA_FOX.D64" This will quick load and run the default file in SEA_FOX.D64 Mount a disk image -mountdisk {} Mounts a host PC disk file to the 1541 drive. If is not supplied then, a new blank disk is mounted and if a .PRG file is supplied with -autoload is then the .PRG copied to the disk. Example hoxs64 -mountdisk -autoload "D:\My Games\bluemax.PRG" This will create and mount a new temporary 1541 disk called "BLUEMAX" and will copy the PC file bluemax.PRG to this new disk naming the 1541 file as "BLUEMAX" also. The file will be auto loaded from disk using LOAD"*",8,1 Mount a cartridge -mountcart Mount a cartridge from a CRT file. Muliple cartriages are not supported. The -mountcart option disables the -reu512k option. Insert a Commodore 1750 RAM Expansion Unit -reu512k Enable 1750 RAM Expansion Cartridge (512K). Muliple cartriages are not supported. The -mountcart option disables the -reu512k option. Start fullscreen -fullscreen Start with a full screen display. Use new CIA -cia-new Use new CIA. Use old CIA -cia-old Use old CIA. Align the magnetic disk tracks -alignd64tracks Align D64 tracks. Enable the debug cart mode used by the VICE test programs -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. Write an exit screen shot to a PNG file -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 Load emulation defaults -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. Hide the application window -window-hide Do not show an application Window and do not show message boxes. Runs in the background. Prevent Windows message boxes -nomessagebox Prevent Windows message box dialogs. Disable sound -nosound No SID sound will be sent to the sound driver. Limit system clock cycles -limitcycles Cause the application to exit after number (a 32 bit number) of clock cycles with exit code 1. Auto reset on CPU halt -hlt-reset Reset the CPU upon freezing with HLT such as opcode $02 etc. Auto close application on CPU halt -hlt-exit Main CPU HLT exits with exit code 255. Run at maximum speed -runfast Run at the fastest possible speed. Disables sound. Load configuration from an INI text file. -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