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>Syntax</h2>
17<dl><dd><pre class="construction">
18#include &lt;revolution/vi.h&gt;
19
20void VISetTrapFilter(VIBool filter);
21</pre></dd></dl>
22
23<h2>Arguments</h2>
24<TABLE class="arguments" border="1" >
25  <tr>
26<th><CODE><STRONG><EM>filter</EM></STRONG></CODE></th>
27<td>Specify <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>
28  </tr>
29</table>
30
31<h2>Return Values</h2>
32<p>None.</p>
33
34<h2>Description</h2>
35<p>This function applies a trap filter to the screen when <CODE>VI_ENABLE</CODE> is specified.<br>Once the trap filter has been enabled during a game with <CODE>VI_ENABLE</CODE>, the trap filter will continue to function until disabled with <CODE>VI_DISABLE</CODE>.</p>
36
37<p>The trap filter affects only composite output. 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>
38
39<p>Changes do not take effect until <a href="VIFlush.html"><code>VIFlush</code></a> is called. See the <a href="VIFlush.html"><code>VIFlush</code></a> function reference for details on enabling effects.<br>Note that trap filter is always set to disabled (<code>VI_DISABLE</code>) by <a href="VIInit.html"><code>VIInit</code></a>.
40</p>
41
42<h2>See Also</h2>
43<P class="reference">
44<a href="VIFlush.html">VIFlush</a>,
45<a href="VIInit.html">VIInit</a>
46</p>
47
48<h2>Revision History</h2>
49<p>
502006/09/16 Added a note that the trap filter will be set to disabled by <CODE>VIInit</CODE>.<br>2006/05/09 Added entry on the length of time that the trap filter continues to function.<br>2006/03/01 Initial version.<br>
51</p>
52
53<hr><p>CONFIDENTIAL</p></body>
54</html>
55