1 <?xml version="1.0" encoding="UTF-8"?>
3 * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
6 * This file must be used under the terms of the CeCILL.
7 * This source file is licensed as described in the file COPYING, which
8 * you should have received as part of this distribution. The terms
9 * are also available at
10 * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt
13 <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="graphics_entities">
15 <refname>graphics_entities</refname>
16 <refpurpose>グラフィックスエンティティデータ構造体の説明</refpurpose>
21 グラフィックウインドウおよびそのウインドウに描画されたもの
24 各 Figure は1個以上のAxes型の子を定義します.
26 Polylines, Rectangles, Arcs, Segs,...のような
27 一連の葉(leaf)エンティティを有します.
28 エンティティの再帰的な集合のCompound型を有することも可能です.
29 グラフィックモードの主要な関心事は,プロパティの変更をより簡単に
31 データ,座標やスケーリング,色や外観のようなオブジェクトのプロパティを
32 最初のグラフィックコマンドを再度実行することなく制御するために
34 を提供します (<link linkend="set">set</link>, <link linkend="get">get</link>参照)
37 グラフィックエンティティは<literal>handle</literal>型のScilab変数に
40 作成されたグラフィックエンティティの各インスタンスを示すユニークなIDです.
41 このハンドルを用いて, "set" および "get"ルーチンによりエンティティの
42 プロパティにアクセスすることができるようになります.
43 ハンドルはグラフィックオブジェクトを操作したり,移動したり,
52 figureエンティティは,グラフィックエンティティ階層の最上位です.
53 このエンティティは図(figure)本体のパラメータを定義し,
54 同時に子を作成する際のデフォルト値も定義します.
55 figureの子はAxesエンティティです.
57 <para>カレントのfigure(描画指示が送信されるfigure)のハンドル
58 は,<literal>get("current_figure")</literal>により取得でき,
59 <literal>set("current_figure",h)</literal>により設定できます.
60 ただし, <literal>h</literal> は figureのハンドルまたは
61 <literal>figure_id</literal> のどちらかです.
62 後者について,その図がまだ作成されていない場合には,作成されます.
65 詳細は<link linkend="figure_properties">figure_properties</link>
74 Axesエンティティはグラフィックエンティティ階層の第二レベルです.
75 このエンティティは座標系の変化に関するパラメータおよび
77 同時に,作成される子のデフォルトのパラメータを定義します.
78 詳細は,<link linkend="axes_properties">axes_properties</link> for
79 details. The handle on the current Axes may be got using
80 <literal>get("current_axes")</literal>を参照ください.
85 <term>Compound: </term>
87 <para>Compound エンティティは単なる子のベクトルで,
88 プロパティを1つだけ(visibilityプロパティ)有しています.
89 これは,一連のエンティティを集約するためのグルーとして
93 <link linkend="glue">glue</link>, <link linkend="unglue">unglue</link>および
94 <link linkend="Compound_properties">Compound_properties</link> 関数を
102 <para>Axisエンティティはグラフィックエンティティ階層の葉です.
103 このエンティティは軸の目盛および外観に関するパラメータを定義します.
106 詳細は<link linkend="axis_properties">axis_properties</link> を参照ください.
111 <term>Polyline: </term>
113 <para>ポリラインエンティティはグラフィックエンティティ階層の葉です.
114 このエンティティは,2次元および3次元ポリラインおよび
115 ポリラインの拡張描画プロパティを定義します.
118 詳細は <link linkend="polyline_properties">polyline_properties</link> を
126 <para>Arcエンティティはグラフィックエンティティ階層の葉です.
127 このエンティティは楕円および楕円の一部を定義します.
130 詳細は<link linkend="arc_properties">arc_properties</link> を参照ください.
135 <term>Rectangle: </term>
137 <para>Rectangleエンティティはグラフィックエンティティ階層の葉です.
138 このエンティティは矩形および塗りつぶされた矩形のパラメータを
142 詳細は<link linkend="rectangle_properties">rectangle_properties</link>
148 <term>Surface: </term>
150 <para>Surfaceエンティティはグラフィックエンティティ階層の葉です.
151 このエンティティはサブタイプ <literal>Fac3d</literal> または
152 <literal>Plot3d</literal>を有します. このエンティティは
156 詳細は<link linkend="surface_properties">surface_properties</link>
164 <para>Fec エンティティはグラフィックエンティティ階層の葉です.
165 このエンティティは2次元有限要素プロットを表します.
168 詳細は <link linkend="fec_properties">fec_properties</link>
174 <term>Grayplot: </term>
176 <para>Grayplot eエンティティはグラフィックエンティティ階層の葉です.
177 このエンティティは色および画像による曲面の二次元プロット表します.
180 詳細は <link linkend="grayplot_properties">grayplot_properties</link> を参照ください.
185 <term>Matplot: </term>
187 <para>Matplot エンティティはグラフィックエンティティ階層の葉です.
188 このエンティティは整数行列による二次元プロット表します.
191 詳細は <link linkend="Matplot_properties">Matplot_properties</link> を参照ください.
198 <para>Segs エンティティはグラフィックエンティティ階層の葉です.
199 このエンティティは,一連の色付の線分または色付の矢印のパラメータを定義します.
202 詳細は <link linkend="segs_properties">segs_properties</link> を参照ください.
209 <para>Champ エンティティはグラフィックエンティティ階層の葉です.
210 このエンティティは2次元ベクトルフィールドに関するパラメータを定義します.
213 詳細は <link linkend="champ_properties">champ_properties</link> を参照ください.
220 <para>Text エンティティはグラフィックエンティティ階層の葉です.
221 このエンティティは文字列の描画に関するパラメータを定義します.
224 詳細は <link linkend="text_properties">text_properties</link> を参照ください.
232 Labelエンティティは<literal>Axes</literal>グラフィックエンティティの
233 子です.このエンティティはグラフィックウィンドウに描画される
234 x, y, z 軸のラベルとタイトルを定義します.
237 詳細は <link linkend="label_properties">label_properties</link> を参照ください.
242 <term>Legend: </term>
244 <para>Legend エンティティはグラフィックエンティティ階層の葉です.
245 このエンティティは,<literal>plot2dx</literal>グラフに描画される
250 詳細は <link linkend="legend_properties">legend_properties</link> を参照ください.
258 <programlisting role="example"><![CDATA[
261 scf() //エンティティモードで図を作成
263 // Figureエンティティのハンドルを取得し,そのプロパティを表示
264 f=get("current_figure")
265 a=f.children //Axisの子のハンドル
266 x=(1:10)'; plot2d(x,[x.^2 x.^1.5])
267 e=a.children // 2つのポリラインからなるCompoun
269 p1=e.children(1) //直近に描画されたポリラインのプロパティ
270 p1.foreground=5; // ポリラインの色を変更
271 e.children.thickness=5; // 2つのポリラインの幅を変更
273 delete(e.children(2))
275 move(e.children,[0,30]) //ポリラインを変換
277 a.axes_bounds=[0 0 0.5 0.5];
279 subplot(222) //新たにAxesエンティティを作成
281 a1=f.children(1); //ハンドルを取得
282 copy(e.children,a1); //最初のプロットのポリラインを新しい軸にコピー
283 a1.data_bounds=[1 0;10 100]; //軸の範囲を変更
285 set("current_figure",10) //figure_id=10の新規図を作成
286 plot3d() //描画データは figure 10に送信される
287 set("current_figure",f) //前の図をカレントの図にする
288 plot2d(x,x^3) //描画データは最初の図に送信される
291 <refsection role="see also">
293 <simplelist type="inline">
295 <link linkend="set">set</link>
298 <link linkend="get">get</link>
301 <link linkend="move">move</link>
304 <link linkend="delete">delete</link>
307 <link linkend="object_editor">object_editor</link>
310 <link linkend="plot">plot</link>
313 <link linkend="surf">surf</link>