blah/README.md

52 lines
1.7 KiB
Markdown
Raw Normal View History

2022-02-10 15:48:05 +08:00
## blah
A small 2D C++ Game Framework, using few dependencies and simple code to maintain easy building and portability.
**☆ This will likely see breaking changes! Use at your own risk! ☆**
#### a sample application
```cpp
#include <blah.h>
using namespace Blah;
Batch batch;
int main()
{
2022-02-10 15:48:05 +08:00
Config config;
config.name = "blah app";
config.on_render = []()
{
2022-11-23 14:52:34 +08:00
auto target = App::backbuffer();
target->clear(Color::black);
2022-02-10 15:48:05 +08:00
2022-11-23 14:52:34 +08:00
auto center = Vec2f(target->width(), target->height()) / 2;
2022-02-10 15:48:05 +08:00
auto rotation = Time::seconds * Calc::TAU;
auto transform = Mat3x2f::create_transform(center, Vec2f::zero, Vec2f::one, rotation);
batch.push_matrix(transform);
batch.rect(Rectf(-32, -32, 64, 64), Color::red);
batch.pop_matrix();
2022-11-23 14:52:34 +08:00
batch.render(target);
2022-02-10 15:48:05 +08:00
batch.clear();
};
2022-11-23 14:52:34 +08:00
return App::run(&config);
}
```
2022-02-10 15:48:05 +08:00
#### building
- Requires C++17 and CMake 3.14+
- At least one **Renderer** implementation must be enabled in CMake:
2023-04-27 23:07:48 +08:00
- [OpenGL](https://github.com/NoelFB/blah/blob/master/src/internal/blah_renderer_opengl.cpp) (Default on Linux/macOS) `BLAH_RENDERER_OPENGL`
- [D3D11](https://github.com/NoelFB/blah/blob/master/src/internal/blah_renderer_d3d11.cpp) (Default on Windows) `BLAH_RENDERER_D3D11`
- Additional renderers can be added by implementing the [Renderer Backend](https://github.com/NoelFB/blah/blob/master/src/internal/blah_renderer.h)
2022-02-10 15:48:05 +08:00
#### notes
2022-02-11 04:26:47 +08:00
- There's no Shader abstraction, so you need to swap between GLSL/HLSL depending on the Renderer.
2022-02-10 15:48:05 +08:00
- Only floatN/mat3x2/mat4x4 uniforms are supported.
2023-04-27 23:07:48 +08:00
- No threaded rendering, so it will explode if you try that.
2022-11-23 14:52:34 +08:00