indrajith/RCBASIC4
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Updated docs and added constants to tracker

Browse Source
This commit is contained in:
n00b87
2026-02-26 15:33:51 -06:00
parent aa7667c838
commit 9dbb4b6b5f
2332 changed files with 6219 additions and 2761 deletions
Download Patch File Download Diff File Expand all files Collapse all files

35
doc/doc_files/setup.html
View File

@@ -9,44 +9,40 @@
<body>
<p><h2><b><u>SETTING UP RCBASIC</u></b> </h2></p>
<p>
RCBasic comes with 2 command-line tools for creating programs. The first is rcbasic_build which takes your sourcecode in your *.bas file and compiles it into a *.cbc file. The *.cbc file contains intermediate bytecode which can be ran with the rcbasic (rcbasic.exe on windows) application.
To get started with RCBasic, just go into the directory where RCBasic is extracted to and start up RCBasic Studio. You are now ready to start coding.
</p>
<p>
NOTE: On Windows, you need to include all the 32-bit dlls with the 32-bit executable and all the 64-bit dlls with the 64-bit executable. The rcbasic package tool will automatically do all of this for you as well as package for other systems as well.
RCBasic also comes with a 2D level editor called Nirvana and a 3D level editor called Serenity. If you are on linux there is a start up script for each one in the main folder where RCBasic is extracted. On Windows, just go into each folder and start up the exe for the editor you want to use.
</p>
<p>
<h2><b><u>RUN PROGRAMS FROM GEANY</u></b></h2>
</p>
<p>
<b><u>LINUX</u></b> In the installer directory there is a folder called geany_files. Inside the folder there is a file named filetypes.rcbasic. You can override the geany *.bas configuration by replacing the freeBasic configuration with this file. Just copy this file to the geany filedefs path, which on most linux distibutions should be (/home/.config/geany/filedefs), and rename the file to filetypes.freebasic.
</p>
<p>
Once you have rcbasic set up with geany you just need to create a new file and save it as *.bas. Then you can compile your program by going to Build->Compile. Once your program is compiled you can run it by going to Build->Execute.
</p>
<p>
NOTE: If you want to use a different file extension for rcbasic programs you can still use this file and just set it up for a different extension. Refer to the geany documentation on how to set up different file types.
</p>
<p>
<b><u>WINDOWS</u></b> Geany comes preconfigured with rcbasic on windows. Just run the start_editor.bat file and create a new *.bas file. Select the File->New with Template option in the menu to start with a simple template program. Once you have created a new *.bas file goto Build->Compile to compile your program to a *.cbc file. Then goto Build->Execute to run your program.
There is a video going over the basics of each editor here:
</p>
<ul>
<li>
<a href="https://www.youtube.com/watch?v=J_GNcGp1Zmg">Nirvana</a>
</li>
<li>
<a href="https://www.youtube.com/watch?v=bj7m40XBl2A">Serenity</a>
</li>
</ul>
<p>
<h2><b><u>USING RCBASIC FROM THE COMMAND-LINE</u></b></h2> RCBasic will be added to path on install on linux. On Windows you will need to add the rcbasic folder to your path. Either (rcbasic/rcbasic_32) or (rcbasic/rcbasic_64) depending on your operating system. Once rcbasic is in your path you can simple pass a source file to rcbasic_build to create a *.cbc file.
</p>
<p id="rc_code"><code>
rcbasic_build&nbsp;myprogram.bas&nbsp;<br>
rcbasic_build4&nbsp;myprogram.bas&nbsp;<br>
</code></p>
<p>
Once you have a *.cbc file you can pass it to rcbasic to run it.
</p>
<p id="rc_code"><code>
rcbasic&nbsp;myprogram.cbc&nbsp;<br>
rcbasic4&nbsp;myprogram.cbc&nbsp;<br>
</code></p>
<p>
Both tools also except the --version argument which will simply output the version of rcbasic you are using.
</p>
<p id="rc_code"><code>
rcbasic_build&nbsp;--version&nbsp;<br>
rcbasic&nbsp;-version&nbsp;<br>
rcbasic_build4&nbsp;--version&nbsp;<br>
rcbasic4&nbsp;-version&nbsp;<br>
</code></p>
<p>
<h2><b><u>PORTING TO OTHER PLATFORMS</u></b></h2>
@@ -55,6 +51,7 @@
From RCBasic Studio, select tools->distribute and then select the platforms you want to distribute to and click the "MAKE APP" button.
</p>
<p>
</p>
</body>
</html>