annotate scripts/plot/__pltopt1__.m @ 6895:76e3d985ae56

[project @ 2007-09-13 18:22:38 by jwe]
author jwe
date Thu, 13 Sep 2007 18:22:51 +0000
parents 751f340d486c
children 93c65f2a5668
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
3162
7c96e85c76db [project @ 1998-04-08 18:19:35 by jwe]
jwe
parents:
diff changeset
1 ## Copyright (C) 1996, 1997 John W. Eaton
7c96e85c76db [project @ 1998-04-08 18:19:35 by jwe]
jwe
parents:
diff changeset
2 ##
7c96e85c76db [project @ 1998-04-08 18:19:35 by jwe]
jwe
parents:
diff changeset
3 ## This file is part of Octave.
7c96e85c76db [project @ 1998-04-08 18:19:35 by jwe]
jwe
parents:
diff changeset
4 ##
7c96e85c76db [project @ 1998-04-08 18:19:35 by jwe]
jwe
parents:
diff changeset
5 ## Octave is free software; you can redistribute it and/or modify it
7c96e85c76db [project @ 1998-04-08 18:19:35 by jwe]
jwe
parents:
diff changeset
6 ## under the terms of the GNU General Public License as published by
7c96e85c76db [project @ 1998-04-08 18:19:35 by jwe]
jwe
parents:
diff changeset
7 ## the Free Software Foundation; either version 2, or (at your option)
7c96e85c76db [project @ 1998-04-08 18:19:35 by jwe]
jwe
parents:
diff changeset
8 ## any later version.
7c96e85c76db [project @ 1998-04-08 18:19:35 by jwe]
jwe
parents:
diff changeset
9 ##
7c96e85c76db [project @ 1998-04-08 18:19:35 by jwe]
jwe
parents:
diff changeset
10 ## Octave is distributed in the hope that it will be useful, but
7c96e85c76db [project @ 1998-04-08 18:19:35 by jwe]
jwe
parents:
diff changeset
11 ## WITHOUT ANY WARRANTY; without even the implied warranty of
7c96e85c76db [project @ 1998-04-08 18:19:35 by jwe]
jwe
parents:
diff changeset
12 ## MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
7c96e85c76db [project @ 1998-04-08 18:19:35 by jwe]
jwe
parents:
diff changeset
13 ## General Public License for more details.
7c96e85c76db [project @ 1998-04-08 18:19:35 by jwe]
jwe
parents:
diff changeset
14 ##
7c96e85c76db [project @ 1998-04-08 18:19:35 by jwe]
jwe
parents:
diff changeset
15 ## You should have received a copy of the GNU General Public License
7c96e85c76db [project @ 1998-04-08 18:19:35 by jwe]
jwe
parents:
diff changeset
16 ## along with Octave; see the file COPYING. If not, write to the Free
5307
4c8a2e4e0717 [project @ 2005-04-26 19:24:27 by jwe]
jwe
parents: 5053
diff changeset
17 ## Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
4c8a2e4e0717 [project @ 2005-04-26 19:24:27 by jwe]
jwe
parents: 5053
diff changeset
18 ## 02110-1301, USA.
3162
7c96e85c76db [project @ 1998-04-08 18:19:35 by jwe]
jwe
parents:
diff changeset
19
6895
76e3d985ae56 [project @ 2007-09-13 18:22:38 by jwe]
jwe
parents: 6736
diff changeset
20 ## Undocumented internal function.
76e3d985ae56 [project @ 2007-09-13 18:22:38 by jwe]
jwe
parents: 6736
diff changeset
21
3162
7c96e85c76db [project @ 1998-04-08 18:19:35 by jwe]
jwe
parents:
diff changeset
22 ## Really decode plot option strings.
7c96e85c76db [project @ 1998-04-08 18:19:35 by jwe]
jwe
parents:
diff changeset
23
7c96e85c76db [project @ 1998-04-08 18:19:35 by jwe]
jwe
parents:
diff changeset
24 ## Author: Rick Niles <niles@axp745.gsfc.nasa.gov>
7c96e85c76db [project @ 1998-04-08 18:19:35 by jwe]
jwe
parents:
diff changeset
25 ## Adapted-By: jwe
7c96e85c76db [project @ 1998-04-08 18:19:35 by jwe]
jwe
parents:
diff changeset
26 ## Maintainer: jwe
7c96e85c76db [project @ 1998-04-08 18:19:35 by jwe]
jwe
parents:
diff changeset
27
6459
5dc550e1f419 [project @ 2007-03-26 18:11:58 by jwe]
jwe
parents: 6444
diff changeset
28 function [options, valid] = __pltopt1__ (caller, opt, err_on_invalid)
3162
7c96e85c76db [project @ 1998-04-08 18:19:35 by jwe]
jwe
parents:
diff changeset
29
6264
cc2bee854d23 [project @ 2007-02-01 10:00:05 by jwe]
jwe
parents: 6146
diff changeset
30 options = __default_plot_options__ ();
6459
5dc550e1f419 [project @ 2007-03-26 18:11:58 by jwe]
jwe
parents: 6444
diff changeset
31 valid = true;
4841
66fb9f8c66c8 [project @ 2004-03-12 23:02:54 by jwe]
jwe
parents: 4260
diff changeset
32
3162
7c96e85c76db [project @ 1998-04-08 18:19:35 by jwe]
jwe
parents:
diff changeset
33 more_opts = 1;
7c96e85c76db [project @ 1998-04-08 18:19:35 by jwe]
jwe
parents:
diff changeset
34
6459
5dc550e1f419 [project @ 2007-03-26 18:11:58 by jwe]
jwe
parents: 6444
diff changeset
35 if (nargin != 2 && nargin != 3)
6046
34f96dd5441b [project @ 2006-10-10 16:10:25 by jwe]
jwe
parents: 5642
diff changeset
36 print_usage ();
3162
7c96e85c76db [project @ 1998-04-08 18:19:35 by jwe]
jwe
parents:
diff changeset
37 endif
7c96e85c76db [project @ 1998-04-08 18:19:35 by jwe]
jwe
parents:
diff changeset
38
5443
ec8c33dcd1bf [project @ 2005-09-08 01:40:57 by jwe]
jwe
parents: 5405
diff changeset
39 if (! ischar (opt))
6146
1a6d826e92b5 [project @ 2006-11-09 03:13:11 by jwe]
jwe
parents: 6085
diff changeset
40 return;
3162
7c96e85c76db [project @ 1998-04-08 18:19:35 by jwe]
jwe
parents:
diff changeset
41 endif
7c96e85c76db [project @ 1998-04-08 18:19:35 by jwe]
jwe
parents:
diff changeset
42
6395
a8dd70bacc1e [project @ 2007-03-07 22:22:12 by jwe]
jwe
parents: 6264
diff changeset
43 have_linestyle = false;
a8dd70bacc1e [project @ 2007-03-07 22:22:12 by jwe]
jwe
parents: 6264
diff changeset
44 have_marker = false;
a8dd70bacc1e [project @ 2007-03-07 22:22:12 by jwe]
jwe
parents: 6264
diff changeset
45
6736
751f340d486c [project @ 2007-06-15 21:31:38 by jwe]
jwe
parents: 6704
diff changeset
46 ## If called by __errplot__, extract the linestyle before proceeding.
751f340d486c [project @ 2007-06-15 21:31:38 by jwe]
jwe
parents: 6704
diff changeset
47 if (strcmp (caller,"__errplot__"))
751f340d486c [project @ 2007-06-15 21:31:38 by jwe]
jwe
parents: 6704
diff changeset
48 if (strncmp (opt, "#~>", 3))
751f340d486c [project @ 2007-06-15 21:31:38 by jwe]
jwe
parents: 6704
diff changeset
49 n = 3;
751f340d486c [project @ 2007-06-15 21:31:38 by jwe]
jwe
parents: 6704
diff changeset
50 elseif (strncmp (opt, "#~", 2) || strncmp (opt, "~>", 2))
751f340d486c [project @ 2007-06-15 21:31:38 by jwe]
jwe
parents: 6704
diff changeset
51 n = 2;
751f340d486c [project @ 2007-06-15 21:31:38 by jwe]
jwe
parents: 6704
diff changeset
52 elseif (strncmp (opt, "~", 1) || strncmp (opt, ">", 1)
751f340d486c [project @ 2007-06-15 21:31:38 by jwe]
jwe
parents: 6704
diff changeset
53 || strncmp (opt, "#", 1))
751f340d486c [project @ 2007-06-15 21:31:38 by jwe]
jwe
parents: 6704
diff changeset
54 n = 1;
751f340d486c [project @ 2007-06-15 21:31:38 by jwe]
jwe
parents: 6704
diff changeset
55 endif
751f340d486c [project @ 2007-06-15 21:31:38 by jwe]
jwe
parents: 6704
diff changeset
56 options.linestyle = opt(1:n);
751f340d486c [project @ 2007-06-15 21:31:38 by jwe]
jwe
parents: 6704
diff changeset
57 opt(1:n) = [];
751f340d486c [project @ 2007-06-15 21:31:38 by jwe]
jwe
parents: 6704
diff changeset
58 have_linestyle = true;
751f340d486c [project @ 2007-06-15 21:31:38 by jwe]
jwe
parents: 6704
diff changeset
59 endif
751f340d486c [project @ 2007-06-15 21:31:38 by jwe]
jwe
parents: 6704
diff changeset
60
6264
cc2bee854d23 [project @ 2007-02-01 10:00:05 by jwe]
jwe
parents: 6146
diff changeset
61 while (! isempty (opt))
cc2bee854d23 [project @ 2007-02-01 10:00:05 by jwe]
jwe
parents: 6146
diff changeset
62 if (strncmp (opt, "--", 2) || strncmp (opt, "-.", 2))
cc2bee854d23 [project @ 2007-02-01 10:00:05 by jwe]
jwe
parents: 6146
diff changeset
63 options.linestyle = opt(1:2);
6704
781777998927 [project @ 2007-06-13 05:23:56 by jwe]
jwe
parents: 6459
diff changeset
64 have_linestyle = true;
6264
cc2bee854d23 [project @ 2007-02-01 10:00:05 by jwe]
jwe
parents: 6146
diff changeset
65 n = 2;
3162
7c96e85c76db [project @ 1998-04-08 18:19:35 by jwe]
jwe
parents:
diff changeset
66 else
6264
cc2bee854d23 [project @ 2007-02-01 10:00:05 by jwe]
jwe
parents: 6146
diff changeset
67 topt = opt(1);
cc2bee854d23 [project @ 2007-02-01 10:00:05 by jwe]
jwe
parents: 6146
diff changeset
68 n = 1;
cc2bee854d23 [project @ 2007-02-01 10:00:05 by jwe]
jwe
parents: 6146
diff changeset
69 if (topt == "-" || topt == ":")
6395
a8dd70bacc1e [project @ 2007-03-07 22:22:12 by jwe]
jwe
parents: 6264
diff changeset
70 have_linestyle = true;
6264
cc2bee854d23 [project @ 2007-02-01 10:00:05 by jwe]
jwe
parents: 6146
diff changeset
71 options.linestyle = topt;
cc2bee854d23 [project @ 2007-02-01 10:00:05 by jwe]
jwe
parents: 6146
diff changeset
72 elseif (topt == "+" || topt == "o" || topt == "*"
cc2bee854d23 [project @ 2007-02-01 10:00:05 by jwe]
jwe
parents: 6146
diff changeset
73 || topt == "." || topt == "x" || topt == "s"
cc2bee854d23 [project @ 2007-02-01 10:00:05 by jwe]
jwe
parents: 6146
diff changeset
74 || topt == "d" || topt == "^" || topt == "v"
cc2bee854d23 [project @ 2007-02-01 10:00:05 by jwe]
jwe
parents: 6146
diff changeset
75 || topt == ">" || topt == "<" || topt == "p"
6442
1896d9b1f302 [project @ 2007-03-23 16:10:33 by jwe]
jwe
parents: 6395
diff changeset
76 || topt == "h" || topt == "@")
6395
a8dd70bacc1e [project @ 2007-03-07 22:22:12 by jwe]
jwe
parents: 6264
diff changeset
77 have_marker = true;
6442
1896d9b1f302 [project @ 2007-03-23 16:10:33 by jwe]
jwe
parents: 6395
diff changeset
78 ## Backward compatibility. Leave undocumented.
1896d9b1f302 [project @ 2007-03-23 16:10:33 by jwe]
jwe
parents: 6395
diff changeset
79 if (topt == "@")
1896d9b1f302 [project @ 2007-03-23 16:10:33 by jwe]
jwe
parents: 6395
diff changeset
80 topt = "+";
1896d9b1f302 [project @ 2007-03-23 16:10:33 by jwe]
jwe
parents: 6395
diff changeset
81 endif
6264
cc2bee854d23 [project @ 2007-02-01 10:00:05 by jwe]
jwe
parents: 6146
diff changeset
82 options.marker = topt;
6444
af8e28709a2c [project @ 2007-03-23 16:42:50 by jwe]
jwe
parents: 6442
diff changeset
83 ### Numeric color specs for backward compatibility. Leave undocumented.
af8e28709a2c [project @ 2007-03-23 16:42:50 by jwe]
jwe
parents: 6442
diff changeset
84 elseif (topt == "k" || topt == "0")
6264
cc2bee854d23 [project @ 2007-02-01 10:00:05 by jwe]
jwe
parents: 6146
diff changeset
85 options.color = [0, 0, 0];
6444
af8e28709a2c [project @ 2007-03-23 16:42:50 by jwe]
jwe
parents: 6442
diff changeset
86 elseif (topt == "r" || topt == "1")
6264
cc2bee854d23 [project @ 2007-02-01 10:00:05 by jwe]
jwe
parents: 6146
diff changeset
87 options.color = [1, 0, 0];
6444
af8e28709a2c [project @ 2007-03-23 16:42:50 by jwe]
jwe
parents: 6442
diff changeset
88 elseif (topt == "g" || topt == "2")
6264
cc2bee854d23 [project @ 2007-02-01 10:00:05 by jwe]
jwe
parents: 6146
diff changeset
89 options.color = [0, 1, 0];
6444
af8e28709a2c [project @ 2007-03-23 16:42:50 by jwe]
jwe
parents: 6442
diff changeset
90 elseif (topt == "b" || topt == "3")
6264
cc2bee854d23 [project @ 2007-02-01 10:00:05 by jwe]
jwe
parents: 6146
diff changeset
91 options.color = [0, 0, 1];
cc2bee854d23 [project @ 2007-02-01 10:00:05 by jwe]
jwe
parents: 6146
diff changeset
92 elseif (topt == "y")
cc2bee854d23 [project @ 2007-02-01 10:00:05 by jwe]
jwe
parents: 6146
diff changeset
93 options.color = [1, 1, 0];
6444
af8e28709a2c [project @ 2007-03-23 16:42:50 by jwe]
jwe
parents: 6442
diff changeset
94 elseif (topt == "m" || topt == "4")
6264
cc2bee854d23 [project @ 2007-02-01 10:00:05 by jwe]
jwe
parents: 6146
diff changeset
95 options.color = [1, 0, 1];
6444
af8e28709a2c [project @ 2007-03-23 16:42:50 by jwe]
jwe
parents: 6442
diff changeset
96 elseif (topt == "c" || topt == "5")
6264
cc2bee854d23 [project @ 2007-02-01 10:00:05 by jwe]
jwe
parents: 6146
diff changeset
97 options.color = [0, 1, 1];
6444
af8e28709a2c [project @ 2007-03-23 16:42:50 by jwe]
jwe
parents: 6442
diff changeset
98 elseif (topt == "w" || topt == "6")
6264
cc2bee854d23 [project @ 2007-02-01 10:00:05 by jwe]
jwe
parents: 6146
diff changeset
99 options.color = [1, 1, 1];
cc2bee854d23 [project @ 2007-02-01 10:00:05 by jwe]
jwe
parents: 6146
diff changeset
100 elseif (isspace (topt))
cc2bee854d23 [project @ 2007-02-01 10:00:05 by jwe]
jwe
parents: 6146
diff changeset
101 ## Do nothing.
cc2bee854d23 [project @ 2007-02-01 10:00:05 by jwe]
jwe
parents: 6146
diff changeset
102 elseif (topt == ";")
cc2bee854d23 [project @ 2007-02-01 10:00:05 by jwe]
jwe
parents: 6146
diff changeset
103 t = index (opt(2:end), ";");
cc2bee854d23 [project @ 2007-02-01 10:00:05 by jwe]
jwe
parents: 6146
diff changeset
104 if (t)
cc2bee854d23 [project @ 2007-02-01 10:00:05 by jwe]
jwe
parents: 6146
diff changeset
105 options.key = undo_string_escapes (opt(2:t));
cc2bee854d23 [project @ 2007-02-01 10:00:05 by jwe]
jwe
parents: 6146
diff changeset
106 n = t+1;
cc2bee854d23 [project @ 2007-02-01 10:00:05 by jwe]
jwe
parents: 6146
diff changeset
107 else
6459
5dc550e1f419 [project @ 2007-03-26 18:11:58 by jwe]
jwe
parents: 6444
diff changeset
108 if (err_on_invalid)
5dc550e1f419 [project @ 2007-03-26 18:11:58 by jwe]
jwe
parents: 6444
diff changeset
109 error ("%s: unfinished key label", caller);
5dc550e1f419 [project @ 2007-03-26 18:11:58 by jwe]
jwe
parents: 6444
diff changeset
110 else
5dc550e1f419 [project @ 2007-03-26 18:11:58 by jwe]
jwe
parents: 6444
diff changeset
111 valid = false;
5dc550e1f419 [project @ 2007-03-26 18:11:58 by jwe]
jwe
parents: 6444
diff changeset
112 options = __default_plot_options__ ();
5dc550e1f419 [project @ 2007-03-26 18:11:58 by jwe]
jwe
parents: 6444
diff changeset
113 return;
5dc550e1f419 [project @ 2007-03-26 18:11:58 by jwe]
jwe
parents: 6444
diff changeset
114 endif
6264
cc2bee854d23 [project @ 2007-02-01 10:00:05 by jwe]
jwe
parents: 6146
diff changeset
115 endif
3617
b0d6c6e84d56 [project @ 2000-03-21 10:51:38 by jwe]
jwe
parents: 3500
diff changeset
116 else
6459
5dc550e1f419 [project @ 2007-03-26 18:11:58 by jwe]
jwe
parents: 6444
diff changeset
117 if (err_on_invalid)
5dc550e1f419 [project @ 2007-03-26 18:11:58 by jwe]
jwe
parents: 6444
diff changeset
118 error ("%s: unrecognized format character: `%s'", caller, topt);
5dc550e1f419 [project @ 2007-03-26 18:11:58 by jwe]
jwe
parents: 6444
diff changeset
119 else
5dc550e1f419 [project @ 2007-03-26 18:11:58 by jwe]
jwe
parents: 6444
diff changeset
120 valid = false;
5dc550e1f419 [project @ 2007-03-26 18:11:58 by jwe]
jwe
parents: 6444
diff changeset
121 options = __default_plot_options__ ();
5dc550e1f419 [project @ 2007-03-26 18:11:58 by jwe]
jwe
parents: 6444
diff changeset
122 return;
5dc550e1f419 [project @ 2007-03-26 18:11:58 by jwe]
jwe
parents: 6444
diff changeset
123 endif
3162
7c96e85c76db [project @ 1998-04-08 18:19:35 by jwe]
jwe
parents:
diff changeset
124 endif
7c96e85c76db [project @ 1998-04-08 18:19:35 by jwe]
jwe
parents:
diff changeset
125 endif
6264
cc2bee854d23 [project @ 2007-02-01 10:00:05 by jwe]
jwe
parents: 6146
diff changeset
126 opt(1:n) = [];
3162
7c96e85c76db [project @ 1998-04-08 18:19:35 by jwe]
jwe
parents:
diff changeset
127 endwhile
7c96e85c76db [project @ 1998-04-08 18:19:35 by jwe]
jwe
parents:
diff changeset
128
6395
a8dd70bacc1e [project @ 2007-03-07 22:22:12 by jwe]
jwe
parents: 6264
diff changeset
129 if (have_marker && ! have_linestyle)
6704
781777998927 [project @ 2007-06-13 05:23:56 by jwe]
jwe
parents: 6459
diff changeset
130 options.linestyle = "none";
6395
a8dd70bacc1e [project @ 2007-03-07 22:22:12 by jwe]
jwe
parents: 6264
diff changeset
131 endif
a8dd70bacc1e [project @ 2007-03-07 22:22:12 by jwe]
jwe
parents: 6264
diff changeset
132
3162
7c96e85c76db [project @ 1998-04-08 18:19:35 by jwe]
jwe
parents:
diff changeset
133 endfunction