/embed-resource

Embed binary or resource files (eg textures or GLSL shader files) in CPP using C++11.

Primary LanguageC++Do What The F*ck You Want To Public LicenseWTFPL

Embed Resource

This fork requires C++17.

Embed binary files and resources (such as GLSL Shader source files) into C++ projects.

Include this repository in your CMake based project:

git submodule add https://github.com/cyrilcode/embed-resource.git lib/ embed-resource

Then add to your CMakeLists.txt for your project:

include_directories(lib/embed-resource)
add_subdirectory(lib/embed-resource)

Now you can add your resources, by calling the provided embed_resources() function in your CMakeLists.txt file. In this fork you have to choose a name after the path (e.g. to avoid name collisions with the same file names from different directories):

embed_resources(MyResources 
    shaders/vertex.glsl shader
    shaders/frag.glsl shader
    )

Then link to your binary by adding the created variable to your add_executable statement:

add_executable(MyApp ${SOURCE_FILES} ${MyResources})

In your C++ project you can access your embed resources using the Resource class provided in Resource.h. Here's an example:

#include <iostream>
using namespace std;

#include "Resource.h"

int main() {

    Resource text = LOAD_RESOURCE(frag_shader);
    cout << string(text.data(), text.size()) << endl;

    return EXIT_SUCCESS;
}

NB: In this fork to reference the file, use the the chosen name and the file name without extensions (- will be replaced with an underscore _). So, in this example, the symbol name is frag_shader.

Credits...

This uses ideas from this blog post which included the Resource class and macro idea. Unfortunately, the use of ld command didn't work on OSX. So, instead, I've used a simple C++ executable that does the same conversion, based on ideas from this Stack Overflow question.

License

Public Domain / WTFPL