Differences

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

--- notes:fall2024:projects:btt0 [2024/07/31 13:49] – created - external edit 127.0.0.1
+++ notes:fall2024:projects:btt0 [2024/09/05 02:12] (current) – [Implementing your own Background] bpatrice
@@ Line 5: / Line 5: @@
 ====URLs====
+To get the Vircon32 DevTools go to https://github.com/vircon32/ComputerSoftware and download the provided tools. This can be found on the right side of the screen under a section called "Releases." This page is where you can find the appropriate package for your system. Once downloaded read the provided Readme.md for the instructions on how to install Vircon32. A nice way to check if you installed Vircon32 correctly is to try putting "Vircon32" in the command line. If it opens Vircon32 it worked.
 ====API====
+Here is the link to Vircon32's API page: http://www.vircon32.com/api.html
+This page serves as a comprehensive reference of all the functions available in Vircon32’s C compiler. You will find this page useful since the C compiler for Vircon32 is different from standard C.
 =====Vircon32=====
-====Obtain source of latest stable release of Vircon32 DevTools====
+====Obtain source of latest stable release of Vircon32 DevTools & Emulator====
-====Obtain source of latest stable release of Vircon32 emulator====
+===For Linux users===
+  * Obtain the source.tar.gz file for latest edition of Vircon32/ComputerSoftware/ from the [[https://github.com/vircon32/ComputerSoftware/releases|Releases]]
+  * Navigate to the location of your now downloaded .tar.gz file and extract using <code>tar xvcf [file].tar.gz</code>
+===For Windows users===
+  * Obtain the source.zip file for latest edition of Vircon32/ComputerSoftware/ from the [[https://github.com/vircon32/ComputerSoftware/releases|Releases]]
+  * Navigate to the location of your now downloaded .zip file and extract
+===System independent===
+  * You should now have a directory you can navigate into called ComputerSoftware/
+  * Navigate inside and check for two directories call DesktopEmulator/ and DevelopmentTools/
+=====Vircon32 installation=====
+At the base of the ComputerSoftware/ directory there should be a file named Readme.md, you will refer to this **heavily**
+Following the Readme, install all dependencies
+__These steps will be done the same in both the DesktopEmulator/ directory and the DevelopmentTools/ directory__
+Again following the Readme
+  * Create a build/ directory off of the DesktopEmulator/ and DevelopmentTools/ directories and enter it
+  * For Linux systems & Pi rather than MSYS Makefiles you will want Unix Makefiles
+  * Follow the remaining commands in the Readme to the end
+  * Keep track of where the Emulator and the DevTools are installed and add those paths to your ~/.bashrc
+  * Don't forget to run source ~/.bashrc or close/reopen your terminal
 =====Hello World=====
@@ Line 29: / Line 56: @@
   * Adding sounds
+====Implementing your own Background====
+A Vircon32 image file:
+  * has a max size of 640x360 pixels
+  * will also only take ".png" files
+  * needs the "video.h" library
+You can implement libraries in your ".c" file with
+<code>
+#include "library name"
+</code>
+But to be able to use it in the ".c" file you need to define it in the ".sh" and ".xml" files.
+Open your ".sh" file and for images do:
+<code>
+png2vircon FileName.png -o obj/FIleName.vtex || abort_build
+</code>
+And then open your ".xml" file and for images do:
+<code>
+ <textures>
+  <texture path="obj/Start.vtex" />
+ </textures>
+</code>
+Back in your ".c" file we have to define the Texture and it Region:
+<code>
+#define TextureFileName  0
+#define RegionFileName   0
+</code>
+The value corresponds to where it sits in your ".xml" file. If FileName is the first texture being made then the value is 0. If it's the second texture then the value = 1, etc...
+This is also the same for audio files, so your first audio file's value would correspond to 0.
+Region can be 0 for backgrounds.
+You then have to define it in the ".c" file again:
+<code>
+select_texture( TextureFileName );
+select_region( RegionFileName );
+define_region_topleft( 0,0, 639,359 );
+</code>
+Then to call it use:
+<code>
+select_texture( TextureFileName );
+select_region( RegionFileName );
+draw_region_at( 0,0 );
+</code>
 =====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.

Lab46 Wiki

User Tools

Site Tools

Differences

Page Tools