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    : #CD202C;
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	: #CD202C;
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    : #CD202C;
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
134  </head>
135  <body>
136<h1>ctr_WaveConverter</h1>
137<h2>Description</h2>
138    <p>
139<CODE>ctr_WaveConverter</CODE> is a tool for converting general-purpose waveform file formats (WAV, AIF, AIFF) into the CTR waveform file format (BCWAV).
140    </p>
141    <p>
142With 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.
143    </p>
144<h2>Using the Tool</h2>
145<h3>Commands</h3>
146
147    <p class="code">
148<CODE>% ctr_WaveConverter32.exe [option...] file...</CODE>
149    </p>
150
151<p class="first_ja">You must specify <CODE>file</CODE> (the input file or files). All other options are optional.</p>
152
153<h4>Options</h4>
154    <p>
155      <table class="table"><tbody>
156<tr><th>Options</th><th>Description</th></tr>
157<tr><td><CODE>--pcm16</CODE> </td>
158<td>Uses the 16-bit PCM encoder.</td></tr>
159<tr><td><CODE>--pcm8</CODE> </td>
160<td>Uses the 8-bit PCM encoder.</td></tr>
161<tr><td><CODE>--dspadpcm</CODE> </td>
162<td>Uses the DSP ADPCM encoder. [Default]</td></tr>
163<tr><td><CODE>--imaadpcm</CODE> </td>
164<td>Uses the IMA ADPCM encoder.</td></tr>
165<tr><td><CODE>--loopStart &lt;loopStartFrame&gt;</CODE></td>
166<td>Specifies the loop start frame. This option may be omitted.</td></tr>
167<tr><td><CODE>--loopEnd &lt;loopEndFrame or &quot;end&quot;&gt;</CODE></td>
168<td>Specifies the loop end frame. This option may be omitted.</td></tr>
169<tr><td>-o &lt;filename&gt;</td>
170<td>Specifies the output filename. This option may be omitted.</td></tr>
171<tr><td><CODE>-v, --verbose</CODE> </td>
172<td>Displays a log at runtime.</td></tr>
173<tr><td><CODE>-u, --update</CODE> </td>
174<td>Converts files only if the input files are more recent than the output files. </td></tr>
175<tr><td><CODE>-h, --help</CODE> </td>
176<td>Displays help.</td></tr>
177      </tbody></table>
178    </p>
179    <p>
180If the encoder type is not specified, the DSP ADPCM encoder is used by default.
181    </p>
182    <p>
183You 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.
184    </p>
185    <p>
186If 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>
187    </p>
188    <p>
189Loop 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.
190    </p>
191    <p>
192Loop 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.)
193    </p>
194    <p>
195For 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, ...).
196    </p>
197    <p>
198DSP ADPCM achieves a compressed waveform size of 1/3.5 compared to 16-bit PCM.
199    </p>
200    <p>
201IMA 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.
202    </p>
203
204<h2>Revision History</h2>
205    <dl class="history">
206      <dt>2010/09/15</dt>
207<dd>Added the --loopStart and --loopEnd  options<br />
208      </dd>
209      <dt>2010/08/30</dt>
210<dd>Changed &quot;nn::snd::Bcwav namespace&quot; to &quot;nn::snd::Bcwave class&quot;.<BR>
211      </dd>
212      <dt>2010/06/23</dt>
213<dd>Initial version.<br />
214      </dd>
215    </dl>
216  <hr><p>CONFIDENTIAL</p></body>
217</html>