Turbo Game Engine (Leadwerks 5) beta updated

Entry posted by Josh · June 21, 2019

2,145 views

A new beta update is available for subscribers. What's new?

Lighting
Point and spot lights are now supported in the new Vulkan renderer, with either PBR or Blinn-Phong lighting. Lighting is controlled by the shader in the material file. There are two main shaders you can use, "Shaders/PBR.spv" and "Shaders/Blinn-Phong.spv". See below for more details.

JSON Materials

Materials can now be loaded from JSON files. I am currently using the .json file extension instead of "mat", "mtl", or something else. If you load a scene and a JSON file is available with the same name as a material in that scene, the material will be loaded from a JSON file instead of the Leadwerks 4 .mat files. For example, you can create a JSON file named "brick01.json", place it in the same folder as "brick01.mat" and the new engine will load the JSON material if the brick material is used in a scene. However, it is not necessary to do this as the engine can also load Leadwerks 4 material files.

A Turbo JSON material file looks like this. The string tokens are more or less locked in now and it is safe to start using them.

{
	"turboMaterialDef": {
		"color": [ 1, 1, 1, 1 ],
		"emission": [ 0, 0, 0 ],
		"metallic": 0,
		"roughness": 0.6,
		"doubleSided": false,
		"blend": false,
		"albedoMap": "./concrete_clean_diff.tex",
		"normalMap": "./concrete_clean_dot3.tex",
		"metallicRoughnessMap": "",
		"emissionMap": "",
		"baseShader": "Shaders/PBR.spv",
		"shadowShader": "Shaders/Shadow.spv",
		"depthShader": "Shaders/DepthPass.spv"
	}
}

You can also indicate a shader for the new engine to use in an old Leadwerks 4 material file by adding a text line like this to the .mat file:

baseshader="Shaders/myshader.spv"

You do not need to specify a shader unless you are using a custom shader. JSON material files, by default, will use the PBR shader. Leadwerks 4 material files, by default, will use the Blinn-Phong shader.

BC5 / BC7 Texture Compression
A ton of new compression formats have been added, including the BC7 and BC5 formats, which provide better quality than DXT compression. Visual Studio 2019 actually has some good built-in DDS tools, although the BC7 compressor Is very slow. A sample material is provided using DDS textures (see "Materials/Rough-rockface1.json").

Lua Commands
A set of simple global Lua commands has been added.

template<typename T>
void LuaSetGlobal(const std::string& name, T var)

template<typename T>
void LuaPushObject(const std::string& name, T var)

template<typename T>
T LuaToObject(const int index = -1)

int LuaCollectGarbage(const int what = LUA_GCCOLLECT, const int data = 0);
void LuaPushString(const std::string& s);
void LuaPushNumber(const double n);
void LuaPushBoolean(const bool b);
void LuaPushNil();
void LuaPushValue(const int index = -1);
bool LuaIsTable(const int index = -1);
bool LuaIsNumber(const int index = -1);
bool LuaIsString(const int index = -1);
bool LuaIsBoolean(const int index = -1);
bool LuaIsObject(const int index = -1);
bool LuaIsNil(const int index = -1);
bool LuaIsFunction(const int index = -1);
bool LuaToBoolean(const int index = -1);
std::string LuaToString(const int index = -1);
double LuaToNumber(const int index = -1);
int LuaType(const int index = -1);
int LuaGetField(const std::string& name, const int index = -1);
int LuaGetTable(const std::string& name, const int index = -1);
int LuaGetGlobal(const std::string& name);
void LuaSetField(const std::string& name, const int index = -1);
void LuaSetTable(const int index = -1);
void LuaPop(const int levels = 1);
void LuaRemove(const int index = -1);
void LuaSetStackSize(const int sz);
int LuaGetStackSize();
void LuaNewTable();

This makes our code simpler and more readable:

#include "Turbo.h"

using namespace Turbo;

int main(int argc, const char *argv[])
{
	//Create a window
	auto window = CreateWindow("MyGame", 0, 0, 1280, 720);
	
	//Create a rendering context
	auto context = CreateContext(window);

	//Set some variables in the script environment
	LuaSetGlobal("mainwindow", window);
	LuaSetGlobal("maincontext", context);

	//Create the world
	auto world = CreateWorld();

	//Load a scene
	auto scene = LoadScene(world, "Maps/start.map");

	//Show off a PBR material
	auto sphere = CreateSphere(world);
	auto mtl = LoadMaterial("Materials/Rough-rockface1.json");
	sphere->SetMaterial(mtl);
	sphere->Move(0, 1, 0);
	sphere->SetScale(2);

	while (window->KeyHit(KEY_ESCAPE) == false and window->Closed() == false)
	{
		world->Update();
		world->Render(context);
	}
	return 0;
}