===================================================================
RCS file: /home/cvs/OpenXM/src/asir-doc/parts/process.texi,v
retrieving revision 1.6
retrieving revision 1.12
diff -u -p -r1.6 -r1.12
--- OpenXM/src/asir-doc/parts/process.texi 2000/11/13 00:16:34 1.6
+++ OpenXM/src/asir-doc/parts/process.texi 2002/09/10 01:40:02 1.12
@@ -1,4 +1,4 @@
-@comment $OpenXM: OpenXM/src/asir-doc/parts/process.texi,v 1.5 2000/09/25 05:12:51 noro Exp $
+@comment $OpenXM: OpenXM/src/asir-doc/parts/process.texi,v 1.11 2002/09/03 02:15:35 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
@@ -505,8 +525,8 @@ input @code{quit}.
* ox_flush::
* ox_get_serverinfo::
* generate_port try_bind_listen try_connect try_accept register_server::
-* ifplot conplot plot plotover::
-* open_canvas clear_canvas draw_obj::
+* ifplot conplot plot polarplot plotover::
+* open_canvas clear_canvas draw_obj draw_string::
@end menu
\JP @node ox_launch ox_launch_nox ox_shutdown,,, 分散計算に関する関数
@@ -779,7 +799,7 @@ ox_xterm*saveLines:1000
\EG @item References
@fref{ox_rpc ox_cmo_rpc ox_execute_string},
@fref{ox_pop_cmo ox_pop_local},
-@fref{ifplot conplot plot plotover}
+@fref{ifplot conplot plot polarplot plotover}
@end table
\JP @node ox_launch_generic,,, 分散計算に関する関数
@@ -1867,11 +1887,12 @@ identifier @var{id} is returned.
@fref{Mathcap}.
@end table
-\JP @node ifplot conplot plot plotover,,, 分散計算に関する関数
-\EG @node ifplot conplot plot plotover,,, Functions for distributed computation
-@subsection @code{ifplot}, @code{conplot}, @code{plot}, @code{plotover}
+\JP @node ifplot conplot plot polarplot plotover,,, 分散計算に関する関数
+\EG @node ifplot conplot plot polarplot plotover,,, Functions for distributed computation
+@subsection @code{ifplot}, @code{conplot}, @code{plot}, @code{polarplot}, @code{plotover}
@findex ifplot
@findex conplot
+@findex polarplot
@findex plot
@findex plotover
@@ -1885,6 +1906,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 +1937,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 +2058,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.
@@ -2114,7 +2151,7 @@ the window.
@item
Several operations are available on the window: by button operations
-for UNIX version, and pull-down menus for Macintosh version.
+for UNIX version, and pull-down menus for Windows version.
@table @code
@item quit
@@ -2188,12 +2225,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 +2243,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 +2313,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 +2322,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 +2347,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