===================================================================
RCS file: /home/cvs/OpenXM/src/asir-doc/parts/process.texi,v
retrieving revision 1.7
retrieving revision 1.11
diff -u -p -r1.7 -r1.11
--- OpenXM/src/asir-doc/parts/process.texi 2001/03/16 05:18:04 1.7
+++ OpenXM/src/asir-doc/parts/process.texi 2002/09/03 02:15:35 1.11
@@ -1,4 +1,4 @@
-@comment $OpenXM: OpenXM/src/asir-doc/parts/process.texi,v 1.6 2000/11/13 00:16:34 noro Exp $
+@comment $OpenXM: OpenXM/src/asir-doc/parts/process.texi,v 1.10 2002/08/14 03:26:36 noro Exp $
\BJP
@node 分散計算,,, Top
@chapter 分散計算
@@ -28,9 +28,20 @@
@section OpenXM
\BJP
-@b{Asir} は, 分散計算における通信プロトコルとして, @b{OpenXM}
-(Open message eXchange protocol for Mathematics) を採用している.
-@b{OpenXM} は, 主として数学オブジェクトをプロセス間でやりとりする
+@b{Asir} は, 分散計算における通信プロトコルとして,
+@b{OpenXM}
+(Open message eXchange for Mathematics) プロトコルを採用している.
+@b{OpenXM} プロジェクトについては,
+@ifhtml
+
+@end ifhtml
+@code{http://www.math.sci.kobe-u.ac.jp/OpenXM/}
+@ifhtml
+
+@end ifhtml
+を参照してほしい.
+
+@b{OpenXM} プロトコルは, 主として数学オブジェクトをプロセス間でやりとりする
ための規約である. @b{OpenXM} においては
\E
\BEG
@@ -38,6 +49,15 @@ On @b{Asir} distributed computations are done under @b
(Open message eXchange protocol for Mathematics), which
is a protocol for exchanging mainly mathematical objects
between processes.
+See
+@ifhtml
+
+@end ifhtml
+@code{http://www.math.sci.kobe-u.ac.jp/OpenXM/}
+@ifhtml
+
+@end ifhtml
+for the details of @b{OpenXM}.
In @b{OpenXM} a distributed computation is done as follows:
\E
@@ -506,7 +526,7 @@ input @code{quit}.
* ox_get_serverinfo::
* generate_port try_bind_listen try_connect try_accept register_server::
* ifplot conplot plot plotover::
-* open_canvas clear_canvas draw_obj::
+* open_canvas clear_canvas draw_obj draw_string::
@end menu
\JP @node ox_launch ox_launch_nox ox_shutdown,,, 分散計算に関する関数
@@ -1885,6 +1905,9 @@ identifier @var{id} is returned.
@item plot(@var{func} [,@var{geometry}] [,@var{xrange}] [,@var{id}] [,@var{name}])
\JP :: 1 変数関数のグラフを表示する.
\EG :: Displays the graph of a univariate function.
+@item polarplot(@var{func} [,@var{geometry}] [,@var{thetarange}] [,@var{id}] [,@var{name}])
+\JP :: 極形式で与えられた曲線を表示する.
+\EG :: Displays the graph of a curve given in polar form.
@item plotover(@var{func},@var{id},@var{number})
\JP :: すでに存在しているウィンドウへ描画する.
\EG Plots on the existing window real zeros of a bivariate function.
@@ -1913,15 +1936,20 @@ identifier @var{id} is returned.
@item
@code{ifplot()} は, 2 変数関数 @var{func} の実数上での零点の
グラフの表示を行う. @code{conplot()} は, 同様の引数に対し,
-等高線の表示を行う. @code{plot()} は 1 変数関数の
-グラフの表示を行う.
+等高線の表示を行う.
+@code{plot()} は 1 変数関数のグラフの表示を行う.
+@code{polarplot()} は 極形式 @var{r=f(theta)} で表された曲線のグラフの表示を行う.
@item
これらは OpenXM サーバとして実現されている. UNIX 上では
@samp{ox_plot} が, Windows 上では @samp{engine} がこれらの機能
を提供しており, これらは @b{Asir} の標準ライブラリディレクトリにある.
-これらは @code{ox_launch()} または @code{ox_launch_nox()}
- により起動しておく必要がある.
+アクティブな @samp{ox_plot} の id が @var{id} として指定された場合,
+そのサーバが用いられる. id の指定がない場合には, 起動されて
+いるサーバのうち, @samp{ox_plot} があればそのサーバが用いられる.
+@samp{ox_plot} が起動されていない場合には,
+@code{ox_launch_nox()} が自動的に実行されて, @samp{ox_plot} が
+立ち上がり, それが用いられる.
@item
引数の内, @var{func} は必須である. その他の引数はオプションである.
@@ -2029,12 +2057,20 @@ Function @code{ifplot()} draws a graph of real zeros o
function.
Function @code{conplot()} plots the contour lines for a same argument.
Function @code{plot()} draws the graph of a uninivariate function.
+Function @code{polarplot()} draws the graph of a curve given in polar form
+@var{r=f(theta)}.
@item
The plotting functions are realized by an OpenXM server.
On UNIX it is @samp{ox_plot} in @b{Asir} root directory.
On Windows @samp{engine} acts as @samp{ox_plot}.
Of course, it must be activated by @code{ox_launch()} @code{ox_launch_nox()}.
+If the identifier of an active @samp{ox_plot} is specified as @var{id},
+the server is used for drawing pictures.
+If @var{id} is not specified, an available @samp{ox_plot} server
+is used if it exists. If no @samp{ox_plot} server is available,
+then @code{ox_launch_nox()} is automatically executed to
+invoke @samp{ox_plot}.
@item
Argument @var{func} is indispensable. Other arguments are optional.
@@ -2188,12 +2224,13 @@ plot*form*ydone*background:white
@fref{ox_launch ox_launch_nox ox_shutdown}, @fref{ox_reset ox_intr register_handler}
@end table
-\JP @node open_canvas clear_canvas draw_obj,,, 分散計算に関する関数
-\EG @node open_canvas clear_canvas draw_obj,,, Functions for distributed computation
-@subsection @code{open_canvas}, @code{clear_canvas}, @code{draw_obj}
+\JP @node open_canvas clear_canvas draw_obj draw_string,,, 分散計算に関する関数
+\EG @node open_canvas clear_canvas draw_obj draw_string,,, Functions for distributed computation
+@subsection @code{open_canvas}, @code{clear_canvas}, @code{draw_obj}, @code{draw_string}
@findex open_canvas
@findex clear_canvas
@findex draw_obj
+@findex draw_string
@table @t
@item open_canvas(@var{id}[,@var{geometry}])
@@ -2205,17 +2242,23 @@ plot*form*ydone*background:white
@item draw_obj(@var{id},@var{index},@var{pointorsegment} [,@var{color}])
\JP :: キャンバス上に点または線分を描画する.
\EG :: Draws a point or a line segment on a canvas.
+@item draw_string(@var{id},@var{index},@var{[x,y]},@var{string} [,@var{color}])
+\JP :: キャンバス上に文字列を描画する.
+\EG :: Draws a character string on a canvas.
@end table
@table @var
@item return
0
-@item id, index, color
+@item id, index, color, x, y
\JP 整数
\EG integer
@item pointorsegment
\JP リスト
\EG list
+@item string
+\JP 文字列
+\EG character string
@end table
@itemize @bullet
@@ -2269,7 +2312,7 @@ and a canvas id @var{index}.
の値 (最大 255) とみなす.
\E
\BEG
-@code{draw_obj_canvas} draws a point or a line segment on
+@code{draw_obj} draws a point or a line segment on
a canvas specified by a server id @var{id} and a canvas id @var{index}.
If @var{pointorsegment} is @var{[x,y]}, it is regarded as a point.
If @var{pointorsegment} is @var{[x,y,u,v]}, it is regarded
@@ -2278,6 +2321,16 @@ If @var{color} is specified, @var{color/65536} mod 256
@var{color/256} mod 256, @var{color} mod 256 are regarded as the vaules
of Red, Green, Blue (Max. 255) respectively.
\E
+@item
+\BJP
+@code{draw_string} は, サーバ id @var{id}, キャンバス id @var{index}
+で指定されるキャンバスに文字列を描画する. 位置は @var{[x,y]} により指定する.
+\E
+\BEG
+@code{draw_string} draws a character string @var{string} on
+a canvas specified by a server id @var{id} and a canvas id @var{index}.
+The position of the string is specified by @var{[x,y]}.
+\E
@end itemize
@example
@@ -2293,7 +2346,9 @@ of Red, Green, Blue (Max. 255) respectively.
0
[187] draw_obj(Id,Ind,[10,10,50,50],0xff00ff);
0
-[188] clear_canvas(Id,Ind);
+[187] draw_string(Id,Ind,[100,50],"hello",0xffff00);
+0
+[189] clear_canvas(Id,Ind);
0
@end example