Table of Contents

Corning Community College

CSCS1320 C/C++ Programming

PROJECT: Building The Thing (BTT0)

OBJECTIVE

Obtain the latest stable release of Vircon32, in source code form, and build it and the associated DevTools in your development system. Collaboratively document the build process.

EDIT

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

BTT0 documentation

Resources

URLs
API

What is Vircon32?

It is a 32-bit virtual console created with the goal of being as simple as possible, but still having enough features to support full, elaborate games.

Vircon Specifications
  • Simplified 32-bit architecture
  • 15 MHz CPU with floating point support
  • 15 MHz CPU with floating point support
  • 15 MHz CPU with floating point support
  • Screen of 640 x 360 pixels (16 : 9), with true color
  • Support for rotation, scaling and transparencies
  • CD-quality stereo sound with 16 channels
  • Up to 4 gamepads with 6 buttons + Start
  • Supports 1 MB memory cards to save games
  • Each ROM is a single file
  • Has a C compiler: no need to write assembly

Dowloading and Installing Vircon32

Obtain source of latest stable release of Vircon32 DevTools and Emulator

go onto your computer and copy the repo to a location of your choosing, git clone https://github.com/vircon32/ComputerSoftware

both emulator and developer tools are included

environment configuration for dev tools
environment configuration for emulator

Hello World

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 color of the text
  • Changing what the text says ( and / or make it a different language )
  • 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

Cartridge Build Scripts

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.

 

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:btt0:final tally of results (52/52)
*:btt0:submitted modified demo code for project by duedate [13/13]
*:btt0:submitted original build scripts and cartridge [13/13]
*:btt0:contributed to project documentation [13/13]
*:btt0:committed project related changes to semester repo [13/13]

Pertaining to the collaborative authoring of project documentation

Additionally