notes:comporg:spring2024:projects:btt0
Differences
This shows you the differences between two versions of the page.
| Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
| notes:comporg:spring2024:projects:btt0 [2024/01/26 15:10] – [Obtain source of latest stable release of Vircon32 emulator] wgates1 | notes:comporg:spring2024:projects:btt0 [2024/02/01 03:55] (current) – [Obtain source of latest stable release of Vircon32 DevTools] rspringe | ||
|---|---|---|---|
| Line 14: | Line 14: | ||
| https:// | https:// | ||
| ====API==== | ====API==== | ||
| + | Here is a link to the C API page on vircon32' | ||
| + | This page will show you all of the tools you need to make games for the emulator using the C language | ||
| =====Vircon32===== | =====Vircon32===== | ||
| Line 20: | Line 22: | ||
| ===URL=== | ===URL=== | ||
| - | **Note: | + | **Note: |
| + | Instead | ||
| https:// | https:// | ||
| This brings you to the latest release from the Vircon32 Github. | 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\\ | ||
| + | -Source code (tar.gz) for Linux or WSL \\ | ||
| + | -Source code (zip) for Windows | ||
| ===build prerequisites=== | ===build prerequisites=== | ||
| + | -Knowledge on archive handling | ||
| + | -Ability to read the Readme | ||
| + | -Basic cli knowledge | ||
| + | -Ability to find and update packages | ||
| + | |||
| + | Vircon32 ComputerSoftware Readme: https:// | ||
| ===build process (platform/ | ===build process (platform/ | ||
| Replicate section per system/OS you are building for | Replicate section per system/OS you are building for | ||
| + | |||
| + | -Extract your archive (location does not matter for this) | ||
| + | -Navigate into the base directory. Should begin with ComputerSoftware. | ||
| + | -Read the Readme.md | ||
| + | -Create a build directory in both DesktopEmulator and DevelopmentTools | ||
| + | -Reference the Readme on which packages are needed and install them. | ||
| ===installation=== | ===installation=== | ||
| + | |||
| + | Begin by installing the required libraries, they will be listed at the bottom of the Readme.md file | ||
| + | |||
| + | begin by typing the command ' | ||
| + | |||
| + | After the packages are installed you will want to continue with the installation steps in the Readme, namely steps 3 through 5. | ||
| + | |||
| + | Keep an eye on the location where each the DevTools and Emulator get installed. | ||
| ===environment configuration=== | ===environment configuration=== | ||
| + | Making note of the location of the DevTools and Emulator, you'll want to add those to your $PATH variable via your .bashrc file. | ||
| + | |||
| + | In this case, DevTools gets installed to /// | ||
| + | |||
| + | <code bash> | ||
| + | vim ~/.bashrc | ||
| + | </ | ||
| + | |||
| + | Then, you can add this line to the very end of your file: | ||
| + | |||
| + | <code bash> | ||
| + | export PATH=$PATH:/ | ||
| + | </ | ||
| ====Obtain source of latest stable release of Vircon32 emulator==== | ====Obtain source of latest stable release of Vircon32 emulator==== | ||
| ===URL=== | ===URL=== | ||
| http:// | http:// | ||
| + | |||
| + | Github: https:// | ||
| + | |||
| ===build prerequisites=== | ===build prerequisites=== | ||
| Line 46: | Line 88: | ||
| ===installation=== | ===installation=== | ||
| ==Step 1 (Getting and installing all necessary dependencies)== | ==Step 1 (Getting and installing all necessary dependencies)== | ||
| + | Once you have got your source files, gotten the contents out of it, and cd'd into it there should be a Readme file, cat it to read it. After that you should have read at the bottom that there are libraries to install. You should install these in the following format: | ||
| + | <code bash> | ||
| + | sudo apt install lib< | ||
| + | </ | ||
| + | So an example would be sudo apt install libsdl2-dev (Notice how the capital SDL became sdl. Also and " | ||
| + | |||
| ==Step 2 (After you have downloaded all the necessary dependencies)== | ==Step 2 (After you have downloaded all the necessary dependencies)== | ||
| + | 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. | ||
| + | <code bash> | ||
| + | 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). | 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). | ||
| Line 53: | Line 108: | ||
| </ | </ | ||
| - | Here is an example of it for a Linux/Pi system: | + | Here is an example of it for a Linux/Pi system |
| <code bash> | <code bash> | ||
| cmake -G 'Unix Makefiles' | cmake -G 'Unix Makefiles' | ||
| </ | </ | ||
| - | NOTE: you need to have the space .. that is not a typo. | + | NOTE: you need to have the " |
| Once you have completed the above step, you need to run the following: | Once you have completed the above step, you need to run the following: | ||
| <code bash> | <code bash> | ||
| - | sude cmake --install | + | 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. | ||
| Line 73: | Line 131: | ||
| ===environment configuration=== | ===environment configuration=== | ||
| + | After running the previous command, the Emulator tools get installed to /// | ||
| + | |||
| + | <code bash> | ||
| + | vim ~/.bashrc | ||
| + | </ | ||
| + | |||
| + | Then, add the following line at the end of the file: | ||
| + | |||
| + | <code bash> | ||
| + | export PATH=$PATH:/ | ||
| + | </ | ||
| + | |||
| + | If you have installed the emulator //after// you installed the DevTools, then you can simply include both paths at once: | ||
| + | |||
| + | <code bash> | ||
| + | export PATH=$PATH:/ | ||
| + | </ | ||
| =====Hello World===== | =====Hello World===== | ||
| Bootstrap a fairly simple “Hello, World” example, modified sufficiently from any provided tutorial or demo code. | Bootstrap a fairly simple “Hello, World” example, modified sufficiently from any provided tutorial or demo code. | ||
| Line 83: | Line 158: | ||
| Some potential changes/ | Some potential changes/ | ||
| * Changing the position of the text( making it appear in the bottom right of the screen )\\ | * 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 )\\ | * Changing the background color to one of the provided colors( make it green )\\ | ||
| * Implementing your own background( make it Jesse from Breaking Bad )\\ | * Implementing your own background( make it Jesse from Breaking Bad )\\ | ||
notes/comporg/spring2024/projects/btt0.1706281824.txt.gz · Last modified: 2024/01/26 15:10 by wgates1
Page Tools
Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 4.0 International
