Added TTF_SetFontLineSkip()

Fixes libsdl-org#353
slouken · Sep 27, 2024 · b229fa3 · b229fa3
1 parent 105a69d
commit b229fa3
Show file tree

Hide file tree

Showing 3 changed files with 21 additions and 1 deletion.
diff --git a/include/SDL3_ttf/SDL_ttf.h b/include/SDL3_ttf/SDL_ttf.h
@@ -511,7 +511,7 @@ extern SDL_DECLSPEC int SDLCALL TTF_GetFontAscent(const TTF_Font *font);
 extern SDL_DECLSPEC int SDLCALL TTF_GetFontDescent(const TTF_Font *font);
 
 /**
- * Query the recommended spacing between lines of text for a font.
+ * Query the spacing between lines of text for a font.
  *
  * \param font the font to query.
  * \returns the font's recommended spacing.
@@ -522,6 +522,18 @@ extern SDL_DECLSPEC int SDLCALL TTF_GetFontDescent(const TTF_Font *font);
  */
 extern SDL_DECLSPEC int SDLCALL TTF_GetFontLineSkip(const TTF_Font *font);
 
+/**
+ * Set the spacing between lines of text for a font.
+ *
+ * \param font the font to modify.
+ * \param lineskip the new line spacing for the font.
+ *
+ * \threadsafety This function should be called on the thread that created the font.
+ *
+ * \since This function is available since SDL_ttf 3.0.0.
+ */
+extern SDL_DECLSPEC void SDLCALL TTF_SetFontLineSkip(TTF_Font *font, int lineskip);
+
 /**
  * Query whether or not kerning is enabled for a font.
  *

diff --git a/src/SDL_ttf.c b/src/SDL_ttf.c
@@ -2788,6 +2788,13 @@ int TTF_GetFontLineSkip(const TTF_Font *font)
     return font->lineskip;
 }
 
+void TTF_SetFontLineSkip(TTF_Font *font, int lineskip)
+{
+    TTF_CHECK_FONT(font,);
+
+    font->lineskip = lineskip;
+}
+
 bool TTF_GetFontKerning(const TTF_Font *font)
 {
     TTF_CHECK_FONT(font, false);

diff --git a/src/SDL_ttf.sym b/src/SDL_ttf.sym
@@ -43,6 +43,7 @@ SDL3_ttf_0.0.0 {
     TTF_SetFontHinting;
     TTF_SetFontKerning;
     TTF_SetFontLanguage;
+    TTF_SetFontLineSkip;
     TTF_SetFontOutline;
     TTF_SetFontSDF;
     TTF_SetFontScriptName;