Export generated fonts to their own folder

Author: LocalIdentity

.gitignore

@@ -8,8 +8,10 @@ Release/
 x64/
 x86/
 ipch/
+Generated Fonts/
 
 # Compiled binaries and intermediates
+*.exe
 *.dll
 *.lib
 *.obj

README.md

@@ -0,0 +1,37 @@
+# Path of Building Font Generator
+
+This utility builds bitmap fonts used by the Path of Building Community fork. It wraps Windows GDI font rendering into a standalone Win32 application that packs glyphs into `.tga` atlases and emits metadata consumed by the main tool.
+
+## Prerequisites
+- Visual Studio 2022 (v143 toolset) with the Desktop development with C++ workload
+- Windows 10 SDK (10.0 or newer)
+
+## Building
+1. Open `GLFontGen.sln` in Visual Studio.
+2. Select the desired configuration (`Release` is recommended for distributing fonts).
+3. Build the solution (`Build > Build Solution`).
+
+The resulting executable (`GLFontGen.exe`) stays local to your build environment; it is intentionally not checked into source control.
+
+## Usage
+1. Run `GLFontGen.exe`.
+2. Pick a font face, weight, and whether to force fixed pitch.
+3. Select the font sizes you want to export.
+4. Click **Generate**.
+
+Outputs are written to `Generated Fonts/` beside the executable:
+
+- One `.tga` atlas per selected point size (e.g. `Consolas.16.tga`).
+- A single `.tgf` metadata file with layout information for every generated height.
+
+## Output Format
+- **TGA**: 32-bit BGRA image containing packed glyphs with premultiplied alpha. Dimensions are powers of two chosen to fit the selected glyph set.
+- **TGF metadata**:
+  - Each font size starts with `HEIGHT <px>;`.
+  - Every glyph line follows `GLYPH <x> <y> <width> <left> <right>` with optional ASCII comment.
+  - `x`/`y` are the glyph origin inside the atlas, `width` is the advance width in pixels, and `left`/`right` provide side bearings.
+
+Refer to `fontgen.cpp` if you need deeper details or want to extend the format.
+
+## License
+Released under the MIT License (see `LICENSE`).

fontgen.cpp

@@ -7,9 +7,11 @@
 
 #include <algorithm>
 #include <array>
+#include <filesystem>
 #include <fstream>
 #include <iomanip>
 #include <sstream>
+#include <system_error>
 #include <string>
 #include <string_view>
 #include <vector>
@@ -61,12 +63,16 @@ class glFontGenV2_c {
 
 private:
 	std::string fontName;
+	std::filesystem::path outputDir;
 	std::vector< fontHeight_s > heights;
 };
 
 void glFontGenV2_c::Init(const std::string_view i_fontName)
 {
 	fontName = i_fontName;
+	outputDir = std::filesystem::path("Generated Fonts");
+	std::error_code ec;
+	std::filesystem::create_directories(outputDir, ec);
 }
 
 void glFontGenV2_c::Build(HDC hdc)
@@ -177,9 +183,10 @@ void glFontGenV2_c::Build(HDC hdc)
 	}
 
 	// Open image file for writing
-	std::stringstream tgaName;
+	std::ostringstream tgaName;
 	tgaName << fontName << "." << height << ".tga";
-	std::ofstream out(tgaName.str(), std::ios_base::binary);
+	const auto tgaPath = outputDir / tgaName.str();
+	std::ofstream out(tgaPath, std::ios_base::binary);
 	if (!out) {
 		return;
 	}
@@ -273,7 +280,8 @@ void glFontGenV2_c::Build(HDC hdc)
 void glFontGenV2_c::Finish()
 {
 	// Open info file for writing
-	std::ofstream tgf(fontName + ".tgf");
+	const auto tgfPath = outputDir / (fontName + ".tgf");
+	std::ofstream tgf(tgfPath);
 	if (!tgf) {
 		return;
 	}