rectangle_properties

説明

Rectangle エンティティはグラフィックエンティティ階層の葉です. このエンティティは 矩形または塗りつぶされた矩形のパラメータを定義します.

parent:

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

children:

このプロパティはハンドルの子を保持する ベクトルを有します.しかし,現在,rectangleハンドルには 子がありません.

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:

mark_sizeプロパティは, mark_modeプロパティが"on"の時, マーカの大きさを選択するために使用されます. この値は, 8pt, 10pt, 12pt, 14pt, 18pt および 24pt を意味する [0 5]の範囲の整数です.

mark_foreground:

このフィールドは,マーカの縁の色であるmark_foreground プロパティの値を有します.この値は(カレントのcolor_mapに関連する)色インデックス または透過エッジを意味する 0 とします.

mark_background:

このフィールドは,マーカの前景色である mark_backgroundプロパティの値を有します. この値は(カレントのcolor_mapに関連する)色インデックス または透過エッジを意味する 0 とします.

line_mode:

このフィールドは矩形のline_modeプロパティ のデフォルト値を有します. この値は,"on"(線を描画 ) または "off" 線を描画しない)とします.

fill_mode:

fill_modeプロパティの値が"on"の場合, この矩形は前景色(foreground color)で塗りつぶされ, mark_modeも"off"となります. そうでない場合,このプロパティの値は"off"で, 矩形の輪郭のみが前景色により描画されます.

line_style:

line_styleプロパティの値は[0 8]の範囲の整数とします. 0および1は実線,その他の値は破線を意味します (getlinestyle参照).

thickness:

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

foreground:

このフィールドは矩形の外形を描画する際に使用される色を有します. この値は(カレントのカラーマップの)色インデックスとします.

background:

このフィールドは矩形を塗りつぶす際に使用される色を有します. この値は(カレントのカラーマップの)色インデックスとします.

data:

このプロパティは 矩形の左上の点の座標,幅と高さをユーザ座標で返す際に使用されます. この結果は,行列 [xleft,yup,[zup],width,height]です.

visible:

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

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:

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

例

a=get("current_axes");//get the handle of the newly created axes
a.data_bounds=[-2,-2;2,2];

xrect(-1,1,2,2)

r=get("hdl");//カレントのエンティティ(ここでは rectangle エンティティ)のハンドルを取得y 
r.type
r.parent.type
r.foreground=13;
r.line_style=2;
r.fill_mode="on";
r.background=color('red');
r.clip_box=[-1 1;1 1];
r.data(:,[3 4])=[1/2 1/2];
r.data(:,[1 2])=[1/2 1/2];
r.clip_state="off"

参照

• set — グラフィックエンティティオブジェクトまたは またはユーザインターフェイスオブジェクトのプロパティの値を設定する.
• get — グラフィックエンティティまたはユーザーインターフェイスオブジェクト からプロパティの値を取得する.
• delete — グラフィックエンティティとその子を削除.
• xrect — 矩形を描画する
• xfrect — 矩形を塗りつぶす
• xrects — 一連の矩形を描画または塗りつぶす
• graphics_entities — グラフィックスエンティティデータ構造体の説明