1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2<html>
3<head>
4<META http-equiv="Content-Type" content="text/html; charset=windows-1252">
5<META name="GENERATOR" content="IBM WebSphere Studio Homepage Builder Version 8.0.0.0 for Windows">
6<META http-equiv="Content-Style-Type" content="text/css">
7<title>G3_MaterialColorSpecEmi</title>
8<LINK rel="stylesheet" href="../../css/nitro.css" type="text/css">
9</head>
10<body>
11<h1 align="left">G3*_MaterialColorSpecEmi <img src="../../image/NTR.gif"align="middle"><img src="../../image/TWL.gif" align="middle"></H1>
12<H2>Syntax</H2>
13<dl>
14  <dd>
15<PRE><CODE>#include &lt;nitro/gx/g3imm.h&gt;
16#include &lt;nitro/gx/g3b.h&gt;
17#include &lt;nitro/gx/g3c.h&gt;
18void G3_MaterialColorSpecEmi(GXRgb specular, GXRgb emission, BOOL IsShininess);
19// Below are APIs for creating the display list (command list):
20void G3B_MaterialColorSpecEmi(
21    <A href="../gx/GXDLInfo.html">GXDLInfo</A>* info,
22    GXRgb specular,
23    GXRgb emission,
24    BOOL IsShininess);
25void G3C_MaterialColorSpecEmi(
26    <A href="../gx/GXDLInfo.html">GXDLInfo</A>* info,
27    GXRgb specular,
28    GXRgb emission,
29    BOOL IsShininess);
30void G3BS_MaterialColorSpecEmi(
31    <A href="../gx/GXDLInfo.html">GXDLInfo</A>* info,
32    GXRgb specular,
33    GXRgb emission,
34    BOOL IsShininess);
35void G3CS_MaterialColorSpecEmi(
36    <A href="../gx/GXDLInfo.html">GXDLInfo</A>* info,
37    GXRgb specular,
38    GXRgb emission,
39    BOOL IsShininess);</CODE></PRE>
40  </dd>
41</dl><h2>Arguments</h2>
42<table border="1" width="100%">
43  <tr>
44    <td width="13%"><em><strong><font face="Courier New">info</font></strong></em></td>
45    <td width="87%">Command List Information.</td>
46  </tr>
47  <tr>
48    <td width="13%"><em><strong><font face="Courier New">specular</font></strong></em></td>
49    <td width="87%">Specular reflection color</td>
50  </tr>
51  <tr>
52    <td width="13%"><em><strong><font face="Courier New">emission</font></strong></em></td>
53    <td width="87%">Emitted light color</td>
54  </tr>
55  <tr>
56    <td width="13%"><em><strong><font face="Courier New">IsShininess</font></strong></em></td>
57    <td width="87%">Enable/Disable flag for the specular reflection shininess table</td>
58  </tr>
59</table>
60<h2>Return Values</h2>
61<p>None.</p>
62<H2>Description</H2>
63<P>This function sets the specular reflection color and emission light color for materials. The specular reflection shininess table flag specifies whether to use the specular reflection table (<code>TRUE</code>) or not to use the specular reflection table (<code>FALSE</code>). Refer to the <CODE><A href="G3_Shininess.html" target="_self">G3*_Shininess</A></CODE> function for details about the specular reflection table.<BR><BR> <b>Note</b>:&nbsp; When conversion does not occur using the specular reflection table, specular (the greater value of 0 and the dot product of the normal vector, N, and the reverse directional half-angle vector, H) is used without modification. Normally, intended specular reflection results can be obtained by setting the specular reflection table to specular raised to the power of <code>n</code>.</P>
64<h2>See Also</h2>
65<P><CODE><A href="G3_MaterialColorDiffAmb.html">G3_MaterialColorDiffAmb</A><BR> <A href="G3_Shininess.html" target="_self">G3*_Shininess</A></CODE></P>
66<H2>Revision History</H2>
67<P>2004/02/09</P>
68<UL>
69  <LI>Added explanation for the specular reflection shininess table flag.
70</UL>
71<P>2004/01/19 Initial version.</P>
72<hr><p>CONFIDENTIAL</p></body>
73</html>
74