1<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
2<html xml:lang="en-US" lang="en-US" xmlns="http://www.w3.org/1999/xhtml">
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>ctr_WaveConverter</title>
7    <style type="text/css">
8    <!--
9    body {
10    /*
11        font-size       : 10pt;
12    */
13        font-weight     : normal;
14        color           : #000000;
15        margin          : 8px;
16    }
17
18    div {
19        width           : 98%;
20        white-space     : nowrap;
21    }
22
23    div.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        /* RVLプラットフォーム系列 */
37    /*
38        border-color    : #34beed;
39    */
40
41        /* TWLプラットフォーム系列 */
42    /*
43        border-color    : #ff458f;
44    */
45
46        margin          : 4px;
47        padding         : 4px;
48    }
49    H1 {
50      font-size		: 150%;
51      font-family		: Arial;
52      border-bottom-width	: 5px;
53      border-bottom-style	: solid;
54      border-bottom-color	: #FF6600;
55      padding-bottom		: 1px;
56      margin-bottom		: 20px;
57      letter-spacing		: normal;
58      font-weight		: bold;
59    }
60
61    h2 {
62        font-weight     : bold;
63    /*
64        font-size       : 16pt;
65    */
66        font-size       : 150%;
67        border-style    : none none solid double;
68        border-width    : 0px 0px 2px 8px;
69        /* 見出しの線の色を指定 */
70        border-color    : #FF6600;
71
72        /* RVLプラットフォーム系列 */
73    /*
74        border-color    : #34beed;
75    */
76
77        /* TWLプラットフォーム系列 */
78    /*
79        border-color    : #ff458f;
80    */
81
82        margin-left     : 2px;
83        padding-left    : 4px;
84    }
85    CODE {
86      font-family		: "Courier New", monospace;
87      position		: normal;
88      left			: 12px;
89      font-size		: 10pt;
90    }
91    table {
92      margin-top        : 2pt;
93      margin-bottom     : 2pt;
94      margin-left       : 0pt;
95      margin-right      : 0pt;
96      padding-left      : 0pt;
97      padding-right     : 0pt;
98      position          : relative;
99      left              : 12px;
100      font-family       : Arial;
101      font-size         : 10pt;
102      border-style      : none none none none;
103    }
104    td,th {
105      padding           : 2pt;
106      border-width      : 2pt;
107      border-style      : none none none none;
108      font-style        : normal;
109      text-align        : left;
110    }
111    td {
112      background        : #e8f4f4;
113      font-weight       : normal;
114    }
115    th {
116      background        : #c0d8d8;
117      font-weight       : bold;
118    }
119
120    p {
121        margin-left     : 4px;
122    }
123    p.code {
124      font-family		: "Courier New", monospace;
125      position		: normal;
126      left			: 12px;
127      font-size		: 10pt;
128      background            : #e8f4f4;
129    }
130
131    -->
132    </style>
133  </head>
134  <body>
135<h1>ctr_WaveConverter</h1>
136<h2>Description</h2>
137    <p>
138<CODE>ctr_WaveConverter</CODE> is a tool for converting general-purpose waveform file formats (WAV, AIF, AIFF) into the CTR waveform file format (BCWAV).
139    </p>
140    <p>
141With the <a href="../api/nn/snd/CTR/Bcwav/Overview.html"><CODE>nn::snd::Bcwav</CODE> class</a> API you can extract metadata or sample data from BCWAV files.
142    </p>
143<h2>Using the Tool</h2>
144<h3>Commands</h3>
145
146    <p class="code">
147<CODE>% ctr_WaveConverter32.exe [option...] file...</CODE>
148    </p>
149
150<p class="first_ja">You must specify <CODE>file</CODE> (the input file or files). All other options are optional.</p>
151
152<h4>Options</h4>
153    <p>
154      <table class="table"><tbody>
155<tr><th>Options</th><th>Description</th></tr>
156<tr><td><CODE>--pcm16</CODE> </td>
157<td>Uses the 16-bit PCM encoder.</td></tr>
158<tr><td><CODE>--pcm8</CODE> </td>
159<td>Uses the 8-bit PCM encoder.</td></tr>
160<tr><td><CODE>--dspadpcm</CODE> </td>
161<td>Uses the DSP ADPCM encoder. [Default]</td></tr>
162<tr><td><CODE>--imaadpcm</CODE> </td>
163<td>Uses the IMA ADPCM encoder.</td></tr>
164<tr><td><CODE>--loopStart &lt;loopStartFrame&gt;</CODE></td>
165<td>Specifies the loop start frame. This option may be omitted.</td></tr>
166<tr><td><CODE>--loopEnd &lt;loopEndFrame or &quot;end&quot;&gt;</CODE></td>
167<td>Specifies the loop end frame. This option may be omitted.</td></tr>
168<tr><td>-o &lt;filename&gt;</td>
169<td>Specifies the output filename. This option may be omitted.</td></tr>
170<tr><td><CODE>-v, --verbose</CODE> </td>
171<td>Displays a log at runtime.</td></tr>
172<tr><td><CODE>-u, --update</CODE> </td>
173<td>Converts files only if the input files are more recent than the output files. </td></tr>
174<tr><td><CODE>-h, --help</CODE> </td>
175<td>Displays help.</td></tr>
176      </tbody></table>
177    </p>
178    <p>
179If the encoder type is not specified, the DSP ADPCM encoder is used by default.
180    </p>
181    <p>
182You can specify multiple input files. However, if you use the option to specify an output filename (<CODE>-o <I>filename</I></CODE>), the output files, having the same filename, will overwrite each other until only the file created by converting the last-specified input file remains.
183    </p>
184    <p>
185If you do not specify an output filename using the -o option, the output filename will include the encoding type before their extension.<br/>Example for PCM16: <CODE>sound.wav</CODE> → <CODE>sound.pcm16.bcwav</CODE>
186    </p>
187    <p>
188Loop frames can be specified using the <CODE>--loopStart</CODE> and <CODE>--loopEnd</CODE> options. If not specified, and loop frames are specified in the .wav/.aiff file, information in the file is used. If specified, any loop frame specifications in the .wav/.aiff file are ignored. Although loop frames are usually specified as a numeric value, a specification of the form &quot;--loopEnd end&quot; can be made when you want to use the last sample of a waveform as the loop end.
189    </p>
190    <p>
191Loop frames are counted from 0. In other words, &quot;0&quot; indicates the first sample, while &quot;100&quot; indicates the 101st sample. In addition, the sample specified as the loop end frame is not played back. (The sample immediately before the loop end frame is the last sample played.)
192    </p>
193    <p>
194For example, assume a 100-sample wave form. Specify <CODE>--loopStart 90 --loopEnd 96</CODE> to loop between frames 90 through 95 (0, 1, ... 88, 89, 90, 91, 92, 93, 94, 95, 90, 91, 92, 93, 94, 95, 90, 91, ...).
195    <p>
196DSP ADPCM achieves a compressed waveform size of 1/3.5 compared to 16-bit PCM.
197    </p>
198    <p>
199IMA ADPCM achieves a compressed waveform size of 1/4 compared to 16-bit PCM. However, playback features for IMA ADPCM have not been publicly disclosed in a standard application development environment.
200    </p>
201
202<h2>Revision History</h2>
203    <dl class="history">
204      <dt>2010/09/15</dt>
205<dd>Added the --loopStart and --loopEnd  options<br />
206      </dd>
207      <dt>2010/08/30</dt>
208<dd>Changed &quot;nn::snd::Bcwav namespace&quot; to &quot;nn::snd::Bcwave class&quot;.<BR>
209      </dd>
210      <dt>2010/06/23</dt>
211<dd>Initial version.<br />
212      </dd>
213    </dl>
214  <hr><p>CONFIDENTIAL</p></body>
215</html>
216