Vircon32 Homepage: http://www.vircon32.com/index.html

Github: https://github.com/vircon32/

Documentation: https://github.com/vircon32/Vircon32Documents/tree/main/Specification/English/PDF%20documents

Here is a link to the C API page on vircon32's website: http://www.vircon32.com/api.html

This page will show you all of the tools you need to make games for the emulator using the C language

Note: Clicking the link in Vircon32 takes you to an older version of the DevTools.
Instead use the following link:
https://github.com/vircon32/ComputerSoftware/releases/tag/devtools-v23.10.27

This brings you to the latest release from the Vircon32 Github.

As we will be building from source you'll want to select and download the correct archive

1. Source code (tar.gz) for Linux or WSL
   
2. Source code (zip) for Windows

1. Knowledge on archive handling
2. Ability to read the Readme
3. Basic cli knowledge
4. Ability to find and update packages

Replicate section per system/OS you are building for

1. Extract your archive (location does not matter for this)
2. Navigate into the base directory. Should begin with ComputerSoftware.
3. Read the Readme.md
4. Create a build directory in both DesktopEmulator and DevelopmentTools
5. Reference the Readme on which packages are needed and install them.

http://www.vircon32.com/emulator.html

Replicate section per system/OS you are building for

Start by cd'ing into either the DesktopEmulator directory or the DevelopmentTools directory (NOTE: It does not matter where you start because you'll be repeating the step in both directories). Once into one of the above specified directories create a new directory named build.

mkdir build

Cd into the new directory and do the following.

Once you have downloaded all the required dependencies you need to run the following line on you system. (This example will be based of off a Linux/pi system).

cmake -G '[your system] Makefiles' ..

Here is an example of it for a Linux/Pi system (this should also work for wsl's in case you are among the non-pi users):

cmake -G 'Unix Makefiles' ..

NOTE: you need to have the “ ..” that is not a typo.

Once you have completed the above step, you need to run the following:

sudo cmake --install .

Note: you need to have the “ .” after install for it to work properly.

Now, you are almost done. Depending on where you started you need to repeat this step for either the DesktopEmulator directory or the DevelopmentTools directory.

Bootstrap a fairly simple “Hello, World” example, modified sufficiently from any provided tutorial or demo code.

This is a link to the provided tutorials on the Vircon Github page: https://github.com/vircon32/ConsoleSoftware/tree/main/Tutorials/RobotGame

Indicate some potential changes/functions used here.

Some potential changes/functions could be:

• Changing the position of the text( making it appear in the bottom right of the screen )
  
• Changing the background color to one of the provided colors( make it green )
  
• Implementing your own background( make it Jesse from Breaking Bad )
  
• Making your own font( Turn a tree into the alphabet )
  
• Adding sounds( like it saying “Mr.Worldwide” ) when booting up the demo

In the tutorials and demos there are corresponding build scripts that will take all the code and related resources, and run the appropriate development tools to create a Vircon32 cartridge file.

Part of your task is to author your own custom build script. Do not just use an existing script, and do not just lightly modify the provided scripts: craft your own, with descriptive comments, that suit your individual effort.