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="IBM WebSphere Studio Homepage Builder Version 8.0.0.0 for Windows">
7<META http-equiv="Content-Style-Type" content="text/css">
8<title>G2S_SetBG2ControlAffine</title>
9<LINK rel="stylesheet" href="../../css/nitro.css" type="text/css">
10</head>
11
12<body>
13
14<h1 align="left">G2S_SetBG2ControlAffine <img src="../../image/NTR.gif"align="middle"><img src="../../image/TWL.gif" align="middle"></H1>
15<H2>Syntax</H2>
16
17<dl>
18  <dd>
19<CODE>#include &lt;nitro/gx/gx_bgcnt.h&gt;</CODE><BR>
20  <PRE><CODE>void G2S_SetBG2ControlAffine(
21    GXBGScrSizeAffine screenSize,
22    GXBGAreaOver areaOver,
23    GXBGScrBase screenBase,
24    GXBGCharBase charBase
25);</CODE></PRE>
26  </dd>
27</dl><h2>Arguments</h2>
28<TABLE border="1" width="100%">
29  <TBODY>
30    <TR>
31      <TD width="300"><em><strong><font face="Courier New">screenSize</font></strong></em></TD>
32      <TD width="700">Screen Size</TD>
33    </TR>
34    <TR>
35      <TD><em><strong><font face="Courier New">areaOver</font></strong></em></TD>
36      <TD>Option for out-of-area processing</TD>
37    </TR>
38    <TR>
39      <TD><em><strong><font face="Courier New">screenBase</font></strong></em></TD>
40      <TD>Screen base block</TD>
41    </TR>
42    <TR>
43      <TD><em><strong><font face="Courier New">charBase</font></strong></em></TD>
44      <TD>Character base block</TD>
45    </TR>
46  </TBODY>
47</TABLE>
48<h2>Return Values</h2>
49<p>None.</p>
50<H2>Description</H2>
51<P>This function sets the sub 2D Engine's BG2 (in the case of affine BG).
52</P>
53<TABLE border="1">
54  <TBODY>
55    <TR>
56      <TD width="30%"><CODE>GX_BG_SCRSIZE_AFFINE_128x128</CODE></TD>
57      <TD width="70%">Sets screen size to 128x128 pixels (256 bytes).</TD>
58    </TR>
59    <TR>
60      <TD width="30%"><CODE>GX_BG_SCRSIZE_AFFINE_256x256</CODE></TD>
61      <TD width="70%">Sets screen size to 256x256 pixels (1 kilobyte).</TD>
62    </TR>
63    <TR>
64      <TD width="30%"><CODE>GX_BG_SCRSIZE_AFFINE_512x512</CODE></TD>
65      <TD width="70%">Sets screen size to 512x512 pixels (4 kilobytes).</TD>
66    </TR>
67    <TR>
68      <TD width="30%"><CODE>GX_BG_SCRSIZE_AFFINE_1024x1024</CODE></TD>
69      <TD width="70%">Sets screen size to 1024x1024 pixels (16 kilobytes).</TD>
70    </TR>
71  </TBODY>
72</TABLE>
73<P></P>
74<TABLE border="1">
75  <TBODY>
76    <TR>
77      <TD width="30%"><CODE>GX_BG_AREAOVER_XLU</CODE></TD>
78      <TD width="70%">Transparent display of the out-of-area region</TD>
79    </TR>
80    <TR>
81      <TD width="30%"><CODE>GX_BG_AREAOVER_REPEAT</CODE></TD>
82      <TD width="70%">Wraparound display of the out-of-area region</TD>
83    </TR>
84  </TBODY>
85</TABLE>
86<P></P>
87<TABLE border="1">
88  <COL span="1" width="30%">
89  <COL span="1" width="70%">
90  <TBODY>
91    <TR>
92      <TD width="30%"><CODE>GX_BG_SCRBASE_0xnnnn</CODE></TD>
93      <TD width="70%">Specifies BG2 screen base block.</TD>
94    </TR>
95  </TBODY>
96</TABLE>
97<P>
98</P>
99<TABLE border="1">
100  <TBODY>
101    <TR>
102      <TD width="30%"><CODE>GX_BG_CHARBASE_0xnnnnn</CODE></TD>
103      <TD width="70%">Specifies BG2 character base block.</TD>
104    </TR>
105  </TBODY>
106</TABLE>
107<P>The following describes the enumerated type definitions of the arguments.</P>
108<PRE><CODE>typedef enum
109{
110    GX_BG_SCRSIZE_AFFINE_128x128 = 0,
111    GX_BG_SCRSIZE_AFFINE_256x256 = 1,
112    GX_BG_SCRSIZE_AFFINE_512x512 = 2,
113    GX_BG_SCRSIZE_AFFINE_1024x1024 = 3
114}
115GXBGScrSizeAffine;
116
117typedef enum
118{
119    GX_BG_AREAOVER_XLU = 0,
120    GX_BG_AREAOVER_REPEAT = 1
121}
122GXBGAreaOver;
123
124typedef enum
125{
126    GX_BG_SCRBASE_0x0000 = 0,
127    GX_BG_SCRBASE_0x0800 = 1,
128    GX_BG_SCRBASE_0x1000 = 2,
129    GX_BG_SCRBASE_0x1800 = 3,
130    GX_BG_SCRBASE_0x2000 = 4,
131    GX_BG_SCRBASE_0x2800 = 5,
132    GX_BG_SCRBASE_0x3000 = 6,
133    GX_BG_SCRBASE_0x3800 = 7,
134    GX_BG_SCRBASE_0x4000 = 8,
135    GX_BG_SCRBASE_0x4800 = 9,
136    GX_BG_SCRBASE_0x5000 = 10,
137    GX_BG_SCRBASE_0x5800 = 11,
138    GX_BG_SCRBASE_0x6000 = 12,
139    GX_BG_SCRBASE_0x6800 = 13,
140    GX_BG_SCRBASE_0x7000 = 14,
141    GX_BG_SCRBASE_0x7800 = 15,
142    GX_BG_SCRBASE_0x8000 = 16,
143    GX_BG_SCRBASE_0x8800 = 17,
144    GX_BG_SCRBASE_0x9000 = 18,
145    GX_BG_SCRBASE_0x9800 = 19,
146    GX_BG_SCRBASE_0xa000 = 20,
147    GX_BG_SCRBASE_0xa800 = 21,
148    GX_BG_SCRBASE_0xb000 = 22,
149    GX_BG_SCRBASE_0xb800 = 23,
150    GX_BG_SCRBASE_0xc000 = 24,
151    GX_BG_SCRBASE_0xc800 = 25,
152    GX_BG_SCRBASE_0xd000 = 26,
153    GX_BG_SCRBASE_0xd800 = 27,
154    GX_BG_SCRBASE_0xe000 = 28,
155    GX_BG_SCRBASE_0xe800 = 29,
156    GX_BG_SCRBASE_0xf000 = 30,
157    GX_BG_SCRBASE_0xf800 = 31
158}
159GXBGScrBase;
160
161typedef enum
162{
163    GX_BG_CHARBASE_0x00000 = 0,
164    GX_BG_CHARBASE_0x04000 = 1,
165    GX_BG_CHARBASE_0x08000 = 2,
166    GX_BG_CHARBASE_0x0c000 = 3,
167    GX_BG_CHARBASE_0x10000 = 4,
168    GX_BG_CHARBASE_0x14000 = 5,
169    GX_BG_CHARBASE_0x18000 = 6,
170    GX_BG_CHARBASE_0x1c000 = 7,
171    GX_BG_CHARBASE_0x20000 = 8,
172    GX_BG_CHARBASE_0x24000 = 9,
173    GX_BG_CHARBASE_0x28000 = 10,
174    GX_BG_CHARBASE_0x2c000 = 11,
175    GX_BG_CHARBASE_0x30000 = 12,
176    GX_BG_CHARBASE_0x34000 = 13,
177    GX_BG_CHARBASE_0x38000 = 14,
178    GX_BG_CHARBASE_0x3c000 = 15
179}
180GXBGCharBase;</CODE></PRE>
181<h2>See Also</h2>
182<P><A href="G2_GetBG2ControlAffine.html">G2S_GetBG2ControlAffine</A></P>
183<H2>Revision History</H2>
184<P>2004/02/09 Initial version.</P>
185<hr><p>CONFIDENTIAL</p></body>
186</html>
187