mface_put_prop(3m17n)

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

💖 mface_put_prop — bestie edition 💖

okay so this is mface_put_prop(3m17n), a lil function from the m17n Library manual, and honestly? it's giving "setter but make it fashion". sit down, grab a boba, we're doing this 🧋✨

✨ NAME ✨

mface_put_prop — bestie, it sets a value of a face property. that's the whole vibe.

✨ SYNOPSIS ✨

int mface_put_prop (MFace * face, MSymbol key, void * val)

like. three args. in, key, out. we love a clean signature 🎀

✨ DESCRIPTION ✨

so the mface_put_prop() function assigns val to the property whose key is key in face face. that's it, that's the whole job. main character behavior, no notes 👑

but wait — key isn't just anything you feel like typing, bestie. it must be one of the followings, no cap:

  • #Mforeground
  • #Mbackground
  • #Mvideomode
  • #Mhline
  • #Mbox
  • #Mfoundry
  • #Mfamily
  • #Mweight
  • #Mstyle
  • #Mstretch
  • #Madstyle
  • #Msize
  • #Mfontset
  • #Mratio
  • #Mhook_func
  • #Mhook_arg

sixteen keys. not fifteen, not seventeen. we respect the list 💅

now here's the tea: among them, the font related properties — that's Mfoundry through Msize — are used as the default values when a font in the fontset of face does not specify those values. so they're like the backup dancers that step in when the main act doesn't show. iconic, honestly. 🌟

and the actual type of the returned value depends of key. so, like, don't assume. check the documentation of the above keys, iykyk. 🔍

✨ RETURN VALUE ✨

  • if the operation was successful, mface_put_prop() returns 0. slay. ✨
  • otherwise it returns -1 and assigns an error code to the external variable merror_code. and that's on periodt. 💀

✨ SEE ALSO ✨

  • mface_get_prop() — the getter to this setter. they're a matching set, fr fr 🫶

✨ ERRORS ✨

  • MERROR_FACE

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

ngl, the licence is real and the permissions are real, so pls treat them with the respect they deserve 🙈

and that's the page, bestie!! this was Version 1.8.4, dated Mon Sep 25 2023. thanks for reading, ily, go set some face properties 💖🌸🦋🎀

📦 where this page comes from