|
- Parameters:
-
| vbi | Initialized vbi_decoder context. |
| pg | Place to store the formatted page. |
| pgno | Page number of the page to fetch, see vbi_pgno. |
| subno | Subpage number to fetch (optional VBI_ANY_SUBNO ). |
| max_level | Format the page at this Teletext implementation level. |
| display_rows | Number of rows to format, between 1 ... 25. |
| navigation | Analyse the page and add navigation links, including TOP and FLOF. |
Fetches a Teletext page designated by pgno and subno from the cache, formats and stores it in pg. Formatting is limited to row 0 ... display_rows - 1 inclusive. The really useful values are 1 (format header only) or 25 (everything). Likewise navigation can be used to save unnecessary formatting time.
Although safe to do, this function is not supposed to be called from an event handler since rendering may block decoding for extended periods of time.
- Returns:
FALSE if the page is not cached or could not be formatted for other reasons, for instance is a data page not intended for display. Level 2.5/3.5 pages which could not be formatted e. g. due to referencing data pages not in cache are formatted at a lower level.
|