CyberVGA

=====================================================================
   ██████╗██╗   ██╗██████╗ ███████╗██████╗ ██╗   ██╗ ██████╗  █████╗ 
  ██╔════╝╚██╗ ██╔╝██╔══██╗██╔════╝██╔══██╗██║   ██║██╔════╝ ██╔══██╗
  ██║      ╚████╔╝ ██████╔╝█████╗  ██████╔╝██║   ██║██║  ███╗███████║
  ██║       ╚██╔╝  ██╔══██╗██╔══╝  ██╔══██╗██║   ██║██║   ██║██╔══██║
  ╚██████╗   ██║   ██████╔╝███████╗██║  ██║╚██████╔╝╚██████╔╝██║  ██║
   ╚═════╝   ╚═╝   ╚═════╝ ╚══════╝╚═╝  ╚═╝ ╚═════╝  ╚═════╝ ╚═╝  ╚═╝
              32-BIT DOS 3D ENGINE  //  MODE X PIPELINE
====================================================================

> A real-mode inspired 3D engine built for MS-DOS

> Software-rendered, fixed-point, VGA Mode X pipeline

> Playable in browser / Full build with editor included

---

[ PLAY NOW ]
------------------------------------------------------------
Run CyberVGA instantly in your browser.
No install required.
Immediate access to the current engine build.
NOTE: For best performance, use the Windows package.

---

[ SYSTEM OVERVIEW ]
------------------------------------------------------------
CyberVGA is a from-scratch 3D engine targeting late MS-DOS
hardware constraints.
No GPU.
No floating point in hot paths.
No modern graphics APIs.
Rendering is handled entirely in software using:
 - VGA Mode X (320x240 planar memory)
 - Q16.16 fixed-point math
 - Custom rasterization pipeline (C + NASM)
This is not a retro-styled engine.
This is a hardware-constrained engine.

---

[ INCLUDED COMPONENTS ]
------------------------------------------------------------
+ Runtime engine
+ CyberEdit (built-in world editor)
+ Custom asset pipeline
+ Playable demo environment
CyberEdit runs inside the same rendering environment
as the engine.
No external tools required for world authoring.

---

[ CORE FEATURES ]
------------------------------------------------------------
RENDERING
---------
+ Software rasterizer (no GPU)
+ Textured triangle pipeline
+ Ordered dithering
+ Palette-based shading
+ Page flipping and planar VRAM control
WORLD SYSTEM
------------
+ Cell and portal architecture
+ Binary world serialization (.CEL)
+ Indoor/outdoor structure support
+ Point light system
TOOLS
-----
+ CyberEdit (in-engine editor)
+ Real-time world editing
+ CMS (CyberMesh) format
+ Blender export pipeline
AUDIO / INPUT
-------------
+ Sound Blaster support
+ Mouse + keyboard controls
+ Free camera system

---

[ TECHNICAL SPECIFICATION ]
------------------------------------------------------------
Language:      C89 (DJGPP) + NASM
Memory Model:  32-bit protected mode (DPMI)
Renderer:      Software (CPU-based)
Math:          Fixed-point (Q16.16)
Target:        486 / early Pentium class systems
Performance-critical paths avoid division using
reciprocal lookup tables.

---

[ CURRENT STATE ]
------------------------------------------------------------
The engine is functional but evolving.
Working:
+ Rendering pipeline
+ World loading
+ Editor integration
+ Lighting system
In progress:
+ Portal clipping refinement
+ Mesh rendering improvements
+ Engine cleanup
+ Entity system
Expect instability during development.

---

[ INSTALLATION - WINDOWS PACKAGE ]
------------------------------------------------------------
1. Download .7z archive
2. Extract contents
3. Run:
   RUNCVGA.BAT   -> start runtime
   RUNCEDIT.BAT  -> start editor
DOSBox is included.
No configuration required.
CONTROLS
--------
WASD        : movement
MOUSE       : look
F12         : key help (editor)
ESC         : exit

---

[ DESIGN PHILOSOPHY ]
------------------------------------------------------------
CyberVGA treats hardware limitations as design inputs.
Every system is built with:
 - explicit memory awareness
 - explicit arithmetic cost
 - minimal abstraction overhead
The goal is not to simulate the past,
but to operate within its constraints deliberately.

---

[ LICENSING ]
------------------------------------------------------------
This project is proprietary.
Source code and assets are not publicly available.

---

[ FOLLOW DEVELOPMENT ]
------------------------------------------------------------
If you are interested in:
+ low-level graphics programming
+ DOS rendering pipelines
+ software rasterization
+ fixed-point engine design
Follow the project and check devlogs for updates.
============================================================
 END OF FILE
============================================================