Scilab Website | Contribute with GitLab | Mailing list archives | ATOMS toolboxes
Scilab Online Help
6.1.1 - English

Change language to:
Français - 日本語 - Português - Русский

Please note that the recommended version of Scilab is 2024.1.0. This page might be outdated.
See the recommended documentation of this function

Scilab Help >> Graphics > text > xstring


draw strings


xstring(x, y, str)
xstring(x, y, str, angle)
xstring(x, y, str, angle, box)



real vectors or scalars, coordinates of the lower-left point of the strings.


matrix of strings.

Starting from Scilab 5.2, it is possible to write LaTeX or MathML expression.


real vector or scalar, clockwise angle in degree; default is 0.


integer vector or scalar, default is 0.


If x is a real scalar, it's regarded as a vector with the size of y whose elements are set to x.

If y is a real scalar, it's regarded as a vector with the size of x whose elements are set to y.

xstring draws n strings at location (x[i], y[i]) in the current graphic scale.

If str contain n elements, these n elements are the n drawn strings.

Otherwise, each row of the matrix stands for a line of text and row elements stand for words separated by a white space.

If angle is a real scalar, it's regarded as a vector of size n whose elements are set to angle.

angle(i)gives the slope in degree used for drawing the strings at location (x[i], y[i]).

If box is an integer scalar, it's regarded as a vector of size n whose elements are set to box.

If box(i) is 1 and angle(i) is 0, a box is drawn around the strings at location (x[i], y[i]).


xstring(0.5,0.5,["$\overbrace{Scilab}$" "n''est ";"pas" "$\underbrace{Matlab}$"])
// LaTeX rendering (>= Scilab 5.2)

//Other example
alphabet=["a" "b" "c" "d" "e" "f" "g" ..
          "h" "i" "j" "k" "l" "m" "n" ..
          "o" "p" "q" "r" "s" "t" "u" ..
          "v" "w" "x" "y" "z"];
xstring(0.1,1.8,alphabet)     // alphabet
xstring(0.1,1.6,alphabet,0,1) // alphabet in a box
xstring(0.1,1.4,alphabet,20)  // angle
set(gca(), "font_style", 1, "font_size", 1);  // use symbol fonts
gce().font_size = 3;          // change the font size
xstring(0.1,0.6,"a")    //big alpha
gce().font_size = 24;

See also

  • text_properties — description of the Text entity properties
  • Math mode in strings — Display mathematical equations in Scilab graphics through the LaTeX or MathML languages.
  • xnumb — draw numbers
  • xtitle — add titles on a graphics window
  • titlepage — add a title in the middle of a graphics window
Report an issue
<< xnumb text xstringb >>

Copyright (c) 2022-2023 (Dassault Systèmes)
Copyright (c) 2017-2022 (ESI Group)
Copyright (c) 2011-2017 (Scilab Enterprises)
Copyright (c) 1989-2012 (INRIA)
Copyright (c) 1989-2007 (ENPC)
with contributors
Last updated:
Mon Jan 03 14:23:28 CET 2022