Polylineエンティティプロパティの説明
Polylineエンティティはグラフィックエンティティ階層の葉です. このエンティティは ポリラインのパラメータを定義します.
このフィールドには親のハンドルが含まれます.
polylineエンティティの親は"Axes"
型または
"Compound"
型です.
このプロパティにはこのハンドルのchildren
のベクトルが含まれます.
しかし,現在,polylineにはchildren
がありません.
このフィールドはこのエンティティのvisible
プロパティの値を有します.
値は"on"
または "off"
となります.
デフォルトで polyline は可視であり,プロパティの値は
"on"
となります. "off"
の場合,
このポリラインは画面に描画されません.
このフィールドはxおよびy座標の値を有します.
3次元軸の場合にはZ要素が追加されます.
この値は,各点の座標を含む2(3)列の行列[x,y,[z]]
です.
このフィールドはポリラインが閉じているかどうかを定義します:
値は "on"
または "off"
となります
(デフォルト値はなく,ポリラインを作成する際に使用されたプリミティブに
依存します).
このフィールドはポリラインのline_mode
プロパティの
デフォルト値を有します. この値には "on"
(線を描画
) または "off"
(線を描画しない)を指定します.
polyline_style
フィールドが 5ではない場合, 曲線の
背景がbackground
プロパティで定義した色で塗られます.
このフィールドは,Segs, Arcs, Rectangle および Polylineオブジェクトの
line_style
のデフォルト値を有します.
line_style
は,線を描画する際に使用される
線の型を選択します.この値は, [1 10]の範囲の整数となります.
1 は実線を意味し, 他の値は破線
(破線, 一点鎖線, 長一点鎖線, 大鎖線, 大長一点鎖線, 点線, 2重点線, 長空白点線, 大空白点線)
の選択を意味します. 以下の例を参照ください.
このプロパティはピクセル単位で線幅を指定する正の実数です.
実際の表示幅は指定された幅を最も近い整数に丸めることで定義されます.
唯一の例外はベクトル単位のエキスポートで,この場合は全体の
thickness
の値が考慮されます.
この整数によりポリラインに描かれる矢印の大きさを設定することができます.
実際の矢印の大きさはthickness
とこのsize factorの
積となります.
このプロパティは以下の各種のポリライン描画モードを設定します:
値が 0または1の場合,連続する2つの点の間に線が描画されます.
値が2の場合,ポリラインは階段プロットとなります. 連続する2つの点は水平線の後に垂直線が続く線により結合されます.
値が3の場合,ポリラインは棒グラフとなります. 指定された各(x,y)について, (x,y) から (x,0)に垂直線が引かれます.
値が 4の場合,連続する2つの点の間に矢印が描かれます.
値が5の場合,ポリラインは塗りつぶされます (パッチ).
値が 6の場合,ポリラインはMatlabに似たbarオブジェクトとなります.
プロパティbar_shift
およびbar_width
がその外観を規定します.
このフィールドにはポリラインを描画する際に使用される
foreground
プロパティのデフォルト値が含まれます.
その値には(カレントのカラーマップに沿った)色インデックスを指定します.
このフィールドはポリラインの背景を塗りつぶす際に使用される色を有します. その値には(カレントのカラーマップに沿った)色インデックスを指定します.
このフィールドは,
interp_color_mode
プロパティが"on"
に設定された
際にポリラインを塗る際に使用される色インデックスの
ベクトルを有します.
これは,各セグメントを塗る際に使用される
カラーマップインデックスの間隔を定義します.
例えば,最初のセグメントは,
インデックスがベクトルの最初の2つの要素の間にある各色により塗りつぶされます.
これはポリラインが 3 または 4つの点で定義されている場合のみ適用可能です.
このため,ベクトルの大きさはこの次元に一致している必要があります.
このフィールドはポリラインを塗る際に補間影モードを
使用するかどうかを定義します:
この値は"on"
または"off"
となります.
"on"に値を切り替える前に interp_color_vector
を
定義する必要があります (上記参照).
このフィールドはポリラインのmark_mode
プロパティのデフォルト値を有します.
この値は"on"
(マーカを描画
drawn) または "off"
(マーカを描画しない)となります.
mark_style
プロパティの値は
mark_mode
プロパティが"on"
の場合に,
使用するマーカの種類を選択するために使用されます.
この値は[0 14]の範囲の整数で,それぞれ以下の意味があります :
ドット,プラス,十字,星,塗りつぶした菱形,
上向き三角形, 下向き三角形, 菱形プラス,円,アスタリスク,
正方形,右向き三角形,左向き三角形およびペンタグラム.
以下の図は,マーカのアスペクトがmark_style
,
mark_foreground
および
mark_background
プロパティに依存する
ことを示します.
このフィールはmark_size_unit
プロパティのデフォルト値
を有します.mark_size_unit
が"point"
に設定された場合,mark_size
の値はポイント単位で直接
指定されます.
mark_size_unit
に"tabulated"
が
指定された場合,mark_size
はfont size配列に相対的に
計算されます: この場合,この値は,
8pt, 10pt, 12pt, 14pt, 18pt および 24pt を意味する
[0 5]の範囲の整数とします.
xrectおよび Scilabのネーティブ関数は
tabulated
モードをデフォルトとします;
plot関数を使用する場合,
point
モードが自動的に有効となります.
mark_size
プロパティは,
mark_mode
プロパティが"on"
の時,
マーカの大きさを選択するために使用されます.
この値は, 8pt, 10pt, 12pt, 14pt, 18pt および 24pt を意味する
[0 5]の範囲の整数です.
このフィールドは,マーカの縁の色であるmark_foreground
プロパティの値を有します.この値は(カレントのcolor_mapに関連する)色インデックス
または透過エッジを意味する 0 とします.
このフィールドは,マーカの前景色である
mark_background
プロパティの値を有します.
この値は(カレントのcolor_mapに関連する)色インデックス
または透過エッジを意味する 0 とします.
このフィールドは,
最初の記号を描画する際に使用されるオフセットである
mark_offset
プロパティの値を有します.
この値は, 0 以上の整数とする必要があります (デフォルト値は 0).
このフィールドは,
記号を描画する際に使用するストライド
(すなわち, 2つの連続する記号の間で stride-1 個の点がスキップされます)
である mark_stride
プロパティの値を有します.
この値は, 1以上の整数とする必要があります (デフォルト値は 1).
このフィールドは関数barをコールする
ことにより計算される
(またはbarhomogenizeを
コールすることにより再計算される)オフセットを有し,
見栄えの良い垂直棒グラフを作成するために使用されます.
このオフセットは他のpolyline_style
にも
適用されることに注意してください.
単位はユーザ座標で表されます.
このフィールドは関数barをコールする
ことにより計算される
(またはbarhomogenizeを
コールすることにより再計算される)オフセットを有し,
見栄えの良い水平棒グラフを作成するために使用されます.
このオフセットは他のpolyline_style
にも
適用されることに注意してください.
単位はユーザ座標で表されます.
このフィールドはユーザが指定する
オフセットを有します
このオフセットは他のpolyline_style
にも
適用されることに注意してください.
このユニットはユーザ座標で表されています.
このフィールドは,
polyline_style
が棒グラフモード (ケース 6)に
せていされている場合に,
選択されたポリラインの幅を定義します:
単位はユーザ座標で表されます.
このフィールドはポリラインのclip_state
プロパティの
値を有します. 値は以下となります:
"off"
ポリラインはクリップされません.
"clipgrf"
ポリラインはAxesボックスの外側でクリップ
されます.
"on"
ポリラインはclip_boxプロパティで
指定された矩形の外側でクリップされます.
このフィールドはclip_box
プロパティを定義します.
clip_state が "off" の場合, デフォルトで,この値は空の行列です.
その他の場合, ベクトル [x,y,w,h]
(左上の点 幅 高さ)
は表示するポリラインの部分を定義しますが,
clip_state
プロパティの値が変更されます.
このフィールドはpolylineデータ構造体に任意のScilab変数を 保存し,再度取得する際に使用できます.
このプロパティは,ポリラインに関係するdatatips
のハンドルの
ベクトルを有します.
しかし, ポリラインのハンドルは現在children
を有しません.
The value can be one of the following:
"always"
: the datatip is always displayed (default mode)."mouseclick"
: clicking on the anchor of the datatip
on the line toogles its display. The anchor is always displayed."mouseover"
: setting the mouse pointer over the
datatip anchor on the line displays the datatip. When going away, the
datatip is masked. Its anchor remains displayed.関数名を有する文字列. この関数の呼び出し手順は,
str=fun(datatipHandle)
とします.
ただし, datatipHandle
は表示するdatatipの
ハンドルです.
この関数は, 文字列または文字列ベクトルを str に返します.
この関数は, datatip本体に類似のプロパティを設定することで, オーバーロードできます.
Some datatips formatting functions are predefined:
polar_datatip_display() | : set by polarplot() |
---|---|
formatBodePhaseTip() | : set by bode() |
display_function
関数で必要とされる全Scilabデータ.
a=get("current_axes")//新規に作成された軸のハンドルを取得 a.data_bounds=[-2,-2;2,2]; xpoly(sin(2*%pi*(0:5)/5),cos(2*%pi*(0:5)/5),"lines",0) p=get("hdl"); //カレントのエンティティ(ここではpolylineエンティティ)のハンドルを取得 p.foreground=2; p.thickness=3; p.mark_style=9; d=p.data;d(1,:)=[0 0];p.data=d; a.rotation_angles=[0 45]; | ![]() | ![]() |
xpoly(sin(2*%pi*(0:5)/5),cos(2*%pi*(0:5)/5),"lines",0) p=get("hdl"); //get handle on current entity (here the polyline entity) p.data=[(-2:0.1:2)' sin((-2:0.1:2)*%pi)'] p.mark_mode="off"; p.polyline_style=3; p.line_style=4; | ![]() | ![]() |
// line_styleプロパティの例 clf(); f=gcf(); for i=1:10 plot2d(1:10, i*ones([1:10]), 2); // line_styleを変更: f.children.children(1).children.line_style = i; f.children.children(1).children.thickness = 2; end f.children.axes_visible = ["off","on","off"]; f.children.y_label.text = "line_style value"; f.children.y_label.font_size = 3; | ![]() | ![]() |
Version | Description |
5.4.0 | line_style = 0 は廃止予定です.代わりに 1 を使用してください (両者は等価で,共に実線を意味します). Scilab 5.4.1以降,値0を使用すると エラーを発生します. New line_style values 9 and 10 added. |
5.5.0 |
|
6.0.0 | New property |