Check whether a banner is visible.
Synopsis:
#include <bbads/bbads.h>
bbads_error_t bbads_banner_is_visible(bbads_banner_t *banner, int *visible)
Arguments:
-
banner
-
The bbads_banner_t* as created in the call to bbads_banner_create().
-
visible
-
A pointer to an int that will be set with the state information. If
visible is set to 0, then the state information will not be provided. If
visible is not 0, then the integer it points to is set as follows:
- 0, if the banner has been made transparent (not visible).
- 1, if the banner is currently visible.
- -1, if there was an error. Check the function's return value for the error code.
Library:
libbbads
Description:
If the application requests receiving events for this banner (see bbads_banner_request_events()), it's also notified of the state change when the banner becomes transparent. See the BBADS_EVENT_INVISIBLE event for more information.
This function is only usable after bbads_banner_load() has been called, otherwise BBADS_ESTATE is returned.
Returns:
-
BBADS_EOK on success.
-
BBADS_EBANNER if the bbads_banner_t* provided is invalid.
-
BBADS_ESTATE if the banner has not yet been loaded.