From c734bccd3f9df7fb29f38930d692f956b47b58a9 Mon Sep 17 00:00:00 2001 From: Svjatoslav Agejenko Date: Thu, 12 Sep 2024 23:39:34 +0300 Subject: [PATCH] Improve file and documentation organization --- .../3D/{3dexplor => 3D Explorer}/explgala.bas | 0 .../3D/{3dexplor => 3D Explorer}/explgala.bat | 0 .../3D/{3dexplor => 3D Explorer}/explmaze.bas | 0 .../3D/{3dexplor => 3D Explorer}/explmaze.bat | 0 .../3D/{3dexplor => 3D Explorer}/qbext.com | Bin .../3D/{3dexplor => 3D Explorer}/script.dat | 0 Graphics/3D/3D Synthezier/doc/index.org | 91 ++++++++---------- .../KHK j\303\265ulud/joulud.bas" | 0 .../KHK j\303\265ulud/joulud2.bas" | 0 .../Presentations/KHK j\303\265ulud/ray2.bas" | 0 .../Presentations/KHK j\303\265ulud/run.bat" | 1 - index.org | 90 ++++++++--------- 12 files changed, 79 insertions(+), 103 deletions(-) rename Graphics/3D/{3dexplor => 3D Explorer}/explgala.bas (100%) rename Graphics/3D/{3dexplor => 3D Explorer}/explgala.bat (100%) rename Graphics/3D/{3dexplor => 3D Explorer}/explmaze.bas (100%) rename Graphics/3D/{3dexplor => 3D Explorer}/explmaze.bat (100%) rename Graphics/3D/{3dexplor => 3D Explorer}/qbext.com (100%) rename Graphics/3D/{3dexplor => 3D Explorer}/script.dat (100%) rename "Graphics/Presentations/KHK j\303\265ulud/khkdemo.bas" => "Graphics/Presentations/KHK j\303\265ulud/joulud.bas" (100%) rename "Graphics/Presentations/KHK j\303\265ulud/khkdemo2.bas" => "Graphics/Presentations/KHK j\303\265ulud/joulud2.bas" (100%) rename "Graphics/Presentations/KHK j\303\265ulud/ray.bas" => "Graphics/Presentations/KHK j\303\265ulud/ray2.bas" (100%) delete mode 100755 "Graphics/Presentations/KHK j\303\265ulud/run.bat" diff --git a/Graphics/3D/3dexplor/explgala.bas b/Graphics/3D/3D Explorer/explgala.bas similarity index 100% rename from Graphics/3D/3dexplor/explgala.bas rename to Graphics/3D/3D Explorer/explgala.bas diff --git a/Graphics/3D/3dexplor/explgala.bat b/Graphics/3D/3D Explorer/explgala.bat similarity index 100% rename from Graphics/3D/3dexplor/explgala.bat rename to Graphics/3D/3D Explorer/explgala.bat diff --git a/Graphics/3D/3dexplor/explmaze.bas b/Graphics/3D/3D Explorer/explmaze.bas similarity index 100% rename from Graphics/3D/3dexplor/explmaze.bas rename to Graphics/3D/3D Explorer/explmaze.bas diff --git a/Graphics/3D/3dexplor/explmaze.bat b/Graphics/3D/3D Explorer/explmaze.bat similarity index 100% rename from Graphics/3D/3dexplor/explmaze.bat rename to Graphics/3D/3D Explorer/explmaze.bat diff --git a/Graphics/3D/3dexplor/qbext.com b/Graphics/3D/3D Explorer/qbext.com similarity index 100% rename from Graphics/3D/3dexplor/qbext.com rename to Graphics/3D/3D Explorer/qbext.com diff --git a/Graphics/3D/3dexplor/script.dat b/Graphics/3D/3D Explorer/script.dat similarity index 100% rename from Graphics/3D/3dexplor/script.dat rename to Graphics/3D/3D Explorer/script.dat diff --git a/Graphics/3D/3D Synthezier/doc/index.org b/Graphics/3D/3D Synthezier/doc/index.org index dc911d4..641003c 100644 --- a/Graphics/3D/3D Synthezier/doc/index.org +++ b/Graphics/3D/3D Synthezier/doc/index.org @@ -8,20 +8,8 @@ #+OPTIONS: H:20 num:20 #+OPTIONS: author:nil -* General -- This software is part of [[../../../../index.html][QBasic apps package]]. -- These programs are free software: released under Creative Commons Zero - (CC0) license. - -- Program author: - - Svjatoslav Agejenko - - Homepage: http://svjatoslav.eu - - Email: mailto://svjatoslav@svjatoslav.eu - -- [[https://www.svjatoslav.eu/projects/][Other software projects hosted at svjatoslav.eu]] - -** Operating principle +* Operating principle 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 @@ -36,27 +24,29 @@ Objects with all its subobjects can be rotated, mirrored or resized omong any axis. Generator has built in cache for data input and output to minimize file access. -* Installation -+ Update include path inside *bin/3dparse.bas* file. +*Examples:* -** System requirements +Download Blender files: +| file | size | +|------------------------+--------| +| [[file:rectangular city.blend][rectangular city.blend]] | 3.6 MB | +| [[file:hexagonal city.blend][hexagonal city.blend]] | 21 MB | -| software | tested version | -|----------+----------------| -| DOS | 6.22 | -| QBasic | 4.5 | +They were produced by importing generated [[https://en.wikipedia.org/wiki/Wavefront_.obj_file][wavefront obj files]] into +[[https://www.blender.org/][Blender]]. -** Directory layout +** Rectangular city +[[file:rectangular city, 1.jpeg]] -+ bin :: - + 3dparse.bas :: 3D generator main executable - + city1.3d :: city with square-like buildings - + city2.3d :: city with hexangular buildings - + result.mtl :: shared material library - + *.bat :: quick launch scripts +[[file:rectangular city, 2.jpeg]] -+ include :: 3D objects used to compose the scene +[[file:rectangular city, 3.jpeg]] +** Hexagonal city +[[file:hexagonal city, 1.jpeg]] + +[[file:hexagonal city, 2.jpeg]] +[[file:hexagonal city, 3.jpeg]] * Scene description language See also examples. ** here @@ -117,6 +107,27 @@ See also examples. : dum dummy function, does notheing +* Installation +Edit *bin/3dparse.bas* file and update include path in there. + +** System requirements + +| software | tested version | +|----------+----------------| +| DOS | 6.22 | +| QBasic | 4.5 | + +** Directory layout + ++ bin :: + + 3dparse.bas :: 3D generator main executable + + city1.3d :: city with square-like buildings + + city2.3d :: city with hexangular buildings + + result.mtl :: shared material library + + *.bat :: quick launch scripts + ++ include :: 3D objects used to compose the scene + * Usage Make sure you have QB binaries in your PATH. Execute @@ -126,27 +137,3 @@ or to generate example cities. After parsing is finished, appropriate *.obj files will appear in the bin directory holding generated scene. Visualize scene with your favourite renderer. - -* Examples - -Download Blender files: -| file | size | -|------------------------+--------| -| [[file:rectangular city.blend][rectangular city.blend]] | 3.6 MB | -| [[file:hexagonal city.blend][hexagonal city.blend]] | 21 MB | - -They were produced by importing generated [[https://en.wikipedia.org/wiki/Wavefront_.obj_file][wavefront obj files]] into -[[https://www.blender.org/][Blender]]. - -** Rectangular city -[[file:rectangular city, 1.jpeg]] - -[[file:rectangular city, 2.jpeg]] - -[[file:rectangular city, 3.jpeg]] -** Hexagonal city -[[file:hexagonal city, 1.jpeg]] - -[[file:hexagonal city, 2.jpeg]] - -[[file:hexagonal city, 3.jpeg]] diff --git "a/Graphics/Presentations/KHK j\303\265ulud/khkdemo.bas" "b/Graphics/Presentations/KHK j\303\265ulud/joulud.bas" similarity index 100% rename from "Graphics/Presentations/KHK j\303\265ulud/khkdemo.bas" rename to "Graphics/Presentations/KHK j\303\265ulud/joulud.bas" diff --git "a/Graphics/Presentations/KHK j\303\265ulud/khkdemo2.bas" "b/Graphics/Presentations/KHK j\303\265ulud/joulud2.bas" similarity index 100% rename from "Graphics/Presentations/KHK j\303\265ulud/khkdemo2.bas" rename to "Graphics/Presentations/KHK j\303\265ulud/joulud2.bas" diff --git "a/Graphics/Presentations/KHK j\303\265ulud/ray.bas" "b/Graphics/Presentations/KHK j\303\265ulud/ray2.bas" similarity index 100% rename from "Graphics/Presentations/KHK j\303\265ulud/ray.bas" rename to "Graphics/Presentations/KHK j\303\265ulud/ray2.bas" diff --git "a/Graphics/Presentations/KHK j\303\265ulud/run.bat" "b/Graphics/Presentations/KHK j\303\265ulud/run.bat" deleted file mode 100755 index 43fe403..0000000 --- "a/Graphics/Presentations/KHK j\303\265ulud/run.bat" +++ /dev/null @@ -1 +0,0 @@ -qb /run khkdemo.bas \ No newline at end of file diff --git a/index.org b/index.org index 0cb76f4..3982218 100644 --- a/index.org +++ b/index.org @@ -8,37 +8,58 @@ #+OPTIONS: H:20 num:20 #+OPTIONS: author:nil -* General - -This collection contains lots of applications: +* Applications +This collection contains lots of toy applications: - Games. - Graphics tests (2D/3D/4D). - Algorithms tests. - Utilities. -I wrote those applications largely more than 20 years ago, mostly in -QBasic. Some are even written in x86 assembly for use under DOS -operating system. Because programs are old, coding style and -commenting is often times bad. I'm now using artificial intelligence -to revive and modernize them one by one. +I wrote those applications mostly more than 20 years ago, mostly in +QBasic. Because programs are old, coding style and commenting was +often times bad. I'm now using artificial intelligence to revive and +modernize them one by one. + +Few examples: +** 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]] + +** 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/hexagonal city, 2.jpeg]] -- These programs are free software: released under Creative Commons Zero - (CC0) license. +[[file:Graphics/3D/3D Synthezier/doc/rectangular city, 3.jpeg]] -- Programs author: - - Svjatoslav Agejenko - - Homepage: https://svjatoslav.eu - - Email: mailto://svjatoslav@svjatoslav.eu -- [[https://www.svjatoslav.eu/projects/][Other software projects hosted at svjatoslav.eu]] +[[file:Graphics/3D/3D Synthezier/doc/index.html][Read more]] +* Getting the source code -** Source code -- [[https://www2.svjatoslav.eu/gitweb/?p=qbasicapps.git;a=snapshot;h=HEAD;sf=tgz][Download latest snapshot in TAR GZ format]] +Programs author is Svjatoslav Agejenko +- Homepage: https://svjatoslav.eu (See also [[https://www.svjatoslav.eu/projects/][other software projects]].) +- Email: mailto://svjatoslav@svjatoslav.eu -- [[https://www2.svjatoslav.eu/gitweb/?p=qbasicapps.git;a=summary][Browse Git repository online]] +*These programs are free software: released under Creative Commons +Zero (CC0) license.* -- Clone Git repository using command: +- [[https://www2.svjatoslav.eu/gitweb/?p=qbasicapps.git;a=summary][Browse Git repository online]]. +- [[https://www2.svjatoslav.eu/gitweb/?p=qbasicapps.git;a=snapshot;h=HEAD;sf=tgz][Download latest snapshot in TAR GZ format]]. +- You can clone Git repository using git: : git clone https://www3.svjatoslav.eu/git/qbasicapps.git * Installation and Usage @@ -154,34 +175,3 @@ screen, it should get locked (confined to the DOSBox window) and work. To release mouse lock, press: : CTRL-F10 - -* Applications - -There are lot of applications. Few examples: - -** 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]] - -** 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/hexagonal city, 2.jpeg]] - -[[file:Graphics/3D/3D Synthezier/doc/rectangular city, 3.jpeg]] - - -[[file:Graphics/3D/3D Synthezier/doc/index.html][Read more]] -- 2.20.1