Add LoadCodepoints bindings (#428)

* Add LoadCodepoints bindings

* Add codepoint docs, tests and exports

Author: RobLoach

include/Font.hpp

@@ -63,6 +63,20 @@ class Font : public FontUnmanaged {
         FontUnmanaged::Load(fileName, fontSize, codepoints, codepointCount);
     }
 
+    /**
+     * Loads a font from a given file, with the given codepoints.
+     *
+     * @param fileName The file path of the font to load.
+     * @param fontSize The desired size of the loaded font.
+     * @param codepoints The codepoints to generate glyphs for.
+     *
+     * @throws raylib::RaylibException Throws if the given font failed to initialize.
+     */
+    void Load(const std::string& fileName, int fontSize, const std::vector<int>& codepoints) {
+        Unload();
+        FontUnmanaged::Load(fileName, fontSize, codepoints);
+    }
+
     void Load(const ::Image& image, ::Color key, int firstChar) {
         Unload();
         FontUnmanaged::Load(image, key, firstChar);

include/FontUnmanaged.hpp

@@ -2,6 +2,7 @@
 #define RAYLIB_CPP_INCLUDE_FONTUNMANAGED_HPP_
 
 #include <string>
+#include <vector>
 
 #include "./RaylibException.hpp"
 #include "./TextureUnmanaged.hpp"
@@ -55,6 +56,19 @@ class FontUnmanaged : public ::Font {
         Load(fileName, fontSize, codepoints, codepointCount);
     }
 
+    /**
+     * Loads a Font from the given file, with the given codepoints.
+     *
+     * @param fileName The file path of the font to load.
+     * @param fontSize The desired size of the loaded font.
+     * @param codepoints The codepoints to generate glyphs for.
+     *
+     * @throws raylib::RaylibException Throws if the given font failed to initialize.
+     */
+    FontUnmanaged(const std::string& fileName, int fontSize, const std::vector<int>& codepoints) {
+        Load(fileName, fontSize, codepoints);
+    }
+
     /**
      * Loads a Font from the given image with a color key.
      *
@@ -123,6 +137,19 @@ class FontUnmanaged : public ::Font {
         }
     }
 
+    /**
+     * Loads a font from a given file, with the given codepoints.
+     *
+     * @param fileName The file path of the font to load.
+     * @param fontSize The desired size of the loaded font.
+     * @param codepoints The codepoints to generate glyphs for.
+     *
+     * @throws raylib::RaylibException Throws if the given font failed to initialize.
+     */
+    void Load(const std::string& fileName, int fontSize, const std::vector<int>& codepoints) {
+        Load(fileName, fontSize, codepoints.data(), static_cast<int>(codepoints.size()));
+    }
+
     /**
      * Loads a font from an image with a color key.
      *

include/Functions.hpp

@@ -445,6 +445,35 @@ RLCPP_MAYBEUNUSED RLCPPAPI inline std::string TextToCamel(const std::string& tex
     return ::TextToCamel(text.c_str());
 }
 
+/**
+ * Load all codepoints from a UTF-8 text string
+ *
+ * @param text The UTF-8 encoded text to load the codepoints from.
+ *
+ * @return The codepoints that were found in the given text.
+ */
+RLCPP_MAYBEUNUSED RLCPPAPI std::vector<int> LoadCodepoints(const std::string& text) {
+    int count = 0;
+    int* codepoints = ::LoadCodepoints(text.c_str(), &count);
+    if (codepoints != NULL) {
+        std::vector<int> output(codepoints, codepoints + count);
+        ::UnloadCodepoints(codepoints);
+        return output;
+    }
+    return std::vector<int>();
+}
+
+/**
+ * Get total number of codepoints in a UTF-8 encoded string
+ *
+ * @param text The UTF-8 encoded text to count the codepoints of.
+ *
+ * @return The total number of codepoints in the given text.
+ */
+RLCPP_MAYBEUNUSED RLCPPAPI inline int GetCodepointCount(const std::string& text) {
+    return ::GetCodepointCount(text.c_str());
+}
+
 /**
  * Get integer value from text (negative values not supported)
  */

modules/raylib.cppm

@@ -132,6 +132,7 @@ using raylib::GetDirectoryPath;
 using raylib::GetPrevDirectoryPath;
 using raylib::GetWorkingDirectory;
 using raylib::LoadDirectoryFiles;
+using raylib::LoadDirectoryFilesEx;
 using raylib::ChangeDirectory;
 using raylib::LoadDroppedFiles;
 using raylib::GetFileModTime;
@@ -158,7 +159,12 @@ using raylib::TextFindIndex;
 using raylib::TextToUpper;
 using raylib::TextToLower;
 using raylib::TextToPascal;
+using raylib::TextToSnake;
+using raylib::TextToCamel;
+using raylib::LoadCodepoints;
+using raylib::GetCodepointCount;
 using raylib::TextToInteger;
+using raylib::TextToFloat;
 
 /**
  * @namespace raylib::Colors

tests/raylib_cpp_test.cpp

@@ -125,6 +125,33 @@ int main(int argc, char* argv[]) {
         AssertEqual(output[1], "How");
     }
 
+    // raylib::GetCodepointCount() and raylib::LoadCodepoints()
+    {
+        // ASCII text has one codepoint per byte.
+        std::string ascii = "Hello";
+        AssertEqual(raylib::GetCodepointCount(ascii), 5);
+
+        std::vector<int> asciiCodepoints = raylib::LoadCodepoints(ascii);
+        AssertEqual(static_cast<int>(asciiCodepoints.size()), raylib::GetCodepointCount(ascii));
+        AssertEqual(asciiCodepoints[0], static_cast<int>('H'));
+        AssertEqual(asciiCodepoints[4], static_cast<int>('o'));
+
+        // Multi-byte UTF-8 text holds fewer codepoints than bytes: "a", U+00E9 and U+20AC.
+        std::string utf8 = "a\xC3\xA9\xE2\x82\xAC";
+        AssertEqual(static_cast<int>(utf8.size()), 6);
+        AssertEqual(raylib::GetCodepointCount(utf8), 3);
+
+        std::vector<int> utf8Codepoints = raylib::LoadCodepoints(utf8);
+        AssertEqual(static_cast<int>(utf8Codepoints.size()), raylib::GetCodepointCount(utf8));
+        AssertEqual(utf8Codepoints[0], 0x61);
+        AssertEqual(utf8Codepoints[1], 0xE9);
+        AssertEqual(utf8Codepoints[2], 0x20AC);
+
+        // An empty string holds no codepoints.
+        AssertEqual(raylib::GetCodepointCount(""), 0);
+        AssertEqual(static_cast<int>(raylib::LoadCodepoints("").size()), 0);
+    }
+
     // Wave
     {
         raylib::Wave wave(path + "/resources/weird.wav");