<?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) 2009 - DIGITEO - Pierre Lando

 *


 * 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: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="xsegs">

    <refnamediv>

        <refname>xsegs</refname>

        <refpurpose>接続されていない線分を描画</refpurpose>

    </refnamediv>

    <refsynopsisdiv>

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

        <synopsis>

            xsegs(xv, yv, [style])

            xsegs(xv, yv, zv,[style])

        </synopsis>

    </refsynopsisdiv>

    <refsection>

        <title>引数</title>

        <variablelist>

            <varlistentry>

                <term>xv, yv, zv</term>

                <listitem>

                    <para>

                        同じ大きさの行列. <varname>zv</varname>が指定されない場合,

                        ゼロベクトルを使用します.

                    </para>

                </listitem>

            </varlistentry>

            <varlistentry>

                <term>style</term>

                <listitem>

                    <para>

                        ベクトルまたはスカラー. <varname>style</varname>が正のスカラーの場合,

                        全ての線分で使用される色を指定します.

                        <varname>style</varname>が負のスカラーの場合

                        , カレントの色が使用されます.

                        <varname>style</varname>がベクトルの場合,

                        <literal>style(i)</literal> は線分<literal>i</literal>に関する

                        色を指定します.

                    </para>

                </listitem>

            </varlistentry>

        </variablelist>

    </refsection>

    <refsection>

        <title>説明</title>

        <para>

            <function>xsegs</function> は,

            <varname>xv</varname>, <varname>yv</varname> および <varname>zv</varname>

            で指定した接続されていない一連の線分を描画します.

            <varname>xv</varname>, <varname>yv</varname> および <varname>zv</varname>

            が行列の場合,列を結合したベクトルとみなされます.

            ある線分を定義する2つ点の座標は,

            <varname>xv</varname>, <varname>yv</varname> および <varname>zv</varname>

            の連続する2つの値で指定されます:

        </para>

        <para>

            <literal>(xv(i),yv(i),zv(i))--&gt;(xv(i+1),yv(i+1),zv(i+1))</literal>.

        </para>

        <para>

            例えば, 大きさ (2,n)の行列の場合, 線分は以下のように定義されます:

        </para>

        <programlisting role="no-scilab-exec"><![CDATA[

xv=[xi_1 xi_2 ...; xf_1 xf_2...]

yv=[yi_1 yi_2 ...; yf_1 yf_2...]

zv=[zi_1 zi_2 ...; zf_1 zf_2...]

 ]]></programlisting>

        <para>

            そして,線分は <literal>(xi_k,yi_k,zi_k)--&gt;(xf_k,yf_k,zf_k)</literal>となります.

        </para>

    </refsection>

    <refsection>

        <title>例</title>

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

// 2次元の例

x=2*%pi*(0:9)/10;

xv=[sin(x);9*sin(x)];

yv=[cos(x);9*cos(x)];

plot2d([-10,10],[-10,10],[-1,-1],"022")

xsegs(xv,yv,1:10)

 ]]></programlisting>

        <scilab:image>

            x=2*%pi*(0:9)/10;

            xv=[sin(x);9*sin(x)];

            yv=[cos(x);9*cos(x)];

            plot2d([-10,10],[-10,10],[-1,-1],"022")

            xsegs(xv,yv,1:10)

        </scilab:image>

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

// 2次元の例

plot2d([-10,10],[-10,10],[-1,-1],"022")

xsegs([9, -9],[9 , -9]) //  X(9,9) から Y(-9, -9) に線を引く

xsegs([5, -2],[4 , -1]) //  X(5,4) から Y(-2, -1) に線を引く

 ]]></programlisting>

        <scilab:image>

            plot2d([-10,10],[-10,10],[-1,-1],"022")

            xsegs([9, -9],[9 , -9]) // Draw the line from X(9,9) to Y(-9, -9)

            xsegs([5, -2],[4 , -1]) // Draw the line from X(5,4) to Y(-2, -1)

        </scilab:image>

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

// 3次元の例

clf();

a=gca();

a.view="3d";

f=gcf();

f.color_map=rainbowcolormap(120);

alpha=2*%pi*(0:119)/40;

xv=[sin(alpha)/2;sin(alpha)/3];

yv=[cos(alpha)/2;cos(alpha)/3];

zv=[alpha/8;alpha/8];

xsegs(xv,yv,zv,1:120);

// Now adjust the data_bounds

a.data_bounds = [min(xv) min(yv) min(zv); ...

                 max(xv) max(yv) max(zv)];

// 矢印を各線分に追加できます

e = gce();

e.arrow_size = 0.4;





 ]]></programlisting>

        <scilab:image>

            a=gca();

            a.view="3d";

            f=gcf();

            f.color_map=rainbowcolormap(120);

            alpha=2*%pi*(0:119)/40;

            xv=[sin(alpha)/2;sin(alpha)/3];

            yv=[cos(alpha)/2;cos(alpha)/3];

            zv=[alpha/8;alpha/8];

            xsegs(xv,yv,zv,1:120);

            a.data_bounds = [min(xv) min(yv) min(zv); ...

            max(xv) max(yv) max(zv)];

            e = gce();

            e.arrow_size = 0.4;

        </scilab:image>

    </refsection>

</refentry>

