ona/readme.md

96 lines
4.4 KiB
Markdown
Raw Normal View History

2023-02-18 04:34:40 +01:00
# Ona
## Table of Contents
1. [Overview](#overview)
1. [Goals](#goals)
1. [Technical Details](#technical-details)
1. [Requirements](#requirements)
1. [Building](#building)
1. [Project Structure](#project-structure)
1. [No Headers](#no-headers)
2023-02-20 14:41:33 +01:00
1. [Module Conventions](#module-conventions)
2023-02-18 04:34:40 +01:00
## Overview
2023-02-20 14:41:33 +01:00
Ona is a straightforward game engine with the aim of staying reasonably lightweight through a modular architecture.
2023-02-18 04:34:40 +01:00
Ona is also the Catalan word for "wave".
## Goals
* Fully-featured two-dimensional raster and vector-derived rendering capabilities.
* Support major computer gaming ecosystems; Namely Microsoft Windows, SteamOS, and GNU Linux systems running on X11 or Wayland.
* Avoid shipping external dependencies beyond the executible itself.
* Be lightweight in base engine memory usage and disk size.
2023-02-20 14:41:33 +01:00
* Provide a simple scene graph system that translates graph nodes into a cache-friendly representation at runtime.
2023-02-18 04:34:40 +01:00
* Provide an execution-speed optimized scripting interface through a Lua-inspired language named "Kym", with features like first-class support for common mathematic types used in rendering.
* One data serialization and configuration system to rule them all backed by the Kym scripting language.
* Opt-in overhead via a native C plug-in interface that allows for systems-level programmers to easily extend engine-level functionality and scripting language library tools.
## Technical Details
### Requirements
Ona currently depends the following third-party tools to build it:
2023-02-18 14:34:20 +01:00
* Clang / LLVM toolchain with full C++20 support or above.
2023-02-18 04:34:40 +01:00
* Python interpreter version 3.10 or above.
Additionally, Ona depends on the following third-party system-wide dependencies:
* SDL2 version 2.0.20 or above.
As the project evolves, dependencies on libraries external to the project codebase will be minimized or removed outright to meet the goals of the project as closely as possible.
### Building
Once all third-party tools and system-wide dependencies are satisfied, navigate to the root project folder and run the `./build.py` Python build script.
By default, the build script will build the engine runtime, required for running games built with Ona, in release-debug mode.
### Project Structure
As Ona uses C++20, it is able to make use of the new modules language feature. While this brings with it a number of drawbacks, like a lack of widescale vendor adoption, it also provides some key benefits.
#### No Headers
2023-02-20 14:41:33 +01:00
A core benefit to the project, and the one which weighed most on this decision, is that all first-party code is free of header usage. Code is grouped in a module and package dichotomy, where each `.cpp` file in the root source directory represents the common package of a module grouping.
2023-02-18 04:34:40 +01:00
2023-02-20 14:41:33 +01:00
Alongside the surface-level benefit of writing having fewer lines of code, this also means there is less work necessary to maintain the codebase at large and a smaller space to create duplication errors in.
2023-02-18 04:34:40 +01:00
2023-02-20 14:41:33 +01:00
#### Module Conventions
2023-02-18 04:34:40 +01:00
2023-02-20 14:41:33 +01:00
The standard is loose on how modules are named and structured, so this codebase enforces its own convention of a package-like structure.
2023-02-18 04:34:40 +01:00
2023-02-20 14:41:33 +01:00
At the source root-level, each `.cpp` file contained represents the core module of each respective library. Higher-level extensions of the core library that do not cyclically depend on each other reside within folders that share a matching name (sans the extension). For example, the `coral.cpp` source file contains many common memory manipulation and floating point mathematics utilities, which are made use of in `coral/image.cpp` for modifying CPU-bound pixel data.
Each module tries to manage a responsibility of the overall project while also not introducing too many inter-dependencies in each other.
##### Coral
Common operating system-independent memory, math, and data structure utilities for use in all other first-party library modules.
##### Oar
The (O)na (Ar)chive format; a non-compressing data bundling format optimized for quick I/O operations and resolving the problem of having free-standing asset files complicating the cross-platform application distribution process.
##### App
Operating system-abstracted interface for building graphical and headless applications.
##### Kym
Scripting language designed around an execution speed-optimized design, and features like first-class support for common mathematic types.
##### Runtime
Base execution environment for games built using Ona.