Basic-Emulator

Basic-Emulator is a simple Applesoft-Basic Emulator.

Usage

At the moment, the emulator supports the following statements:

• [ LET ] <variable> = <expression> where <expresion> is either an arithmetic expression or a string
• PRINT <expression> where <expression> is either an arithmetic expression or a string
• DEF FN <name>(<variable>) = <expr> which defines a single variable function that can be used throughout the program

Each statement must be preceded by a line number. The program may be executed using the RUN emulator command. It is possible to toggle between CRT rendering and flat rendering with the F2 key. Arithmetic expressions may use the following builtin functions:

• ABS(x): absolute value
• ATN(x): atan
• COS(x): cosine
• EXP(x): e to the power of x
• INT(x): floor
• LOG(x): log
• RND(x): random number between 0 and 1
• SGN(x): sign
• SIN(x): sine
• SQR(x): square root
• TAN(x): tangens

Prerequisites

In order to build the emulator, you must have a few things installed:

• CMake
• LLVM
• Ninja

Make sure that all of the above are installed correctly and that they are set in your PATH environment variable.

Linux

On Debian based distros, the following packages are required:

sudo apt install git cmake ninja-build libx11-dev xorg-dev libglu1-mesa-dev

Building

VSCode

In order to build the project using VSCode, you must first configure the CMake project:

1. Press F1 to open the command palette
2. Type in CMake: Configure
3. Press Enter

You will probably get asked what preset you want to choose, you can choose from

• Debug: <os>-64-debug
• Release: <os>-64-release

Then you can build the project:

1. Press F1 to open the command palette
2. Type in CMake: Build
3. Press Enter

Command Line

In order to build the project using the commandline, you must first configure the CMake project. There are different presets to choose from, you can list them using:

cmake --list-presets

There will probably be two presets to choose from:

• Debug: <os>-64-debug
• Release: <os>-64-release

You can then go on and choose a preset using the following command:

cmake --preset=<preset-name>

After this, you can build the project. For building, there are also different presets to choose from. It must be noted that the build preset must match with the configure preset. You can see all possible build presets using the following command:

cmake --build --list-presets

Now you can build the project using a preset of your choice:

cmake --build --preset=<preset-name>