changeset 16813:81e041f5633a

doc: Add copyobj, struct2hdl, hdl2struct to manual. * doc/interpreter/plot.txi: Add copyobj, struct2hdl, hdl2struct to manual.
author Rik <rik@octave.org>
date Sat, 22 Jun 2013 14:36:42 -0700
parents 366a13bd71d5
children 64e7bb01fce2
files doc/interpreter/plot.txi
diffstat 1 files changed, 27 insertions(+), 0 deletions(-) [+]
line wrap: on
line diff
--- a/doc/interpreter/plot.txi
+++ b/doc/interpreter/plot.txi
@@ -531,7 +531,9 @@
 become children of the current axes object.
 
 @DOCSTRING(axes)
+
 @DOCSTRING(line)
+
 @DOCSTRING(patch)
 
 @DOCSTRING(fill)
@@ -1168,6 +1170,31 @@
 
 @DOCSTRING(findfigs)
 
+@cindex saving graphics objects
+
+Figures can be printed or saved in many graphics formats with @code{print} and
+@code{saveas}.  Occasionally, however, it may be useful to save the original
+Octave handle graphic directly so that further modifications can be made such
+as modifying a title or legend.  
+
+This can be accomplished with the following functions by 
+
+@example
+@group
+fig_struct = hdl2struct (gcf);
+save myplot.fig -struct fig_struct;
+@dots{}
+fig_struct = load ("myplot.fig");
+struct2hdl (fig_struct);
+@end group
+@end example
+
+@DOCSTRING(hdl2struct)
+
+@DOCSTRING(struct2hdl)
+
+@DOCSTRING(copyobj)
+
 @node Graphics Object Properties
 @subsection Graphics Object Properties
 @cindex graphics object properties