First Commit

3rdparty/plutosvg/README.md

@@ -0,0 +1,87 @@
+![emoji-collection.png](https://github.com/user-attachments/assets/a5de9b70-39a8-4a15-a012-22ab3cb93054)
+
+# PlutoSVG
+
+PlutoSVG is a compact and efficient SVG rendering library written in C. It is specifically designed for parsing and rendering SVG documents embedded in OpenType fonts, providing an optimal balance between speed and minimal memory usage. It is also suitable for rendering scalable icons.
+
+## Basic Usage
+
+```c
+#include <plutosvg.h>
+
+#include <stdio.h>
+
+int main(void)
+{
+    plutosvg_document_t* document = plutosvg_document_load_from_file("camera.svg", -1, -1);
+    if(document == NULL) {
+        printf("Unable to load: camera.svg\n");
+        return -1;
+    }
+
+    plutovg_surface_t* surface = plutosvg_document_render_to_surface(document, NULL, -1, -1, NULL, NULL, NULL);
+    plutovg_surface_write_to_png(surface, "camera.png");
+    plutosvg_document_destroy(document);
+    plutovg_surface_destroy(surface);
+    return 0;
+}
+```
+
+![camera.png](https://github.com/sammycage/plutosvg/blob/master/camera.png)
+
+## Integrating with FreeType
+
+```c
+#include <plutosvg-ft.h>
+
+#include <ft2build.h>
+#include FT_FREETYPE_H
+#include FT_MODULE_H
+
+int main(void)
+{
+    FT_Library library;
+
+    // Initialize the FreeType library
+    if(FT_Init_FreeType(&library)) {
+        // Handle error
+        return -1;
+    }
+
+    // Set PlutoSVG hooks for the SVG module
+    if(FT_Property_Set(library, "ot-svg", "svg-hooks", &plutosvg_ft_hooks)) {
+        // Handle error
+        return -1;
+    }
+
+    // Your code here
+
+    // Clean up
+    FT_Done_FreeType(library);
+    return 0;
+}
+```
+
+## Installation
+
+Follow the steps below to install PlutoSVG using either [Meson](https://mesonbuild.com/) or [CMake](https://cmake.org/).
+
+### Using Meson
+
+```bash
+git clone https://github.com/sammycage/plutosvg.git
+cd plutosvg
+meson setup build
+meson compile -C build
+meson install -C build
+```
+
+### Using CMake
+
+```bash
+git clone --recursive https://github.com/sammycage/plutosvg.git
+cd plutosvg
+cmake -B build .
+cmake --build build
+cmake --install build
+```