PLGETCURSOR(3plplot)

πŸ’… PLGETCURSOR β€” bestie edition

ok so this is a page from the PLplot API manual (yes, the whole PLplot API, we're fancy like that ✨) and it's all about plGetCursor. buckle up πŸŽ€


🌸 NAME 🌸

plGetCursor β€” waits for a graphics input event, then translates that into world coordinates. literally that's the whole gig πŸ¦‹


✨ SYNOPSIS ✨

PLINT plGetCursor(gin)

πŸ’– DESCRIPTION πŸ’–

okay so plGetCursor sits there and waits for a graphics input event, then translates it to world coordinates. slay. 🫢

It returns 0 if no translation to world coordinates is possible. like, it tried, it can't, moving on πŸ’€

To be super clear about the return values: this function returns 1 on success, and 0 if no translation to world coordinates is possible. that's the vibe check. πŸ‘‘

Redacted form: plGetCursor(gin)

This function is used in examples 1 and 20. iconic cameos, no cap πŸ”₯


πŸŽ€ ARGUMENTS πŸŽ€

  • gin (PLGraphicsIn(3plplot) *, output) β€” pointer to a PLGraphicsIn(3plplot) structure, and that structure is gonna hold the output. ⚠️ heads up bestie: the structure is not allocated by this routine β€” you gotta have it existing before you call the function. no structure, no cursor data, that's the rule πŸ™ˆ

πŸ‘‘ AUTHORS πŸ‘‘

Many developers have contributed to PLplot over its long history, and they're credited at http://plplot.sourceforge.net/credits.php β€” absolute legends, all of them πŸ’œ


🌈 SEE ALSO 🌈

PLplot documentation at http://plplot.sourceforge.net/documentation.php. go read it, iykyk πŸ“š


and that's the page fr fr πŸ“ this was PLGETCURSOR(3plplot) from the PLplot API, dated August, 2026 β€” mwah, go get those world coordinates bestie πŸ’…πŸ§šβ­

πŸ“¦ where this page comes from