mdraw_per_char_extents(3m17n)

🌸 mdraw_per_char_extents — m17n Library, section 3m17n 🌸

okay bestie, gather round, because we're about to get extremely cozy with the m17n Library's little per-character measuring machine 💖 no cap, it's lowkey the moment your text gets measured letter by letter and honestly? it's giving meticulous. ✨

---

✨ NAME ✨

mdraw_per_char_extents — it's the function that does the thing 🎀 (and yes, the original NAME section literally just leaves it at the dash, so we're keeping that energy 💅)

---

🦋 SYNOPSIS 🦋

void mdraw_per_char_extents (MFrame * frame, MText * mt, MDrawMetric *
array_return, MDrawMetric * overall_return)

that's the whole vibe. four args, no return value, just pure measurement main character energy 👑

---

💜 DESCRIPTION 💜

Obtain per character dimension information. Periodt. That's the whole job description.

So here's the tea 🍵 — mdraw_per_char_extents() computes the text dimension of each character in the M-text mt. The faces given as text properties in mt and the default face of frame frame determine the fonts to draw the text. iykyk, the frame matters. 🫶

Then each successive element in array_return gets set to the drawn metrics of successive characters — and that's relative to the origin of the drawing, plus a rectangle for each character in mt. literally every single character gets its own lil rectangle. iconic. ✨

⚠️ bestie, listen — the number of elements of array_return must be equal to or greater than the number of characters in mt. Not less. Never less. Do not play with this. 💀

And if the pointer overall_return is not NULL, this function also computes the extents of the overall text and stores the results in the members of the structure pointed to by overall_return. So you get the whole squad's total, not just the individuals. ate. 🔥

---

🎀 COPYRIGHT 🎀

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>. 💖

---

okay that's the whole page, no notes 💅 Version 1.8.4, dated Mon Sep 25 2023 — mwah, love u, go measure some characters bestie 🌈⭐💜