Mercurial > octave

changeset 22518:e15b89c4c2dd

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
patch.m: Update docstring and demo (bug #47672) * patch.m: Update docstring and change demo #4 for input mixed between property/value pairs and structures. Reviewed and pushed by Andreas Weber <andy.weber.aw@gmail.com>
author Markus Mützel <markus.muetzel@gmx.de>
date Tue, 20 Sep 2016 16:32:53 +0200
parents 34f98c1e4d56
children 7ccbc2a6b99d
files scripts/plot/draw/patch.m
diffstat 1 files changed, 6 insertions(+), 7 deletions(-) [+]
line wrap: on
line diff
--- a/scripts/plot/draw/patch.m	Tue Sep 20 00:04:03 2016 +0200
+++ b/scripts/plot/draw/patch.m	Tue Sep 20 16:32:53 2016 +0200
@@ -20,9 +20,9 @@
 ## @deftypefn  {} {} patch ()
 ## @deftypefnx {} {} patch (@var{x}, @var{y}, @var{c})
 ## @deftypefnx {} {} patch (@var{x}, @var{y}, @var{z}, @var{c})
-## @deftypefnx {} {} patch (@var{fv})
 ## @deftypefnx {} {} patch ("Faces", @var{faces}, "Vertices", @var{verts}, @dots{})
 ## @deftypefnx {} {} patch (@dots{}, @var{prop}, @var{val}, @dots{})
+## @deftypefnx {} {} patch (@dots{}, @var{propstruct}, @dots{})
 ## @deftypefnx {} {} patch (@var{hax}, @dots{})
 ## @deftypefnx {} {@var{h} =} patch (@dots{})
 ## Create patch object in the current axes with vertices at locations
@@ -55,9 +55,8 @@
 ## @qcode{"Vertices"}/@var{verts}, @qcode{"Faces"}/@var{faces} as
 ## inputs.
 ##
-## A third input form is to create a structure @var{fv} with the fields
-## @qcode{"vertices"}, @qcode{"faces"}, and optionally
-## @qcode{"facevertexcdata"}.
+## Instead of using property/value pairs, any property can be set by passing a
+## structure @var{propstruct} with the respective field names.
 ##
 ## If the first argument @var{hax} is an axes handle, then plot into this axis,
 ## rather than the current axes returned by @code{gca}.
@@ -150,9 +149,9 @@
 %! x2 = sin (t2) + 0.8;
 %! y2 = cos (t2);
 %! vert = [x1, y1; x2, y2];
-%! fac = [1:8,NaN(1,8);9:24];
-%! patch ("Faces",fac, "Vertices",vert, ...
-%!        "FaceVertexCData",[0, 1, 0; 0, 0, 1], "FaceColor", "flat");
+%! p.Faces = [1:8,NaN(1,8);9:24];
+%! p.FaceColor = "flat";
+%! patch (p, 'Vertices', vert, 'FaceVertexCData', [0, 1, 0; 0, 0, 1]);
 %! title ("patch() with specification of color for each vertex");
 
 %!demo