mfont_parse_name(3m17n)

📦
version 1.8.4 · 2 versions
, in debian trixie, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

mfont_parse_name 💖

okay bestie, welcome to the mfont_parse_name page from the The m17n Library manual — she's a tiny function with big main character energy ✨

✨ NAME ✨

mfont_parse_name — the one that takes a font name (a string, a little text vibe) and hands you back an actual font object 🎀 no cap, that's the whole plot.

🌸 SYNOPSIS 🌸

MFont* mfont_parse_name (const char * name, MSymbol format)

🦋 DESCRIPTION 🦋

so here's the tea, bestie: mfont_parse_name() creates a new font object. That's it, that's the job 💅 The properties get pulled out of the fontname — like, name is where the good stuff lives, and this function goes in and extracts all the properties from it. obsessed.

the format argument tells it how to read name, and it's giving three whole moods:

  • if format is Mx — name gets parsed as XLFD (that's X Logical Font Description, the classic one 👑)
  • if format is Mfontconfig — name gets parsed as Fontconfig's textual representation of a font 🌈
  • if format is Mnil — it tries name as XLFD first, and if that fails, it falls back to parsing it as Fontconfig's representation. literally the "try again bestie" option 🙈

💜 RETURN VALUE 💜

if the operation was successful, this function returns a pointer to the created font 🫶

otherwise? it returns NULL. yeah. 💀

Copyright (C) 2001 Information-technology Promotion Agency (IPA)

Copyright (C) 2001-2011 National Institute of Advanced Industrial Science and Technology (AIST)

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License <http://www.gnu.org/licenses/fdl.html>.

and that's the whole page, bestie — Version 1.8.4, dated Mon Sep 25 2023, signed off with love from the m17n crew 🧚‍♀️ slay, go parse some font names, periodt 💖✨

📦 where this page comes from