msdf-atlas-gen-builder

This repository uses Github Actions to self-build Viktor Chlumský's msdf-atlas-gen upon triggering a workflow.

This work is unofficial. If you are new to msdf-atlas-gen, please refer to the official distribution.

This repository is not meant to be an alternative release source, and therefore we will not propose pre-built binaries in the release section (and we made the build artifacts to expire almost instantly).

The reason is that we do not wish to be an alternative source of binaries, and we want to encourage users to either build their own, or to download binaries only from official sources (for security reason, never trust alternative distributions or .dll files downloaded from random websites).

Why?

This repository provides a build system and binaries for PizzaGameKit. It mostly aims at being self-sufficient and having our own mirrors, without the need to fetch any online dependencies.

No source change is made. Current target version is msdf-atlas-gen 1.3

There's a few build system differences to better fit the needs of PizzaGameKit:

• No online dependency or need for vcpkg;
• No support for Artery font format export;
• No support for Skia, hence some SVG import will be broken (but we don't care because we only work with correctly shaped ttf/otf);
• No support for WOFF2 fonts;
• No support for pcf.bz2 fonts;
• Freetype is built without Harfbuzz but that should be unconsequential to msdf-atlas-gen;
• Link all dependencies statically (most notably the VC Runtime on Windows).

This repository builds win-x64, win-arm64, linux-x64, linux-arm64, and osx (as Universal binaries containing both x64 and arm64).

How to use

This repository is meant to be forked, and then the Github Actions workflow should be run. Once completed, the binaries will be available in the workflow artifacts for download.

Alternatively, you can download the repository (make sure to download each submodules as well, and each of their sub-submodules), and run the build scripts corresponding to your system. Binaries will be placed in ./binaries. For troubleshooting, check ./logs.

Requirements

For building Windows:

• Visual Studio with the C++ development workload (of the expected target architecture, i.e. x86.x64 or ARM64);
• PowerShell;
• CMake 3.15 (or newer).

For building Linux:

• Any C++ build system;
• CMake 3.15 (or newer).

For building macOS:

• Any C++ build system (preferably Xcode's);
• CMake 3.15 (or newer).

Licenses

Each submodules abide to their own licenses:

• freetype;
• libpng;
• msdf-atlas-gen;
• zlib;

This very repository does nothing fancy and is just a collection of build scripts. You can consider those scripts as public domain.