Man Scilab
axis_properties
Scilab Data type
axis_properties - description of the
axis entity properties
Description
The Axis entity is a leaf of the graphics entities hierarchy.
This entity defines the parameters for axis scaling and appearance.
-
Axis properties
-
visible:
This field contains the
visible
property value
for the entity . It should be
"on"
or
"off"
.
By default, the axis entity is visible, the value's property is
"on"
. If
"off"
, the axis is not drawn on the screen.
-
tics_direction:
Specify the direction of the tics drawn under the horizontal axis and
the vertical axis.
The possible values of this property are:
-
"top"
. In this case, tics are drawn at
the top of the horizontal axis.
-
"bottom"
. In this case, tics are drawn at
the bottom of the horizantal axis.
-
"left"
. In this case, tics are going left on
the vertical axis.
-
"right"
. In this case, tics are going right on
the vertical axis.
The defaults values are
"top"
for the horizontal axis and
"right"
for vertical axis.
-
xtics_coord:
This field represent the x-coordinate of the axis. It is a row vector
containing values increasing from left to right which give tics positions
for a horizontal axis. Other case, the entity is a vertical axis, this
property contain a scale which defines the x-origin of the axis.
-
ytics_coord:
This field represent the y-coordinate of the axis. It is a row vector
containing values increasing from bottom to top which give tics positions
for a vertical axis. Other case, the entity is a horizantal axis, this
property contain a scale which defines the y-origin of the axis.
-
tics_color:
The value of this properties is index of the color used to draw the axis'lines and tics.
-
sub_tics:
This field sets the number of tics to draw between two main
tics.
-
tics_segment:
This field contains a flag which controls the display of the base segment of
the axis. The default is
"on"
, else if to not display it, the property
takes
"off"
as value.
-
tics_style:
This property describes how the tics are given. It is a string flag
which can have these possible values:
-
"v"
. It's the default value, In this case, tics positions
are given by the row factor
xtics_coord
for horizontal
axis (
ytics_coord
for the vertical one).
-
"r"
. In this case, tics positions are given by the
vector
[min,max,n]
where n is the number of intervals.
-
"i"
. In this case the vector given tics positions is of
size 4,
[k1,k2,a,n]
then values are increasing between
k1*10^a
and
k2*10^a
, n is the number of intervals.
-
tics_labels:
This filed is a string matrix, which contains the strings to be drawn along
the axis at tics positions.
-
labels_font_color:
This property determines the color of the tics labels.
-
labels_font_size:
An integer specifying the font size used to draw the tics labels.
-
clip_state:
This field contains the
clip_state
property
value for the arc. Clip_state value should be :
-
"off"
this means that the axis is not clipped
-
"clipgrf"
this means that the
axis is clipped outside the Axes box.
-
"on"
this means that the
axis is clipped outside the arc given by property clip_box.
-
clip_box:
This field is to determinate the
clip_box
property.
By Default 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 axis to display, however
clip_state
property
value will be changed.
-
parent:
This property contains the handle of the parent. The parent of the axis
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=[-1,-1;10,10];
drawaxis(x=2:7,y=4,dir='u');
a1=a.children(1)
a1.xtics_coord=[1 4 5 8 10];
a1.tics_color=2;
a1.labels_font_size=3;
a1.tics_direction="bottom";
a1.tics_labels= [" February" "May" "june" "August" "October"];
drawaxis(x=1.2:1:10,y=5,dir='u',textcolor=13);
a2=get("hdl")
a2.sub_tics=0;
a2.tics_segments="off";
a2.ytics_coord=4;
drawaxis(x=-1,y=0:1:7,dir='r',fontsize=10,textcolor=5,ticscolor=6,sub_int=10)
a3=get("hdl");
a3.tics_labels= 'B' +string(0:7);
a3.tics_direction="left";
See Also
set
,
get
,
delete
,
drawaxis
,
graphics_entities
,
Author
Djalel ABDEMOUCHE
Back