MAD64 RELEASE 2022.07

Mad64 is planned to be an all in one C64 development environment.
It currently is an editor that assembles your code as you type. IN future it will be able to execute and emulate a c64 while you type.

;====== HOW TO BUILD ======
** WINDOWS 10/11 **
For visual studio 2019 or 2022, use the mad64.sln including.  There are dependancies to download. Just build and run.

You can also build commandline with cmake using:
cmake -B build
cmake --build build --config release

** Linux (tested on UBUNTU & DEBIAN) **
from a terminal:
sudo apt install cmake
sudo apt-get install build-essential
sudo apt-get install libsdl2-dev
sudo apt-get install libsdl2-ttf-dev
sudo apt install git
git clone https://github.com/madpuppet/Mad64
cd Mad64
cmake -B build
cmake --build build --config release
build/Mad64

** MacOS **
Install Brew
Using Brew,  install  CMAKE, GIT, SDL2, SDL2_TTF
git clone https://github.com/madpuppet/Mad64
cd Mad64
cmake -B build
cmake --build build --config release
build/Mad64



;====== FILE MANIPULATION

CTRL-L         Load a text file
CTRL-S         Save current text file
CTRL-SHIFT-S   Save As
CTRL-Q         Quit current text file
CTRL-N         New file (will ask for a name of file, but doesn't create it on disk until you save it)
F1             Open Settings File - saving settings file will auto-apply changed settings in most cases
               Settings file on Windows is located  %appdata%\madpuppet\mad64\settings.ini

;====== EDIT MODES

INSERT         Toggle Insert/Overwrite mode
SHIFT-INSERT   Toggle Autoindent mode
CTRL-INSERT    Toggle Space/Tabs mode

;====== UNDO/REDO

CTRL-Z         Undo
CTRL-SHIFT-Z   Redo

;====== MARKING TEXT,   CUT & PASTE

Hold SHIFT down while move cursor with key or mouse to select text.

CTRL-A         Select All
CTRL-X         Cut selection to copy buffer
CTRL-C         Copy selection to copy buffer
CTRL-V         Paste from copy buffer
DOUBLE CLICK   on any word to select the entire word.  Useful to follow up with a CTRL-F or CTRL-R for search and replace

;====== SEARCH AND REPLACE

CTRL-F         Find text.  If a word is selected, then that word is copied as the search string
CTRL-R         Replace text.  If a word is selected, then that word is copied as the search string and the replace string is cleared
RIGHT CLICK    on the search or replace box to clear and select the box

;====== EMULATION

F5             Toggle emulation auto-run on/off
CTRL-F5        Reset and Start emulation auto-run
CTRL-SHIFT-F5  Load PRG file in Vice (use settings file to set up path to VICE)
F6             Hard Reset c64.  Does not start emulation or take focus.  You should follow with F5 and click on emulator window to capture input.

F10            Step to next 6502 instruction
SHIFT-F10      Step to start of next vic rasterline
CTRL-F10       Step to start of next vic frame
ALT-F10        Step one clock cycle

;====== ASSEMBLER SYNTAX

6502 ASSEMBLY DIRECTIVES

4095       - decimal
$0FFF      - hex number
%01010001  - binary number
&03123200  - base 4 (useful for multicolor graphics)

* = $1000  - set memory ptr

loop:      - label
!loop:     - local label (can have multiple of same name)

bne loop   - branch to loop label
bne loop-  - branch to previous instance of loop
bne loop+  - branch to next instance of loop
dc.b 1,2   - declare some 8 bit values. Also accepts ".byte"
dc.w 1,2   - declare some 16 bit values (little endian).  also accepts ".word"
dc.l 1,2   - declare some 32 bit values (little endian).  also accepts ".long"
dc.s 1     - declare 24 bit values used for sprite (big endian). also accepts ".sprite"
dc.t "hi"  - declare some text. also accepts ".text"

;====== ASSEMBLER DIRECTIVES

.import "file"                          - import a binary file to the current mem addr. path is local to asm file location.
.generate.b (0,255,sin(I/255.0*PI))     - generate data bytes using iterator 0 to 255 accessible through I variable
.generate.w (0,255,sin(I/255.0*PI))     - generate data words using iterator 0 to 255 accessible through I variable
.generate.s (0,255,sin(I/255.0*PI))     - generate data 3 byte values using iterator 0 to 255 accessible through I variable
.basicStartup                           - generate basic header code to call next line is assembly
.basicStartup(startLabel)               - generate basic header code to call "startLabel" as entry point to assembly

;====== ASSEMBLER EXPRESSIONS

(5 + 5) * 2  - BODMAS order of operations is followed,  brackets can be used to give higher priority
+, -, *, /   - add, subtract, multiply, divide
%            - integer modulo
<<, >>       - bitwise left & right shift
~, ^, &, |   - bitwise not, xor, and, or
||, &&, ==, <, >, <=, >=    - logical operators Or, And, Equals, Less, Greater, Less or Equal, Greater or Equal
A ? B : C    - ternary operator - if A then B else C
round(x)     - round to closet integral
floor(x)     - drop to closest integral
mod(x,y)     - floating point module x % y
sin(x)       - sin of x radians
cos(x)       - cos of x radians
tan(x)       - tan of x radians
asin(x)      - arc sin - note that invalid ranges will just return 0 to avoid NaNs
acos(x)      - arc cos
atan(x)      - arc tan
atan2(x,y)   - arc tangent in 2d
rand(a,b)    - integer random number >= a and <= b
rad(a)       - convert a from degrees to radians
deg(a)       - convert a from radians to degrees

;====== BUILT IN CONSTANTS

Mad64 has all the vic, cia and sid registers pre-defined as labels.  use vic.xxx, cia1.xxx, cia2.xxx, vic.xxx
It also has some rom function address and memory locations, though this is incomplete at this date.

vic.background0,  vic.border       -  vic registers
cia1.dataPortA, cia2.timerALow     -  cia 1 & 2 registers
sid.v1_freqLow, sid_v2_freqHi      -  sid registers
rom.SETNAM, rom.LOAD               -  basic rom function addresses


;====== RELEASE NOTES

2022.9

Add memory banking
Add bitmap mode
Add xscroll/yscroll/rsel/csel support
Add raster interrupt support
Add sprite-sprite collisions
Add cia1 timer interrupts
Add cia2 nmi interrupts
Add F6 hard-reset support
Add cia1 keyboard support
Add support for undocking the log windows
Add sprite/charset/bitmap dump support


2022.8

Beginning work on emulator
- can emulate a subset of 6502
- can emulate text mode graphics
- register view in log window
- F10 to single step
- resets emulation after every compile
- horizontal scrollbar for edit window
- dump memory view in log window
- added memory breakpoint support by clicking on a byte in the logwindow Dump memory
- added sprite support to emulator

2022.7

Many polishes to editor.
Search & Replace working
Got Linux version building via CMAKE and binary added to release.
Compiler now works on a thread so can't slow down editting even on massive files.

2022.5

First public release
Editor and compiler are functional.
Search works
Log window has contextual help.