polyline_properties

説明

Polylineエンティティはグラフィックエンティティ階層の葉です. このエンティティは ポリラインのパラメータを定義します.

parent:

このフィールドには親のハンドルが含まれます. polylineエンティティの親は"Axes" 型または "Compound"型です.

children:

このプロパティにはこのハンドルのchildren のベクトルが含まれます. しかし,現在,polylineにはchildrenがありません.

visible:

このフィールドはこのエンティティのvisible プロパティの値を有します. 値は"on" または "off"となります. デフォルトで polyline は可視であり,プロパティの値は "on"となります. "off" の場合, このポリラインは画面に描画されません.

data:

このフィールドはxおよびy座標の値を有します. 3次元軸の場合にはZ要素が追加されます. この値は,各点の座標を含む2(3)列の行列[x,y,[z]]です.

closed:

このフィールドはポリラインが閉じているかどうかを定義します: 値は "on" または "off"となります (デフォルト値はなく,ポリラインを作成する際に使用されたプリミティブに 依存します).

line_mode:

このフィールドはポリラインのline_modeプロパティの デフォルト値を有します. この値には "on"(線を描画 ) または "off" (線を描画しない)を指定します.

fill_mode:

polyline_styleフィールドが 5ではない場合, 曲線の 背景がbackground プロパティで定義した色で塗られます.

line_style:

このフィールドは,Segs, Arcs, Rectangle および Polylineオブジェクトの line_styleのデフォルト値を有します. line_styleは,線を描画する際に使用される 線の型を選択します.この値は, [1 10]の範囲の整数となります. 1 は実線を意味し, 他の値は破線 (破線, 一点鎖線, 長一点鎖線, 大鎖線, 大長一点鎖線, 点線, 2重点線, 長空白点線, 大空白点線) の選択を意味します. 以下の例を参照ください.

thickness:

このプロパティはピクセル単位で線幅を指定する正の実数です. 実際の表示幅は指定された幅を最も近い整数に丸めることで定義されます. 唯一の例外はベクトル単位のエキスポートで,この場合は全体の thicknessの値が考慮されます.

arrow_size_factor:

この整数によりポリラインに描かれる矢印の大きさを設定することができます. 実際の矢印の大きさはthicknessとこのsize factorの 積となります.

polyline_style:

このプロパティは以下の各種のポリライン描画モードを設定します:

• 値が 0または1の場合,連続する2つの点の間に線が描画されます.

• 値が2の場合,ポリラインは階段プロットとなります. 連続する2つの点は水平線の後に垂直線が続く線により結合されます.

• 値が3の場合,ポリラインは棒グラフとなります. 指定された各(x,y)について, (x,y) から (x,0)に垂直線が引かれます.

• 値が 4の場合,連続する2つの点の間に矢印が描かれます.

• 値が5の場合,ポリラインは塗りつぶされます (パッチ).

• 値が 6の場合,ポリラインはMatlabに似たbarオブジェクトとなります. プロパティbar_shift およびbar_width がその外観を規定します.

foreground:

このフィールドにはポリラインを描画する際に使用される foregroundプロパティのデフォルト値が含まれます. その値には(カレントのカラーマップに沿った)色インデックスを指定します.

background:

このフィールドはポリラインの背景を塗りつぶす際に使用される色を有します. その値には(カレントのカラーマップに沿った)色インデックスを指定します.

interp_color_vector:

このフィールドは, interp_color_modeプロパティが"on"に設定された 際にポリラインを塗る際に使用される色インデックスの ベクトルを有します. これは,各セグメントを塗る際に使用される カラーマップインデックスの間隔を定義します. 例えば,最初のセグメントは, インデックスがベクトルの最初の2つの要素の間にある各色により塗りつぶされます. これはポリラインが 3 または 4つの点で定義されている場合のみ適用可能です. このため,ベクトルの大きさはこの次元に一致している必要があります.

interp_color_mode:

このフィールドはポリラインを塗る際に補間影モードを 使用するかどうかを定義します: この値は"on" または"off"となります. "on"に値を切り替える前に interp_color_vectorを 定義する必要があります (上記参照).

mark_mode:

このフィールドはポリラインのmark_mode プロパティのデフォルト値を有します. この値は"on" (マーカを描画 drawn) または "off" (マーカを描画しない)となります.

mark_style:

mark_styleプロパティの値は mark_modeプロパティが"on"の場合に, 使用するマーカの種類を選択するために使用されます. この値は[0 14]の範囲の整数で,それぞれ以下の意味があります : ドット,プラス,十字,星,塗りつぶした菱形, 上向き三角形, 下向き三角形, 菱形プラス,円,アスタリスク, 正方形,右向き三角形,左向き三角形およびペンタグラム. 以下の図は,マーカのアスペクトがmark_style, mark_foreground および mark_backgroundプロパティに依存する ことを示します.

mark_size_unit:

このフィールは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:

This property specifies the size of the marks displayed when the mark_mode property is "on". If its value is scalar, the same mark size is set for all points of the curve. Otherwise it must be a row with as many elements as there are points in the curve. The type of values depends on the mark_size_unit property.

mark_foreground:

This property specifies the color of the edges or details of marks. Acceptable values are indices of colors in the current figure's colormap, or -2 for white, -1 for black, or 0 for transparent edges. If its value is scalar, the same specified color is used for the marks of all points of the curve. Otherwise it must be a row with as many elements as there are points in the curve.

mark_background:

This property specifies the color filling the background of marks. Acceptable values are indices of colors in the current figure's colormap, or -2 for white, -1 for black, or 0 for transparent edges. If its value is scalar, the same specified color is used for the marks of all points of the curve. Otherwise it must be a row with as many elements as there are points in the curve.

mark_offset:

このフィールドは, 最初の記号を描画する際に使用されるオフセットである mark_offset プロパティの値を有します. この値は, 0 以上の整数とする必要があります (デフォルト値は 0).

mark_stride:

このフィールドは, 記号を描画する際に使用するストライド (すなわち, 2つの連続する記号の間で stride-1 個の点がスキップされます) である mark_stride プロパティの値を有します. この値は, 1以上の整数とする必要があります (デフォルト値は 1).

x_shift:

このフィールドは関数barをコールする ことにより計算される (またはbarhomogenizeを コールすることにより再計算される)オフセットを有し, 見栄えの良い垂直棒グラフを作成するために使用されます. このオフセットは他のpolyline_styleにも 適用されることに注意してください. 単位はユーザ座標で表されます.

y_shift:

このフィールドは関数barをコールする ことにより計算される (またはbarhomogenizeを コールすることにより再計算される)オフセットを有し, 見栄えの良い水平棒グラフを作成するために使用されます. このオフセットは他のpolyline_styleにも 適用されることに注意してください. 単位はユーザ座標で表されます.

z_shift:

このフィールドはユーザが指定する オフセットを有します このオフセットは他のpolyline_styleにも 適用されることに注意してください. このユニットはユーザ座標で表されています.

bar_width:

このフィールドは, polyline_style が棒グラフモード (ケース 6)に せていされている場合に, 選択されたポリラインの幅を定義します: 単位はユーザ座標で表されます.

clip_state:

このフィールドはポリラインのclip_stateプロパティの 値を有します. 値は以下となります:

• "off" ポリラインはクリップされません.

• "clipgrf" ポリラインはAxesボックスの外側でクリップ されます.

• "on"ポリラインはclip_boxプロパティで 指定された矩形の外側でクリップされます.

clip_box:

このフィールドはclip_boxプロパティを定義します. clip_state が "off" の場合, デフォルトで,この値は空の行列です. その他の場合, ベクトル　[x,y,w,h] (左上の点 幅 高さ) は表示するポリラインの部分を定義しますが, clip_stateプロパティの値が変更されます.

user_data:

このフィールドはpolylineデータ構造体に任意のScilab変数を 保存し,再度取得する際に使用できます.

datatips:

このプロパティは,ポリラインに関係するdatatipsのハンドルの ベクトルを有します. しかし, ポリラインのハンドルは現在childrenを有しません.

datatip_display_mode:

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.

display_function:

関数名を有する文字列. この関数の呼び出し手順は, 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_data:

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;

参照

• champ_properties — 2次元ベクトルフィールドエンティティプロパティの説明
• param3d_properties — 3次元曲線エンティティのプロパティの説明
• plot — 2Dプロット
• set — グラフィックエンティティオブジェクトまたは またはユーザインターフェイスオブジェクトのプロパティの値を設定する.
• get — Gets the handle of a graphical or User Interface object, or the property's value of objects.
• xpoly — ポリラインまたはポリゴンを描画する
• xfpoly — ポリゴンを塗りつぶす
• xpolys — 一連のポリラインまたはポリゴンを描画
• xfpolys — 一連のポリゴンを塗りつぶす
• graphics_entities — グラフィックスエンティティデータ構造体の説明

履歴