champ_properties

説明

Champエンティティはグラフィックエンティティ階層の葉です. このエンティティは2次元ベクトルフィールドのパラメータを定義します.

visible:

このプロパティにはエンティティのvisible プロパティの値が含まれます.この値には, "on" または "off"を指定します. "on"の場合,ベクトルフィールドが描画され, "off"の場合,ベクトルフィールドは画面上に 表示されません.

data:

このフィールドは, 各要素の行および列のインデックスからなる"champdata" 型のtlistデータ構造体を定義します: x および y グリッド座標はそれぞれ data.xおよび data.yに 含まれます. data.fx および data.fyという名前の 相補フィールドは,それぞれ,点(x(i),y(j))における ベクトルフィールドのx および y要素 を定義する行列です.

user_data:

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

line_style:

line_style プロパティの値は [1 10]の範囲の整数とする必要があります. 1は実線,その他の値は破線の選択を意味します (getlinestyle参照).

thickness:

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

colored:

このプロパティの値が"on"の場合, フィールドの ベクトルがフィールドのインテンシティに比例した色により描画されます.

arrow_size:

このプロパティは矢印の大きさを二重に指定します. 値は正または負とします.

• arrow_size < 0: arrows size は ベクトルの平均ノルムに比例します.

• arrow_size > 0: arrows size は windowsの次元に比例します.

clip_state:

このフィールドには champ のclip_state プロパティの値が含まれます. 値は以下となります:

• "off" この場合,ベクトルフィールドはクリップされません.

• "clipgrf" この場合,ベクトルフィールドはaxesボックスの外でクリップされます.

• "on" この場合,ベクトルフィールドはclip_boxプロパティで指定された矩形の外で クリップされます.

clip_box:

このプロパティには clip_box プロパティが含まれます. この値はclip_state が "off"の場合には空の行列となります. その他の場合,ベクトル [x,y,w,h](左上の点 幅 高さ) は表示するベクトルフィールドの領域を定義しますが, clip_stateプロパティの値は変更されます.

parent:

このプロパティには親(parent)のハンドルが含まれます. 2次元ベクトルフィールドエンティティの親は "Axes" または "Compound"型のどちらかです.

例

a = get("current_axes");  // 新規に作成された軸のハンドルを取得
a.data_bounds = [-10,-10 ; 10,10];
c = champ(-5:5, -5:5, rand(11,11), rand(11,11))
set(c, "colored","on", "thickness",2, "arrow_size",-1);
c.data       // "champdata"型のtlistを表示
a.data_bounds = [-5,-5 ; 5,5];

参照

• set — グラフィックエンティティオブジェクトまたは またはユーザインターフェイスオブジェクトのプロパティの値を設定する.
• get — Gets the handle of a graphical or User Interface object, or the property's value of objects.
• delete — グラフィックエンティティとその子を削除.
• champ — 2次元ベクトルフィールドのプロット
• graphics_entities — グラフィックスエンティティデータ構造体の説明

履歴