added japanese translation of sound module. 74/14474/2
Rui Hirokawa [Tue, 29 Apr 2014 08:17:14 +0000 (17:17 +0900)]
Change-Id: I7206c9de80c8a8343dc80d5f0dcf6ee52e829903

14 files changed:
scilab/modules/sound/help/ja_JP/analyze.xml [new file with mode: 0644]
scilab/modules/sound/help/ja_JP/auread.xml [new file with mode: 0644]
scilab/modules/sound/help/ja_JP/auwrite.xml [new file with mode: 0644]
scilab/modules/sound/help/ja_JP/beep.xml [new file with mode: 0644]
scilab/modules/sound/help/ja_JP/lin2mu.xml [new file with mode: 0644]
scilab/modules/sound/help/ja_JP/loadwave.xml [new file with mode: 0644]
scilab/modules/sound/help/ja_JP/mapsound.xml [new file with mode: 0644]
scilab/modules/sound/help/ja_JP/mu2lin.xml [new file with mode: 0644]
scilab/modules/sound/help/ja_JP/playsnd.xml [new file with mode: 0644]
scilab/modules/sound/help/ja_JP/savewave.xml [new file with mode: 0644]
scilab/modules/sound/help/ja_JP/sound.xml [new file with mode: 0644]
scilab/modules/sound/help/ja_JP/soundsec.xml [new file with mode: 0644]
scilab/modules/sound/help/ja_JP/wavread.xml [new file with mode: 0644]
scilab/modules/sound/help/ja_JP/wavwrite.xml [new file with mode: 0644]

diff --git a/scilab/modules/sound/help/ja_JP/analyze.xml b/scilab/modules/sound/help/ja_JP/analyze.xml
new file mode 100644 (file)
index 0000000..bebfea6
--- /dev/null
@@ -0,0 +1,99 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+<!--
+    * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
+    * Copyright (C) ????-2006 - INRIA - Scilab 
+    * 
+    * This file must be used under the terms of the CeCILL.
+    * This source file is licensed as described in the file COPYING, which
+    * you should have received as part of this distribution.  The terms
+    * are also available at    
+    * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt
+    *
+ -->
+
+<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="ja" xml:id="analyze">
+    
+    <refnamediv>
+        
+        <refname>analyze</refname>
+        
+        <refpurpose>サウンド信号の周波数プロット</refpurpose>
+        
+    </refnamediv>
+    
+    <refsection>
+        
+        <title>引数</title>
+        
+        <variablelist>
+            
+            <varlistentry>
+                
+                <term>fmin,fmax,rate,points</term>
+                
+                <listitem>
+                    
+                    <para>スカラー. デフォルト値 fmin=100,fmax=1500,rate=22050,points=8192;</para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+        </variablelist>
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>説明</title>
+        
+        <para>
+            
+            サンプリングレート<literal>rate</literal>の
+            
+            信号<literal>w</literal> の周波数プロットを作成します.
+            
+            データ長は<literal>points</literal>である必要があります.
+            
+            プロットされる周波数の最大値は<literal>fmax</literal>, 
+            
+            最小値は<literal>fmin</literal>となります.
+            
+        </para>
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>例</title>
+        
+        <programlisting role="example"><![CDATA[ 
+// まず0.5秒分のサウンドパラメータを作成.
+t=soundsec(0.5);
+
+// 次にサウンドを生成.
+s=sin(440*t)+sin(220*t)/2+sin(880*t)/2;
+[nr,nc]=size(t);
+s(nc/2:nc)=sin(330*t(nc/2:nc));
+analyze(s);
+ ]]></programlisting>
+        
+        <scilab:image>
+            
+            t=soundsec(0.5);
+            
+            s=sin(440*t)+sin(220*t)/2+sin(880*t)/2;
+            
+            [nr,nc]=size(t);
+            
+            s(nc/2:nc)=sin(330*t(nc/2:nc));
+            
+            analyze(s);
+            
+        </scilab:image>
+        
+    </refsection>
+    
+</refentry>
+
diff --git a/scilab/modules/sound/help/ja_JP/auread.xml b/scilab/modules/sound/help/ja_JP/auread.xml
new file mode 100644 (file)
index 0000000..f8b2b25
--- /dev/null
@@ -0,0 +1,231 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+<!--
+    * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
+    * Copyright (C) ????-2008 - INRIA - Scilab 
+    * 
+    * This file must be used under the terms of the CeCILL.
+    * This source file is licensed as described in the file COPYING, which
+    * you should have received as part of this distribution.  The terms
+    * are also available at    
+    * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt
+    *
+    -->
+
+<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="ja" xml:id="auread">
+    
+    <refnamediv>
+        
+        <refname>auread</refname>
+        
+        <refpurpose>.au サウンドファイルを読み込む</refpurpose>
+        
+    </refnamediv>
+    
+    <refsynopsisdiv>
+        
+        <title>呼び出し手順</title>
+        
+        <synopsis>y=auread(aufile)
+            
+            y=auread(aufile,ext)
+            
+            [y,Fs,bits]=auread(aufile)
+            
+            [y,Fs,bits]=auread(aufile,ext)
+            
+        </synopsis>
+        
+    </refsynopsisdiv>
+    
+    <refsection>
+        
+        <title>引数</title>
+        
+        <variablelist>
+            
+            <varlistentry>
+                
+                <term>aufile</term>
+                
+                <listitem>
+                    
+                    <para>文字列 (拡張子が指定されない場合,拡張子.auが追加されます)</para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+            <varlistentry>
+                
+                <term>Fs</term>
+                
+                <listitem>
+                    
+                    <para>...</para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+            <varlistentry>
+                
+                <term>[]</term>
+                
+                <listitem>
+                    
+                    <para>整数, サンプリング周波数(単位:Hz).</para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+            <varlistentry>
+                
+                <term>ext</term>
+                
+                <listitem>
+                    
+                    <para>
+                        
+                        文字列(<literal>'size'</literal> または
+                        
+                        <literal>'snd'</literal>) または
+                        
+                        整数 (n サンプルを読み込む) または
+                        
+                        1 x 2 整数ベクトル [n1,n2] (n1 から n2を読み込む).
+                        
+                    </para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+        </variablelist>
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>説明</title>
+        
+        <para>
+            
+            <literal>.au</literal>サウンドファイルを読み込むための
+            
+            ユーティリティ関数.
+            
+            <literal>auread(aufile)</literal> は
+            
+            aufile文字列で指定されたサウンドファイルを読み込み,
+            
+            yにサンプリングデータを返します.
+            
+            大きさは範囲[-1,+1]となります.
+            
+        </para>
+        
+        <para>
+            
+            以下の形式の複数チャネルデータをサポートします:
+            
+            8-bit mu-law, 8-, 16-, および 32-bitリニア, および浮動小数点.
+            
+        </para>
+        
+        <para>
+            
+            <literal>[y,Fs,bits]=auread(aufile)</literal> は
+            
+            ヘルツ単位のサンプリングレート (Fs)と,
+            
+            ファイル中でデータをエンコードする際に使用される
+            
+            サンプル毎のビット数を返します.
+            
+        </para>
+        
+        <para>
+            
+            <literal>auread(aufile,n)</literal> は,各チャネルから
+            
+            最初のnサンプルを返します.
+            
+        </para>
+        
+        <para>
+            
+            <literal>auread(aufile,[n1,n2])</literal> は,
+            
+            サンプル n1 から n2までを返します.
+            
+        </para>
+        
+        <para>
+            
+            <literal>auread(aufile,'size')</literal> は,
+            
+            実際のオーディオデータの配置でファイル中に含まれる
+            
+            オーディオデータの大きさを,
+            
+            [samples channels] のベクトルとして返します.
+            
+        </para>
+        
+        <para>
+            
+            <literal>auread(aufile,'snd')</literal> は
+            
+            サンプルとデータに関する情報を tlist として返します.
+            
+        </para>
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>例</title>
+        
+        <programlisting role="example"><![CDATA[ 
+y=wavread('SCI/modules/sound/demos/chimes.wav');
+
+// デフォルトは 8-bits mu-law です
+auwrite(y,TMPDIR+'/tmp.au');
+y1=auread(TMPDIR+'/tmp.au');
+max(abs(y-y1))
+ ]]></programlisting>
+        
+    </refsection>
+    
+    <refsection role="see also">
+        
+        <title>参照</title>
+        
+        <simplelist type="inline">
+            
+            <member>
+                
+                <link linkend="savewave">savewave</link>
+                
+            </member>
+            
+            <member>
+                
+                <link linkend="analyze">analyze</link>
+                
+            </member>
+            
+            <member>
+                
+                <link linkend="mapsound">mapsound</link>
+                
+            </member>
+            
+        </simplelist>
+        
+    </refsection>
+    
+</refentry>
+
diff --git a/scilab/modules/sound/help/ja_JP/auwrite.xml b/scilab/modules/sound/help/ja_JP/auwrite.xml
new file mode 100644 (file)
index 0000000..a3984e3
--- /dev/null
@@ -0,0 +1,229 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+<!--
+    * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
+    * Copyright (C) ????-2006 - INRIA - Scilab
+    *
+    * This file must be used under the terms of the CeCILL.
+    * This source file is licensed as described in the file COPYING, which
+    * you should have received as part of this distribution.  The terms
+    * are also available at
+    * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt
+    *
+    -->
+
+<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="ja" xml:id="auwrite">
+    
+    <refnamediv>
+        
+        <refname>auwrite</refname>
+        
+        <refpurpose>.auサウンドファイルを書き込む</refpurpose>
+        
+    </refnamediv>
+    
+    <refsynopsisdiv>
+        
+        <title>呼び出し手順</title>
+        
+        <synopsis>auwrite(y,aufile)
+            
+            auwrite(y,Fs,aufile)
+            
+            auwrite(y,Fs,bits,aufile)
+            
+            auwrite(y,Fs,bits,method,aufile)
+            
+        </synopsis>
+        
+    </refsynopsisdiv>
+    
+    <refsection>
+        
+        <title>引数</title>
+        
+        <variablelist>
+            
+            <varlistentry>
+                
+                <term>y</term>
+                
+                <listitem>
+                    
+                    <para>実数ベクトルまたは行列,エントリは[-1,1]の範囲.</para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+            <varlistentry>
+                
+                <term>aufile</term>
+                
+                <listitem>
+                    
+                    <para>文字列(拡張子が指定されない場合,拡張子.auが追加されます)</para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+            <varlistentry>
+                
+                <term>Fs</term>
+                
+                <listitem>
+                    
+                    <para>整数, 周波数サンプリング(単位:Hz).</para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+            <varlistentry>
+                
+                <term>bits</term>
+                
+                <listitem>
+                    
+                    <para>整数, エンコーディングのビット数.</para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+            <varlistentry>
+                
+                <term>method</term>
+                
+                <listitem>
+                    
+                    <para>
+                        
+                        文字列, <literal>'mu'</literal> (デフォルト) または
+                        
+                        <literal>'linear'</literal>, エンコーディング手法.
+                        
+                    </para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+        </variablelist>
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>説明</title>
+        
+        <para>
+            
+            <literal>.au</literal> サウンドファイルを
+            
+            保存するためのユーティリティ関数.
+            
+            <literal>auwrite(y,aufile)</literal> は,
+            
+            文字列aufileで指定されたサウンドファイルを書き込みます.
+            
+            データは列毎に1チャネルで整列している必要があります.
+            
+            大きさが範囲[-1,+1]の外側にある場合,無視されます.
+            
+            サポートされる複数チャネルデータは,
+            
+            8-bit mu-law, および8, 16, 32, 64 ビット線形形式です.
+            
+        </para>
+        
+        <para>
+            
+            <literal>auwrite(y,Fs,aufile)</literal> は,
+            
+            データのサンプル・レート<literal>Fs</literal>(単位:Hz)を
+            
+            指定します.
+            
+        </para>
+        
+        <para>
+            
+            <literal>auwrite(y,Fs,bits,aufile)</literal> は,
+            
+            エンコーダのビット数を選択します.
+            
+            指定可能な設定は[8,16,32,64]ビットです.
+            
+            <literal>auwrite(y,Fs,bits,method,aufile)</literal> により,
+            
+            エンコーディング手法を選択でき,
+            
+            'mu' または 'linear'のどちらかを指定します.
+            
+            'mu'を選択する場合,ビット数は 8 とする必要があることに
+            
+            注意してください.デフォルトの手法は 8ビット 
+            
+            mu-lawエンコーディングです.
+            
+        </para>
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>例</title>
+        
+        <programlisting role="example"><![CDATA[
+A=matrix(1:6,2,3);
+auwrite(A/6,22050,64,'linear',TMPDIR+'/foo.au');
+B=auread(TMPDIR+'/foo.au');
+max(abs(A- round(B*6)))
+ ]]></programlisting>
+        
+    </refsection>
+    
+    <refsection role="see also">
+        
+        <title>参照</title>
+        
+        <simplelist type="inline">
+            
+            <member>
+                
+                <link linkend="auread">auread</link>
+                
+            </member>
+            
+            <member>
+                
+                <link linkend="wavread">wavread</link>
+                
+            </member>
+            
+            <member>
+                
+                <link linkend="savewave">savewave</link>
+                
+            </member>
+            
+            <member>
+                
+                <link linkend="analyze">analyze</link>
+                
+            </member>
+            
+            <member>
+                
+                <link linkend="mapsound">mapsound</link>
+                
+            </member>
+            
+        </simplelist>
+        
+    </refsection>
+    
+</refentry>
+
diff --git a/scilab/modules/sound/help/ja_JP/beep.xml b/scilab/modules/sound/help/ja_JP/beep.xml
new file mode 100644 (file)
index 0000000..eab0c49
--- /dev/null
@@ -0,0 +1,87 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+<!--
+    * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
+    * Copyright (C) ????-2006 - INRIA - Allan CORNET 
+    * 
+    * This file must be used under the terms of the CeCILL.
+    * This source file is licensed as described in the file COPYING, which
+    * you should have received as part of this distribution.  The terms
+    * are also available at    
+    * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt
+    *
+    -->
+
+<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="ja" xml:id="beep">
+    
+    <refnamediv>
+        
+        <refname>beep</refname>
+        
+        <refpurpose>ビープ音を生成</refpurpose>
+        
+    </refnamediv>
+    
+    <refsynopsisdiv>
+        
+        <title>呼び出し手順</title>
+        
+        <synopsis>beep();
+            
+            beep('on')
+            
+            beep('off')
+            
+            s=beep()
+            
+        </synopsis>
+        
+    </refsynopsisdiv>
+    
+    <refsection>
+        
+        <title>説明</title>
+        
+        <para>
+            
+            <literal>beep()</literal> は,使用する
+            
+            コンピュータのデフォルトのビープ音を生成します.
+            
+        </para>
+        
+        <para>
+            
+            <literal>beep('on')</literal> はビープをonにします.
+            
+        </para>
+        
+        <para>
+            
+            <literal>beep('off')</literal>はビープをoffにします.
+            
+        </para>
+        
+        <para>
+            
+            <literal>s=beep()</literal> は現在のビープモード(on または off)
+            
+            を返します.
+            
+        </para>
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>例</title>
+        
+        <programlisting role="example"><![CDATA[
+beep() // サウンドを作成
+beep("off") // サウンドを無効にする
+]]></programlisting>
+        
+    </refsection>
+    
+</refentry>
+
diff --git a/scilab/modules/sound/help/ja_JP/lin2mu.xml b/scilab/modules/sound/help/ja_JP/lin2mu.xml
new file mode 100644 (file)
index 0000000..27738d9
--- /dev/null
@@ -0,0 +1,104 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+<!--
+    * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
+    * Copyright (C) ????-2006 - INRIA - Scilab 
+    * 
+    * This file must be used under the terms of the CeCILL.
+    * This source file is licensed as described in the file COPYING, which
+    * you should have received as part of this distribution.  The terms
+    * are also available at    
+    * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt
+    *
+    -->
+
+<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="ja" xml:id="lin2mu">
+    
+    <refnamediv>
+        
+        <refname>lin2mu</refname>
+        
+        <refpurpose>linear信号をmu-lawエンコーディングに変換</refpurpose>
+        
+    </refnamediv>
+    
+    <refsynopsisdiv>
+        
+        <title>呼び出し手順</title>
+        
+        <synopsis>mu=lin2mu(y)</synopsis>
+        
+    </refsynopsisdiv>
+    
+    <refsection>
+        
+        <title>引数</title>
+        
+        <variablelist>
+            
+            <varlistentry>
+                
+                <term>y</term>
+                
+                <listitem>
+                    
+                    <para>実数ベクトル</para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+            <varlistentry>
+                
+                <term>mu</term>
+                
+                <listitem>
+                    
+                    <para>実数ベクトル</para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+        </variablelist>
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>説明</title>
+        
+        <para>
+            
+            ユーティリティ関数: 線形信号をmu-lawエンコーディングに変換します.
+            
+            <literal>mu = lin2mu(y)</literal> は,
+            
+            大きさが-1 &lt;= y &lt;= の範囲の線形オーディオ信号を
+            
+            範囲が0 &lt;= mu &lt;= 255の
+            
+            mu-law に変換します.
+            
+        </para>
+        
+    </refsection>
+    
+    <refsection role="see also">
+        
+        <title>参照</title>
+        
+        <simplelist type="inline">
+            
+            <member>
+                
+                <link linkend="mu2lin">mu2lin</link>
+                
+            </member>
+            
+        </simplelist>
+        
+    </refsection>
+    
+</refentry>
+
diff --git a/scilab/modules/sound/help/ja_JP/loadwave.xml b/scilab/modules/sound/help/ja_JP/loadwave.xml
new file mode 100644 (file)
index 0000000..de0669d
--- /dev/null
@@ -0,0 +1,159 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+<!--
+    * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
+    * Copyright (C) ????-2006 - INRIA - Scilab 
+    * 
+    * This file must be used under the terms of the CeCILL.
+    * This source file is licensed as described in the file COPYING, which
+    * you should have received as part of this distribution.  The terms
+    * are also available at    
+    * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt
+    *
+    -->
+
+<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns3="http://www.w3.org/1999/xhtml" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:id="loadwave" xml:lang="ja">
+    
+    <refnamediv>
+        
+        <refname>loadwave</refname>
+        
+        <refpurpose>サウンドwavファイルをscilabに読み込む</refpurpose>
+        
+    </refnamediv>
+    
+    <refsynopsisdiv>
+        
+        <title>呼び出し手順</title>
+        
+        <synopsis>x=loadwave(filename);
+            
+            [x,y]=loadwave(filename);
+            
+        </synopsis>
+        
+    </refsynopsisdiv>
+    
+    <refsection>
+        
+        <title>引数</title>
+        
+        <variablelist>
+            
+            <varlistentry>
+                
+                <term>filename</term>
+                
+                <listitem>
+                    
+                    <para>文字列. 読み込むwavファイルのパス</para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+            <varlistentry>
+                
+                <term>x</term>
+                
+                <listitem>
+                    
+                    <para>行列,各チャネル毎に1行</para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+            <varlistentry>
+                
+                <term>y</term>
+                
+                <listitem>
+                    
+                    <para>
+                        
+                        ベクトル,
+                        
+                        [データ形式, チャネル数, 各チャネルのサンプル/秒,
+                        
+                        所要バイト/秒の推定値,
+                        
+                        基本サンプリングブロックのバイト並び,
+                        
+                        ビット/サンプル, サウンドデータ長(単位:バイト),
+                        
+                        バイト/サンプル(チャネル毎)].
+                        
+                    </para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+        </variablelist>
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>説明</title>
+        
+        <para>
+            
+            サウンドファイル<literal>.wav</literal>をScilabに行列として読み込みます.
+            
+            yが指定された場合, サンプルに関する情報が代入されます
+            
+            <literal>loadwave</literal>により送信されたメッセージを参照).
+            
+        </para>
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>例</title>
+        
+        <programlisting role="example"><![CDATA[ 
+// まず0.5秒分のサウンドパラメータを作成.
+t=soundsec(0.5);
+
+// 次にサウンドを生成: 2チャンネルのサウンド.
+s=[sin(2*%pi*440*t);sin(2*%pi*350*t)];
+savewave(TMPDIR+'/foo.wav',s);
+s1=loadwave(TMPDIR+'/foo.wav');
+max(abs(s1-s))
+ ]]></programlisting>
+        
+    </refsection>
+    
+    <refsection role="see also">
+        
+        <title>参照</title>
+        
+        <simplelist type="inline">
+            
+            <member>
+                
+                <link linkend="savewave">savewave</link>
+                
+            </member>
+            
+            <member>
+                
+                <link linkend="analyze">analyze</link>
+                
+            </member>
+            
+            <member>
+                
+                <link linkend="mapsound">mapsound</link>
+                
+            </member>
+            
+        </simplelist>
+        
+    </refsection>
+    
+</refentry>
+
diff --git a/scilab/modules/sound/help/ja_JP/mapsound.xml b/scilab/modules/sound/help/ja_JP/mapsound.xml
new file mode 100644 (file)
index 0000000..963b095
--- /dev/null
@@ -0,0 +1,107 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+<!--
+    * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
+    * Copyright (C) ????-2006 - INRIA - Scilab 
+    * 
+    * This file must be used under the terms of the CeCILL.
+    * This source file is licensed as described in the file COPYING, which
+    * you should have received as part of this distribution.  The terms
+    * are also available at    
+    * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt
+    *
+    -->
+
+<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="ja" xml:id="mapsound">
+    
+    <refnamediv>
+        
+        <refname>mapsound</refname>
+        
+        <refpurpose>サウンドマップをプロット</refpurpose>
+        
+    </refnamediv>
+    
+    <refsynopsisdiv>
+        
+        <title>呼び出し手順</title>
+        
+        <synopsis>mapsound (w,dt,fmin,fmax,simpl,rate)</synopsis>
+        
+    </refsynopsisdiv>
+    
+    <refsection>
+        
+        <title>引数</title>
+        
+        <variablelist>
+            
+            <varlistentry>
+                
+                <term>dt,fmin,fmax,simpl,rate</term>
+                
+                <listitem>
+                    
+                    <para>スカラー. デフォルト値 dt=0.1,fmin=100,fmax=1500,simpl=1,rate=22050;</para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+        </variablelist>
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>説明</title>
+        
+        <para>
+            
+            音のサウンドマップをプロット. 時間増分dt毎にFFTを行います.
+            
+            <literal>rate</literal> はサンプリング・レートです. 
+            
+            速度面を考慮して<literal>simpl</literal> 点が収集されます.
+            
+            <literal>fmin</literal> および <literal>fmax</literal> が
+            
+            グラフィック境界として使用されます.
+            
+        </para>
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>例</title>
+        
+        <programlisting role="example"><![CDATA[ 
+// まず0.5秒分のサウンドパラメータを生成
+t=soundsec(0.5);
+
+// 次にサウンドを生成.
+s=sin(440*t)+sin(220*t)/2+sin(880*t)/2;
+[nr,nc]=size(t);
+s(nc/2:nc)=sin(330*t(nc/2:nc));
+mapsound(s);
+ ]]></programlisting>
+        
+        <scilab:image>
+            
+            t=soundsec(0.5);
+            
+            s=sin(440*t)+sin(220*t)/2+sin(880*t)/2;
+            
+            [nr,nc]=size(t);
+            
+            s(nc/2:nc)=sin(330*t(nc/2:nc));
+            
+            mapsound(s);
+            
+        </scilab:image>
+        
+    </refsection>
+    
+</refentry>
+
diff --git a/scilab/modules/sound/help/ja_JP/mu2lin.xml b/scilab/modules/sound/help/ja_JP/mu2lin.xml
new file mode 100644 (file)
index 0000000..6d3e674
--- /dev/null
@@ -0,0 +1,114 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+<!--
+    * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
+    * Copyright (C) ????-2006 - INRIA - Scilab 
+    * 
+    * This file must be used under the terms of the CeCILL.
+    * This source file is licensed as described in the file COPYING, which
+    * you should have received as part of this distribution.  The terms
+    * are also available at    
+    * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt
+    *
+    -->
+
+<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="ja" xml:id="mu2lin">
+    
+    <refnamediv>
+        
+        <refname>mu2lin</refname>
+        
+        <refpurpose>mu-lawエンコーディングを線形信号に変換</refpurpose>
+        
+    </refnamediv>
+    
+    <refsynopsisdiv>
+        
+        <title>呼び出し手順</title>
+        
+        <synopsis>mu=lin2mu(y)</synopsis>
+        
+    </refsynopsisdiv>
+    
+    <refsection>
+        
+        <title>引数</title>
+        
+        <variablelist>
+            
+            <varlistentry>
+                
+                <term>y</term>
+                
+                <listitem>
+                    
+                    <para>実数ベクトル</para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+            <varlistentry>
+                
+                <term>mu</term>
+                
+                <listitem>
+                    
+                    <para>実数ベクトル</para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+        </variablelist>
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>説明</title>
+        
+        <para>
+            
+            ユーティリティ関数: <literal>y=mu2lin(mu)</literal> は,
+            
+            0 &lt;= mu &lt;= 255の範囲で保存された
+            
+            mu-law形式の8-bitオーディオ信号を,
+            
+            大きさが範囲 -s &lt; y &lt; s (ただし,s = 32124/32768 ~= .9803.  )の
+            
+            線形信号に変換します.
+            
+            入力 mu は,しばしば,バイトエンコードされたオーディオファイルを読み込む
+            
+            mget(...,'uc') により取得されます.
+            
+            Craig Reese
+            
+            (IDA/Supercomputing Research Center Joe Campbell: Department of Defense)
+            
+            によるCプログラムを翻訳.
+            
+        </para>
+        
+    </refsection>
+    
+    <refsection role="see also">
+        
+        <title>参照</title>
+        
+        <simplelist type="inline">
+            
+            <member>
+                
+                <link linkend="mu2lin">mu2lin</link>
+                
+            </member>
+            
+        </simplelist>
+        
+    </refsection>
+    
+</refentry>
+
diff --git a/scilab/modules/sound/help/ja_JP/playsnd.xml b/scilab/modules/sound/help/ja_JP/playsnd.xml
new file mode 100644 (file)
index 0000000..4273446
--- /dev/null
@@ -0,0 +1,158 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+<!--
+    * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
+    * Copyright (C) ????-2006 - INRIA - Scilab
+    *
+    * This file must be used under the terms of the CeCILL.
+    * This source file is licensed as described in the file COPYING, which
+    * you should have received as part of this distribution.  The terms
+    * are also available at
+    * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt
+    *
+    -->
+
+<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="ja" xml:id="playsnd">
+    
+    <refnamediv>
+        
+        <refname>playsnd</refname>
+        
+        <refpurpose>サウンドプレイヤー機能</refpurpose>
+        
+    </refnamediv>
+    
+    <refsynopsisdiv>
+        
+        <title>呼び出し手順</title>
+        
+        <synopsis>[]=playsnd(y)
+            
+            []=playsnd(y,rate,bits [,command])
+            
+        </synopsis>
+        
+    </refsynopsisdiv>
+    
+    <refsection>
+        
+        <title>引数</title>
+        
+        <variablelist>
+            
+            <varlistentry>
+                
+                <term>y</term>
+                
+                <listitem>
+                    
+                    <para>行列. 各行は1チャネルを記述</para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+            <varlistentry>
+                
+                <term>fs</term>
+                
+                <listitem>
+                    
+                    <para>実数, サンプリング周波数 (デフォルト値は22050).</para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+            <varlistentry>
+                
+                <term>bits</term>
+                
+                <listitem>
+                    
+                    <para>実数, ビット長 (通常 8 または 16). 未使用.</para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+            <varlistentry>
+                
+                <term>command</term>
+                
+                <listitem>
+                    
+                    <para>
+                        
+                        Unixシステムのみで使用され,
+                        
+                        サウンド(wav)ファイルを演奏する際に使用されるコマンド名を指定します.
+                        
+                        デフォルト値は<literal>play</literal>です.
+                        
+                        <literal>/dev/audio</literal>が指定された場合,
+                        
+                        8ビットmu-law rawサウンドが生成され,
+                        
+                        <literal>/dev/audio</literal>に送信されます.
+                        
+                    </para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+        </variablelist>
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>説明</title>
+        
+        <para>
+            
+            Scilab行列で指定されたマルチチャネル信号を演奏します.
+            
+            ただし, サウンドのサンプリングレートは<literal>rate</literal>です.
+            
+        </para>
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>例</title>
+        
+        <programlisting role="example"><![CDATA[
+// a two channel signal
+y=loadwave("SCI/modules/sound/demos/chimes.wav");
+playsnd(y)
+ ]]></programlisting>
+        
+    </refsection>
+    
+    <refsection role="see also">
+        
+        <title>参照</title>
+        
+        <simplelist type="inline">
+            
+            <member>
+                
+                <link linkend="lin2mu">lin2mu</link>
+                
+            </member>
+            
+            <member>
+                
+                <link linkend="wavread">wavread</link>
+                
+            </member>
+            
+        </simplelist>
+        
+    </refsection>
+    
+</refentry>
+
diff --git a/scilab/modules/sound/help/ja_JP/savewave.xml b/scilab/modules/sound/help/ja_JP/savewave.xml
new file mode 100644 (file)
index 0000000..c63be1f
--- /dev/null
@@ -0,0 +1,151 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+<!--
+    * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
+    * Copyright (C) ????-2006 - INRIA - Scilab 
+    * 
+    * This file must be used under the terms of the CeCILL.
+    * This source file is licensed as described in the file COPYING, which
+    * you should have received as part of this distribution.  The terms
+    * are also available at    
+    * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt
+    *
+    -->
+
+<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns4="http://www.w3.org/1999/xhtml" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:id="savewave" xml:lang="ja">
+    
+    <refnamediv>
+        
+        <refname>savewave</refname>
+        
+        <refpurpose>データをサウンドwavファイルに保存.</refpurpose>
+        
+    </refnamediv>
+    
+    <refsynopsisdiv>
+        
+        <title>呼び出し手順</title>
+        
+        <synopsis>savewave(filename,x [, rate , nbits]);</synopsis>
+        
+    </refsynopsisdiv>
+    
+    <refsection>
+        
+        <title>引数</title>
+        
+        <variablelist>
+            
+            <varlistentry>
+                
+                <term>filename</term>
+                
+                <listitem>
+                    
+                    <para>文字列. 出力wavファイルのパス</para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+            <varlistentry>
+                
+                <term>x</term>
+                
+                <listitem>
+                    
+                    <para>mxn 行列, ただし, m はチャンネル数, n は各チャネルの
+                        
+                        サンプル数
+                        
+                    </para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+            <varlistentry>
+                
+                <term>rate</term>
+                
+                <listitem>
+                    
+                    <para>
+                        
+                        サンプリング・レート(サンプル数/秒)を指定するスカラー.
+                        
+                        22050 がデフォルト値です.
+                        
+                    </para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+        </variablelist>
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>説明</title>
+        
+        <para>
+            
+            x をwavサウンドファイルに保存します.
+            
+            他のサウンドファイルを<literal>sox</literal>プログラムにより
+            
+            wavファイルに変換できます.
+            
+        </para>
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>例</title>
+        
+        <programlisting role="example"><![CDATA[ 
+// まず0.5秒分のサウンドパラメータを作成.
+t=soundsec(0.5);
+
+// 次にサウンドを生成.
+s=sin(2*%pi*440*t)+sin(2*%pi*220*t)/2+sin(2*%pi*880*t)/2;
+[nr,nc]=size(t);
+s(nc/2:nc)=sin(2*%pi*330*t(nc/2:nc));
+savewave(TMPDIR+'/foo.wav',s);
+ ]]></programlisting>
+        
+    </refsection>
+    
+    <refsection role="see also">
+        
+        <title>参照</title>
+        
+        <simplelist type="inline">
+            
+            <member>
+                
+                <link linkend="loadwave">loadwave</link>
+                
+            </member>
+            
+            <member>
+                
+                <link linkend="analyze">analyze</link>
+                
+            </member>
+            
+            <member>
+                
+                <link linkend="mapsound">mapsound</link>
+                
+            </member>
+            
+        </simplelist>
+        
+    </refsection>
+    
+</refentry>
+
diff --git a/scilab/modules/sound/help/ja_JP/sound.xml b/scilab/modules/sound/help/ja_JP/sound.xml
new file mode 100644 (file)
index 0000000..84e50dc
--- /dev/null
@@ -0,0 +1,170 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+<!--
+    * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
+    * Copyright (C) ????-2007 - INRIA - Scilab
+    *
+    * This file must be used under the terms of the CeCILL.
+    * This source file is licensed as described in the file COPYING, which
+    * you should have received as part of this distribution.  The terms
+    * are also available at
+    * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt
+    *
+    -->
+
+<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="ja" xml:id="sound">
+    
+    <refnamediv>
+        
+        <refname>sound</refname>
+        
+        <refpurpose>サウンドプレイヤー機能</refpurpose>
+        
+    </refnamediv>
+    
+    <refsynopsisdiv>
+        
+        <title>呼び出し手順</title>
+        
+        <synopsis>sound(y [,fs,bits,command)</synopsis>
+        
+    </refsynopsisdiv>
+    
+    <refsection>
+        
+        <title>引数</title>
+        
+        <variablelist>
+            
+            <varlistentry>
+                
+                <term>y</term>
+                
+                <listitem>
+                    
+                    <para>実数ベクトル</para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+            <varlistentry>
+                
+                <term>fs</term>
+                
+                <listitem>
+                    
+                    <para>実数, サンプリング周波数(単位:サンプル/秒) (デフォルト値は 22050)</para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+            <varlistentry>
+                
+                <term>bits</term>
+                
+                <listitem>
+                    
+                    <para>実数, ビット数(未使用)</para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+            <varlistentry>
+                
+                <term>command</term>
+                
+                <listitem>
+                    
+                    <para>
+                        
+                        Unixシステムでのみ使用され,
+                        
+                        サウンド(wav)ファイルを演奏する際に使用される
+                        
+                        コマンドの名前を指定します.
+                        
+                        デフォルト値は<literal>aplay</literal>です.
+                        
+                        <literal>/dev/audio</literal>を指定した場合,
+                        
+                        8ビットmu-law raw サウンドファイルが作成され,
+                        
+                        <literal>/dev/audio</literal>に送信されます.
+                        
+                    </para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+        </variablelist>
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>説明</title>
+        
+        <para>
+            
+            <literal>sound(y,fs)</literal>は,行列<literal>y</literal> 
+            
+            (サンプリング周波数fs)で指定されたサウンド信号を演奏します.
+            
+            実際には,この関数は <literal>playsnd</literal>のラッパーです.
+            
+            yの値は範囲-1.0 &lt;= y &lt;= 1.0にあると仮定されます.
+            
+            この範囲の外側の値は丸められます.
+            
+            <literal>y</literal> の行数はチャネル数を指定します.
+            
+            <literal>sound(y)</literal> は,デフォルトのサンプリング・レート
+            
+            22050 サンプル/秒でサウンドを演奏します.
+            
+            <literal>sound(y,fs,nbits)</literal> は,
+            
+            可能な場合(この機能は未使用),
+            
+            <literal>nbits</literal> ビット/サンプルでサウンドを演奏します.
+            
+            多くのプラットフォームは8または16ビットをサポートします.
+            
+        </para>
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>例</title>
+        
+        <programlisting role="example"><![CDATA[
+// 2チャンネル信号
+y=loadwave("SCI/modules/sound/demos/chimes.wav");
+sound(y)
+ ]]></programlisting>
+        
+    </refsection>
+    
+    <refsection role="see also">
+        
+        <title>参照</title>
+        
+        <simplelist type="inline">
+            
+            <member>
+                
+                <link linkend="playsnd">playsnd</link>
+                
+            </member>
+            
+        </simplelist>
+        
+    </refsection>
+    
+</refentry>
+
diff --git a/scilab/modules/sound/help/ja_JP/soundsec.xml b/scilab/modules/sound/help/ja_JP/soundsec.xml
new file mode 100644 (file)
index 0000000..d8460a4
--- /dev/null
@@ -0,0 +1,145 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+<!--
+    * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
+    * Copyright (C) ????-2006 - INRIA - Scilab 
+    * 
+    * This file must be used under the terms of the CeCILL.
+    * This source file is licensed as described in the file COPYING, which
+    * you should have received as part of this distribution.  The terms
+    * are also available at
+    * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt
+    *
+    -->
+
+<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="ja" xml:id="soundsec">
+    
+    <refnamediv>
+        
+        <refname>soundsec</refname>
+        
+        <refpurpose>
+            
+            周波数<literal>freq</literal> Hzで
+            
+            <literal>t</literal>秒分のサンプルベクトルを生成.
+            
+        </refpurpose>
+        
+    </refnamediv>
+    
+    <refsynopsisdiv>
+        
+        <title>呼び出し手順</title>
+        
+        <synopsis>samples=soundsec(t [,freq])</synopsis>
+        
+    </refsynopsisdiv>
+    
+    <refsection>
+        
+        <title>引数</title>
+        
+        <variablelist>
+            
+            <varlistentry>
+                
+                <term>t</term>
+                
+                <listitem>
+                    
+                    <para>正の実数の1行1列行列, サンプルの時間長.</para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+            <varlistentry>
+                
+                <term>freq</term>
+                
+                <listitem>
+                    
+                    <para>
+                        
+                        正の実数の1行1列行列, サンプル/秒の周波数.
+                        
+                    </para>
+                    
+                    <para>デフォルト値は22050 Hz</para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+        </variablelist>
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>説明</title>
+        
+        <para>
+            
+            サンプル・レート<literal>freq</literal>で
+            
+            0から <literal>t</literal> 秒までの時間ベクトルを生成します.
+            
+        </para>
+        
+        <para>
+            
+            サンプルは常に <literal>[0,t[</literal>(上界を除く)に整合するように生成されます.
+            
+        </para>
+        
+        <para>
+            
+            0 を<literal>t</literal> または <literal>freq</literal> に指定すると,
+            
+            空の行列が返されます.
+            
+        </para>
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>例</title>
+        
+        <programlisting role="example"><![CDATA[ 
+// まず0.5秒分のサウンドパラメータを作成.
+t=soundsec(0.5);
+
+// 次に A4 = 440Hz サインを生成
+s=sin(2*%pi*440*t);
+analyze(s,200,600,22050);
+ ]]></programlisting>
+        
+    </refsection>
+    
+    <refsection role="see also">
+        
+        <title>参照</title>
+        
+        <simplelist type="inline">
+            
+            <member>
+                
+                <link linkend="playsnd">playsnd</link>
+                
+            </member>
+            
+            <member>
+                
+                <link linkend="analyze">analyze</link>
+                
+            </member>
+            
+        </simplelist>
+        
+    </refsection>
+    
+</refentry>
+
diff --git a/scilab/modules/sound/help/ja_JP/wavread.xml b/scilab/modules/sound/help/ja_JP/wavread.xml
new file mode 100644 (file)
index 0000000..68a5366
--- /dev/null
@@ -0,0 +1,250 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+<!--
+    * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
+    * Copyright (C) ????-2008 - INRIA - Scilab 
+    * 
+    * This file must be used under the terms of the CeCILL.
+    * This source file is licensed as described in the file COPYING, which
+    * you should have received as part of this distribution.  The terms
+    * are also available at    
+    * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt
+    *
+    -->
+
+<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns3="http://www.w3.org/1999/xhtml" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:id="wavread" xml:lang="ja">
+    
+    <refnamediv>
+        
+        <refname>wavread</refname>
+        
+        <refpurpose>.wav サウンドファイルを読み込む</refpurpose>
+        
+    </refnamediv>
+    
+    <refsynopsisdiv>
+        
+        <title>呼び出し手順</title>
+        
+        <synopsis>y=wavread(wavfile)
+            
+            y=wavread(wavfile,ext)
+            
+            [y,Fs,bits]=wavread(wavfile)
+            
+            [y,Fs,bits]=wavread(wavfile,ext)
+            
+        </synopsis>
+        
+    </refsynopsisdiv>
+    
+    <refsection>
+        
+        <title>引数</title>
+        
+        <variablelist>
+            
+            <varlistentry>
+                
+                <term>wavfile</term>
+                
+                <listitem>
+                    
+                    <para>文字列(拡張子が指定されない場合,拡張子 .wav が追加されます)
+                        
+                    </para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+            <varlistentry>
+                
+                <term>Fs</term>
+                
+                <listitem>
+                    
+                    <para>整数, サンプリング周波数(単位:Hz) (サンプル数/秒).
+                        
+                    </para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+            <varlistentry>
+                
+                <term>ext</term>
+                
+                <listitem>
+                    
+                    <para>
+                        
+                        文字列 (<literal>'size'</literal>) または string('info') または
+                        
+                        (nサンプルを読み込む)整数 ,
+                        
+                        (n1からn2を読み込む) 1 x 2整数ベクトル.
+                        
+                    </para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+        </variablelist>
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>説明</title>
+        
+        <para>
+            
+            <literal>.wav</literal>サウンドファイルを読み込む
+            
+            ユーティリティ関数.
+            
+            <literal>wavread(wavfile)</literal> は文字列wavfileで
+            
+            指定されたサウンドファイルを読み込み,サンプルデータをyに返します.
+            
+            大きさは [-1,+1]の範囲となります.
+            
+            以下の形式の多チャネルデータをサポートします:
+            
+            8-bit mu-law, 8-, 16-, および 32ビット,線形, および浮動小数点.
+            
+        </para>
+        
+        <para>
+            
+            <literal>[y,Fs,bits]=wavread(wavfile)</literal> は,
+            
+            ファイル中のデータをエンコードする際に使用された
+            
+            サンプルレート(Fs) (単位:Hz),ビット数/サンプルを返します.
+            
+        </para>
+        
+        <para>
+            
+            <literal>wavread(wavfile,n)</literal>は各チャネルの最初のnサンプルを
+            
+            返します.
+            
+        </para>
+        
+        <para>
+            
+            <literal>wavread(wavfile,[n1,n2])</literal> はサンプル n1 から n2までを返します.
+            
+        </para>
+        
+        <para>
+            
+            <literal>wavread(wavfile,'size')</literal> は,
+            
+            
+            
+            ファイル中に含まれるオーディオデータの大きさを
+            
+            [チャネル サンプル] のベクトルとして返します.
+            
+        </para>
+        
+        <para>
+            
+            <literal>wavread(wavfile,'info')</literal> は,
+            
+            実際のオーディオデータについて
+            
+            ファイル中に含まれるオーディオデータに関する情報を,
+            
+            ベクトル
+            
+            [データ形式, チャネル数, サンプル/秒/チャネル, 所要バイト/秒の推定値,
+            
+            基本サンプルブロックのバイト並び, ビット/秒, サウンドデータ長(単位:バイト),
+            
+            バイト/サンプル (チャネル毎)]
+            
+            として返します.
+            
+        </para>
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>例</title>
+        
+        <programlisting role="example"><![CDATA[ 
+wavread("SCI/modules/sound/demos/chimes.wav","size")
+[y,Fs,bits]=wavread("SCI/modules/sound/demos/chimes.wav");Fs,bits
+subplot(2,1,1)
+plot2d(y(1,:)) // 最初のチャネル
+subplot(2,1,2)
+plot2d(y(2,:)) // 2番目のチャネル
+y=wavread("SCI/modules/sound/demos/chimes.wav",[1 5]) //最初の5サンプル
+ ]]></programlisting>
+        
+        <scilab:image>
+            
+            wavread("SCI/modules/sound/demos/chimes.wav","size")
+            
+            [y,Fs,bits]=wavread("SCI/modules/sound/demos/chimes.wav");
+            
+            subplot(2,1,1)
+            
+            plot2d(y(1,:))
+            
+            subplot(2,1,2)
+            
+            plot2d(y(2,:))
+            
+            y=wavread("SCI/modules/sound/demos/chimes.wav",[1 5])
+            
+        </scilab:image>
+        
+        
+        
+    </refsection>
+    
+    <refsection role="see also">
+        
+        <title>参照</title>
+        
+        <simplelist type="inline">
+            
+            <member>
+                
+                <link linkend="auread">auread</link>
+                
+            </member>
+            
+            <member>
+                
+                <link linkend="savewave">savewave</link>
+                
+            </member>
+            
+            <member>
+                
+                <link linkend="analyze">analyze</link>
+                
+            </member>
+            
+            <member>
+                
+                <link linkend="mapsound">mapsound</link>
+                
+            </member>
+            
+        </simplelist>
+        
+    </refsection>
+    
+</refentry>
+
diff --git a/scilab/modules/sound/help/ja_JP/wavwrite.xml b/scilab/modules/sound/help/ja_JP/wavwrite.xml
new file mode 100644 (file)
index 0000000..549495a
--- /dev/null
@@ -0,0 +1,189 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+<!--
+    * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
+    * Copyright (C) ????-2006 - INRIA - Scilab 
+    * 
+    * This file must be used under the terms of the CeCILL.
+    * This source file is licensed as described in the file COPYING, which
+    * you should have received as part of this distribution.  The terms
+    * are also available at    
+    * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt
+    *
+    -->
+
+<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns4="http://www.w3.org/1999/xhtml" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:id="wavwrite" xml:lang="ja">
+    
+    <refnamediv>
+        
+        <refname>wavwrite</refname>
+        
+        <refpurpose>.wavサウンドファイルに書き込む</refpurpose>
+        
+    </refnamediv>
+    
+    <refsynopsisdiv>
+        
+        <title>呼び出し手順</title>
+        
+        <synopsis>wavwrite(y, wavfile)
+            
+            wavwrite(y, Fs, wavfile)
+            
+            wavwrite(y, Fs, nbits, wavfile)
+            
+        </synopsis>
+        
+    </refsynopsisdiv>
+    
+    <refsection>
+        
+        <title>引数</title>
+        
+        <variablelist>
+            
+            <varlistentry>
+                
+                <term>y</term>
+                
+                <listitem>
+                    
+                    <para>実数ベクトルまたは行列,エントリは [-1,1]の範囲.</para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+            <varlistentry>
+                
+                <term>wavfile</term>
+                
+                <listitem>
+                    
+                    <para>文字列 (拡張子が指定されない場合拡張子.wavが追加されます)
+                        
+                    </para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+            <varlistentry>
+                
+                <term>Fs</term>
+                
+                <listitem>
+                    
+                    <para>整数, サンプリング周波数(単位:Hz). デフォルト値は 22500.</para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+            <varlistentry>
+                
+                <term>nbits</term>
+                
+                <listitem>
+                    
+                    <para>ビット長8, 16, 24, 32 ビット. 
+                        
+                        各サンプルに記録される情報のビット数を示します.
+                        
+                        16がデフォルト値です.
+                        
+                        k                    
+                    </para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+        </variablelist>
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>説明</title>
+        
+        <para>
+            
+            <literal>.wav</literal> サウンドファイルを保存するためのユーティリティ関数.
+            
+            <literal>wavwrite(y,wavfile)</literal>は文字列wavfileで指定された
+            
+            サウンドファイルを書き込みます.
+            
+            デーはは1チャネル毎に1列に並べられている必要があります.
+            
+            範囲[-1,+1]を超える大きさは無視されます.
+            
+        </para>
+        
+        <para>
+            
+            <literal>wavwrite(y,Fs,wavfile)</literal> は,
+            
+            データのサンプルレート <literal>Fs</literal>を
+            
+            Hzで指定します.
+            
+        </para>
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>例</title>
+        
+        <programlisting role="example"><![CDATA[ 
+A=matrix(1:6,2,3);
+wavwrite(A/6,TMPDIR+'/foo.wav');
+B=wavread(TMPDIR+'/foo.wav');
+ ]]></programlisting>
+        
+    </refsection>
+    
+    <refsection role="see also">
+        
+        <title>参照</title>
+        
+        <simplelist type="inline">
+            
+            <member>
+                
+                <link linkend="auread">auread</link>
+                
+            </member>
+            
+            <member>
+                
+                <link linkend="wavread">wavread</link>
+                
+            </member>
+            
+            <member>
+                
+                <link linkend="savewave">savewave</link>
+                
+            </member>
+            
+            <member>
+                
+                <link linkend="analyze">analyze</link>
+                
+            </member>
+            
+            <member>
+                
+                <link linkend="mapsound">mapsound</link>
+                
+            </member>
+            
+        </simplelist>
+        
+    </refsection>
+    
+</refentry>
+