#+TITLE:  QBasicApps - collection of applications mostly written in MS QBasic for DOS environment

* (document settings) :noexport:
** use dark style for TWBS-HTML exporter
#+HTML_HEAD: <link href="https://bootswatch.com/3/darkly/bootstrap.min.css" rel="stylesheet">
#+HTML_HEAD: <script src="https://cdnjs.cloudflare.com/ajax/libs/jquery/1.11.3/jquery.min.js"></script>
#+HTML_HEAD: <script src="https://cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.5/js/bootstrap.min.js"></script>
#+HTML_HEAD: <style type="text/css">
#+HTML_HEAD:   footer {background-color: #111 !important;}
#+HTML_HEAD:   pre {background-color: #111; color: #ccc;}
#+HTML_HEAD: </style>

* General

- This program is free software: you can redistribute it and/or modify
  it under the terms of the [[https://www.gnu.org/licenses/lgpl.html][GNU Lesser General Public License]] as
  published by the Free Software Foundation, either version 3 of the
  License, or (at your option) any later version.

- Program author:
  - Svjatoslav Agejenko
  - Homepage: https://svjatoslav.eu
  - Email: mailto://svjatoslav@svjatoslav.eu

- [[https://www.svjatoslav.eu/projects/][Other software projects hosted at svjatoslav.eu]]

** Source code
- [[https://www2.svjatoslav.eu/gitweb/?p=qbasicapps.git;a=snapshot;h=HEAD;sf=tgz][Download latest snapshot in TAR GZ format]]

- [[https://www2.svjatoslav.eu/gitweb/?p=qbasicapps.git;a=summary][Browse Git repository online]]

- Clone Git repository using command:
  : git clone https://www2.svjatoslav.eu/git/qbasicapps.git

* Running QBasic applications on Debian GNU/Linux

To run these applications on a modern GNU Debian Linux system, follow
these steps:

1. Install DOSBox by running the following command in your terminal:
   : sudo apt-get install dosbox

2. Place a copy of QBASIC.EXE and/or QuickBasic compiler in repository root directory.

3. Execute script that is located in the repository root directory:
   : ./run_dosbox.sh

4. Run the script to launch DOSBox:
   : ./run_dosbox.sh

5. Inside DOSBox, navigate to the directory containing your QBasic program and run it using the interpreter or compiler.


* DOSBox usage tips
** How to change keyboard layout to Dvorak

In case you want to use Dvorak keyboard layout and DOSBox fails to
auto-apply it, here is how you can set it manually:

1. Edit file:
  : ~/.dosbox/dosbox-<version>.conf

2. Modify *keyboardlayout* field as follows
  : keyboardlayout=dv103

3. Save the changes and restart DOSBox for the configuration to take
   effect.

** Increase window size

If you have big high-resolution screen, by default DOSBox window could
appear small. To make it bigger:

1. Edit file:
  : ~/.dosbox/dosbox-<version>.conf

2. Set windowresolution to either of those values:
   : windowresolution=1366x768
   : windowresolution=1600x900

3. Save the changes and restart DOSBox for the configuration to take
   effect.


* Content
This collection contains lots of applications:
+ Games.
+ Graphics tests (2D/3D/4D).
+ Algorithms tests.
+ Utilities.

I wrote them long time ago mostly in QBasic, some in x86 assembly for
use under DOS operating system.


Few sample applications from the package:
** Checkers
 Play checkers against the computer with any board size and any amount
 of caps. Does thinking by recursively testing many possible scenarios
 with any depth.

 Since it is slow QBasic implementation, it isn't practical to play
 with many caps or big thinking depth, for reasonable responce time.

 See directory:
 : games/checkers

 [[file:games/checkers/screenshot.png]]

** Platform game
 Jump around, collect coins and dont touch snails! Inspired by Super
 Mario Bros.

 See directory:
 : games/platform

 [[file:games/platform/screenshot.png]]

** 3D Synthezier
 Parses scene definition language and creates 3D world based on
 it. Result will be in a [[https://en.wikipedia.org/wiki/Wavefront_.obj_file][wavefront obj file]], witch can be then
 visualized using external renderer.

 See directory:
 : graphics/3D/3D Synthezier

 [[file:graphics/3D/3D Synthezier/doc/rectangular city, 1.jpeg]]

 [[file:graphics/3D/3D Synthezier/doc/hexagonal city, 2.jpeg]]

 [[file:graphics/3D/3D Synthezier/doc/index.html][Read more]]