Please note that the recommended version of Scilab is 2024.0.0. This page might be outdated.
See the recommended documentation of this function
description of the axis entity properties
The Axis entity is a leaf of the graphics entities hierarchy. This entity defines the parameters for axis scaling and appearance.
- Axis properties
This property contains the handle of the parent. The parent of the axis entity should be of the type
This field contains the
visibleproperty value for the entity . It should be
"off". By default, the axis entity is visible, the value's property is
"off", the axis is not drawn on the screen.
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.
This field represents 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.
This field represents 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 horizontal axis, this property contain a scale which defines the y-origin of the axis.
The value of this properties is index of the color used to draw the axis'lines and tics.
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
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_coordfor horizontal axis (
ytics_coordfor 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
k2*10^a, n is the number of intervals.
This field sets the number of tics to draw between two main tics.
This field is a string matrix, which contains the strings to be drawn along the axis at tics positions.
This property is a character string which specifies the floating-point display format of the tics labels numbers, when relevant. It uses the format syntax of the C language printf function (for example
"%.3f"). If equal to
"", a default display format is used.
This property determines the color of the tics labels.
It is a scalar specifying the character size of tics labels. If
"off"only the integer part of the value is used. For more information see graphics_fonts.
This property specifies whether ticks labels are displayed using fractional font sizes. Its value must be either
"on"the floating point value of
font_sizeis used for display and the font is anti-aliased. If
"off"only the integer part is used and the font is not smoothed.
This field contains the
clip_stateproperty 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.
This field is to determinate the
clip_boxproperty. 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_stateproperty value will be changed.
This field can be used to store any scilab variable in the axis data structure, and to retrieve it.
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_segment="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";
- set — set a property value of a graphic entity object or of a User Interface object.
- get — Retrieve a property value from a graphics entity or an User Interface object.
- delete — delete a graphic entity and its children.
- drawaxis — draw an axis
- graphics_entities — description of the graphics entities data structures
|<< axis||axis||drawaxis >>|