[scilab.git] / scilab / modules / graphics / help / ja_JP / 3d_plot / param3d.xml

<?xml version="1.0" encoding="UTF-8"?>

<!--

 * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab

 * Copyright (C) ENPC - Jean-Philippe Chancelier

 *


 * Copyright (C) 2012 - 2016 - Scilab Enterprises
 *
 * This file is hereby licensed under the terms of the GNU GPL v2.0,
 * pursuant to article 5.3.4 of the CeCILL v.2.1.
 * This file was originally licensed under the terms of the CeCILL v2.1,
 * and continues to be available under such terms.
 * For more information, see the COPYING file which you should have received
 * along with this program.

 *

 -->

<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns5="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="param3d" xml:lang="ja">

    <refnamediv>

        <refname>param3d</refname>

        <refpurpose>パラメータ表現の曲線の3次元プロット</refpurpose>

    </refnamediv>

    <refsynopsisdiv>

        <title>呼び出し手順</title>

        <synopsis>param3d(x,y,z,[theta,alpha,leg,flag,ebox])</synopsis>

    </refsynopsisdiv>

    <refsection>

        <title>引数</title>

        <variablelist>

            <varlistentry>

                <term>x,y,z</term>

                <listitem>

                    <para>同じ大きさのベクトル (パラメータ表現の曲線の点).</para>

                </listitem>

            </varlistentry>

            <varlistentry>

                <term>theta, alpha</term>

                <listitem>

                    <para>観測点の球座標を指定する実数値(単位:度).

                        <emphasis>デフォルト値はT 35 度および 45度です.</emphasis>

                    </para>

                </listitem>

            </varlistentry>

            <varlistentry>

                <term>leg</term>

                <listitem>

                    <para>各軸のラベルを定義する文字列. @ をフィールドセパレータとし,

                        "X@Y@Z"のようになります.

                    </para>

                </listitem>

            </varlistentry>

            <varlistentry>

                <term>flag=[type,box]</term>

                <listitem>

                    <para>

                        <literal>type</literal> および <literal>box</literal> の意味は

                        <literal>plot3d</literal>と同じ意味になります:

                    </para>

                    <variablelist>

                        <varlistentry>

                            <term>type</term>

                            <listitem>

                                <para>整数 (スケール).</para>

                                <variablelist>

                                    <varlistentry>

                                        <term>type=0</term>

                                        <listitem>

                                            <para>プロットは

                                                (前の<literal>param3d</literal>,

                                                <literal>plot3d</literal>, <literal>contour</literal> または

                                                <literal>plot3d1</literal>のコールで設定された)

                                                カレントの3次元スケールで行われます.

                                            </para>

                                        </listitem>

                                    </varlistentry>

                                    <varlistentry>

                                        <term>type=1</term>

                                        <listitem>

                                            <para>

                                                3次元ボックスのスケールがアスペクト比の最大値に基づき

                                                自動的に調整され,

                                                境界はオプションの引数<literal>ebox</literal>の値で

                                                指定されます.

                                            </para>

                                        </listitem>

                                    </varlistentry>

                                    <varlistentry>

                                        <term>type=2</term>

                                        <listitem>

                                            <para>

                                                3次元ボックスのスケールがアスペクト比の最大値に基づき

                                                自動的に調整され,

                                                境界は指令したデータにより計算されます.

                                                <emphasis>これがデフォルト値です.</emphasis>

                                            </para>

                                        </listitem>

                                    </varlistentry>

                                    <varlistentry>

                                        <term>type=3</term>

                                        <listitem>

                                            <para>

                                                オプション<literal>ebox</literal>で指定したボックス境界を有する

                                                3次元等軸プロットで,<literal>type=1</literal>に似ています.

                                            </para>

                                        </listitem>

                                    </varlistentry>

                                    <varlistentry>

                                        <term>type=4</term>

                                        <listitem>

                                            <para>データで定義された境界に基づく3次元等軸プロットで,

                                                <literal>type=2</literal>に似ています.

                                            </para>

                                        </listitem>

                                    </varlistentry>

                                    <varlistentry>

                                        <term>type=5</term>

                                        <listitem>

                                            <para>

                                                オプション<literal>ebox</literal>で指定されたボックス境界で

                                                定義された境界に基づく3次元拡張等軸プロットで,

                                                <literal>type=1</literal>に似ています.

                                            </para>

                                        </listitem>

                                    </varlistentry>

                                    <varlistentry>

                                        <term>type=6</term>

                                        <listitem>

                                            <para>

                                                データで定義された境界に基づく3次元拡張等軸プロットで,

                                                <literal>type=2</literal>に似ています.

                                                軸の境界は axes エンティティプロパティによりカスタマイズできる

                                                ことに注意してください(<link linkend="axes_properties">axes_properties</link>参照).

                                            </para>

                                        </listitem>

                                    </varlistentry>

                                </variablelist>

                            </listitem>

                        </varlistentry>

                        <varlistentry>

                            <term>box</term>

                            <listitem>

                                <para>整数 (プロットの周囲のフレーム).</para>

                                <variablelist>

                                    <varlistentry>

                                        <term>box=0</term>

                                        <listitem>

                                            <para>プロットの周囲に何も描画されませ.</para>

                                        </listitem>

                                    </varlistentry>

                                    <varlistentry>

                                        <term>box=1</term>

                                        <listitem>

                                            <para>実装されていません (box=0と同様).</para>

                                        </listitem>

                                    </varlistentry>

                                    <varlistentry>

                                        <term>box=2</term>

                                        <listitem>

                                            <para>曲面の背後の軸のみが描画されます.</para>

                                        </listitem>

                                    </varlistentry>

                                    <varlistentry>

                                        <term>box=3</term>

                                        <listitem>

                                            <para>

                                                曲面を囲うボックスが描画され,キャプションが追加されます.

                                            </para>

                                        </listitem>

                                    </varlistentry>

                                    <varlistentry>

                                        <term>box=4</term>

                                        <listitem>

                                            <para>

                                                曲面を囲うボックスが描画され,キャプションと軸が追加されます.

                                                軸のアスペクトもaxesエンティティのプロパティによりカスタマイズ

                                                できることに注意してください (<link linkend="axes_properties">axes_properties</link>参照).

                                                <emphasis>これがデフォルト値です.</emphasis>

                                            </para>

                                        </listitem>

                                    </varlistentry>

                                </variablelist>

                            </listitem>

                        </varlistentry>

                    </variablelist>

                </listitem>

            </varlistentry>

            <varlistentry>

                <term>ebox</term>

                <listitem>

                    <para>

                        プロットの境界をベクトル

                        <literal>[xmin,xmax,ymin,ymax,zmin,zmax]</literal>で指定します.



                        この引数は,<literal>flag</literal>の<literal>type</literal>が<literal>1</literal>,

                        <literal>3</literal> または <literal>5</literal>に設定された場合,

                        使用されます (対応する動作については上記参照).

                        <literal>flag</literal> が指定されない場合

                        <literal>ebox</literal> は無視されます.

                        指定された場合, <literal>ebox</literal>引数は,

                        <literal>data_bounds</literal>に基づいて動作し,

                        axesエンティティのプロパティによりリセットすることも可能であることに

                        注意してください(<link linkend="axes_properties">axes_properties</link>参照).

                        ebox のデフォルト値は[0,1,0,1,0,1]です.

                    </para>

                </listitem>

            </varlistentry>

        </variablelist>

    </refsection>

    <refsection>

        <title>説明</title>

        <para>

            <literal>param3d</literal> はその座標<literal>x</literal>,

            <literal>y</literal> および<literal>z</literal>により定義される

            3次元曲線をプロットするために使用されます.

            データは surface エンティティのプロパティにより取得または修正できることに

            注意してください (<link linkend="surface_properties">surface_properties</link>を参照ください).

        </para>

        <para>プロットされる曲線の

            <literal>rotation angles</literal>,

            <literal>colors</literal> および <literal>thickness</literal> のような

            プロパティも polyline エンティティプロパティにより取得または修正することが

            できます

            (<link linkend="polyline_properties">polyline_properties</link>参照).

        </para>

        <para>

            複数のプロットを行うには<literal>param3d1</literal> を使用してください.

        </para>

        <para>

            コマンド <literal>param3d()</literal> を入力するとデモを参照できます.

        </para>

    </refsection>

    <refsection>

        <title>例</title>

        <programlisting role="example"><![CDATA[

t=0:0.1:5*%pi;

param3d(sin(t),cos(t),t/10,35,45,"X@Y@Z",[2,3])



e=gce() //3次元ポリラインのハンドル



e.foreground=color('red');



a=gca(); //軸のハンドル

a.rotation_angles=[10 70];

 ]]></programlisting>

        <scilab:image>

            t=0:0.1:5*%pi;

            param3d(sin(t),cos(t),t/10,35,45,"X@Y@Z",[2,3])



            e=gce() //the handle on the 3D polyline



            e.foreground=color('red');



            a=gca(); //the handle on the axes

            a.rotation_angles=[10 70];

        </scilab:image>

    </refsection>

    <refsection role="see also">

        <title>参照</title>

        <simplelist type="inline">

            <member>

                <link linkend="param3d1">param3d1</link>

            </member>

            <member>

                <link linkend="plot3d">plot3d</link>

            </member>

        </simplelist>

    </refsection>

</refentry>