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


xstringb

draw strings into a box

Syntax

xstringb(x,y,str,w,h,[option])
hdl = xstringb(...)

Arguments

x,y,w,h

vector of 4 real scalars defining the box.

str

matrix of strings.

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

option

string.

hdl

This optional output contains a handle to a Compound object whose children are the created Text entities. Use hdl to modify properties of a specific or all Text entities after they are created. For a list of properties, see text_properties.

Description

xstringb draws the matrix of strings str centered inside the rectangle rect=[x,y,w,h] (lower-left point, width, height) in user coordinates.

If option is given with the value "fill", the character size is computed so as to fill as much as possible in the rectangle.

Enter the command xstringb() to see a demo.

Examples

str=["Scilab" "is";"$\sqrt{not}$" "elisaB"];
plot2d(0,0,[-1,1],"010"," ",[0,0,1,1]);

r=[0,0,1,0.5];
xstringb(r(1),r(2),str,r(3),r(4),"fill");
xrect(r(1),r(2)+r(4),r(3),r(4));

r=[r(1),r(2)+r(4)+0.01,r(3),r(4)/2];
xrect(r(1),r(2)+r(4),r(3),r(4))
xstringb(r(1),r(2),str,r(3),r(4),"fill");

See also

  • titlepage — add a title in the middle of a graphics window
  • xstring — draw strings
  • xstringl — compute a box which surrounds strings
  • xtitle — add titles on a graphics window

History

VersionDescription
2025.0.0 Function returns the created handle(s).
Report an issue
<< xstring text xstringl >>

Copyright (c) 2022-2024 (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:
Thu Oct 24 11:13:10 CEST 2024