Table of Contents

Corning Community College

CSCS1320 C/C++ Programming

PROJECT: Fun With Games (FWG0)

OBJECTIVE

Obtain the latest stable release of Vircon32, along with its DevTools, and modify the “hello, world!” demo to display an image, along with modified text (content, position, attributes).

As has been the case with many projects this semester, you will also be contributing to the project documentation, detailing the necessary steps to obtain, configure, build, and use the items being focused on.

With clarification gained from asking any needed questions, you will proceed to craft useful documentation with the rest of the class. The final result should allow anyone to accomplish the task.

If you struggle with how to form questions, perhaps consider utilizing the college learning commons to receive assistance with forming good questions.

NOTE: Do not add the source code to Vircon32 or DevTools to your repository! Process these outside of your repository. Once installed, your files specifically related to your modified “Hello, World!” cartridge should be added to your repository.

EDIT

You will want to go here to edit and fill in the various sections of the document:

FWG0

URLs

The GitHub repository for Vircon32 and DevTools Can be found at: https://github.com/vircon32/ComputerSoftware/releases

This site will provide zip files for both and how to install them.

Build from Source

Install the Emulator and the DevTools outside the Lab46 repository. It is recommended to do this on your Pi and the following steps is for the Pi. Download the following from the GitHub repository linked in previous section

Vircon32-Emulator-24.3.2-RaspberryPi4-Raspbian.zip

Vircon32-DevTools-24.2.4-RaspberryPi4-Raspbian.zip

Unzip these files which provide a similar file name with a .DEB file extension

vircon32-emulator_24.3-2_armhf.deb

vircon32-devtools_24.2-4_armhf.deb

To install these use the following commands:

     sudo dpkg -i vircon32-emulator_24.3.2_armhf.deb
     sudo apt-get install -f 
     
     sudo dpkg -i vircon32-devtools_24.2.4_armhf.deb

The base path for the install is /opt/Vircon32/Emulator

To run the Vircun32 API, change to the emulator directory and run ./Vircon32

There's a hidden task bar near the top of the screen that shows up when your mouse is near that shows multiple actions you can do.

Cartridge build process

compile
assemble
image processing
packing the ROM

Using the Vircon32 API

displaying text

A basic way of displaying text would be to set the ( x, y ) coordinates of the starting point, followed by printing your text. Below is the example from the Hello World tutorial.

    // draw our text near the top-left of the screen
    set_drawing_point( 20, 120 );
    print( "Hello, World!" );
processing textures and regions
displaying a region at location
 

SUBMISSION

To be successful in this project, the following criteria (or their equivalent) must be met:

Submit Tool Usage

Let's say you have completed work on the project, and are ready to submit, you would do the following:

lab46:~/src/SEMESTER/DESIG/PROJECT$ submit DESIG PROJECT file1 file2 file3 ... fileN

You should get some sort of confirmation indicating successful submission if all went according to plan. If not, check for typos and or locational mismatches.

RUBRIC

I'll be evaluating the project based on the following criteria:

52:fwg0:final tally of results (52/52)
*:fwg0:submitted adequately modified demo code for project by duedate [13/13]
*:fwg0:all files needed to build cartridge are submitted [13/13]
*:fwg0:code compiles, cartridge builds with no warning or error [13/13]
*:fwg0:committed project related changes to semester repo [13/13]

Pertaining to the collaborative authoring of project documentation

Additionally