Sophie

Sophie

distrib > Mandriva > 9.1 > ppc > by-pkgid > 9f39b42a4a9bb5f46373ffcca30c81df > files > 31

libzvbi0-devel-0.2.3-1mdk.ppc.rpm

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1">
<title>Data Service Decoder</title>
<link href="doxygen.css" rel="stylesheet" type="text/css">
</head><body>
<!-- Generated by Doxygen 1.2.18 -->
<center>
<a class="qindex" href="index.html">Main Page</a> &nbsp; <a class="qindex" href="modules.html">Modules</a> &nbsp; <a class="qindex" href="annotated.html">Data Structures</a> &nbsp; <a class="qindex" href="functions.html">Data Fields</a> &nbsp; <a class="qindex" href="pages.html">Related Pages</a> &nbsp; <a class="qindex" href="examples.html">Examples</a> &nbsp; </center>
<hr><h1>Data Service Decoder</h1><table border=0 cellpadding=0 cellspacing=0>
<tr><td></td></tr>
<tr><td colspan=2><br><h2>Modules</h2></td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="group__BCD.html">BCD arithmetic for Teletext page numbers</a></td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="group__Cache.html">Page cache</a></td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="group__Event.html">Events</a></td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="group__Export.html">Exporting formatted Teletext and Closed Caption pages</a></td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="group__Page.html">Formatted text page</a></td></tr>
<tr><td colspan=2><br><h2>Typedefs</h2></td></tr>
<tr><td nowrap align=right valign=top>typedef int&nbsp;</td><td valign=bottom><a class="el" href="group__Service.html#a0">vbi_pgno</a></td></tr>
<tr><td nowrap align=right valign=top>typedef int&nbsp;</td><td valign=bottom><a class="el" href="group__Service.html#a1">vbi_subno</a></td></tr>
<tr><td colspan=2><br><h2>Enumerations</h2></td></tr>
<tr><td nowrap align=right valign=top>enum &nbsp;</td><td valign=bottom><a class="el" href="group__Service.html#a11">vbi_page_type</a> </td></tr>
<tr><td>&nbsp;</td><td><font size=-1><em>Page classification.</em> <a href="#a11">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top>enum &nbsp;</td><td valign=bottom><a class="el" href="group__Service.html#a12">vbi_wst_level</a> { <br>
&nbsp;&nbsp;<a class="el" href="group__Service.html#a12a61">VBI_WST_LEVEL_1</a>, 
<br>
&nbsp;&nbsp;<a class="el" href="group__Service.html#a12a62">VBI_WST_LEVEL_1p5</a>, 
<br>
&nbsp;&nbsp;<a class="el" href="group__Service.html#a12a63">VBI_WST_LEVEL_2p5</a>, 
<br>
&nbsp;&nbsp;<a class="el" href="group__Service.html#a12a64">VBI_WST_LEVEL_3p5</a>
<br>
 }</td></tr>
<tr><td>&nbsp;</td><td><font size=-1><em>Teletext implementation level.</em> <a href="#a12">More...</a><em></em></font><br><br></td></tr>
<tr><td colspan=2><br><h2>Functions</h2></td></tr>
<tr><td nowrap align=right valign=top>vbi_decoder *&nbsp;</td><td valign=bottom><a class="el" href="group__Service.html#a2">vbi_decoder_new</a> (void)</td></tr>
<tr><td>&nbsp;</td><td><font size=-1><em>Allocate a new data service decoder instance.</em> <a href="#a2"></a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top>void&nbsp;</td><td valign=bottom><a class="el" href="group__Service.html#a3">vbi_decoder_delete</a> (vbi_decoder *vbi)</td></tr>
<tr><td>&nbsp;</td><td><font size=-1><em>Delete a data service decoder instance.</em> <a href="#a3"></a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top>void&nbsp;</td><td valign=bottom><a class="el" href="group__Service.html#a4">vbi_decode</a> (vbi_decoder *vbi, <a class="el" href="structvbi__sliced.html">vbi_sliced</a> *sliced, int lines, double time)</td></tr>
<tr><td>&nbsp;</td><td><font size=-1><em>Main function of the data service decoder.</em> <a href="#a4"></a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top>void&nbsp;</td><td valign=bottom><a class="el" href="group__Service.html#a5">vbi_channel_switched</a> (vbi_decoder *vbi, <a class="el" href="group__Event.html#a0">vbi_nuid</a> nuid)</td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="group__Service.html#a11">vbi_page_type</a>&nbsp;</td><td valign=bottom><a class="el" href="group__Service.html#a6">vbi_classify_page</a> (vbi_decoder *vbi, <a class="el" href="group__Service.html#a0">vbi_pgno</a> pgno, <a class="el" href="group__Service.html#a1">vbi_subno</a> *subno, char **language)</td></tr>
<tr><td nowrap align=right valign=top>void&nbsp;</td><td valign=bottom><a class="el" href="group__Service.html#a7">vbi_teletext_set_default_region</a> (vbi_decoder *vbi, int default_region)</td></tr>
<tr><td nowrap align=right valign=top>void&nbsp;</td><td valign=bottom><a class="el" href="group__Service.html#a8">vbi_teletext_set_level</a> (vbi_decoder *vbi, int level)</td></tr>
</table>
<hr><h2>Typedef Documentation</h2>
<a name="a0" doxytag="bcd.h::vbi_pgno"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
  <tr>
    <td class="md">
      <table cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td class="md" nowrap valign="top"> typedef int vbi_pgno
      </table>
    </td>
  </tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
Teletext or Closed Caption page number. For Teletext pages this is a bcd number in range 0x100 ... 0x8FF. Page numbers containing digits 0xA to 0xF are reserved for various system purposes, these pages are not intended for display.
<p>
Closed Caption page numbers between 1 ... 8 correspond to the four Caption and Text channels:  <table border=1 cellspacing=3 cellpadding=3><tr><td>1</td><td>Caption 1</td><td> "Primary synchronous caption service [English]" </td></tr>
<tr><td>2</td><td>Caption 2</td><td> "Special non-synchronous data that is intended to augment information carried in the program" </td></tr>
<tr><td>3</td><td>Caption 3</td><td> "Secondary synchronous caption service, usually second language [Spanish, French]" </td></tr>
<tr><td>4</td><td>Caption 4</td><td> "Special non-synchronous data similar to Caption 2" </td></tr>
<tr><td>5</td><td>Text 1</td><td> "First text service, data usually not program related" </td></tr>
<tr><td>6</td><td>Text 2</td><td> "Second text service, additional data usually not program related [ITV data]" </td></tr>
<tr><td>7</td><td>Text 3</td><td> "Additional text channel" </td></tr>
<tr><td>8</td><td>Text 4</td><td> "Additional text channel" </td></tr></table>
     </td>
  </tr>
</table>
<a name="a1" doxytag="bcd.h::vbi_subno"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
  <tr>
    <td class="md">
      <table cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td class="md" nowrap valign="top"> typedef int vbi_subno
      </table>
    </td>
  </tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
This is the subpage number only applicable to Teletext pages, a BCD number in range 0x00 ... 0x99. On special 'clock' pages (for example listing the current time in different time zones) it can assume values between 0x0000 ... 0x2359 expressing local time. These are not actually subpages.     </td>
  </tr>
</table>
<hr><h2>Enumeration Type Documentation</h2>
<a name="a11" doxytag="vbi.h::vbi_page_type"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
  <tr>
    <td class="md">
      <table cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td class="md" nowrap valign="top"> enum vbi_page_type
      </table>
    </td>
  </tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
Page classification.
<p>
See <a class="el" href="group__Service.html#a6">vbi_classify_page()</a>.     </td>
  </tr>
</table>
<a name="a12" doxytag="vt.h::vbi_wst_level"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
  <tr>
    <td class="md">
      <table cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td class="md" nowrap valign="top"> enum vbi_wst_level
      </table>
    </td>
  </tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
Teletext implementation level.
<p>
<dl compact><dt><b>Enumeration values: </b></dt><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em><a name="a12a61" doxytag="VBI_WST_LEVEL_1"></a><em>VBI_WST_LEVEL_1</em></em>&nbsp;</td><td>
1 - Basic Teletext pages </td></tr>
<tr><td valign=top><em><a name="a12a62" doxytag="VBI_WST_LEVEL_1p5"></a><em>VBI_WST_LEVEL_1p5</em></em>&nbsp;</td><td>
1.5 - Additional national and graphics characters </td></tr>
<tr><td valign=top><em><a name="a12a63" doxytag="VBI_WST_LEVEL_2p5"></a><em>VBI_WST_LEVEL_2p5</em></em>&nbsp;</td><td>
2.5 - Additional text styles, more colors and DRCS. You should enable Level 2.5 only if you can render and/or export such pages. </td></tr>
<tr><td valign=top><em><a name="a12a64" doxytag="VBI_WST_LEVEL_3p5"></a><em>VBI_WST_LEVEL_3p5</em></em>&nbsp;</td><td>
3.5 - Multicolor DRCS, proportional script </td></tr>
</table>
</dl>
    </td>
  </tr>
</table>
<hr><h2>Function Documentation</h2>
<a name="a2" doxytag="vbi.c::vbi_decoder_new"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
  <tr>
    <td class="md">
      <table cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td class="md" nowrap valign="top"> vbi_decoder* vbi_decoder_new </td>
          <td class="md" valign="top">(&nbsp;</td>
          <td class="md" nowrap valign="top">void&nbsp;</td>
          <td class="mdname1" valign="top" nowrap>&nbsp;          </td>
          <td class="md" valign="top">)&nbsp;</td>
          <td class="md" nowrap></td>
        </tr>

      </table>
    </td>
  </tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
Allocate a new data service decoder instance.
<p>
<dl compact><dt><b>Returns: </b></dt><dd>
 vbi_decoder pointer or <code>NULL</code> on failure, probably due to lack of memory. </dl>    </td>
  </tr>
</table>
<a name="a3" doxytag="vbi.c::vbi_decoder_delete"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
  <tr>
    <td class="md">
      <table cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td class="md" nowrap valign="top"> void vbi_decoder_delete </td>
          <td class="md" valign="top">(&nbsp;</td>
          <td class="md" nowrap valign="top">vbi_decoder *&nbsp;</td>
          <td class="mdname1" valign="top" nowrap>&nbsp; <em>vbi</em>          </td>
          <td class="md" valign="top">)&nbsp;</td>
          <td class="md" nowrap></td>
        </tr>

      </table>
    </td>
  </tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
Delete a data service decoder instance.
<p>
<dl compact><dt><b>Parameters: </b></dt><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>vbi</em>&nbsp;</td><td>
Decoder structure allocated with <a class="el" href="group__Service.html#a2">vbi_decoder_new()</a>. </td></tr>
</table>
</dl>    </td>
  </tr>
</table>
<a name="a4" doxytag="vbi.c::vbi_decode"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
  <tr>
    <td class="md">
      <table cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td class="md" nowrap valign="top"> void vbi_decode </td>
          <td class="md" valign="top">(&nbsp;</td>
          <td class="md" nowrap valign="top">vbi_decoder *&nbsp;</td>
          <td class="mdname" nowrap>&nbsp; <em>vbi</em>, </td>
        </tr>
        <tr>
          <td></td>
          <td></td>
          <td class="md" nowrap><a class="el" href="structvbi__sliced.html">vbi_sliced</a> *&nbsp;</td>
          <td class="mdname" nowrap>&nbsp; <em>sliced</em>, </td>
        </tr>
        <tr>
          <td></td>
          <td></td>
          <td class="md" nowrap>int&nbsp;</td>
          <td class="mdname" nowrap>&nbsp; <em>lines</em>, </td>
        </tr>
        <tr>
          <td></td>
          <td></td>
          <td class="md" nowrap>double&nbsp;</td>
          <td class="mdname" nowrap>&nbsp; <em>time</em></td>
        </tr>
        <tr>
          <td></td>
          <td class="md">)&nbsp;</td>
          <td class="md" colspan="2"></td>
        </tr>

      </table>
    </td>
  </tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
Main function of the data service decoder.
<p>
<dl compact><dt><b>Parameters: </b></dt><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>vbi</em>&nbsp;</td><td>
Initialized vbi decoding context as returned by <a class="el" href="group__Service.html#a2">vbi_decoder_new()</a>. </td></tr>
<tr><td valign=top><em>sliced</em>&nbsp;</td><td>
Array of <a class="el" href="structvbi__sliced.html">vbi_sliced</a> data packets to be decoded. </td></tr>
<tr><td valign=top><em>lines</em>&nbsp;</td><td>
Number of <a class="el" href="structvbi__sliced.html">vbi_sliced</a> data packets, i. e. VBI lines. </td></tr>
<tr><td valign=top><em>time</em>&nbsp;</td><td>
Timestamp associated with <em>all</em> sliced data packets. This is the time in seconds and fractions since 1970-01-01 00:00, for example from function gettimeofday(). <em>time</em> should only increment, the latest time entered is considered the current time for activity calculation.</td></tr>
</table>
</dl>Decodes zero or more lines of sliced VBI data from the same video frame, updates the decoder state and calls event handlers.
<p>
<em>timestamp</em> shall advance by 1/30 to 1/25 seconds whenever calling this function. Failure to do so will be interpreted as frame dropping, which starts a resynchronization cycle, eventually a channel switch may be assumed which resets even more decoder state. So even if a frame did not contain any useful data this function must be called, with <em>lines</em> set to zero.
<p>
<dl compact><dt><b>Note: </b></dt><dd>
This is one of the few not reentrant libzvbi functions. If multiple threads call this with the same <em>vbi</em> context you must implement your own locking mechanism. Never call this function from an event handler. </dl>    </td>
  </tr>
</table>
<a name="a5" doxytag="vbi.c::vbi_channel_switched"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
  <tr>
    <td class="md">
      <table cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td class="md" nowrap valign="top"> void vbi_channel_switched </td>
          <td class="md" valign="top">(&nbsp;</td>
          <td class="md" nowrap valign="top">vbi_decoder *&nbsp;</td>
          <td class="mdname" nowrap>&nbsp; <em>vbi</em>, </td>
        </tr>
        <tr>
          <td></td>
          <td></td>
          <td class="md" nowrap><a class="el" href="group__Event.html#a0">vbi_nuid</a>&nbsp;</td>
          <td class="mdname" nowrap>&nbsp; <em>nuid</em></td>
        </tr>
        <tr>
          <td></td>
          <td class="md">)&nbsp;</td>
          <td class="md" colspan="2"></td>
        </tr>

      </table>
    </td>
  </tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
<dl compact><dt><b>Parameters: </b></dt><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>vbi</em>&nbsp;</td><td>
VBI decoding context. </td></tr>
<tr><td valign=top><em>nuid</em>&nbsp;</td><td>
Set to zero for now.</td></tr>
</table>
</dl>Call this after switching away from the channel (RF channel, video input line, precisely: the network) from which this context used to receive vbi data, to reset the decoding context accordingly. This includes deletion of all cached Teletext and Closed Caption pages.
<p>
The decoder attempts to detect channel switches automatically, but this is not 100 % reliable, especially without receiving and decoding Teletext or VPS which frequently transmit network identifiers.
<p>
Note the reset is not executed until the next frame is about to be decoded, so you may still receive "old" events after calling this. You may also receive blank events (e. g. unknown network, unknown aspect ratio) revoking a previously sent event, until new information becomes available.     </td>
  </tr>
</table>
<a name="a6" doxytag="vbi.c::vbi_classify_page"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
  <tr>
    <td class="md">
      <table cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td class="md" nowrap valign="top"> <a class="el" href="group__Service.html#a11">vbi_page_type</a> vbi_classify_page </td>
          <td class="md" valign="top">(&nbsp;</td>
          <td class="md" nowrap valign="top">vbi_decoder *&nbsp;</td>
          <td class="mdname" nowrap>&nbsp; <em>vbi</em>, </td>
        </tr>
        <tr>
          <td></td>
          <td></td>
          <td class="md" nowrap><a class="el" href="group__Service.html#a0">vbi_pgno</a>&nbsp;</td>
          <td class="mdname" nowrap>&nbsp; <em>pgno</em>, </td>
        </tr>
        <tr>
          <td></td>
          <td></td>
          <td class="md" nowrap><a class="el" href="group__Service.html#a1">vbi_subno</a> *&nbsp;</td>
          <td class="mdname" nowrap>&nbsp; <em>subno</em>, </td>
        </tr>
        <tr>
          <td></td>
          <td></td>
          <td class="md" nowrap>char **&nbsp;</td>
          <td class="mdname" nowrap>&nbsp; <em>language</em></td>
        </tr>
        <tr>
          <td></td>
          <td class="md">)&nbsp;</td>
          <td class="md" colspan="2"></td>
        </tr>

      </table>
    </td>
  </tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
<dl compact><dt><b>Parameters: </b></dt><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>vbi</em>&nbsp;</td><td>
Initialized vbi decoding context. </td></tr>
<tr><td valign=top><em>pgno</em>&nbsp;</td><td>
Teletext or Closed Caption page to examine, see vbi_pgno. </td></tr>
<tr><td valign=top><em>subno</em>&nbsp;</td><td>
The highest subpage number of this page will be stored here. <em>subno</em> can be <code>NULL</code>. </td></tr>
<tr><td valign=top><em>language</em>&nbsp;</td><td>
If it is possible to determine the language a page is written in, a pointer to the language name (Latin-1) will be stored here, <code>NULL</code> if the language is unknown. <em>language</em> can be <code>NULL</code> if this information is not needed.</td></tr>
</table>
</dl>Returns information about the page.
<p>
For Closed Caption pages (<em>pgno</em> 1 ... 8) <em>subno</em> will always be zero, <em>language</em> set or <code>NULL</code>. The return value will be <code>VBI_SUBTITLE_PAGE</code> for page 1 ... 4 (Closed Caption channel 1 ... 4), <code>VBI_NORMAL_PAGE</code> for page 5 ... 8 (Text channel 1 ... 4), or <code>VBI_NO_PAGE</code> if no data is currently transmitted on the channel.
<p>
For Teletext pages (<em>pgno</em> 0x100 ... 0x8FF) <em>subno</em> returns the highest subpage number used. Note this number can be larger (but not smaller) than the number of subpages actually received and cached. Still there is no guarantee the advertised subpages will ever appear or stay in cache.
<p>
 <table border=1 cellspacing=3 cellpadding=3><tr><td><b>subno</b></td><td><b>meaning</b> </td></tr>
<tr><td>0</td><td>single page, no subpages </td></tr>
<tr><td>1</td><td>never </td></tr>
<tr><td>2 ... 0x3F7F</td><td>has subpages 1 ... <em>subno</em>  </td></tr>
<tr><td>0xFFFE</td><td>has unknown number (two or more) of subpages </td></tr>
<tr><td>0xFFFF</td><td>presence of subpages unknown </td></tr></table>

<p>
<em>language</em> currently returns the language of subtitle pages, <code>NULL</code> if unknown or the page is not classified as <code>VBI_SUBTITLE_PAGE</code>.
<p>
Other page types are:
<p>
 <table border=1 cellspacing=3 cellpadding=3><tr><td>VBI_NO_PAGE</td><td>Page is not in transmission </td></tr>
<tr><td>VBI_NORMAL_PAGE</td><td>&nbsp; </td></tr>
<tr><td>VBI_SUBTITLE_PAGE</td><td>&nbsp; </td></tr>
<tr><td>VBI_SUBTITLE_INDEX</td><td>List of subtitle pages </td></tr>
<tr><td>VBI_NONSTD_SUBPAGES</td><td>For example a world time page </td></tr>
<tr><td>VBI_PROGR_WARNING</td><td>Program related warning (perhaps schedule change anouncements, the Teletext specification does not elaborate on this) </td></tr>
<tr><td>VBI_CURRENT_PROGR</td><td>Information about the current program </td></tr>
<tr><td>VBI_NOW_AND_NEXT</td><td>Brief information about the current and next program </td></tr>
<tr><td>VBI_PROGR_INDEX</td><td>Program index page (perhaps the front page of all program related pages) </td></tr>
<tr><td>VBI_PROGR_SCHEDULE</td><td>Program schedule page </td></tr>
<tr><td>VBI_UNKNOWN_PAGE</td><td>&nbsp; </td></tr></table>

<p>
<dl compact><dt><b>Note: </b></dt><dd>
The results of this function are volatile: As more information becomes available and pages are edited (e. g. activation of subtitles, news updates, program related pages) subpage numbers can grow, page types, subno 0xFFFE and 0xFFFF and languages can change.</dl><dl compact><dt><b>Returns: </b></dt><dd>
 Page type. </dl>    </td>
  </tr>
</table>
<a name="a7" doxytag="packet.c::vbi_teletext_set_default_region"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
  <tr>
    <td class="md">
      <table cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td class="md" nowrap valign="top"> void vbi_teletext_set_default_region </td>
          <td class="md" valign="top">(&nbsp;</td>
          <td class="md" nowrap valign="top">vbi_decoder *&nbsp;</td>
          <td class="mdname" nowrap>&nbsp; <em>vbi</em>, </td>
        </tr>
        <tr>
          <td></td>
          <td></td>
          <td class="md" nowrap>int&nbsp;</td>
          <td class="mdname" nowrap>&nbsp; <em>default_region</em></td>
        </tr>
        <tr>
          <td></td>
          <td class="md">)&nbsp;</td>
          <td class="md" colspan="2"></td>
        </tr>

      </table>
    </td>
  </tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
<dl compact><dt><b>Parameters: </b></dt><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>vbi</em>&nbsp;</td><td>
Initialized vbi decoding context. </td></tr>
<tr><td valign=top><em>default_region</em>&nbsp;</td><td>
A value between 0 ... 80, index into the Teletext character set table according to ETS 300 706, Section 15 (or libzvbi source file lang.c). The three last significant bits will be replaced.</td></tr>
</table>
</dl>The original Teletext specification distinguished between eight national character sets. When more countries started to broadcast Teletext the three bit character set id was locally redefined and later extended to seven bits grouping the regional variants. Since some stations still transmit only the legacy three bit id and we don't ship regional variants of this decoder as TV manufacturers do, this function can be used to set a default for the extended bits. The "factory default" is 16.     </td>
  </tr>
</table>
<a name="a8" doxytag="packet.c::vbi_teletext_set_level"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
  <tr>
    <td class="md">
      <table cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td class="md" nowrap valign="top"> void vbi_teletext_set_level </td>
          <td class="md" valign="top">(&nbsp;</td>
          <td class="md" nowrap valign="top">vbi_decoder *&nbsp;</td>
          <td class="mdname" nowrap>&nbsp; <em>vbi</em>, </td>
        </tr>
        <tr>
          <td></td>
          <td></td>
          <td class="md" nowrap>int&nbsp;</td>
          <td class="mdname" nowrap>&nbsp; <em>level</em></td>
        </tr>
        <tr>
          <td></td>
          <td class="md">)&nbsp;</td>
          <td class="md" colspan="2"></td>
        </tr>

      </table>
    </td>
  </tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
<dl compact><dt><b>Parameters: </b></dt><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>vbi</em>&nbsp;</td><td>
Initialized vbi decoding context. </td></tr>
<tr><td valign=top><em>level</em>&nbsp;</td><td>
</td></tr>
</table>
</dl><dl compact><dt><b><a class="el" href="deprecated.html#_deprecated000005">Deprecated: </a></b></dt><dd>
 This became a parameter of <a class="el" href="group__Cache.html#a4">vbi_fetch_vt_page()</a>. </dl>     </td>
  </tr>
</table>
<hr><address style="align: right;"><small>Generated on Thu Jan 2 16:03:42 2003 for ZVBI Library by
<a href="http://www.doxygen.org/index.html">
<img src="doxygen.png" alt="doxygen" align="middle" border=0 
width=110 height=53></a>1.2.18 </small></address>
</body>
</html>