ttfGetFontFamilyName function

String? ttfGetFontFamilyName(Pointer<TtfFont> font)

Query a font's family name.

This string is dictated by the contents of the font file.

Note that the returned string is to internal storage, and should not be modified or free'd by the caller. The string becomes invalid, with the rest of the font, when font is handed to TTF_CloseFont().

\param font the font to query. \returns the font's family name.

\threadsafety It is safe to call this function from any thread.

\since This function is available since SDL_ttf 3.0.0.

extern SDL_DECLSPEC const char * SDLCALL TTF_GetFontFamilyName(const TTF_Font *font)

Implementation

String? ttfGetFontFamilyName(Pointer<TtfFont> font) {
  final ttfGetFontFamilyNameLookupFunction = libSdl3Ttf.lookupFunction<
      Pointer<Utf8> Function(Pointer<TtfFont> font),
      Pointer<Utf8> Function(Pointer<TtfFont> font)>('TTF_GetFontFamilyName');
  final result = ttfGetFontFamilyNameLookupFunction(font);
  if (result == nullptr) {
    return null;
  }
  return result.toDartString();
}