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=utf-8">
5<meta http-equiv="Content-Style-Type" content="text/css">
6<title>Play Coin Library</title>
7<style type="text/css">
8<!--
9body {
10/*
11    font-size       : 10pt;
12*/
13    font-weight     : normal;
14    color           : #000000;
15    margin          : 8px;
16}
17
18div {
19    width           : 98%;
20    white-space     : nowrap;
21}
22
23div.title {
24    text-align      : left;
25    font-weight     : bold;
26/*
27    font-size       : 16pt;
28*/
29    font-size       : 150%;
30    color           : #202020;
31    border-style    : double;
32    border-width    : 8px;
33    /* タイトルを囲む枠線の色を指定 */
34    border-color    : #FF6600;
35
36    margin          : 4px;
37    padding         : 4px;
38}
39
40h1 {
41    font-weight     : bold;
42/*
43    font-size       : 16pt;
44*/
45    font-size       : 150%;
46    border-style    : none none solid double;
47    border-width    : 0px 0px 2px 8px;
48    /* 見出しの線の色を指定 */
49    border-color    : #FF6600;
50
51    margin-left     : 2px;
52    padding-left    : 4px;
53}
54
55p {
56    margin-left     : 4px;
57}
58
59-->
60</style>
61
62</head>
63<body>
64<a name="top"></a>
65
66<div class="title">
67Play Coin Library
68</div>
69
70
71<h1>1. Introduction</h1>
72<ul>
73<li>This library provides functions for accessing the Play Coins that users accumulate by walking around with their CTR systems.
74</ul>
75
76
77<h1>2. Supplement About This Version</h1>
78<ul>
79<li><font color="red">To embed this in your application, add <CODE>LIBS += libnn_plCoin</CODE> to your Omakefile.<br> Also add <CODE>#include &lt;nn/pl/CTR/pl_GameCoin.h&gt;</CODE> to your source code.</font>
80<li>Before you can use this library's functions, you must first call the <CODE>nn::fs::Initialize</CODE> and <CODE>nn::ptm::CTR::Initialize</CODE> functions, and then call the <CODE>nn::pl::CTR::InitializeGameCoin</CODE> function.
81<li><font color="red">The <CODE>nn::pl::CTR::InitializeGameCoin</CODE> and <CODE>nn::pl::CTR::FinalizeGameCoin</CODE> functions do not support being called multiple times. </font><br>Note that no matter how many times you call <CODE>nn::pl::CTR::InitializeGameCoin</CODE>, the library will close after <CODE>nn::pl::CTR::FinalizeGameCoin</CODE> is called once.
82<li>Because this library's functions only return a single error, <CODE>nn::pl::ResultLackOfGameCoin</CODE>, functions other than <CODE>nn::pl::CTR::UseGameCoin</CODE> only return actual success. For other results, <CODE>nn::pl::ResultGameCoinDataReset</CODE> is sometimes returned. This is handled as a success, even though it indicates that the Play Coin has been initialized because the data was corrupted or for some other reason. Check this if you want to notify the user that Play Coin has been initialized.
83<li><font color="red">The <CODE>nn::pl::CTR::SetGameCoinCountForDebug</CODE> function and the <CODE>nn::pl::CTR::AddGameCoinCountForDebug</CODE> function have been deprecated. </font><br> During development, use the tool described below to set the number of Play Coins that a system has.<br>
84</ul>
85
86<h1>3. Known Bugs</h1>
87<ul>
88<li>None.
89</ul>
90
91<h1>4. Configuration Tool</h1>
92<ul>
93<li>This package has a tool for setting the number of Play Coins that a system has (<CODE>CTR_SDK\tools\TargetTools\CTR-TS\Release\GameCoinSetter.[cia|csu]</CODE>).
94<li>Set a number of coins using Left and Right on the +Control Pad and then apply it by pressing the A Button.
95<li>By pressing the L Button, R Button, and X Button simultaneously you can prevent the number of Play Coins from increasing any more today (although you can still use this tool to increase and decrease the number). There is no way to cancel this feature apart from changing the date in System Settings.
96</ul>
97
98<div align="right"><A href="javascript:history.go(-1)">Back</A></div>
99
100<hr><p>CONFIDENTIAL</p></body>
101</html>