From: <hba...@us...> - 2009-07-12 23:06:32
|
Revision: 10144 http://plplot.svn.sourceforge.net/plplot/?rev=10144&view=rev Author: hbabcock Date: 2009-07-12 23:06:30 +0000 (Sun, 12 Jul 2009) Log Message: ----------- Add -cmap0 and -cmap1 to the list of supported command line arguments. Modified Paths: -------------- trunk/doc/docbook/src/advanced.xml Modified: trunk/doc/docbook/src/advanced.xml =================================================================== --- trunk/doc/docbook/src/advanced.xml 2009-07-12 23:00:11 UTC (rev 10143) +++ trunk/doc/docbook/src/advanced.xml 2009-07-12 23:06:30 UTC (rev 10144) @@ -97,6 +97,8 @@ -dpi dpi Resolution, in dots per inch (e.g. -dpi 360x360) -compression num Sets compression level in supporting devices -drvopt option[=value][,option[=value]]* Driver specific options + -cmap0 name Sets PLplot color table 0 using the file name + -cmap1 name Sets PLplot color table 1 using the file name </screen> </para> This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site. |
From: <ai...@us...> - 2010-01-08 02:51:55
|
Revision: 10748 http://plplot.svn.sourceforge.net/plplot/?rev=10748&view=rev Author: airwin Date: 2010-01-08 02:51:48 +0000 (Fri, 08 Jan 2010) Log Message: ----------- Documentation for the PLPLOT_DEV environment variable This adds details to the docbook documentation about the newly supported PLPLOT_DEV environment variable. Thanks to David MacMahon for this. Modified Paths: -------------- trunk/doc/docbook/src/advanced.xml Modified: trunk/doc/docbook/src/advanced.xml =================================================================== --- trunk/doc/docbook/src/advanced.xml 2010-01-08 02:40:14 UTC (rev 10747) +++ trunk/doc/docbook/src/advanced.xml 2010-01-08 02:51:48 UTC (rev 10748) @@ -598,9 +598,10 @@ all internal data structures necessary for plotting and initializes the output device driver. The output device can be a terminal, disk file, window system, pipe, or socket. If the output device has not - already been specified when &plinit; is called, a list of valid - output devices is given and the user is prompted for a choice. For - example: + already been specified when &plinit; is called, the output device + will be taken from the value of the PLPLOT_DEV environment variable. + If this variable is not set (or is empty), a list of valid output + devices is given and the user is prompted for a choice. For example: </para> <para> @@ -651,6 +652,15 @@ &plparseopts;. </para> </listitem> + <listitem> + <para> + The value of the <literal>PLPLOT_DEV</literal> environment + variable. Note that specifying the output device via &plsdev; + or the <literal>-dev</literal> command line argument will + override the value given by the <literal>PLPLOT_DEV</literal> + environment variable. + </para> + </listitem> </itemizedlist> </para> This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site. |
From: <ai...@us...> - 2012-01-20 20:07:58
|
Revision: 12137 http://plplot.svn.sourceforge.net/plplot/?rev=12137&view=rev Author: airwin Date: 2012-01-20 20:07:52 +0000 (Fri, 20 Jan 2012) Log Message: ----------- Clarify the introduction to color to make it clear both plcol0 and plcol1 set the current color which is used for all subsequent plotting actions. Modified Paths: -------------- trunk/doc/docbook/src/advanced.xml Modified: trunk/doc/docbook/src/advanced.xml =================================================================== --- trunk/doc/docbook/src/advanced.xml 2012-01-20 10:34:19 UTC (rev 12136) +++ trunk/doc/docbook/src/advanced.xml 2012-01-20 20:07:52 UTC (rev 12137) @@ -1403,14 +1403,22 @@ of globally turning off the color (and subsequently turning it on again if so desired) using &plscolor;. </para> - <para> The PLplot color model utilizes two color maps which can be used - interchangeably. However, color map0 (discussed in <xref - linkend="color-map-0"/>) has discrete colors with no particular order - and is most suited to coloring the background, axes, lines, and labels, - and color map1 (discussed in <xref linkend="color-map-1"/>) has - continuously changing colors and is most suited to plots (see <xref - linkend="contour-plots"/>) in which data values are represented by - colors. </para> + <para> The PLplot color model allows the user to set the current + color from a wide range of colours using two distinct color maps. + Color map0 (discussed in <xref linkend="color-map-0"/>) has discrete + colors with no particular order and is most suited to coloring the + background, axes, lines, and labels, and color map1 (discussed in + <xref linkend="color-map-1"/>) has continuously changing colors and is + most suited to plots (see <xref linkend="contour-plots"/>) in which + data values are represented by colors. Setting the background color + is a special case that is handled exclusively by color map 0 (as + discussed in <xref linkend="color-map-0"/>). The user can change the + current color (as opposed to the background color) at any point in the + plot by selecting any of the colors from either color map 0 or 1 using + calls to &plcol0; or &plcol1;. When the current color is changed all + subsequent drawing actions will utilise the new color until it is + changed again. +</para> <sect2 id="color-map-0"> <title>Color Map0</title> This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site. |
From: <ai...@us...> - 2013-09-23 18:24:29
|
Revision: 12516 http://sourceforge.net/p/plplot/code/12516 Author: airwin Date: 2013-09-23 18:24:27 +0000 (Mon, 23 Sep 2013) Log Message: ----------- Add section in advanced.xml concerning the pllegend and plcolorbar capabilities. Modified Paths: -------------- trunk/doc/docbook/src/advanced.xml Modified: trunk/doc/docbook/src/advanced.xml =================================================================== --- trunk/doc/docbook/src/advanced.xml 2013-09-22 10:01:44 UTC (rev 12515) +++ trunk/doc/docbook/src/advanced.xml 2013-09-23 18:24:27 UTC (rev 12516) @@ -2767,4 +2767,38 @@ </sect1> + <sect1 id="legends"> + <title>Legends and color bars</title> + <para> + The &pllegend; and &plcolorbar; routines are available in PLplot to + provide users with the capability of visually annotating their plots + with a legend (a series of patterned boxes, lines, or symbols with + associated explanatory UTF-8 text) or a color bar (an annotated + subplot representing a continuous range of colours within the main + plot and typically identifying certain colours with certain numerical + values using an axis). &pllegend; is useful for visually annotating + most two-dimensional plots. See standard examples 4 and 26 for some + examples. &plcolorbar; is especially useful for annotating continous + shade plots generated by &plshades;. See standard example 16 for an + example. + </para> + + <para> + The &pllegend; and &plcolorbar; routines provide the users complete + and convenient control of the size and position of the results on the + plot and also return size data that makes it straightforward to stack + different legend or colorbar results together on the plot (see + standard example 33 for an example of this capability). Furthermore, + the &pllegend; and &plcolorbar; routines provide the user with many + different style possibilities for the results. Because of all these + features, &pllegend; and &plcolorbar; have an extensive argument list. + So we recommend first-time users of &pllegend; and &plcolorbar; use + examples 4, 16, and 26 as a tutorial on how to use these PLplot + capabilities in a simple way, and for more advanced use we recommend + that users study the &pllegend; and &plcolorbar; documentation and + also example 33 which attempts to exercise most capabilities of these + two PLplot functions. + </para> + </sect1> + </chapter> This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site. |
From: <ai...@us...> - 2013-09-23 19:22:15
|
Revision: 12517 http://sourceforge.net/p/plplot/code/12517 Author: airwin Date: 2013-09-23 19:22:13 +0000 (Mon, 23 Sep 2013) Log Message: ----------- colour ==> color. Modified Paths: -------------- trunk/doc/docbook/src/advanced.xml Modified: trunk/doc/docbook/src/advanced.xml =================================================================== --- trunk/doc/docbook/src/advanced.xml 2013-09-23 18:24:27 UTC (rev 12516) +++ trunk/doc/docbook/src/advanced.xml 2013-09-23 19:22:13 UTC (rev 12517) @@ -3,7 +3,7 @@ advanced.xml: "Advanced Use of PLplot" chapter Copyright (C) 1994 Geoffrey Furnish and Maurice LeBrun -Copyright (C) 1999, 2000, 2001, 2002, 2005 Alan W. Irwin +Copyright (C) 1999-2013 Alan W. Irwin Copyright (C) 1999, 2000, 2001, 2002, 2003 Rafael Laboissiere Copyright (C) 2004 Andrew Roach Copyright (C) 2005 Thomas J. Duck @@ -776,7 +776,7 @@ <para>First, write a call back function, of type <literal>plD_pixel_fp</literal>, which specifies how a single pixel is set - in the current colour. This can be of type static void. For example, in the + in the current color. This can be of type static void. For example, in the <filename>gd.c</filename> driver it looks like this: <programlisting> @@ -914,8 +914,8 @@ <para>We also do some computational gymnastics to "expand" cmap0 if the user wants anti-aliased text. Basically, you have to work out how many spare - colours there are in the driver after cmap0 and cmap1 are done, then set a - few variables in FT to let the render know how many colours it's going to + colors there are in the driver after cmap0 and cmap1 are done, then set a + few variables in FT to let the render know how many colors it's going to have at its disposal, and call plscmap0n to resize cmap0. The call to <literal>pl_set_extended_cmap0</literal> does the remaining part of the work. Note it essential to protect that call by the @@ -1404,7 +1404,7 @@ if so desired) using &plscolor;. </para> <para> The PLplot color model allows the user to set the current - color from a wide range of colours using two distinct color maps. + color from a wide range of colors using two distinct color maps. Color map0 (discussed in <xref linkend="color-map-0"/>) has discrete colors with no particular order and is most suited to coloring the background, axes, lines, and labels, and color map1 (discussed in @@ -2774,8 +2774,8 @@ provide users with the capability of visually annotating their plots with a legend (a series of patterned boxes, lines, or symbols with associated explanatory UTF-8 text) or a color bar (an annotated - subplot representing a continuous range of colours within the main - plot and typically identifying certain colours with certain numerical + subplot representing a continuous range of colors within the main + plot and typically identifying certain colors with certain numerical values using an axis). &pllegend; is useful for visually annotating most two-dimensional plots. See standard examples 4 and 26 for some examples. &plcolorbar; is especially useful for annotating continous This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site. |
From: <ai...@us...> - 2013-10-05 19:38:29
|
Revision: 12580 http://sourceforge.net/p/plplot/code/12580 Author: airwin Date: 2013-10-05 19:38:25 +0000 (Sat, 05 Oct 2013) Log Message: ----------- Add some explanatory text concerning UTF-8 encoded input strings. This explanation includes a wide variety of UTF-8 glyphs (all the "peace" words in Example 24 and a number of mathematical symbols). Thus, this additional explanatory text is also a good test of how our documentation build system handles UTF-8 glyphs in general. Tested by Alan W. Irwin <ai...@us...> for -DBUILD_DOC=ON and the following targets: man (results not affected since the man pages ignore the advanced chapter.) info (good results; all math glyphs and all but the glyphs occurring in the Korean, Hindi, and Mandarin "peace" words came through fine. That's exactly the same set of missing glyphs that occurs when I use "less" on advanced.xml so it is possible some configuration adjustment for my system will fix the missing glyphs that occur both for the info form of our documentation and when using "less".) html (outstanding results; all math glyphs and all the glyphs occurring in the set of "peace" words render without issues including the CTL languages like Hebrew, Arabic, and Hindi.) pdf (good results; all math glyphs and all but the glyphs occurring in the Korean and Mandarin "peace" words come through fine. I attribute these issues to missing Korean and Mandarin glyphs in the chosen FreeSans, FreeSerif, and FreeMono fonts. The order of the glyphs in the Hindi peace word is not correct (last two glyphs switched) which is a common complex text layout (CTL) issue when using unsophisticated software to render Hindi. More comments on these PDF results are forthcoming on the plplot-devel list.) Modified Paths: -------------- trunk/doc/docbook/src/advanced.xml Modified: trunk/doc/docbook/src/advanced.xml =================================================================== --- trunk/doc/docbook/src/advanced.xml 2013-10-05 19:00:37 UTC (rev 12579) +++ trunk/doc/docbook/src/advanced.xml 2013-10-05 19:38:25 UTC (rev 12580) @@ -2106,7 +2106,7 @@ <para> Sections of text can have an underline or overline appended. For - example, the string &over-under; is obtained by specifying + example, the string S̅(f̲r̲e̲q̲) is obtained by specifying <literal>"#+S#+(#-freq#-)"</literal>. </para> @@ -2274,6 +2274,85 @@ STRING/></literal> as appropriate. </para> + <para> + It should be emphasized that the unicode escape sequences + above only work properly for modern unicode-aware devices such as the + svg device or the very large set of cairo and qt devices. And for + those devices the alternative of simply specifying the unicode symbols + using UTF-8 encoding of PLplot input strings is much more convenient + for users than using the above escape sequences. For example, we + use UTF-8 strings rather than escape sequences in example 24 + to render the word "Peace" in several different languages. + </para> + + <table frame="all" id="peace"> + <title>The word "peace" expressed in several different languages in example 24 using UTF-8</title> + <tgroup align="center" cols="2"> + <colspec align="center" colnum="1" colwidth="2*"/> + <tbody valign="top"> + <row> + <entry>Hebrew</entry> + <entry>שלום</entry> + </row> + <row> + <entry>French</entry> + <entry>Paix</entry> + </row> + <row> + <entry>Kurdish</entry> + <entry>Hasîtî</entry> + </row> + <row> + <entry>English</entry> + <entry>Peace</entry> + </row> + <row> + <entry>Korean</entry> + <entry>평화</entry> + </row> + <row> + <entry>Turkish</entry> + <entry>Barış</entry> + </row> + <row> + <entry>Hindi</entry> + <entry>शांति</entry> + </row> + <row> + <entry>German</entry> + <entry>Friede</entry> + </row> + <row> + <entry>Arabic</entry> + <entry>ﺳﻼم</entry> + </row> + <row> + <entry>Mandarin</entry> + <entry>和平</entry> + </row> + <row> + <entry>Russian</entry> + <entry>Мир</entry> + </row> + <row> + <entry>Spanish</entry> + <entry>Paz</entry> + </row> + </tbody> + </tgroup> + </table> + + <para> + For unicode-aware devices it is possible as well to specify + mathematical glyphs (such as ∂, ∇, ∑, ∫, and ∰) using UTF-8 encoding + of PLplot input strings. A typical input method in this case is + simply to cut and paste the desired mathematical glyph from, e.g., + gucharmap to source code being edited by a unicode-aware editor such + as emacs. Such input methods may be conveniently used, for example, + to specify the very wide range of mathematical symbols that are + typically desired for scentific plots. + </para> + </sect2> <sect2 id="character-size"> This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site. |