User Tools

Site Tools


notes:comporg:spring2024:projects:btt0

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
notes:comporg:spring2024:projects:btt0 [2024/01/29 01:33] – [Obtain source of latest stable release of Vircon32 DevTools] cburlingnotes: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://github.com/vircon32/Vircon32Documents/tree/main/Specification/English/PDF%20documents https://github.com/vircon32/Vircon32Documents/tree/main/Specification/English/PDF%20documents
 ====API==== ====API====
 +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
 =====Vircon32===== =====Vircon32=====
  
Line 31: Line 33:
  
 ===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://github.com/vircon32/ComputerSoftware/blob/main/Readme.md
  
 ===build process (platform/OS)=== ===build process (platform/OS)===
 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 'aptitude <package>' to search for the specific libraries and 'apt install <package>' to install. You most likely need to use the token 'sudo' when installing.
 +
 +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 ///usr/local/DevTools//, so you will want to open up your .bashrc file:
 +
 +<code bash>
 +vim ~/.bashrc
 +</code>
 +
 +Then, you can add this line to the very end of your file:
 +
 +<code bash>
 +export PATH=$PATH:/usr/local/DevTools
 +</code>
 ====Obtain source of latest stable release of Vircon32 emulator==== ====Obtain source of latest stable release of Vircon32 emulator====
  
 ===URL=== ===URL===
 http://www.vircon32.com/emulator.html http://www.vircon32.com/emulator.html
 +
 +Github: https://github.com/vircon32/ComputerSoftware/tree/main/DesktopEmulator
 +
 ===build prerequisites=== ===build prerequisites===
  
Line 50: 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<package name>-dev
 +</code>
 +So an example would be sudo apt install libsdl2-dev (Notice how the capital SDL became sdl. Also and "_" will become "-").
 +
 ==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. 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.
Line 56: Line 100:
 </code> </code>
  
-Cd into the new directory and do the following.+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 69: Line 113:
 </code> </code>
  
-NOTE: you need to have the space .. that is not a typo.+NOTE: you need to have the ..that is not a typo.
  
 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: 
Line 75: Line 119:
 sudo cmake --install . sudo cmake --install .
 </code> </code>
 +
 +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.  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 85: Line 131:
 ===environment configuration=== ===environment configuration===
  
 +After running the previous command, the Emulator tools get installed to ///opt/Vircon32/Emulator//. To use these tools, they will have to be added to your $PATH variable. To do this open .bashrc in any editor:
 +
 +<code bash>
 +vim ~/.bashrc
 +</code>
 +
 +Then, add the following line at the end of the file:
 +
 +<code bash>
 +export PATH=$PATH:/opt/Vircon32/Emulator
 +</code>
 +
 +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:/usr/local/DevTools:/opt/Vircon32/Emulator
 +</code>
 =====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 95: Line 158:
 Some potential changes/functions could be: Some potential changes/functions could be:
   * 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.1706492023.txt.gz · Last modified: 2024/01/29 01:33 by cburling