README.md

Ash Engine

Ash Engine is a cross-platform 3D engine (only for learning purpose) based on Qt, OpenGL and Assimp.

Screenshots

Requirements

Windows 7 x64 or newer, macOS 10.12 or newer, or Ubuntu 16.04
A graphics card that supports OpenGL 3.3+

Features

Friendly, simple and convenient GUI.
Readable, clear code structure which is easy to expand.
Supports reading and saving 3D model files in 40+ formats, including FBX, DXF, Collada, Obj, X, PLY, 3DS, etc.
Supports reading and saving the entire project (using the file type *.aeproj defined by this engine)
Uses tree structure to describe the scene, supports basic transformation (translation, rotation, scaling) on model and mesh.
Supports diffuse maps, specular maps, and normal maps.
Supports ambient light, directional light, point light, and spotlight. You can create not more than 8 lights of each type. For each light, you can adjust its color, position, and many other properties.

User Manual

Basic User Manuals

The basic user manuals describe the structure and usage of Ash Engine.

Basic User Manual (English)

Basic User Manual (Chinese)

Advanced User Manuals

The advanced user manuals cover the implementation of custom functions using API provided by Ash Engine. This requires the user to be familiar with C++ object-oriented programming and some Qt classes (such as QVector3D).

Note: Read the basic manuals first before you start to read any advanced manual.