LunaSVG is an SVG rendering library in C++, designed to be lightweight and portable, offering efficient rendering and manipulation of Scalable Vector Graphics (SVG) files.

#include <lunasvg.h>

using namespace lunasvg;

int main()
{
    auto document = Document::loadFromFile("tiger.svg");
    if(document == nullptr)
        return -1;
    auto bitmap = document->renderToBitmap();
    if(bitmap.isNull())
        return -1;
    bitmap.writeToPng("tiger.png");
    return 0;
}

LunaSVG supports nearly all graphical features outlined in the SVG 1.1 and SVG 1.2 Tiny specifications. The primary exceptions are animation, filters, and scripts. As LunaSVG is designed for static rendering, animation is unlikely to be supported in the future. However, support for filters may be added. It currently handles a wide variety of elements, including:

<a> <circle> <clipPath> <defs> <ellipse> <g> <image> <line> <linearGradient> <marker> <mask> <path> <pattern> <polygon> <polyline> <radialGradient> <rect> <stop> <style> <svg> <symbol> <text> <tspan> <use>

Follow the steps below to install LunaSVG using either CMake or Meson.

git clone https://github.com/sammycage/lunasvg.git
cd lunasvg
cmake -B build .
cmake --build build
cmake --install build

After installing LunaSVG, you can include the library in your CMake projects using find_package:

find_package(lunasvg REQUIRED)

# Link LunaSVG to your target
target_link_libraries(your_target_name PRIVATE lunasvg::lunasvg)

Alternatively, you can use CMake's FetchContent to include LunaSVG directly in your project without needing to install it first:

include(FetchContent)
FetchContent_Declare(
    lunasvg
    GIT_REPOSITORY https://github.com/sammycage/lunasvg.git
    GIT_TAG master  # Specify the desired branch or tag
)
FetchContent_MakeAvailable(lunasvg)

# Link LunaSVG to your target
target_link_libraries(your_target_name PRIVATE lunasvg::lunasvg)

Replace your_target_name with the name of your executable or library target.

git clone https://github.com/sammycage/lunasvg.git
cd lunasvg
meson setup build
meson compile -C build
meson install -C build

After installing LunaSVG, you can include the library in your Meson projects using the dependency function:

lunasvg_dep = dependency('lunasvg', required: true)

Alternatively, add lunasvg.wrap to your subprojects directory to include LunaSVG directly in your project without needing to install it first. Create a file named lunasvg.wrap with the following content:

[wrap-git]
url = https://github.com/sammycage/lunasvg.git
revision = head
depth = 1

[provide]
lunasvg = lunasvg_dep

You can retrieve the dependency from the wrap fallback with:

lunasvg_dep = dependency('lunasvg', fallback: ['lunasvg', 'lunasvg_dep'])

LunaSVG provides a command-line tool svg2png for converting SVG files to PNG format.

svg2png [filename] [resolution] [bgColor]

$ svg2png input.svg
$ svg2png input.svg 512x512
$ svg2png input.svg 512x512 0xff00ffff

• OpenSiv3D
• PICsimLab
• MoneyManagerEx
• RmlUi
• EKA2L1
• ObEngine
• OTTO
• EmulationStation-DE
• SvgBooga
• Dear ImGui
• Multi Theft Auto: San Andreas
• eScada Solutions
• CARLA Simulator