Mercurial > octave-nkf
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. |