champ_properties

champ_properties — description of the 2D vector field entity properties

Description

The Champ entity is a leaf of the graphics entities hierarchy. This entity defines the parameters for a 2D vector field.

visible: This properties contains the visible property value for the entity . It should be "on" or "off" . If "on" the vector field is drawn, If "off" the vector field is not displayed on the screen.
data:

This property represent a matrix [x,y,fx,fy]x where y gives the coordinates of the champ boundary. If xv=matrix(x,2,-1) and yv=matrix(y,2,-1) the two vectors xv(:,k) and yv(:,k) are the boundary coordinates of the segments numbered k. fx and fy are two square matrices which are the x and y components of the fields value at each given point.

line_style: The line_style property value should be an integer in [0 9]. 0 stands for solid the other value stands for a selection of dashes. This property applies to all lines used to draw the vector field.
thickness: This property contains the thickness property for all lines used to draw the vector field. Its value should be a non negative integer..
colored: If this this property value is "on", fields vectors are drawn using a color proportional to the intensity of the field.
clip_state:

This field contains the clip_state property value for the champ. It should be :

"off" this means that the vector field is not clipped

"cliprf" this means that the vector field is clipped outside the Axes box.

"on" this means that the vector field is clipped outside the rectangle given by property clip_box.

clip_box: This property contains the clip_box property. Its value should be an empty matrix if clip_state is "off" .Other cases the vector [x,y,w,h] (upper-left point width height) defines the portions of the vector field to display, however clip_state property value will be changed.
parent: This property contains the handle of the parent. The parent of the 2D vector field entity should be of the type "Axes" or "Agregation".

Examples



  
  set("figure_style","new") //create a figure
   a=get("current_axes");//get the handle of the newly created axes
   a.data_bounds=[-10,-10,10,10];
   champ(-5:5,-5:5,rand(11,11),rand(11,11))

   c=a.children

   c.colored="on";
   c.thickness=2;
   a.data_bounds=[-5,-5,5,5];

 
  

See also

set, get, delete, champ, champ1, graphics_entities

Author

Djalel ABDEMOUCHE