Scilab Website | Contribute with GitLab | Mailing list archives | ATOMS toolboxes
Scilab Online Help
5.5.0 - Français

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

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

Aide de Scilab >> Graphiques > annotation > captions

captions

draw graph captions

Calling Sequence

hl=captions(h, strings [,location])

Arguments

h

vector of handles on polyline entities.

strings

n vector of strings, strings(i) is the caption of the ith polyline

hl

a handle of type "Legend", points to the structure containing all the captions information (see legend_properties.

location

a character string with possible values:

  • "in_upper_right": captions are drawn in the upper right corner of the axes box.

  • "in_upper_left": captions are drawn in the upper left corner of the axes box.

  • "in_lower_right": captions are drawn in the lower right corner of the axes box.

  • "in_lower_left": captions are drawn in the lower left corner of the axes box.

  • "out_upper_right": captions are drawn at the right of the upper right corner of the axes box.

  • "out_upper_left": captions are drawn at the left of the upper left corner of the axes box.

  • "out_lower_right": captions are drawn at the right of the lower right corner of the axes box.

  • "out_lower_left": captions are drawn at the left of the lower left corner of the axes box.

  • "upper_caption": captions are drawn above the upper left corner of the axes box.

  • "lower_caption": captions are drawn below the lower left corner of the axes box. This option correspond to the leg argument of plot2d

  • "by_coordinates": the upper left corner of the captions box is given by the "position" field of the associated data structure. The x and y positions are given as fractions of the axes_bounds sizes.

Description

Puts captions on the current plot at the in the bottom left corner of the graphic window using the specified strings as labels. captions prepends labels by a recall of the corresponding polylines. The type and properties are recovered from the given handles:

The captions function creates a Legend data structure.

There is at most one Legend associated with each axes. If the caption function is recalled while a Legend still exist the old one is replaced.

Examples

t=0:0.1:2*%pi;
a=gca();a.data_bounds=[t(1) -1.8;t($) 1.8];
a.margins(4)=0.2;

plot2d(t,[cos(t'),cos(2*t'),cos(3*t')],[1,2 3]);  
e=gce();
e.children(1).thickness=3;
e.children(2).line_style=4;

hl=captions(e.children,['cos(t)';'cos(2*t)';'cos(3*t)']);
hl=captions(e.children,['cos(t)';'cos(2*t)';'cos(3*t)'],'in_upper_right');

hl.legend_location='in_upper_right'
hl.fill_mode='on';

See Also

Report an issue
<< legends annotation Label entity properties >>

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:
Fri Apr 11 14:14:55 CEST 2014