comparison doc/interpreter/plot.txi @ 11878:2415586d0f5a release-3-0-x

doc fixes
author John W. Eaton <jwe@octave.org>
date Sun, 12 Oct 2008 19:38:43 +0200
parents 233de4b9b259
children 3342d1a7c4c9
comparison
equal deleted inserted replaced
11877:d11919389e09 11878:2415586d0f5a
399 appearance and may also contain links to other graphics objects. 399 appearance and may also contain links to other graphics objects.
400 Graphics objects are only referenced by a numeric index, or @dfn{handle}. 400 Graphics objects are only referenced by a numeric index, or @dfn{handle}.
401 401
402 @table @asis 402 @table @asis
403 @item root figure 403 @item root figure
404 @cindex root figure graphics object
405 @cindex graphics object, root figure
404 The parent of all figure objects. The index for the root figure is 406 The parent of all figure objects. The index for the root figure is
405 defined to be 0. 407 defined to be 0.
406 408
407 @item figure 409 @item figure
410 @cindex figure graphics object
411 @cindex graphics object, figure
408 A figure window. 412 A figure window.
409 413
410 @item axes 414 @item axes
415 @cindex axes graphics object
416 @cindex graphics object, axes
411 An set of axes. This object is a child of a figure object and may be a 417 An set of axes. This object is a child of a figure object and may be a
412 parent of line, text, image, patch, or surface objects. 418 parent of line, text, image, patch, or surface objects.
413 419
414 @item line 420 @item line
421 @cindex line graphics object
422 @cindex graphics object, line
415 A line in two or three dimensions. 423 A line in two or three dimensions.
416 424
417 @item text 425 @item text
426 @cindex text graphics object
427 @cindex graphics object, text
418 Text annotations. 428 Text annotations.
419 429
420 @item image 430 @item image
431 @cindex image graphics object
432 @cindex graphics object, image
421 A bitmap image. 433 A bitmap image.
422 434
423 @item patch 435 @item patch
436 @cindex patch graphics object
437 @cindex graphics object, patch
424 A filled polygon, currently limited to two dimensions. 438 A filled polygon, currently limited to two dimensions.
425 439
426 @item surface 440 @item surface
441 @cindex surface graphics object
442 @cindex graphics object, surface
427 A three-dimensional surface. 443 A three-dimensional surface.
428 @end table 444 @end table
429 445
430 To determine whether an object is a graphics object index or a figure 446 To determine whether an object is a graphics object index or a figure
431 index, use the functions @code{ishandle} and @code{isfigure}. 447 index, use the functions @code{ishandle} and @code{isfigure}.
595 @c Either @code{"on"} or @code{"off"} to toggle display of figures. 611 @c Either @code{"on"} or @code{"off"} to toggle display of figures.
596 @end table 612 @end table
597 613
598 @node Figure Properties 614 @node Figure Properties
599 @subsubsection Figure Properties 615 @subsubsection Figure Properties
616 @cindex figure properties
600 617
601 @table @code 618 @table @code
602 @item nextplot 619 @item nextplot
603 May be one of 620 May be one of
604 @table @code 621 @table @code
625 @code{"portrait"}. 642 @code{"portrait"}.
626 @end table 643 @end table
627 644
628 @node Axes Properties 645 @node Axes Properties
629 @subsubsection Axes Properties 646 @subsubsection Axes Properties
647 @cindex axes properties
630 648
631 @table @code 649 @table @code
632 @item position 650 @item position
633 A four-element vector specifying the coordinates of the lower left 651 A vector specifying the position of the plot, excluding titles, axes and
634 corner and width and height of the plot, in normalized units. For 652 legend. The four elements of the vector are the coordinates of the
635 example, @code{[0.2, 0.3, 0.4, 0.5]} sets the lower left corner of the 653 lower left corner and width and height of the plot, in units normalized
636 axes at @math{(0.2, 0.3)} and the width and height to be 0.4 and 0.5 654 to the width and height of the plot window. For example, @code{[0.2,
637 respectively. 655 0.3, 0.4, 0.5]} sets the lower left corner of the axes at @math{(0.2,
656 0.3)} and the width and height to be 0.4 and 0.5 respectively. See also
657 the @code{outerposition} property.
638 658
639 @item title 659 @item title
640 Index of text object for the axes title. 660 Index of text object for the axes title.
641 661
642 @item box 662 @item box
751 @item "replace" 771 @item "replace"
752 @item "replacechildren" 772 @item "replacechildren"
753 @end table 773 @end table
754 774
755 @item outerposition 775 @item outerposition
756 A four-element vector specifying the coordinates of the lower left 776 A vector specifying the position of the plot, including titles, axes and
757 corner and width and height of the plot, in normalized units including 777 legend. The four elements of the vector are the coordinates of the
758 the tics, labels etc. For example, @code{[0.2, 0.3, 0.4, 0.5]} sets the 778 lower left corner and width and height of the plot, in units normalized
759 lower left corner of the axes at @math{(0.2, 0.3)} and the width and 779 to the width and height of the plot window. For example, @code{[0.2,
760 height to be 0.4 and 0.5 respectively. 780 0.3, 0.4, 0.5]} sets the lower left corner of the axes at @math{(0.2,
781 0.3)} and the width and height to be 0.4 and 0.5 respectively. See also
782 the @code{position} property.
761 @end table 783 @end table
762 784
763 @node Line Properties 785 @node Line Properties
764 @subsubsection Line Properties 786 @subsubsection Line Properties
787 @cindex line properties
765 788
766 @table @code 789 @table @code
767 @itemx xdata 790 @itemx xdata
768 @itemx ydata 791 @itemx ydata
769 @itemx zdata 792 @itemx zdata
794 future version of Octave. 817 future version of Octave.
795 @end table 818 @end table
796 819
797 @node Text Properties 820 @node Text Properties
798 @subsubsection Text Properties 821 @subsubsection Text Properties
822 @cindex text properties
799 823
800 @table @code 824 @table @code
801 @item string 825 @item string
802 The character string contained by the text object. 826 The character string contained by the text object.
803 827
1077 @end float 1101 @end float
1078 @end ifnotinfo 1102 @end ifnotinfo
1079 1103
1080 @node Image Properties 1104 @node Image Properties
1081 @subsubsection Image Properties 1105 @subsubsection Image Properties
1106 @cindex image properties
1082 1107
1083 @table @code 1108 @table @code
1084 @item cdata 1109 @item cdata
1085 The data for the image. Each pixel of the image corresponds to an 1110 The data for the image. Each pixel of the image corresponds to an
1086 element of @code{cdata}. The value of an element of @code{cdata} 1111 element of @code{cdata}. The value of an element of @code{cdata}
1094 the image. 1119 the image.
1095 @end table 1120 @end table
1096 1121
1097 @node Patch Properties 1122 @node Patch Properties
1098 @subsubsection Patch Properties 1123 @subsubsection Patch Properties
1124 @cindex patch properties
1099 1125
1100 @table @code 1126 @table @code
1101 @item cdata 1127 @item cdata
1102 @itemx xdata 1128 @itemx xdata
1103 @itemx ydata 1129 @itemx ydata
1124 @xref{Marker Styles}. 1150 @xref{Marker Styles}.
1125 @end table 1151 @end table
1126 1152
1127 @node Surface Properties 1153 @node Surface Properties
1128 @subsubsection Surface Properties 1154 @subsubsection Surface Properties
1155 @cindex surface properties
1129 1156
1130 @table @code 1157 @table @code
1131 @item xdata 1158 @item xdata
1132 @itemx ydata 1159 @itemx ydata
1133 @itemx zdata 1160 @itemx zdata
1140 future version of Octave. 1167 future version of Octave.
1141 @end table 1168 @end table
1142 1169
1143 @node Managing Default Properties 1170 @node Managing Default Properties
1144 @subsection Managing Default Properties 1171 @subsection Managing Default Properties
1172 @cindex default graphics properties
1173 @cindex graphics properties, default
1145 1174
1146 Object properties have two classes of default values, @dfn{factory 1175 Object properties have two classes of default values, @dfn{factory
1147 defaults} (the initial values) and @dfn{user-defined defaults}, which 1176 defaults} (the initial values) and @dfn{user-defined defaults}, which
1148 may override the factory defaults. 1177 may override the factory defaults.
1149 1178
1226 @noindent 1255 @noindent
1227 returns a list of factory defaults. 1256 returns a list of factory defaults.
1228 1257
1229 @node Colors 1258 @node Colors
1230 @subsection Colors 1259 @subsection Colors
1260 @cindex graphics colors
1261 @cindex colors, graphics
1231 1262
1232 Colors may be specified as RGB triplets with values ranging from zero to 1263 Colors may be specified as RGB triplets with values ranging from zero to
1233 one, or by name. Recognized color names include @code{"blue"}, 1264 one, or by name. Recognized color names include @code{"blue"},
1234 @code{"black"}, @code{"cyan"}, @code{"green"}, @code{"magenta"}, 1265 @code{"black"}, @code{"cyan"}, @code{"green"}, @code{"magenta"},
1235 @code{"red"}, @code{"white"}, and @code{"yellow"}. 1266 @code{"red"}, @code{"white"}, and @code{"yellow"}.
1236 1267
1237 @node Line Styles 1268 @node Line Styles
1238 @subsection Line Styles 1269 @subsection Line Styles
1270 @cindex line styles, graphics
1271 @cindex graphics line styles
1272
1239 Line styles are specified by the following properties: 1273 Line styles are specified by the following properties:
1240 1274
1241 @table @code 1275 @table @code
1242 @item linestyle 1276 @item linestyle
1243 May be one of 1277 May be one of
1257 of 2 is twice as wide as the default, etc. 1291 of 2 is twice as wide as the default, etc.
1258 @end table 1292 @end table
1259 1293
1260 @node Marker Styles 1294 @node Marker Styles
1261 @subsection Marker Styles 1295 @subsection Marker Styles
1296 @cindex graphics marker styles
1297 @cindex marker styles, graphics
1298
1262 Marker styles are specified by the following properties: 1299 Marker styles are specified by the following properties:
1263 @table @code 1300 @table @code
1264 @item marker 1301 @item marker
1265 A character indicating a plot marker to be place at each data point, or 1302 A character indicating a plot marker to be place at each data point, or
1266 @code{"none"}, meaning no markers should be displayed. 1303 @code{"none"}, meaning no markers should be displayed.