1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2<html>
3
4<head>
5<meta http-equiv="Content-Type" content="text/html; charset=windows-1252">
6<meta name="GENERATOR" content="Microsoft FrontPage 3.0">
7<meta http-equiv="Content-Style-Type" content="text/css">
8<link rel="stylesheet" type="text/css" href="../CSS/revolution.css">
9<title>VISetTrapFilter</title>
10</head>
11
12<body>
13
14<h1 align="left">VISetTrapFilter</h1>
15
16<h2>C Specification</h2>
17
18<dl>
19<dd><pre><code>#include &lt;revolution/vi.h&gt;</code></pre>
20  </dd>
21<dd><pre><code>void VISetTrapFilter(VIBool filter)</code></pre>
22  </dd>
23</dl>
24
25<h2>Arguments</h2>
26
27<table border="1" cellpadding="3" cellspacing="0.1">
28  <tr>
29<td width="120" bgcolor="#ffffe8"><code><STRONG><EM><CODE>filter</CODE></EM></STRONG></code></td>
30<td width="520">Specifiy <CODE>VI_ENABLE</CODE> to apply a trap filter onscreen. If <CODE>VI_DISABLE</CODE> is specified, a trap filter is not applied onscreen.</td>
31  </tr>
32</table>
33
34<h2>Return Values</h2>
35
36<p>None.</p>
37
38<h2>Description</h2>
39
40<p>This function applies a trap filter to the screen when VI_ENABLE is specified.<br>Once the trap filter has been enabled with VI_ENABLED, the trap filter will continue to function until disabled with VI_DISABLE.</p>
41
42<p>The trap filter affects only composite output.<br>When the trap filter is applied to the screen, cross-color is mitigated but the entire screen becomes slightly blurred. If a trap filter is not applied to the screen, the edges of the picture are sharper and text is easier to read, but cross-color occurs.</p>
43
44<p>Changes do not take effect until <code><a href="VIFlush.html">VIFlush</a></code> is called. See the <code><a href="VIFlush.html">VIFlush</a></code> function reference for more details about when the change takes effect.</p>
45
46<h2>See Also</h2>
47<p><code><a href="VIFlush.html">VIFlush</a></code></p>
48
49<h2>Revision History</h2>
50
51<p>03/01/2006 Initial version.<br>05/09/2006 Added entry on the length of time that the trap filter continues to function.</p>
52
53</body>
54</html>
55