annotate doc/interpreter/genpropdoc.m @ 20600:1d6ab08edcde stable

Add Ethan Biery to list of contributors
author Philip Nienhuis <prnienhuis@users.sf.net>
date Thu, 01 Oct 2015 22:38:34 +0200
parents ab4090316e6d
children a9a1f021d96b
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
19731
4197fc428c7d maint: Update copyright notices for 2015.
John W. Eaton <jwe@octave.org>
parents: 19631
diff changeset
1 ## Copyright (C) 2014-2015 Pantxo Diribarne
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
2 ##
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
3 ## This program is free software; you can redistribute it and/or modify it
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
4 ## under the terms of the GNU General Public License as published by
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
5 ## the Free Software Foundation; either version 3 of the License, or
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
6 ## (at your option) any later version.
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
7 ##
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
8 ## This program is distributed in the hope that it will be useful,
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
9 ## but WITHOUT ANY WARRANTY; without even the implied warranty of
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
10 ## MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
11 ## GNU General Public License for more details.
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
12 ##
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
13 ## You should have received a copy of the GNU General Public License
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
14 ## along with this program. If not, see
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
15 ## <http://www.gnu.org/licenses/>.
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
16
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
17 ## -*- texinfo -*-
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
18 ## @deftypefn {Function File} {@var{retval} =} genpropdoc (@var{OBJNAME}, @var{FILENAME})
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
19 ##
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
20 ## Print FILENAME texinfo source file associated to OBJNAME objects. This
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
21 ## function is meant to be run for generating octave documentation
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
22 ## (see doc/interpreter/graphics_properties.mk).
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
23 ##
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
24 ## All the hard coded documentation is written in getdoc function. See the
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
25 ## comments in getdoc bellow for instruction on how to document a graphics
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
26 ## property.
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
27 ##
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
28 ## @seealso{}
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
29 ## @end deftypefn
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
30
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
31 function genpropdoc (objname, fname)
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
32 objnames = {"root", "figure", "axes", "line", ...
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
33 "text", "image", "patch", "surface"};
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
34
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
35 ## Base properties
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
36 base = getstructure ("base");
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
37
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
38 ## Object properties
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
39 if (any (strcmp (objname, objnames)))
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
40 obj = getstructure (objname, base);
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
41 else
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
42 error ("genpropdoc: unknown object %s", objname);
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
43 endif
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
44
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
45 ## Docstring
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
46 str = printdoc (objname, obj);
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
47
19826
4f6ae6b94abe make --enable-silent-rules configure option more useful
John W. Eaton <jwe@octave.org>
parents: 19810
diff changeset
48 if (nargin == 2)
4f6ae6b94abe make --enable-silent-rules configure option more useful
John W. Eaton <jwe@octave.org>
parents: 19810
diff changeset
49 fid = fopen (fname, "w+");
4f6ae6b94abe make --enable-silent-rules configure option more useful
John W. Eaton <jwe@octave.org>
parents: 19810
diff changeset
50 if (fid < 0)
4f6ae6b94abe make --enable-silent-rules configure option more useful
John W. Eaton <jwe@octave.org>
parents: 19810
diff changeset
51 error ("genpropdoc: couldn't open %s.", fname);
4f6ae6b94abe make --enable-silent-rules configure option more useful
John W. Eaton <jwe@octave.org>
parents: 19810
diff changeset
52 endif
4f6ae6b94abe make --enable-silent-rules configure option more useful
John W. Eaton <jwe@octave.org>
parents: 19810
diff changeset
53 else
4f6ae6b94abe make --enable-silent-rules configure option more useful
John W. Eaton <jwe@octave.org>
parents: 19810
diff changeset
54 fid = stdout;
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
55 endif
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
56
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
57 fprintf (fid, str);
19826
4f6ae6b94abe make --enable-silent-rules configure option more useful
John W. Eaton <jwe@octave.org>
parents: 19810
diff changeset
58
4f6ae6b94abe make --enable-silent-rules configure option more useful
John W. Eaton <jwe@octave.org>
parents: 19810
diff changeset
59 if (nargin == 2)
4f6ae6b94abe make --enable-silent-rules configure option more useful
John W. Eaton <jwe@octave.org>
parents: 19810
diff changeset
60 fclose (fid);
4f6ae6b94abe make --enable-silent-rules configure option more useful
John W. Eaton <jwe@octave.org>
parents: 19810
diff changeset
61 endif
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
62
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
63 endfunction
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
64
19441
86e69f51328d genpropdoc.m: Use two spaces after period at start of sentence.
Rik <rik@octave.org>
parents: 19357
diff changeset
65 function s = getdoc (objname, field, base)
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
66 ## Properties are represented by a struct with fields :
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
67 ##
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
68 ## -"doc": string to be printed verbatim after being expanded
19441
86e69f51328d genpropdoc.m: Use two spaces after period at start of sentence.
Rik <rik@octave.org>
parents: 19357
diff changeset
69 ## through expand_doc function. Special keywords are:
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
70 ## "__objname__" : replaced by the current object name;
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
71 ## "__prop__" : replaced by the current property name;
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
72 ## "__modemsg__" : replaced by a message explaining that
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
73 ## the propmode will be toggled to "manual".
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
74 ## You may also cross reference properties using the label format
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
75 ## OBJNAMEPROPERTY, e.g, "@xref{XREFaxescolor, , axes color property}."
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
76 ##
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
77 ## -"valid": string that describes valid values for the current property.
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
78 ## Use "packopt" function to join options with " | " separator
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
79 ## and "markdef" to mark default among valid values between curly braces.
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
80 ## If not provided, valid values for radio properties are automatically
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
81 ## retrieved using set function.
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
82 ##
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
83 ## -"default": string. If not provided the default value is automatically
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
84 ## retrieved using get function.
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
85 ##
19441
86e69f51328d genpropdoc.m: Use two spaces after period at start of sentence.
Rik <rik@octave.org>
parents: 19357
diff changeset
86 ## -"printdefault": a boolean (def. true) that specifies whether the
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
87 ## default value should be printed. It is useful for properties
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
88 ## like root "screendepth" that default to screen dependant values.
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
89
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
90 packopt = @(c) strjoin (c, " | ");
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
91 markdef = @(s) ["@{" s "@}"];
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
92
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
93 ## Some generic templates:
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
94 valid_color = "colorspec";
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
95 valid_handle = "graphics handle";
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
96 valid_string = "string";
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
97 valid_fcn = packopt ({"string", "function handle"});
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
98 valid_cellstring = packopt ({"string", "cell array of strings"});
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
99 valid_2elvec = "two-element vector";
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
100 valid_3elvec = "three-element vector";
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
101 valid_4elvec = "four-element vector";
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
102 valid_vecmat = packopt ({"vector", "matrix"});
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
103 valid_scalmat = packopt ({"scalar", "matrix"});
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
104
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
105 doc_notimpl = "%s is not yet implemented for __objname__ objects. \
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
106 __prop__ is unused.";
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
107 doc_unused = "__prop__ is unused.";
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
108
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
109 ## Initialize structure
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
110 if (isfield (base, field))
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
111 s = base.(field);
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
112 else
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
113 s = struct ("valid", "", "default", "", "doc", "", "printdefault", true);
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
114 endif
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
115
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
116 ## Base properties: Write generic documentation because it will be included
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
117 ## in the list of each graphics object. If a given graphics object
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
118 ## interprets the property differently than others, then the doc will have
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
119 ## to be rewritten for this object.
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
120 if (strcmp (objname, "base"))
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
121 switch (field)
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
122 case "beingdeleted"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
123 case "busyaction"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
124 case "buttondownfcn"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
125 s.valid = valid_fcn;
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
126 case "children"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
127 s.doc = "Graphics handles of the __objname__'s children.";
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
128 s.valid = "vector of graphics handles";
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
129
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
130 case "clipping"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
131 s.doc = "If __prop__ is @qcode{\"on\"}, the __objname__ is \
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
132 clipped in its parent axes limits.";
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
133
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
134 case "createfcn"
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
135 s.doc = "Callback function executed immediately after __objname__ \
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
136 has been created. Function is set by using default property on root object, \
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
137 e.g., @code{set (0, \"default__objname__createfcn\", \
20136
e51473fdb622 doc: Periodic grammarcheck of documentation.
Rik <rik@octave.org>
parents: 20112
diff changeset
138 'disp (\"__objname__ created!\")')}.";
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
139 s.valid = valid_fcn;
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
140
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
141 case "deletefcn"
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
142 s.doc = "Callback function executed immediately before __objname__ \
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
143 is deleted.";
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
144 s.valid = valid_fcn;
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
145
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
146 case "handlevisibility"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
147 s.doc = "If __prop__ is @qcode{\"off\"}, the __objname__'s \
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
148 handle is not visible in its parent's \"children\" property.";
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
149
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
150 case "hittest"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
151 case "interruptible"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
152 case "parent"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
153 s.doc = "Handle of the parent graphics object.";
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
154 s.valid = valid_handle;
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
155
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
156 case "selected"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
157 case "selectionhighlight"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
158 case "tag"
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
159 s.doc = "A user-defined string to label the graphics object.";
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
160 s.valid = valid_string;
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
161
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
162 case "type"
19441
86e69f51328d genpropdoc.m: Use two spaces after period at start of sentence.
Rik <rik@octave.org>
parents: 19357
diff changeset
163 s.doc = "Class name of the graphics object. __prop__ is \
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
164 always @qcode{\"__objname__\"}";
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
165 s.valid = valid_string;
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
166 s.printdefault = false;
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
167
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
168 case "uicontextmenu"
20112
69f92e0affd2 Handle uicontextmenu deletion/reset (bug #44801)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents: 19868
diff changeset
169 s.doc = "Graphics handle of the uicontextmenu object that is \
69f92e0affd2 Handle uicontextmenu deletion/reset (bug #44801)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents: 19868
diff changeset
170 currently associated to this __objname__ object.";
69f92e0affd2 Handle uicontextmenu deletion/reset (bug #44801)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents: 19868
diff changeset
171 s.valid = valid_handle;
69f92e0affd2 Handle uicontextmenu deletion/reset (bug #44801)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents: 19868
diff changeset
172
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
173 case "userdata"
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
174 s.doc = "User-defined data to associate with the graphics object.";
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
175 s.valid = "Any Octave data";
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
176
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
177 case "visible"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
178 s.doc = "If __prop__ is @qcode{\"off\"}, the __objname__ is \
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
179 not rendered on screen.";
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
180 endswitch
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
181
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
182 ## Root properties:
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
183 elseif (strcmp (objname, "root"))
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
184 switch (field)
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
185 ## Overridden shared properties
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
186 case {"beingdeleted", "busyaction", "buttondownfcn", ...
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
187 "clipping", "createfcn", "deletefcn", "handlevisibility", ...
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
188 "hittest", "interruptible", "selected", ...
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
189 "selectionhighlight", "uicontextmenu", "visible"}
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
190 s.doc = doc_unused;
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
191
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
192 case "parent"
19441
86e69f51328d genpropdoc.m: Use two spaces after period at start of sentence.
Rik <rik@octave.org>
parents: 19357
diff changeset
193 s.doc = "Root figure has no parent graphics object. __prop__ \
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
194 is always empty.";
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
195
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
196 ## Specific properties
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
197 case "callbackobject"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
198 s.valid = valid_handle;
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
199
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
200 case "commandwindowsize"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
201 case "currentfigure"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
202 s.doc = "Graphics handle of the current figure.";
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
203 s.valid = valid_handle;
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
204
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
205 case "diary"
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
206 s.doc = "If __prop__ is @qcode{\"on\"}, the Octave command window \
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
207 session is saved to file. @xref{XREFrootdiaryfile, , @w{diaryfile property}}.";
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
208
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
209 case "diaryfile"
19441
86e69f51328d genpropdoc.m: Use two spaces after period at start of sentence.
Rik <rik@octave.org>
parents: 19357
diff changeset
210 s.doc = "The name of the diary file. \
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
211 @xref{XREFdiary, , @w{diary function}}.";
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
212 s.valid = valid_string;
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
213
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
214 case "echo"
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
215 s.doc = "Control whether Octave displays commands executed from \
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
216 scripts. @xref{XREFecho, , @w{echo function}}.";
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
217
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
218 case "errormessage"
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
219 s.doc = "The last error message raised. \
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
220 @xref{XREFlasterr, , @w{lasterr function}}.";
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
221 s.valid = valid_string;
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
222
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
223 case "fixedwidthfontname"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
224 s.valid = valid_string;
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
225
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
226 case "format"
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
227 s.doc = "This property is a wrapper around the @code{format} function.\
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
228 @xref{XREFformat, , @w{format function}}.";
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
229
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
230 case "formatspacing"
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
231 s.doc = "This property is a wrapper around the @code{format} function.\
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
232 @xref{XREFformat, , @w{format function}}.";
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
233
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
234 case "language"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
235 s.valid = valid_string;
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
236
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
237 case "monitorpositions"
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
238 s.doc = doc_unused;
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
239 s.printdefault = false;
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
240
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
241 case "pointerlocation"
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
242 s.doc = doc_unused;
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
243 s.valid = valid_2elvec;
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
244
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
245 case "pointerwindow"
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
246 s.doc = doc_unused;
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
247 s.valid = valid_handle;
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
248
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
249 case "recursionlimit"
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
250 s.doc = "The maximum number of times a function can be called \
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
251 recursively. \
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
252 @xref{XREFmax_recursion_depth, , @w{max_recursion_depth function}}.";
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
253 s.valid = "double";
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
254
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
255 case "screendepth"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
256 s.valid = "double";
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
257 s.printdefault = false;
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
258
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
259 case "screenpixelsperinch"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
260 s.valid = "double";
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
261 s.printdefault = false;
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
262
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
263 case "screensize"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
264 s.valid = valid_4elvec;
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
265 s.printdefault = false;
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
266
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
267 case "showhiddenhandles"
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
268 s.doc = "If __prop__ is @qcode{\"on\"}, all graphics objects handles \
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
269 are visible in their parents' children list, regardless of the value of their \
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
270 @code{handlevisibility} property.";
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
271
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
272 case "units"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
273 endswitch
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
274
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
275 ## Figure properties
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
276 elseif (strcmp (objname, "figure"))
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
277 switch (field)
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
278 ## Overridden shared properties
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
279 case "clipping"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
280 s.doc = doc_unused;
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
281
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
282 ## Specific properties
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
283 case "alphamap"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
284 s.doc = sprintf (doc_notimpl, "Transparency");
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
285 case "closerequestfcn"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
286 s.valid = valid_fcn;
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
287
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
288 case "color"
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
289 s.doc = "Color of the figure background. \
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
290 @xref{Colors, , colorspec}.";
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
291 s.valid = valid_color;
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
292
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
293 case "colormap"
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
294 s.doc = "A matrix containing the RGB color map for the current axes.";
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
295 s.valid = "N-by-3 matrix";
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
296
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
297 case "currentaxes"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
298 s.doc = "Handle to the graphics object of the current axes.";
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
299 s.valid = valid_handle;
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
300
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
301 case "currentcharacter"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
302 s.doc = doc_unused;
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
303
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
304 case "currentobject"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
305 s.valid = valid_handle;
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
306
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
307 case "currentpoint"
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
308 s.doc = "A 1-by-2 matrix which holds the coordinates of the point \
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
309 over which the mouse pointer was when a mouse event occurred. The X and Y \
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
310 coordinates are in units defined by the figure's @code{units} property \
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
311 and their origin is the lower left corner of the plotting area.\n\
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
312 \n\
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
313 Events which set @code{currentpoint} are\n\
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
314 @table @asis\n\
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
315 @item A mouse button was pressed\n\
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
316 always\n\
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
317 @item A mouse button was released\n\
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
318 only if the figure's callback @code{windowbuttonupfcn} is defined\n\
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
319 @item The pointer was moved while pressing the mouse button (drag)\n\
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
320 only if the figure's callback @code{windowbuttonmotionfcn} is defined\n\
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
321 @end table";
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
322 s.valid = valid_2elvec;
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
323
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
324 case "dockcontrols"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
325 s.doc = doc_unused;
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
326
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
327 case "doublebuffer"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
328 case "filename"
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
329 s.doc = "The filename used when saving the plot figure";
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
330 s.valid = valid_string;
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
331
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
332 case "integerhandle"
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
333 s.doc = "Assign the next lowest unused integer as the Figure number.";
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
334
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
335 case "inverthardcopy"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
336 case "keypressfcn"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
337 s.valid = valid_fcn;
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
338
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
339 case "keyreleasefcn"
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
340 s.doc = "With @code{keypressfcn}, the keyboard callback functions. \
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
341 These callback functions are called when a key is pressed/released \
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
342 respectively. The functions are called with two input arguments. The first \
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
343 argument holds the handle of the calling figure. The second argument holds \
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
344 an event structure which has the following members:\n\
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
345 @table @code\n\
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
346 @item Character:\n\
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
347 The ASCII value of the key\n\
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
348 @item Key:\n\
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
349 Lowercase value of the key\n\
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
350 @item Modifier:\n\
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
351 A cell array containing strings representing the modifiers pressed with the \
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
352 key.\n\
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
353 @end table";
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
354 s.valid = valid_fcn;
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
355
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
356 case "menubar"
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
357 s.doc = "Control the display of the figure menu bar in the upper \
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
358 left of the figure.";
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
359
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
360 case "name"
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
361 s.doc = "Name to be displayed in the figure title bar. The name is \
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
362 displayed to the right of any title determined by the @code{numbertitle} \
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
363 property.";
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
364 s.valid = valid_string;
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
365
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
366 case "nextplot"
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
367
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
368 case "numbertitle"
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
369 s.doc = "Display \"Figure\" followed by the numerical figure handle \
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
370 value in the figure title bar.";
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
371
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
372 case "outerposition"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
373 s.valid = valid_4elvec;
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
374
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
375 case "paperorientation"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
376 case "paperposition"
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
377 s.doc = "Vector @code{[x0 y0 width height]} defining the position of \
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
378 the figure (in @code{paperunits} units) on the printed page.\
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
379 __modemsg__.";
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
380 s.valid = valid_4elvec;
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
381
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
382 case "paperpositionmode"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
383 s.doc = "If __prop__ is set to @qcode{\"auto\"}, the \
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
384 @code{paperposition} property is automatically computed: the printed \
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
385 figure will have the same size as the on-screen figure and will be centered \
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
386 on the output page.";
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
387
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
388 case "papersize"
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
389 s.doc = "Vector @code{[width height]} defining the size of the \
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
390 paper for printing. Setting this property forces the @code{papertype} \
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
391 property to be set to @qcode{\"<custom>\"}.";
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
392 s.valid = valid_2elvec;
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
393
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
394 case "papertype"
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
395 s.doc = "Name of the paper used for printed output. \
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
396 Setting __prop__ also changes @code{papersize} accordingly.";
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
397
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
398 case "paperunits"
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
399 s.doc = "The unit used to compute the @code{paperposition} property.";
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
400
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
401 case "pointer"
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
402 s.doc = doc_unused;
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
403 case "pointershapecdata"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
404 s.doc = doc_unused;
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
405 case "pointershapehotspot"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
406 s.doc = doc_unused;
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
407
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
408 case "position"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
409 s.valid = valid_4elvec;
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
410
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
411 case "renderer"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
412 case "renderermode"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
413 case "resize"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
414 case "resizefcn"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
415 s.valid = valid_fcn;
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
416
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
417 case "selectiontype"
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
418 s.doc = doc_unused;
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
419
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
420 case "toolbar"
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
421 s.doc = doc_unused;
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
422
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
423 case "units"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
424 s.doc = "The unit used to compute the @code{position} and \
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
425 @code{outerposition} properties.";
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
426
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
427 case "windowbuttondownfcn"
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
428 s.doc = "@xref{XREFfigurewindowbuttonupfcn, , \
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
429 @w{windowbuttonupfcn property}}.";
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
430 s.valid = valid_fcn;
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
431
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
432 case "windowbuttonmotionfcn"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
433 s.doc = "@xref{XREFfigurewindowbuttonupfcn, , \
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
434 @w{windowbuttonupfcn property}}.";
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
435 s.valid = valid_fcn;
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
436
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
437 case "windowbuttonupfcn"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
438 s.doc = "With @code{windowbuttondownfcn} and \
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
439 @code{windowbuttonmotionfcn}, the mouse callback functions. These \
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
440 callback functions are called when a mouse button is pressed, dragged, or \
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
441 released respectively. When these callback functions are executed, the \
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
442 @code{currentpoint} property holds the current coordinates of the cursor.";
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
443 s.valid = valid_fcn;
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
444
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
445 case "windowkeypressfcn"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
446 s.valid = valid_fcn;
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
447
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
448 case "windowkeyreleasefcn"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
449 s.valid = valid_fcn;
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
450
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
451 case "windowscrollwheelfcn"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
452 s.valid = valid_fcn;
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
453
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
454 case "windowstyle"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
455 case "wvisual"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
456 case "wvisualmode"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
457 case "xdisplay"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
458 case "xvisual"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
459 case "xvisualmode"
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
460
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
461 endswitch
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
462
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
463 ## Axes properties
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
464 elseif (strcmp (objname, "axes"))
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
465 switch (field)
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
466 ## Overridden shared properties
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
467 case "clipping"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
468 s.doc = doc_unused;
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
469
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
470 ## Specific properties
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
471 case "activepositionproperty"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
472 case "alim"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
473 s.doc = sprintf (doc_notimpl, "Transparency");
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
474 case "alimmode"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
475 case "ambientlightcolor"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
476 s.doc = sprintf (doc_notimpl, "Light");
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
477 case "box"
19780
97690ea6f57a Add documentation for axes property "mouse_wheel_zoom".
Rik <rik@octave.org>
parents: 19731
diff changeset
478 s.doc = "Control whether the axes has a surrounding box.";
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
479
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
480 case "cameraposition"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
481 s.valid = valid_3elvec;
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
482
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
483 case "camerapositionmode"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
484 case "cameratarget"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
485 s.valid = valid_3elvec;
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
486
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
487 case "cameratargetmode"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
488 case "cameraupvector"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
489 s.valid = valid_3elvec;
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
490
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
491 case "cameraupvectormode"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
492 case "cameraviewangle"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
493 s.valid = "scalar";
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
494
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
495 case "cameraviewanglemode"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
496 case "clim"
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
497 s.doc = "Define the limits for the color axis of image children. \
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
498 __modemsg__. @xref{XREFpcolor, , @w{pcolor function}}.";
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
499 s.valid = valid_2elvec;
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
500
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
501 case "climmode"
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
502
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
503 case "color"
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
504 s.doc = "Color of the axes background. @xref{Colors, , colorspec}.";
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
505 s.valid = valid_color;
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
506
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
507 case "colororder"
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
508 s.doc = "RGB values used by plot function for automatic line \
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
509 coloring.";
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
510 s.valid = "N-by-3 RGB matrix";
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
511
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
512 case "currentpoint"
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
513 s.doc = "Matrix @code{[xf, yf, zf; xb, yb, zb]} which holds the \
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
514 coordinates (in axes data units) of the point over which the mouse pointer \
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
515 was when the mouse button was pressed. If a mouse callback function is \
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
516 defined, @code{currentpoint} holds the pointer coordinates at the time \
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
517 the mouse button was pressed. For 3-D plots, the first row of the returned \
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
518 matrix specifies the point nearest to the current camera position and the \
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
519 second row the furthest point. The two points forms a line which is \
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
520 perpendicular to the screen.";
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
521 s.valid = "2-by-3 matrix";
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
522
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
523 case "dataaspectratio"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
524 s.doc = "Specify the relative height and width of the data \
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
525 displayed in the axes. Setting @code{dataaspectratio} to \
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
526 @w{@code{[1, 2]}} causes the length of one unit as displayed on the x-axis \
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
527 to be the same as the length of 2 units on the y-axis. __modemsg__.";
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
528 s.valid = valid_3elvec;
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
529
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
530 case "dataaspectratiomode"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
531 case "drawmode"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
532 case "fontangle"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
533 case "fontname"
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
534 s.doc = "Name of the font used for axes annotations.";
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
535 s.valid = valid_string;
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
536
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
537 case "fontsize"
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
538 s.doc = "Size of the font used for axes annotations. \
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
539 @xref{XREFaxesfontunits, , @w{fontunits property}}.";
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
540 s.valid = "scalar";
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
541
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
542 case "fontunits"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
543 s.doc = "Unit used to interpret @code{fontsize} property.";
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
544
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
545 case "fontweight"
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
546
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
547 case "gridlinestyle"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
548 case "interpreter"
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
549
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
550 case "layer"
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
551 s.doc = "Control whether the axes is drawn below child graphics \
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
552 objects (ticks, labels, etc. covered by plotted objects) or above.";
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
553
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
554 case "linestyleorder"
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
555
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
556 case "linewidth"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
557 case "minorgridlinestyle"
19810
4cecd33915ef genpropdoc.m: Update axes property name to "mousewheelzoom".
Rik <rik@octave.org>
parents: 19780
diff changeset
558 case "mousewheelzoom"
19780
97690ea6f57a Add documentation for axes property "mouse_wheel_zoom".
Rik <rik@octave.org>
parents: 19731
diff changeset
559 s.doc = "Fraction of axes limits to zoom for each wheel movement.";
97690ea6f57a Add documentation for axes property "mouse_wheel_zoom".
Rik <rik@octave.org>
parents: 19731
diff changeset
560 s.valid = "scalar in the range (0, 1)";
97690ea6f57a Add documentation for axes property "mouse_wheel_zoom".
Rik <rik@octave.org>
parents: 19731
diff changeset
561
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
562 case "nextplot"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
563 case "outerposition"
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
564 s.doc = "Specify the position of the plot including titles, \
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
565 axes, and legend. The four elements of the vector are the \
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
566 coordinates of the lower left corner and width and height of the \
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
567 plot, in units normalized to the width and height of the plot \
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
568 window. For example, @code{[0.2, 0.3, 0.4, 0.5]} sets the lower \
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
569 left corner of the axes at @math{(0.2, 0.3)} and the width and \
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
570 height to be 0.4 and 0.5 respectively. \
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
571 @xref{XREFaxesposition, , @w{position property}}.";
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
572 s.valid = valid_4elvec;
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
573
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
574 case "plotboxaspectratio"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
575 case "plotboxaspectratiomode"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
576 case "position"
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
577 s.doc = "Specify the position of the plot excluding titles, \
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
578 axes, and legend. The four elements of the vector are the \
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
579 coordinates of the lower left corner and width and height of the \
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
580 plot, in units normalized to the width and height of the plot \
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
581 window. For example, @code{[0.2, 0.3, 0.4, 0.5]} sets the lower \
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
582 left corner of the axes at @math{(0.2, 0.3)} and the width and \
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
583 height to be 0.4 and 0.5 respectively. \
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
584 @xref{XREFaxesouterposition, , @w{outerposition property}}.";
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
585 s.valid = valid_4elvec;
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
586
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
587 case "projection"
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
588
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
589 case "tickdir"
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
590 s.doc = "Control whether axes tick marks project \"in\" to the plot \
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
591 box or \"out\".";
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
592
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
593 case "tickdirmode"
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
594
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
595 case "ticklength"
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
596 s.doc = "Two-element vector @code{[2Dlen 3Dlen]} specifying the \
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
597 length of the tickmarks relative to the longest visible axis.";
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
598 s.valid = valid_2elvec;
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
599
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
600 case "tightinset"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
601 case "title"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
602 s.doc = "Graphics handle of the title text object.";
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
603 s.valid = valid_handle;
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
604
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
605 case "units"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
606 case "view"
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
607 s.doc = "Two-element vector @code{[azimuth elevation]} specifying \
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
608 the viewpoint for three-dimensional plots";
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
609 s.valid = valid_2elvec;
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
610
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
611 case "xaxislocation"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
612 case "xcolor"
19441
86e69f51328d genpropdoc.m: Use two spaces after period at start of sentence.
Rik <rik@octave.org>
parents: 19357
diff changeset
613 s.doc = "Color of the x-axis. @xref{Colors, , colorspec}.";
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
614 s.valid = packopt ({markdef(valid_color), "@qcode{\"none\"}"});
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
615
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
616 case "xdir"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
617 case "xgrid"
19780
97690ea6f57a Add documentation for axes property "mouse_wheel_zoom".
Rik <rik@octave.org>
parents: 19731
diff changeset
618 s.doc = "Control whether major x grid lines are displayed.";
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
619
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
620 case "xlabel"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
621 s.doc = "Graphics handle of the x label text object.";
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
622 s.valid = valid_handle;
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
623
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
624 case "xlim"
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
625 s.doc = "Two-element vector @code{[xmin xmax]} specifying the limits \
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
626 for the x-axis. __modemsg__. @xref{XREFxlim, , @w{xlim function}}.";
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
627 s.valid = valid_2elvec;
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
628
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
629 case "xlimmode"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
630 case "xminorgrid"
19780
97690ea6f57a Add documentation for axes property "mouse_wheel_zoom".
Rik <rik@octave.org>
parents: 19731
diff changeset
631 s.doc = "Control whether minor x grid lines are displayed.";
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
632
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
633 case "xminortick"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
634 case "xscale"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
635 case "xtick"
19441
86e69f51328d genpropdoc.m: Use two spaces after period at start of sentence.
Rik <rik@octave.org>
parents: 19357
diff changeset
636 s.doc = "Position of x tick marks. __modemsg__.";
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
637 s.valid = "vector";
20498
ab4090316e6d Don't put default xtick vector size in documentation (bug #45725).
Rik <rik@octave.org>
parents: 20136
diff changeset
638 s.printdefault = false;
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
639
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
640 case "xticklabel"
19441
86e69f51328d genpropdoc.m: Use two spaces after period at start of sentence.
Rik <rik@octave.org>
parents: 19357
diff changeset
641 s.doc = "Labels of x tick marks. __modemsg__.";
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
642 s.valid = valid_cellstring;
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
643
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
644 case "xticklabelmode"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
645 case "xtickmode"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
646 case "yaxislocation"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
647 case "ycolor"
19441
86e69f51328d genpropdoc.m: Use two spaces after period at start of sentence.
Rik <rik@octave.org>
parents: 19357
diff changeset
648 s.doc = "Color of the y-axis. @xref{Colors, , colorspec}.";
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
649 s.valid = packopt ({markdef(valid_color), "@qcode{\"none\"}"});
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
650
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
651 case "ydir"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
652 case "ygrid"
19780
97690ea6f57a Add documentation for axes property "mouse_wheel_zoom".
Rik <rik@octave.org>
parents: 19731
diff changeset
653 s.doc = "Control whether major y grid lines are displayed.";
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
654
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
655 case "ylabel"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
656 s.doc = "Graphics handle of the y label text object.";
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
657 s.valid = valid_handle;
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
658
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
659 case "ylim"
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
660 s.doc = "Two-element vector @code{[ymin ymax]} specifying the limits \
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
661 for the y-axis. __modemsg__. @xref{XREFylim, , @w{ylim function}}.";
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
662 s.valid = valid_2elvec;
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
663
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
664 case "ylimmode"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
665 case "yminorgrid"
19780
97690ea6f57a Add documentation for axes property "mouse_wheel_zoom".
Rik <rik@octave.org>
parents: 19731
diff changeset
666 s.doc = "Control whether minor y grid lines are displayed.";
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
667
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
668 case "yminortick"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
669 case "yscale"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
670 case "ytick"
19441
86e69f51328d genpropdoc.m: Use two spaces after period at start of sentence.
Rik <rik@octave.org>
parents: 19357
diff changeset
671 s.doc = "Position of y tick marks. __modemsg__.";
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
672 s.valid = "vector";
20498
ab4090316e6d Don't put default xtick vector size in documentation (bug #45725).
Rik <rik@octave.org>
parents: 20136
diff changeset
673 s.printdefault = false;
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
674
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
675 case "yticklabel"
19441
86e69f51328d genpropdoc.m: Use two spaces after period at start of sentence.
Rik <rik@octave.org>
parents: 19357
diff changeset
676 s.doc = "Labels of y tick marks. __modemsg__.";
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
677 s.valid = valid_cellstring;
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
678
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
679 case "yticklabelmode"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
680 case "ytickmode"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
681 case "zcolor"
19441
86e69f51328d genpropdoc.m: Use two spaces after period at start of sentence.
Rik <rik@octave.org>
parents: 19357
diff changeset
682 s.doc = "Color of the z-axis. @xref{Colors, , colorspec}.";
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
683 s.valid = packopt ({markdef(valid_color), "@qcode{\"none\"}"});
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
684
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
685 case "zdir"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
686 case "zgrid"
19780
97690ea6f57a Add documentation for axes property "mouse_wheel_zoom".
Rik <rik@octave.org>
parents: 19731
diff changeset
687 s.doc = "Control whether major z grid lines are displayed.";
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
688
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
689 case "zlabel"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
690 s.doc = "Graphics handle of the z label text object.";
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
691 s.valid = valid_handle;
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
692
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
693 case "zlim"
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
694 s.doc = "Two-element vector @code{[zmin zmaz]} specifying the limits \
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
695 for the z-axis. __modemsg__. @xref{XREFzlim, , @w{zlim function}}.";
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
696 s.valid = valid_2elvec;
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
697
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
698 case "zlimmode"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
699 case "zminorgrid"
19780
97690ea6f57a Add documentation for axes property "mouse_wheel_zoom".
Rik <rik@octave.org>
parents: 19731
diff changeset
700 s.doc = "Control whether minor z grid lines are displayed.";
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
701
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
702 case "zminortick"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
703 case "zscale"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
704 case "ztick"
19441
86e69f51328d genpropdoc.m: Use two spaces after period at start of sentence.
Rik <rik@octave.org>
parents: 19357
diff changeset
705 s.doc = "Position of z tick marks. __modemsg__.";
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
706 s.valid = "vector";
20498
ab4090316e6d Don't put default xtick vector size in documentation (bug #45725).
Rik <rik@octave.org>
parents: 20136
diff changeset
707 s.printdefault = false;
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
708
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
709 case "zticklabel"
19441
86e69f51328d genpropdoc.m: Use two spaces after period at start of sentence.
Rik <rik@octave.org>
parents: 19357
diff changeset
710 s.doc = "Labels of z tick marks. __modemsg__.";
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
711 s.valid = valid_cellstring;
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
712
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
713 case "zticklabelmode"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
714 case "ztickmode"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
715 endswitch
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
716
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
717 ## Line properties
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
718 elseif (strcmp (objname, "line"))
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
719 switch (field)
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
720 ## Overridden shared properties
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
721 case "children"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
722 s.doc = doc_unused;
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
723
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
724 ## Specific properties
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
725 case "color"
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
726 s.doc = "Color of the line object. @xref{Colors, , colorspec}.";
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
727 s.valid = valid_color;
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
728
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
729 case "displayname"
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
730 s.doc = "Text for the legend entry corresponding to this line.";
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
731 s.valid = valid_cellstring;
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
732
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
733 case "erasemode"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
734 s.doc = doc_unused;
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
735
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
736 case "interpreter"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
737 case "linestyle"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
738 s.doc = "@xref{Line Styles}.";
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
739
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
740 case "linewidth"
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
741 s.doc = "Width of the line object measured in points.";
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
742
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
743 case "marker"
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
744 s.doc = "Shape of the marker for each data point. \
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
745 @xref{Marker Styles}.";
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
746
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
747 case "markeredgecolor"
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
748 s.doc = "Color of the edge of the markers. When set to \
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
749 @qcode{\"auto\"}, the marker edges have the same color as the line. If set \
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
750 to @qcode{\"none\"}, no marker edges are displayed. This property can also \
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
751 be set to any color. @xref{Colors, , colorspec}.";
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
752
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
753 case "markerfacecolor"
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
754 s.doc = "Color of the face of the markers. When set to \
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
755 @qcode{\"auto\"}, the marker faces have the same color as the line. If set \
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
756 to @qcode{\"none\"}, the marker faces are not displayed. This property \
19441
86e69f51328d genpropdoc.m: Use two spaces after period at start of sentence.
Rik <rik@octave.org>
parents: 19357
diff changeset
757 can also be set to any color. @xref{Colors, , colorspec}.";
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
758
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
759 case "markersize"
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
760 s.doc = "Size of the markers measured in points.";
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
761 s.valid = "scalar";
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
762
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
763 case "xdata"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
764 s.doc = "Vector of x data to be plotted.";
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
765 s.valid = "vector";
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
766
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
767 case "xdatasource"
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
768 s.doc = "Name of a vector in the current base workspace to use as \
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
769 x data.";
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
770 s.valid = valid_string;
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
771
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
772 case "ydata"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
773 s.doc = "Vector of y data to be plotted.";
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
774 s.valid = "vector";
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
775
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
776 case "ydatasource"
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
777 s.doc = "Name of a vector in the current base workspace to use as \
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
778 y data.";
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
779 s.valid = valid_string;
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
780
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
781 case "zdata"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
782 s.doc = "Vector of z data to be plotted.";
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
783 s.valid = "vector";
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
784
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
785 case "zdatasource"
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
786 s.doc = "Name of a vector in the current base workspace to use as \
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
787 z data.";
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
788 s.valid = valid_string;
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
789
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
790 endswitch
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
791
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
792 ## Text properties
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
793 elseif (strcmp (objname, "text"))
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
794 switch (field)
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
795 ## Overridden shared properties
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
796 case "children"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
797 s.doc = doc_unused;
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
798
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
799 ## Specific properties
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
800 case "backgroundcolor"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
801 s.doc = sprintf (doc_notimpl, "Background area");
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
802 s.valid = valid_color;
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
803
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
804 case "color"
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
805 s.doc = "Color of the text. @xref{Colors, ,colorspec}.";
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
806 s.valid = valid_color;
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
807
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
808 case "displayname"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
809 case "edgecolor"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
810 s.doc = sprintf (doc_notimpl, "Background area");
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
811 s.valid = valid_color;
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
812
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
813 case "editing"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
814 case "erasemode"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
815 s.doc = doc_unused;
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
816
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
817 case "extent"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
818 case "fontangle"
19441
86e69f51328d genpropdoc.m: Use two spaces after period at start of sentence.
Rik <rik@octave.org>
parents: 19357
diff changeset
819 s.doc = "Flag whether the font is italic or normal. \
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
820 @code{fontangle} is currently unused.";
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
821
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
822 case "fontname"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
823 s.doc = "The font used for the text.";
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
824 s.valid = valid_string;
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
825
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
826 case "fontsize"
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
827 s.doc = "The font size of the text as measured in \
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
828 @code{fontunits}.";
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
829 s.valid = "scalar";
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
830
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
831 case "fontunits"
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
832 s.doc = "The units used to interpret @code{fontsize} property.";
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
833
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
834 case "fontweight"
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
835 s.doc = "Control variant of base font used: bold, light, normal, etc.";
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
836
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
837 case "horizontalalignment"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
838 case "interpreter"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
839 case "linestyle"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
840 s.doc = sprintf (doc_notimpl, "Background area");
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
841
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
842 case "linewidth"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
843 s.doc = sprintf (doc_notimpl, "Background area");
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
844 s.valid = "scalar";
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
845
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
846 case "margin"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
847 s.doc = sprintf (doc_notimpl, "Background area");
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
848 s.valid = "scalar";
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
849
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
850 case "position"
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
851 s.doc = "Vector @code{[X0 Y0 Z0]} where X0, Y0 and Z0 indicate the \
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
852 position of the text anchor as defined by @code{verticalalignment} and \
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
853 @code{horizontalalignment}.";
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
854 s.valid = valid_4elvec;
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
855
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
856 case "rotation"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
857 s.doc = "The angle of rotation for the displayed text, \
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
858 measured in degrees.";
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
859 s.valid = "scalar";
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
860
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
861 case "string"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
862 s.doc = "The text object string content.";
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
863 s.valid = valid_string;
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
864
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
865 case "units"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
866 case "verticalalignment"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
867 endswitch
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
868
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
869 ## Image properties
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
870 elseif (strcmp (objname, "image"))
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
871 switch (field)
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
872 ## Overridden shared properties
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
873 case "children"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
874 s.doc = doc_unused;
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
875
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
876 ## Specific properties
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
877 case "alphadata"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
878 s.doc = sprintf (doc_notimpl, "Transparency");
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
879 s.valid = valid_scalmat;
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
880
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
881 case "alphadatamapping"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
882 s.doc = sprintf (doc_notimpl, "Transparency");
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
883
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
884 case "cdata"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
885 s.valid = "matrix";
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
886
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
887 case "cdatamapping"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
888 case "displayname"
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
889 s.doc = "Text for the legend entry corresponding to this image.";
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
890 s.valid = valid_cellstring;
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
891
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
892 case "erasemode"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
893 s.doc = doc_unused;
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
894
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
895 case "xdata"
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
896 s.doc = "Two-element vector @code{[xmin xmax]} specifying the x \
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
897 coordinates of the first and last columns of the image.\n\
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
898 \n\
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
899 Setting @code{xdata} to the empty matrix ([]) will restore the default value \
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
900 of @code{[1 columns(image)]}.";
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
901 s.valid = valid_2elvec;
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
902
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
903 case "ydata"
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
904 s.doc = "Two-element vector @code{[ymin ymax]} specifying the y \
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
905 coordinates of the first and last rows of the image.\n\
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
906 \n\
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
907 Setting @code{ydata} to the empty matrix ([]) will restore the default value \
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
908 of @code{[1 rows(image)]}.";
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
909 s.valid = valid_2elvec;
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
910
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
911 endswitch
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
912
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
913 ## Surface properties
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
914 elseif (strcmp (objname, "surface"))
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
915 switch (field)
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
916 ## Overridden shared properties
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
917 case "children"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
918 s.doc = doc_unused;
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
919
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
920 ## Specific properties
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
921 case "alphadata"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
922 s.doc = sprintf (doc_notimpl, "Transparency");
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
923 s.valid = valid_scalmat;
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
924
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
925 case "alphadatamapping"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
926 s.doc = sprintf (doc_notimpl, "Transparency");
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
927
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
928 case "ambientstrength"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
929 s.doc = sprintf (doc_notimpl, "Light");
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
930
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
931 case "backfacelighting"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
932 s.doc = sprintf (doc_notimpl, "Light");
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
933
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
934 case "cdata"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
935 s.valid = "matrix";
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
936
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
937 case "cdatamapping"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
938 case "cdatasource"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
939 case "diffusestrength"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
940 s.doc = sprintf (doc_notimpl, "Light");
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
941
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
942 case "displayname"
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
943 s.doc = "Text for the legend entry corresponding to this surface.";
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
944
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
945 case "edgealpha"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
946 s.doc = sprintf (doc_notimpl, "Transparency");
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
947 s.valid = "scalar";
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
948
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
949 case "edgecolor"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
950 case "edgelighting"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
951 s.doc = sprintf (doc_notimpl, "Light");
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
952
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
953 case "erasemode"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
954 s.doc = doc_unused;
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
955 case "facealpha"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
956 s.doc = sprintf (doc_notimpl, "Transparency");
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
957 s.valid = valid_scalmat;
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
958
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
959 case "facecolor"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
960 case "facelighting"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
961 s.doc = sprintf (doc_notimpl, "Light");
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
962
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
963 case "interpreter"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
964 case "linestyle"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
965 s.doc = "@xref{Line Styles}.";
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
966
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
967 case "linewidth"
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
968 s.doc = "@xref{XREFlinelinewidth, , @w{line linewidth property}}.";
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
969
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
970 case "marker"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
971 s.doc = "@xref{Marker Styles}.";
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
972
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
973 case "markeredgecolor"
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
974 s.doc = "@xref{XREFlinemarkeredgecolor, , \
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
975 @w{line markeredgecolor property}}.";
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
976
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
977 case "markerfacecolor"
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
978 s.doc = "@xref{XREFlinemarkerfacecolor, , \
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
979 @w{line markerfacecolor property}}.";
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
980
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
981 case "markersize"
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
982 s.doc = "@xref{XREFlinemarkersize, , \
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
983 @w{line markersize property}}.";
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
984 s.valid = "scalar";
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
985
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
986 case "meshstyle"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
987 case "normalmode"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
988 case "specularcolorreflectance"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
989 s.doc = sprintf (doc_notimpl, "Light");
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
990
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
991 case "specularexponent"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
992 s.doc = sprintf (doc_notimpl, "Light");
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
993
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
994 case "specularstrength"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
995 s.doc = sprintf (doc_notimpl, "Light");
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
996
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
997 case "vertexnormals"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
998 case "xdata"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
999 s.valid = "matrix";
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
1000
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1001 case "xdatasource"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1002 case "ydata"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1003 s.valid = "matrix";
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
1004
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1005 case "ydatasource"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1006 case "zdata"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1007 s.valid = "matrix";
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
1008
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1009 case "zdatasource"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1010 endswitch
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
1011
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1012 ## Patch properties
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1013 elseif (strcmp (objname, "patch"))
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
1014 switch (field)
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1015 ## Overridden shared properties
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1016 case "children"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1017 s.doc = doc_unused;
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1018
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1019 ## Specific properties
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1020 case "alphadatamapping"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1021 s.doc = sprintf (doc_notimpl, "Transparency");
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
1022
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1023 case "ambientstrength"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1024 s.doc = sprintf (doc_notimpl, "Light");
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1025 s.valid = "scalar";
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
1026
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1027 case "backfacelighting"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1028 s.doc = sprintf (doc_notimpl, "Light");
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
1029
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1030 case "cdata"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1031 s.doc = "Data defining the patch object color.\n\
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
1032 Patch color can be defined for faces or for vertices.\n\
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
1033 \n\
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
1034 If @code{cdata} is a scalar index into the current colormap or a RGB triplet, \
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
1035 it defines the color of all faces.\n\
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
1036 \n\
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
1037 If @code{cdata} is an N-by-1 vector of indices or an N-by-3 (RGB) matrix, \
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
1038 it defines the color of each one of the N faces.\n\
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
1039 \n\
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
1040 If @code{cdata} is an N-by-M or an N-by-M-by-3 (RGB) matrix, \
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
1041 it defines the color at each vertex.";
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1042 s.valid = valid_scalmat;
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
1043
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1044 case "diffusestrength"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1045 s.doc = sprintf (doc_notimpl, "Light");
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1046 s.valid = "scalar";
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
1047
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1048 case "displayname"
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
1049 s.doc = "Text of the legend entry corresponding to this patch.";
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
1050
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1051 case "edgealpha"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1052 s.doc = sprintf (doc_notimpl, "Transparency");
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1053 s.valid = valid_scalmat;
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
1054
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1055 case "edgecolor"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1056 case "edgelighting"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1057 s.doc = sprintf (doc_notimpl, "Light");
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
1058
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1059 case "erasemode"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1060 s.doc = doc_unused;
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
1061
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1062 case "facealpha"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1063 s.doc = sprintf (doc_notimpl, "Transparency");
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1064 s.valid = valid_scalmat;
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
1065
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1066 case "facecolor"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1067 ## Don't provide a default value, and mark colorspec with
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1068 ## braces, this forces the default rgb triplet to be displayed
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1069 s.valid = packopt ({markdef(valid_color), ...
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
1070 "@qcode{\"none\"}", ...
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1071 "@qcode{\"flat\"}", ...
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1072 "@qcode{\"interp\"}"});
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
1073
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1074 case "facelighting"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1075 s.doc = sprintf (doc_notimpl, "Light");
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
1076
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1077 case "faces"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1078 case "xdata"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1079 s.valid = valid_vecmat;
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
1080
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1081 case "facevertexalphadata"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1082 s.doc = sprintf (doc_notimpl, "Transparency");
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1083 s.valid = valid_scalmat;
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
1084
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1085 case "facevertexcdata"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1086 case "interpreter"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1087 s.doc = doc_unused;
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
1088
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1089 case "linestyle"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1090 case "linewidth"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1091 case "marker"
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
1092 s.doc = "@xref{XREFlinemarker, , @w{line marker property}}.";
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
1093
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1094 case "markeredgecolor"
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
1095 s.doc = "@xref{XREFlinemarkeredgecolor, , \
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
1096 @w{line markeredgecolor property}}.";
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
1097
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1098 case "markerfacecolor"
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
1099 s.doc = "@xref{XREFlinemarkerfacecolor, , \
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
1100 @w{line markerfacecolor property}}.";
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
1101
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1102 case "markersize"
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
1103 s.doc = "@xref{XREFlinemarkersize, , @w{line markersize property}}.";
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1104 s.valid = "scalar";
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
1105
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1106 case "normalmode"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1107 case "specularcolorreflectance"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1108 s.doc = sprintf (doc_notimpl, "Light");
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1109 s.valid = "scalar";
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
1110
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1111 case "specularexponent"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1112 s.doc = sprintf (doc_notimpl, "Light");
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1113 s.valid = "scalar";
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
1114
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1115 case "specularstrength"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1116 s.doc = sprintf (doc_notimpl, "Light");
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1117 s.valid = "scalar";
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
1118
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1119 case "vertexnormals"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1120 case "vertices"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1121 s.valid = valid_vecmat;
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
1122
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1123 case "xdata"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1124 s.valid = valid_vecmat;
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
1125
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1126 case "ydata"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1127 s.valid = valid_vecmat;
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
1128
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1129 case "zdata"
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1130 s.valid = valid_vecmat;
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
1131
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1132 endswitch
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1133 endif
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
1134
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1135 ## Replace keywords
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1136 if (! isempty (s.doc) && ! strcmp (objname, "base"))
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1137 s.doc = expand_doc (s.doc, field, objname);
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1138 endif
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
1139
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1140 endfunction
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1141
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1142 function strout = expand_doc (strin, field, objname)
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1143 strout = strrep (strin, "__objname__", objname);
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1144 strout = strrep (strout, "__prop__", ["@code{" field "}"]);
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1145
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1146 modemsg = "Setting @code{%s} also forces the @code{%smode} \
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1147 property to be set to @qcode{\"manual\"}";
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1148 modemsg = sprintf (modemsg, field, field);
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1149 strout = strrep (strout, "__modemsg__", modemsg);
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1150 endfunction
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1151
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1152 function s = getstructure (objname, base = [])
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1153 hf = [];
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1154 if (! strcmp (objname, "root"))
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
1155 ## Use an improbable number to avoid ishandle to return true for 1
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1156 hf = figure (2265465, "visible", "off");
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1157 endif
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1158
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
1159 ## Build a default object to extract its properties list and default values.
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1160 if (strcmp (objname, "base"))
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
1161 ## Base properties are extracted from hggroup that only have 2 additional
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
1162 ## regular (non-hidden) properties, "displayname" and "erasemode".
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1163 h = hggroup ();
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1164 elseif (strcmp (objname, "root"))
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1165 h = 0;
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1166 elseif (strcmp (objname, "figure"))
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1167 h = hf;
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1168 else
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1169 eval (["h = " objname " ();"]);
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1170 endif
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
1171
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1172 gprop = get (h);
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1173 sprop = set (h);
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1174
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1175 fields = fieldnames (gprop);
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1176 nf = numel (fields);
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1177 args = cell (2*nf, 1);
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1178 for ii = 1:nf
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1179 field = fields{ii};
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1180
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1181 ## Get hard coded documentation
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1182 val = getdoc (objname, field, base);
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
1183
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1184 ## Extract the default values that are not hard coded in getdoc
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1185 if (isempty (val.default) && val.printdefault)
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1186 val.default = getdefault (h, objname, field);
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1187 endif
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
1188
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1189 val.isreadonly = ! isfield (sprop, field);
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1190
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1191 ## Extract the valid values that are not hard coded in getdoc
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1192 if (! val.isreadonly && isempty (val.valid))
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1193 val.valid = sprop.(field);
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
1194 if (! isempty (val.valid) && iscellstr (val.valid))
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1195 ## Add double quotes around string radio properties
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1196 val.valid = cellfun (@(s) ["@qcode{\"" s "\"}"], val.valid,
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1197 "uniformoutput", false);
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
1198 val.valid = strjoin (val.valid, " | ");
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1199 endif
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1200 endif
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
1201
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1202 args{2*(ii-1)+1} = field;
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1203 args{2*ii} = val;
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1204 endfor
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1205
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1206 ## Build struct and remove unused fields in base properties
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1207 s = struct (args{:});
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1208
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1209 if (strcmp (objname, "base"))
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1210 s = rmfield (s, {"displayname", "erasemode"});
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1211 endif
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1212
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1213 if (isfigure (hf))
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1214 close (hf)
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1215 endif
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
1216
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1217 endfunction
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1218
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
1219 function def = getdefault (h, objname, field)
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1220 ## This function is meant to be run without initialization file so
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1221 ## that the properties we get are the default.
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1222 def = get (h, field);
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
1223
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1224 ## Don't print default values for graphics handles
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1225 if (isscalar (def) && def != 0 && ishandle (def))
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1226 def = "";
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1227 else
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1228 if (ischar (def))
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
1229 def = ['@qcode{"' def '"}'];
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1230 else
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
1231 if ((isvector (def) && numel (def) < 5) || isempty (def))
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1232 ## Use disp to print the default value for short vectors and
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1233 ## empty values
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1234 str = disp (def);
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1235 str(end) = []; # remove linefeed
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1236 str = strtrim (str); # remove leading space
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1237
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1238 ## Add [] around vector values
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1239 if (ismatrix (def) && numel (def) > 1)
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1240 str = ["[" str "]"];
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1241 ## Add ";" between columns vector values
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1242 if (rows (def) != 1)
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1243 str = strrep (str, "\n", "; ");
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1244 endif
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1245 endif
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
1246
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1247 ## Replace texinfo reserved characters
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1248 def = strrep (str, "{", "@{");
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1249 def = strrep (def, "}", "@}");
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1250 def = strrep (def, "@", "@@");
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
1251
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1252 def = ["@code{" def "}"];
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1253 else
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
1254 args = arrayfun (@(x) num2str (x), size (def), "uniformoutput", false);
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1255 def = [strjoin(args, "-by-") " " class(def)];
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1256 endif
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1257 endif
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1258 endif
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
1259
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1260 endfunction
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1261
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1262 function str = printdoc (objname, obj)
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1263 ## Sort fields so that they appear in alphabetic order in the manual
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1264 fields = sort (fieldnames (obj));
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1265 nf = numel (fields);
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1266
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1267 ## File header and begining of properties table
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1268 str = [warn_autogen() "\n\n@table @asis"];
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1269
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
1270 for ii = 1:nf
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1271 field = fields{ii};
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1272 str = sprintf ("%s\n\n", str);
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1273
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1274 ## @anchor: cross reference using XREFobjnamefield label
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
1275 ## Concept index: call info from octave with 'doc ("objname field")'
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1276 str = sprintf ("%s@anchor{XREF%s%s}\n@cindex %s %s\n",
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1277 str, objname, field, objname, field);
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1278
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1279 ## Item
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1280 str = sprintf ("%s@item @code{%s}", str, field);
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1281
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1282 ## Mark item read-only if needed
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1283 if (obj.(field).isreadonly)
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1284 str = sprintf ("%s (read-only):", str);
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1285 else
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1286 str = sprintf ("%s:", str);
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1287 endif
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
1288
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1289 ## Print valid and default values
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1290 tmp = print_options (obj.(field).valid,
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1291 obj.(field).default);
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1292 if (! isempty (tmp))
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1293 str = sprintf ("%s %s\n", str, tmp);
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1294 else
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1295 str = sprintf ("%s\n", str);
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1296 endif
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1297
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1298 ## Print documentation
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1299 str = sprintf ("%s%s\n", str, obj.(field).doc);
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1300 endfor
19631
db92e7e28e1f strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 19441
diff changeset
1301
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1302 ## End of properties table
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1303 str = sprintf ("%s\n@end table", str);
19858
0e585d3b8b9a genpropdoc.m: Improve documentation on graphic object properties.
Rik <rik@octave.org>
parents: 19826
diff changeset
1304
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1305 endfunction
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1306
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1307 function str = warn_autogen ()
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1308 str = "@c DO NOT EDIT! Generated automatically by genpropdoc.m.\n\
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1309 \n\
19731
4197fc428c7d maint: Update copyright notices for 2015.
John W. Eaton <jwe@octave.org>
parents: 19631
diff changeset
1310 @c Copyright (C) 2014-2015 Pantxo Diribarne\n\
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1311 @c\n\
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1312 @c This file is part of Octave.\n\
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1313 @c\n\
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1314 @c Octave is free software; you can redistribute it and/or modify it\n\
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1315 @c under the terms of the GNU General Public License as published by the\n\
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1316 @c Free Software Foundation; either version 3 of the License, or (at\n\
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1317 @c your option) any later version.\n\
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1318 @c\n\
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1319 @c Octave is distributed in the hope that it will be useful, but WITHOUT\n\
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1320 @c ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or\n\
19441
86e69f51328d genpropdoc.m: Use two spaces after period at start of sentence.
Rik <rik@octave.org>
parents: 19357
diff changeset
1321 @c FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License\n\
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1322 @c for more details.\n\
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1323 @c\n\
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1324 @c You should have received a copy of the GNU General Public License\n\
19441
86e69f51328d genpropdoc.m: Use two spaces after period at start of sentence.
Rik <rik@octave.org>
parents: 19357
diff changeset
1325 @c along with Octave; see the file COPYING. If not, see\n\
19291
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1326 @c <http://www.gnu.org/licenses/>.";
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1327 endfunction
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1328
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1329 function str = print_options (val, default)
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1330 str = "";
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1331 if (! isempty (val))
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1332 tmp = strrep (val, default, ["@{" default "@}"]);
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1333 if (length (tmp) == length (val) && ! isempty (default))
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1334 str = [tmp ", def. " default];
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1335 else
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1336 str = tmp;
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1337 endif
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1338 elseif (! isempty (default))
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1339 str = ["def. " default];
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1340 endif
1f2a16d41ba2 Automatically generate graphics properties documentation (bug #42536)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
diff changeset
1341 endfunction