minput_set_spot(3m17n)

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

💅 minput_set_spot — from the m17n library, section 3m17n

okay bestie, gather round, because this one is short but it's important 🫶

✨ NAME ✨

minput_set_spot -

(yeah, the dash is just... sitting there. no lil blurb. the manpage said what it said and left the rest to the DESCRIPTION. we respect that 🙈)

🎀 SYNOPSIS 🎀

void minput_set_spot (MInputContext * ic, int x, int y, int ascent, int
       descent, int fontsize, MText * mt, int pos)

look at her. eight parameters. main character energy fr fr 👑

🌸 DESCRIPTION 🌸

so basically this function sets the spot of the input context. that's the whole vibe. ✨

minput_set_spot() sets the spot of input context ic to the coordinate (x, y) with the height specified by ascent and descent.

now here's the tea ☕ — the semantics of these values depends on the input method driver. like, it's not one-size-fits-all, bestie. each driver gets to decide what these numbers mean. iykyk.

for instance:

  • a driver designed to work in a CUI environment may use x and y as the column- and row numbers, and may ignore ascent and descent. literally just... ignoring them. iconic behaviour honestly 💀
  • a driver designed to work in a window system may interpret x and y as the pixel offsets relative to the origin of the client window, and may interpret ascent and descent as the ascent- and descent pixels of the line at (x, y).

fontsize specifies the fontsize of preedit text in 1/10 point. yes, tenths. not points. tenths of a point. keep up 🎀

mt and pos are the M-text and the character position at the spot.

and listen — mt may be NULL. if it is, the input method cannot get information about the text around the spot. no text context for you, babe. that's just how it is 😭

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!! 💖✨🦋

this was Version 1.8.4, dated Mon Sep 25 2023, living its best life in the m17n library as minput_set_spot(3m17n). slay, go set some spots, mwah 💅🌸🍓

📦 where this page comes from