Help

File Formats     

VICE Snapshot (.vsf)

A VICE Emulator snapshot file that can be imported into Redjac.

CCS64 Freeze File (.c64)

A CCS64 Emulator freeze file that can be imported into Redjac.

C64 Memory Dump (.bin)

A dump of the C64's memory from $0000 to $ffff that can be imported into Redjac

Charset Files (.chr | .prg)

Redjac can save both a binary 2048 byte charset (.chr) or 2050 byte charsets (.prg), which contain a 2 byte header.

Screen Layout

Click image to enlarge...

 
     

 

 

 

 

 

 

 

 

Menu at the top of the Redjac window (see Redjac Menus section below for details of each menu action). 

Memory scanner, operated by sliding the selector left or right to look through memory. Can also be operated by clicking the '+' and '-' buttons either side of the slider.

Charset display that renders the current section of memory to find a viable charset.

Colour selectors to choose whether the background or hires/multicolours of the displayed charset are altered when a colour is chosen from the palette.

Palette selector used to change the colours of the displayed charset, used in conjunction with the colour selectors above. Note, for the purposes of ripping and testing, any colours can be chosen at any time in any combination. However, in practise a C64 can only display the first seven colours for the character colour when in multicolour mode.

Menus   

File Menu

Import VICE Snapshot

Imports a .vsf snapshot file saved from VICE (v3.6 up).

Import CCS64 Freeze File

Imports a .c64 freeze file saved from CCS64 (v3.9.2).  

Import C64 Memory Dump

Imports a .bin memory dump file from a monitor (see later).

Save Charset

Saves the presently displayed charset as either a binary 2048 byte charset (.chr) or 2050 byte charset (.prg), which contains a 2 byte header.

Charset Byte Table

Presents the currently displayed charset as a byte table, 256 rows of 8 byte char definitions. Speed of table generation depends on speed of your computer! Table Can be copy/pasted into code or copied to the clipboard.

Byte Table Formatting

Select the formatting for the above byte table, including options for prefix (!byte | .byte | dc.b | DATA)  and hex or decimal output.
  
Quit

Quits Redjac, with prompt.
  
View Menu

Screen Resolution

Hires selects a hires charset and screen mode, multicolour selects a multicolour charset and screen mode,

Show Charset Grid

Select to overlay a grid showing individual character boundaries.

Scanline Emulation

Toggles the built-in scanline emulation on the charset display.

CRT Emulation

Toggles the built-in CRT emulation on the charset display.
    
Tools Menu

Dump Charset

Allows the saving of the current charset as an image (bmp, png, jpg) or to the clipboard. Saves to  folder from where Redjac was launched.

Compress Charset

Compresses the charset by removing any spaces and/or duplicates.

Help (?) Menu 

About...

Information about Redjac including version and build date and time. Changelog panel also available.

Help File

Loads the help file from the 'docs' folder in the same folder as the Redjac executable.

Web Support

Launches your default web browser and directs to the support page on this website.

Redjac Website

Launches your default web browser and directs to the homepage of this website.

Donate!

Launches your default web browser and directs to the donate page on this website.  

Emulator 'Snapshot' Files

Both VICE and CCS64 save files that contain information about the entire state of the emulated C64. Redjac can read both VICE 'Snapshot' and CCS64 'Freeze' files. To create these from within the emulators, use the following actions...

VICE (3.6 and above)

 From the 'Snapshot' menu, select 'Save snapshot image...'

CCS64 (v3.9.2)

From the '-State' menu, select 'Save...'

NOTE: for full compatibility, it's always best to dump the C64 memory. See below!
  
C64 Memory Dump Files

Redjac can read dumps of the C64's memory from $0000 to $FFFF, that are 65,536 bytes in size.

Various cartridges with built-in monitors are capable of dumping the contents of the C64 memory to a file. Please refer to your chosen cartridge documentation.

Emulators can dump a memory file very easily. Below are some instructions how to dump a memory file from both VICE and CCS64 using their in-built monitors.

VICE (v3.6 and above)

Once a program has loaded, select 'Activate monitor' from the 'File' menu. In the monitor window, type: 

BS "filename.bin" 0 0000 FFFF

Replace 'filename' with a filename of your choice, not forgetting to add the .bin extension so Redjac can load it later.  If you don't add a file path, the file will be saved to the 'bin' folder of your VICE folder.

CCS64 (v3.9.2) 

Once a program has loaded, select 'Machine Code Monitor' from the 'File' menu. In the monitor window, type:

S "filename.bin" 0000 FFFF

Replace 'filename' with a filename of your choice, not forgetting to add the .bin extension so Redjac can load it later.  If you don't add a file path, the file will be saved to your CCS64 folder.

 

For more help, visit the support page here...