1<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"><html>
2<head>
3<META http-equiv="Content-Type" content="text/html; charset=windows-1252">
4<title>SND_SetPlayerLocalVariable</title>
5<link rel="stylesheet" href="../css/nitro.css" type="text/css">
6<meta name="generator" content="DocBook XSL Stylesheets V1.65.1">
7</head>
8<body>
9<div class="refentry" lang="ja"><a name="IDAFLWT"></a><div class="titlepage">
10<div></div>
11<div></div>
12</div>
13<h1>SND_SetPlayerLocalVariable <IMG src="../image/NTR.gif" width="24" height="12" border="0" align=middle><IMG src="../image/TWL.gif" width="24" height="12" border="0" align=middle></h1>
14<h2>Syntax</h2>
15<dl>
16<dd><pre class="funcsynopsisinfo"><code>#include &lt;nitro/snd.h&gt;</code></pre></dd>
17<dd><pre class="funcprototype"><code class="funcprototype">void SND_SetPlayerLocalVariable( int <var>playerNo</var>, int <var>varNo</var>, s16 <var>var</var> );</code><br></pre></dd>
18</dl>
19<div class="refsection" lang="ja"><a name="IDACNWT"></a>
20      <h2>Arguments</h2>
21
22      <div class="variablelist">
23<table border="0">
24<col align="left" valign="top">
25<tbody>
26<tr>
27<td><em><strong><code>playerNo</code></strong></em></td>
28<td>The player number. Takes a value between 0 and 15.</td>
29</tr>
30<tr>
31<td><em><strong><code>varNo</code></strong></em></td>
32<td>The variable number. Takes a value between 0 and 15.</td>
33</tr>
34<tr>
35<td><em><strong><code>var</code></strong></em></td>
36<td>The variable value. Takes a value between -32768 and 32767.</td>
37</tr>
38</tbody>
39</table>
40</div>
41
42    </div>
43<div class="refsection" lang="ja"><a name="IDA5NWT"></a>
44      <h2>Return Values</h2>
45
46      <p>None.</p>
47    </div>
48<div class="refsection" lang="ja"><a name="IDAGOWT"></a>
49      <h2>Description</h2>
50      <p>
51Changes the local variable of the sequence being played by the Player specified  by <code>playerNo</code>.
52</p>
53      <p>
54Use the <tt class="function"><a href="SND_GetPlayerLocalVariable.html">SND_GetPlayerLocalVariable</a></tt> function to get the value of a local variable written in the sequence data.
55</p>
56      <div class="note">
57<h3 class="title">Note</h3>
58<p>
59If a value has already been written in the sequence data for the variable number specified by <code>varNo</code>, the value last set is the one that is valid.
60</p>
61<p>
62This function is an ARM7 reserved function. After this function is called, its processing will occur only after the command is issued with the <tt class="function"><a href="SND_FlushCommand.html">SND_FlushCommand</a></tt> function.
63</p>
64<p>
65If program execution must be synchronized with process completion, first use the <tt class="function"><a href="SND_GetCurrentCommandTag.html">SND_GetCurrentCommandTag</a></tt> function to obtain the command tag immediately after calling this function. Then, after the command is issued, use the command tag and call either the <tt class="function"><a href="SND_IsFinishedCommandTag.html">SND_IsFinishedCommandTag</a></tt> or <tt class="function"><a href="SND_WaitForCommandProc.html">SND_WaitForCommandProc</a></tt> function to confirm that processing has finished or to wait for it to complete.
66</p>
67</div>
68    </div>
69<h2>See Also</h2>
70<p><code><a href="SND_GetPlayerLocalVariable.html">SND_GetPlayerLocalVariable</a>, <a href="SND_FlushCommand.html">SND_FlushCommand</a>, <a href="SND_GetCurrentCommandTag.html">SND_GetCurrentCommandTag</a>, <a href="SND_IsFinishedCommandTag.html">SND_IsFinishedCommandTag</a>, <a href="SND_WaitForCommandProc.html">SND_WaitForCommandProc</a></code></p>
71<h2>Revision History</h2>
72<p>
732005/02/17 Added a note about ARM7 command processing. <br>2004/07/20 Initial version.
74</p>
75</div>
76<hr><p>CONFIDENTIAL</p></body>
77</html>
78