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 5.0">
7<META http-equiv="Content-Style-Type" content="text/css">
8<LINK rel="stylesheet" type="text/css" href="../../CSS/revolution.css">
9<title>GXSetDither</title>
10</head>
11
12<body>
13<h1 align="left">GXSetDither</h1>
14
15<h2>Syntax</h2>
16<dl><dd><pre class="construction">
17#include &lt;revolution/gx.h&gt;
18
19void GXSetDither( <a href="../Enumerated_Types/GXBool.html">GXBool</a> dither );
20</pre></dd></dl>
21
22<h2>Arguments</h2>
23<TABLE class="arguments" border="1" >
24  <tr>
25<TH>dither</TH>
26<TD>Dithering is enabled if <CODE>GX_TRUE</CODE> and the pixel format is <CODE>GX_PF_RGBA6_Z24</CODE> or <CODE>GX_PF_RGB565_Z16</CODE>.&nbsp;Otherwise, dithering is disabled.</TD>
27  </tr>
28</TABLE>
29
30<h2>Return Values</h2>
31<p>None.</p>
32
33<H2>Description</H2>
34<P>Enabling <SPAN class="argument">dither</SPAN> is only valid when the pixel format (see the <A href="GXSetPixelFmt.html"><CODE>GXSetPixelFmt</CODE></A> function) is either <CODE>GX_PF_RGBA6_Z24</CODE> or <CODE>GX_PF_RGB565_Z16</CODE>.</P>
35<P>A 4x4 Bayer matrix is used for dithering.</P>
36<P>Dithering should be turned off if you are planning to use the results of rendering for comparisons. For example, using an outline rendering algorithm that writes ID's to the alpha channel, copies the alpha channel to a texture, and later compares the texture in the TEV.</P>
37
38<h2>See Also</h2>
39<P class="reference">
40<A href="GXSetPixelFmt.html">GXSetPixelFmt</A>
41</P>
42
43<H2>Revision History</H2>
44<P>
452006/03/01 Initial version.<br>
46</P>
47
48<hr><p>CONFIDENTIAL</p></body>
49</HTML>