~ubuntu-branches/ubuntu/karmic/scilab/karmic

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
.TH locate 2 "April 1993" "Scilab Group" "Scilab Function" 
.so ../sci.an
.SH NAME
locate - mouse selection of a set of points 
.SH CALLING SEQUENCE
.nf
x=locate([n,flag])
.fi
.SH PARAMETERS 
.TP 8
x
: matrix of size (2,n1). n1=n if the parameter n is given.
.TP
n,flag 
: integer values.
.LP
.SH DESCRIPTION
\fVlocate\fR is used to get the coordinates of one or more 
points selected with the mouse in a graphics window. The coordinates 
are given using the current graphics scale. 

If n>0, n points are selected and their coordinates are returned in 
the matrix \fVx\fR.

If n<=0, points are selected until the user clicks with the left button 
of the mouse which stands for stop. The last point (clicked with the left 
button) is not returned.

x=locate() is the same as \fVx=locate(-1)\fR.
.LP
If \fVflag=1\fR a cross is drawn at the points where the mouse is clicked.
.SH SEE ALSO
xclick, xgetmouse
.SH AUTHOR
S.S. & J.Ph.C