xosd *xosd_is_onscreen (xosd *osd);
osd_is_onscreen determines weather a XOSD window, is currently being shown (is mapped to the X display). Because XOSD displays data asynchronously (see xosd_display(3xosd) for details) it can be difficult to know if data is being displayed, xosd_is_onscreen solves this problem.
Call xosd_show(3xosd) or xosd_hide(3xosd) to alter the visibility of the XOSD window.
osd The XOSD window to query.
A 1 is returned if the window is onscreen (mapped), or 0 if it is hidden (unmapped). On error, -1 is returned and xosd_error is set to indicate the reason for the error.
char *xosd_error A string to a text string describing the error, if one occurred.
The xosd_is_onscreen function first appeared in version 2.1 of the XOSD library.
The XOSD library was originally written by Andr� Renaud and is currenly maintained by Tim Wright, who also wrote the xosd_is_onscreen function. Michael JasonSmith thinks he wrote this document, but is not sure; drop Micahel an email (<firstname.lastname@example.org>) if you think he didnt write this document.
There are no known bugs with xosd_is_onscreen. Bug reports can be sent to <email@example.com>.
xosd_display(3xosd), xosd_show(3xosd), xosd_hide(3xosd)