annotate scripts/plot/__pltopt__.m @ 7017:a1dbe9d80eee

[project @ 2007-10-12 21:27:11 by jwe]
author jwe
date Fri, 12 Oct 2007 21:27:37 +0000
parents 93c65f2a5668
children 7d48766c21a5
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
7017
a1dbe9d80eee [project @ 2007-10-12 21:27:11 by jwe]
jwe
parents: 7016
diff changeset
1 ## Copyright (C) 1994, 1995, 1996, 1997, 1998, 2000, 2002, 2004, 2005,
a1dbe9d80eee [project @ 2007-10-12 21:27:11 by jwe]
jwe
parents: 7016
diff changeset
2 ## 2006, 2007 John W. Eaton
2313
5ca126254d15 [project @ 1996-07-11 21:25:22 by jwe]
jwe
parents: 2311
diff changeset
3 ##
5ca126254d15 [project @ 1996-07-11 21:25:22 by jwe]
jwe
parents: 2311
diff changeset
4 ## This file is part of Octave.
5ca126254d15 [project @ 1996-07-11 21:25:22 by jwe]
jwe
parents: 2311
diff changeset
5 ##
5ca126254d15 [project @ 1996-07-11 21:25:22 by jwe]
jwe
parents: 2311
diff changeset
6 ## Octave is free software; you can redistribute it and/or modify it
5ca126254d15 [project @ 1996-07-11 21:25:22 by jwe]
jwe
parents: 2311
diff changeset
7 ## under the terms of the GNU General Public License as published by
7016
93c65f2a5668 [project @ 2007-10-12 06:40:56 by jwe]
jwe
parents: 6895
diff changeset
8 ## the Free Software Foundation; either version 3 of the License, or (at
93c65f2a5668 [project @ 2007-10-12 06:40:56 by jwe]
jwe
parents: 6895
diff changeset
9 ## your option) any later version.
2313
5ca126254d15 [project @ 1996-07-11 21:25:22 by jwe]
jwe
parents: 2311
diff changeset
10 ##
5ca126254d15 [project @ 1996-07-11 21:25:22 by jwe]
jwe
parents: 2311
diff changeset
11 ## Octave is distributed in the hope that it will be useful, but
5ca126254d15 [project @ 1996-07-11 21:25:22 by jwe]
jwe
parents: 2311
diff changeset
12 ## WITHOUT ANY WARRANTY; without even the implied warranty of
5ca126254d15 [project @ 1996-07-11 21:25:22 by jwe]
jwe
parents: 2311
diff changeset
13 ## MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
5ca126254d15 [project @ 1996-07-11 21:25:22 by jwe]
jwe
parents: 2311
diff changeset
14 ## General Public License for more details.
5ca126254d15 [project @ 1996-07-11 21:25:22 by jwe]
jwe
parents: 2311
diff changeset
15 ##
5ca126254d15 [project @ 1996-07-11 21:25:22 by jwe]
jwe
parents: 2311
diff changeset
16 ## You should have received a copy of the GNU General Public License
7016
93c65f2a5668 [project @ 2007-10-12 06:40:56 by jwe]
jwe
parents: 6895
diff changeset
17 ## along with Octave; see the file COPYING. If not, see
93c65f2a5668 [project @ 2007-10-12 06:40:56 by jwe]
jwe
parents: 6895
diff changeset
18 ## <http://www.gnu.org/licenses/>.
933
598a3aa40360 [project @ 1994-11-17 04:23:41 by jwe]
jwe
parents:
diff changeset
19
6895
76e3d985ae56 [project @ 2007-09-13 18:22:38 by jwe]
jwe
parents: 6459
diff changeset
20 ## Undocumented internal function.
76e3d985ae56 [project @ 2007-09-13 18:22:38 by jwe]
jwe
parents: 6459
diff changeset
21
3500
7923abdeb4e5 [project @ 2000-01-31 06:35:00 by jwe]
jwe
parents: 3449
diff changeset
22 ## @deftypefn {Function File} {} __pltopt__ (@var{caller}, @var{opt})
6895
76e3d985ae56 [project @ 2007-09-13 18:22:38 by jwe]
jwe
parents: 6459
diff changeset
23 ##
2311
2b5788792cad [project @ 1996-07-11 20:18:38 by jwe]
jwe
parents: 2303
diff changeset
24 ## Decode plot option strings.
2b5788792cad [project @ 1996-07-11 20:18:38 by jwe]
jwe
parents: 2303
diff changeset
25 ##
3449
858695b3ed62 [project @ 2000-01-18 04:08:59 by jwe]
jwe
parents: 3426
diff changeset
26 ## @var{opt} can currently be some combination of the following:
2311
2b5788792cad [project @ 1996-07-11 20:18:38 by jwe]
jwe
parents: 2303
diff changeset
27 ##
3449
858695b3ed62 [project @ 2000-01-18 04:08:59 by jwe]
jwe
parents: 3426
diff changeset
28 ## @table @code
858695b3ed62 [project @ 2000-01-18 04:08:59 by jwe]
jwe
parents: 3426
diff changeset
29 ## @item "-"
6267
0078497b3b0b [project @ 2007-02-01 10:34:14 by jwe]
jwe
parents: 6264
diff changeset
30 ## For solid linestyle (default).
3717
e3501697c995 [project @ 2000-09-08 06:27:44 by jwe]
jwe
parents: 3500
diff changeset
31 ##
6267
0078497b3b0b [project @ 2007-02-01 10:34:14 by jwe]
jwe
parents: 6264
diff changeset
32 ## @item "--"
0078497b3b0b [project @ 2007-02-01 10:34:14 by jwe]
jwe
parents: 6264
diff changeset
33 ## For dashed line style.
3717
e3501697c995 [project @ 2000-09-08 06:27:44 by jwe]
jwe
parents: 3500
diff changeset
34 ##
6267
0078497b3b0b [project @ 2007-02-01 10:34:14 by jwe]
jwe
parents: 6264
diff changeset
35 ## @item "-."
3717
e3501697c995 [project @ 2000-09-08 06:27:44 by jwe]
jwe
parents: 3500
diff changeset
36 ## For linespoints plot style.
e3501697c995 [project @ 2000-09-08 06:27:44 by jwe]
jwe
parents: 3500
diff changeset
37 ##
6267
0078497b3b0b [project @ 2007-02-01 10:34:14 by jwe]
jwe
parents: 6264
diff changeset
38 ## @item ":"
0078497b3b0b [project @ 2007-02-01 10:34:14 by jwe]
jwe
parents: 6264
diff changeset
39 ## For dots plot style.
3717
e3501697c995 [project @ 2000-09-08 06:27:44 by jwe]
jwe
parents: 3500
diff changeset
40 ##
6267
0078497b3b0b [project @ 2007-02-01 10:34:14 by jwe]
jwe
parents: 6264
diff changeset
41 ## @item "r"
0078497b3b0b [project @ 2007-02-01 10:34:14 by jwe]
jwe
parents: 6264
diff changeset
42 ## Red line color.
3717
e3501697c995 [project @ 2000-09-08 06:27:44 by jwe]
jwe
parents: 3500
diff changeset
43 ##
6267
0078497b3b0b [project @ 2007-02-01 10:34:14 by jwe]
jwe
parents: 6264
diff changeset
44 ## @item "g"
0078497b3b0b [project @ 2007-02-01 10:34:14 by jwe]
jwe
parents: 6264
diff changeset
45 ## Green line color.
3717
e3501697c995 [project @ 2000-09-08 06:27:44 by jwe]
jwe
parents: 3500
diff changeset
46 ##
6267
0078497b3b0b [project @ 2007-02-01 10:34:14 by jwe]
jwe
parents: 6264
diff changeset
47 ## @item "b"
0078497b3b0b [project @ 2007-02-01 10:34:14 by jwe]
jwe
parents: 6264
diff changeset
48 ## Blue line color.
3717
e3501697c995 [project @ 2000-09-08 06:27:44 by jwe]
jwe
parents: 3500
diff changeset
49 ##
6267
0078497b3b0b [project @ 2007-02-01 10:34:14 by jwe]
jwe
parents: 6264
diff changeset
50 ## @item "c"
0078497b3b0b [project @ 2007-02-01 10:34:14 by jwe]
jwe
parents: 6264
diff changeset
51 ## Cyan line color.
3717
e3501697c995 [project @ 2000-09-08 06:27:44 by jwe]
jwe
parents: 3500
diff changeset
52 ##
6267
0078497b3b0b [project @ 2007-02-01 10:34:14 by jwe]
jwe
parents: 6264
diff changeset
53 ## @item "m"
0078497b3b0b [project @ 2007-02-01 10:34:14 by jwe]
jwe
parents: 6264
diff changeset
54 ## Magenta line color.
4006
efac4b97bb09 [project @ 2002-07-26 01:20:46 by jwe]
jwe
parents: 3717
diff changeset
55 ##
6267
0078497b3b0b [project @ 2007-02-01 10:34:14 by jwe]
jwe
parents: 6264
diff changeset
56 ## @item "y"
0078497b3b0b [project @ 2007-02-01 10:34:14 by jwe]
jwe
parents: 6264
diff changeset
57 ## Yellow line color.
3717
e3501697c995 [project @ 2000-09-08 06:27:44 by jwe]
jwe
parents: 3500
diff changeset
58 ##
6267
0078497b3b0b [project @ 2007-02-01 10:34:14 by jwe]
jwe
parents: 6264
diff changeset
59 ## @item "k"
0078497b3b0b [project @ 2007-02-01 10:34:14 by jwe]
jwe
parents: 6264
diff changeset
60 ## Black line color.
3717
e3501697c995 [project @ 2000-09-08 06:27:44 by jwe]
jwe
parents: 3500
diff changeset
61 ##
6267
0078497b3b0b [project @ 2007-02-01 10:34:14 by jwe]
jwe
parents: 6264
diff changeset
62 ## @item "w"
0078497b3b0b [project @ 2007-02-01 10:34:14 by jwe]
jwe
parents: 6264
diff changeset
63 ## White line color.
3717
e3501697c995 [project @ 2000-09-08 06:27:44 by jwe]
jwe
parents: 3500
diff changeset
64 ##
3449
858695b3ed62 [project @ 2000-01-18 04:08:59 by jwe]
jwe
parents: 3426
diff changeset
65 ## @item ";title;"
858695b3ed62 [project @ 2000-01-18 04:08:59 by jwe]
jwe
parents: 3426
diff changeset
66 ## Here @code{"title"} is the label for the key.
3717
e3501697c995 [project @ 2000-09-08 06:27:44 by jwe]
jwe
parents: 3500
diff changeset
67 ##
6267
0078497b3b0b [project @ 2007-02-01 10:34:14 by jwe]
jwe
parents: 6264
diff changeset
68 ## @item "+"
0078497b3b0b [project @ 2007-02-01 10:34:14 by jwe]
jwe
parents: 6264
diff changeset
69 ## @itemx "o"
0078497b3b0b [project @ 2007-02-01 10:34:14 by jwe]
jwe
parents: 6264
diff changeset
70 ## @itemx "*"
0078497b3b0b [project @ 2007-02-01 10:34:14 by jwe]
jwe
parents: 6264
diff changeset
71 ## @itemx "."
0078497b3b0b [project @ 2007-02-01 10:34:14 by jwe]
jwe
parents: 6264
diff changeset
72 ## @itemx "x"
0078497b3b0b [project @ 2007-02-01 10:34:14 by jwe]
jwe
parents: 6264
diff changeset
73 ## @itemx "s"
0078497b3b0b [project @ 2007-02-01 10:34:14 by jwe]
jwe
parents: 6264
diff changeset
74 ## @itemx "d"
0078497b3b0b [project @ 2007-02-01 10:34:14 by jwe]
jwe
parents: 6264
diff changeset
75 ## @itemx "^"
0078497b3b0b [project @ 2007-02-01 10:34:14 by jwe]
jwe
parents: 6264
diff changeset
76 ## @itemx "v"
0078497b3b0b [project @ 2007-02-01 10:34:14 by jwe]
jwe
parents: 6264
diff changeset
77 ## @itemx ">"
0078497b3b0b [project @ 2007-02-01 10:34:14 by jwe]
jwe
parents: 6264
diff changeset
78 ## @itemx "<"
0078497b3b0b [project @ 2007-02-01 10:34:14 by jwe]
jwe
parents: 6264
diff changeset
79 ## @itemx "p"
0078497b3b0b [project @ 2007-02-01 10:34:14 by jwe]
jwe
parents: 6264
diff changeset
80 ## @itemx "h"
3717
e3501697c995 [project @ 2000-09-08 06:27:44 by jwe]
jwe
parents: 3500
diff changeset
81 ## Used in combination with the points or linespoints styles, set the point
e3501697c995 [project @ 2000-09-08 06:27:44 by jwe]
jwe
parents: 3500
diff changeset
82 ## style.
3449
858695b3ed62 [project @ 2000-01-18 04:08:59 by jwe]
jwe
parents: 3426
diff changeset
83 ## @end table
2311
2b5788792cad [project @ 1996-07-11 20:18:38 by jwe]
jwe
parents: 2303
diff changeset
84 ##
3449
858695b3ed62 [project @ 2000-01-18 04:08:59 by jwe]
jwe
parents: 3426
diff changeset
85 ## The legend may be fixed to include the name of the variable
858695b3ed62 [project @ 2000-01-18 04:08:59 by jwe]
jwe
parents: 3426
diff changeset
86 ## plotted in some future version of Octave.
933
598a3aa40360 [project @ 1994-11-17 04:23:41 by jwe]
jwe
parents:
diff changeset
87
3162
7c96e85c76db [project @ 1998-04-08 18:19:35 by jwe]
jwe
parents: 3101
diff changeset
88 ## Author: jwe
2314
949ab8eba8bc [project @ 1996-07-12 03:58:02 by jwe]
jwe
parents: 2313
diff changeset
89
6459
5dc550e1f419 [project @ 2007-03-26 18:11:58 by jwe]
jwe
parents: 6267
diff changeset
90 function [options, valid] = __pltopt__ (caller, opt, err_on_invalid)
5dc550e1f419 [project @ 2007-03-26 18:11:58 by jwe]
jwe
parents: 6267
diff changeset
91
5dc550e1f419 [project @ 2007-03-26 18:11:58 by jwe]
jwe
parents: 6267
diff changeset
92 valid = true;
5dc550e1f419 [project @ 2007-03-26 18:11:58 by jwe]
jwe
parents: 6267
diff changeset
93 options = __default_plot_options__ ();
933
598a3aa40360 [project @ 1994-11-17 04:23:41 by jwe]
jwe
parents:
diff changeset
94
6459
5dc550e1f419 [project @ 2007-03-26 18:11:58 by jwe]
jwe
parents: 6267
diff changeset
95 if ((nargin == 2 || nargin == 3) && (nargout == 1 || nargout == 2))
5dc550e1f419 [project @ 2007-03-26 18:11:58 by jwe]
jwe
parents: 6267
diff changeset
96 if (nargin == 2)
5dc550e1f419 [project @ 2007-03-26 18:11:58 by jwe]
jwe
parents: 6267
diff changeset
97 err_on_invalid = true;
5dc550e1f419 [project @ 2007-03-26 18:11:58 by jwe]
jwe
parents: 6267
diff changeset
98 endif
6146
1a6d826e92b5 [project @ 2006-11-09 03:13:11 by jwe]
jwe
parents: 6046
diff changeset
99 if (ischar (opt))
1a6d826e92b5 [project @ 2006-11-09 03:13:11 by jwe]
jwe
parents: 6046
diff changeset
100 nel = rows (opt);
1a6d826e92b5 [project @ 2006-11-09 03:13:11 by jwe]
jwe
parents: 6046
diff changeset
101 elseif (iscellstr (opt))
1a6d826e92b5 [project @ 2006-11-09 03:13:11 by jwe]
jwe
parents: 6046
diff changeset
102 nel = numel (opt);
1a6d826e92b5 [project @ 2006-11-09 03:13:11 by jwe]
jwe
parents: 6046
diff changeset
103 else
1a6d826e92b5 [project @ 2006-11-09 03:13:11 by jwe]
jwe
parents: 6046
diff changeset
104 error ("__pltopt__: expecting argument to be character string or cell array of character strings");
1a6d826e92b5 [project @ 2006-11-09 03:13:11 by jwe]
jwe
parents: 6046
diff changeset
105 endif
1a6d826e92b5 [project @ 2006-11-09 03:13:11 by jwe]
jwe
parents: 6046
diff changeset
106 if (ischar (opt))
1a6d826e92b5 [project @ 2006-11-09 03:13:11 by jwe]
jwe
parents: 6046
diff changeset
107 opt = cellstr (opt);
1a6d826e92b5 [project @ 2006-11-09 03:13:11 by jwe]
jwe
parents: 6046
diff changeset
108 endif
6264
cc2bee854d23 [project @ 2007-02-01 10:00:05 by jwe]
jwe
parents: 6146
diff changeset
109 for i = nel:-1:1
6459
5dc550e1f419 [project @ 2007-03-26 18:11:58 by jwe]
jwe
parents: 6267
diff changeset
110 [options(i), valid] = __pltopt1__ (caller, opt{i}, err_on_invalid);
5dc550e1f419 [project @ 2007-03-26 18:11:58 by jwe]
jwe
parents: 6267
diff changeset
111 if (! err_on_invalid && ! valid)
5dc550e1f419 [project @ 2007-03-26 18:11:58 by jwe]
jwe
parents: 6267
diff changeset
112 return;
5dc550e1f419 [project @ 2007-03-26 18:11:58 by jwe]
jwe
parents: 6267
diff changeset
113 endif
6146
1a6d826e92b5 [project @ 2006-11-09 03:13:11 by jwe]
jwe
parents: 6046
diff changeset
114 endfor
1a6d826e92b5 [project @ 2006-11-09 03:13:11 by jwe]
jwe
parents: 6046
diff changeset
115 else
6046
34f96dd5441b [project @ 2006-10-10 16:10:25 by jwe]
jwe
parents: 5642
diff changeset
116 print_usage ();
933
598a3aa40360 [project @ 1994-11-17 04:23:41 by jwe]
jwe
parents:
diff changeset
117 endif
598a3aa40360 [project @ 1994-11-17 04:23:41 by jwe]
jwe
parents:
diff changeset
118
598a3aa40360 [project @ 1994-11-17 04:23:41 by jwe]
jwe
parents:
diff changeset
119 endfunction