1
PLplot Development Release 5.6.0
2
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
4
This is a stable release of PLplot. It represents the ongoing efforts of the
5
community to improve the PLplot plotting package. Development releases in the
6
5.7.x series will be available every few months. The next full release will
9
If you encounter a problem that is not already documented in the
10
PROBLEMS file, then please send bug reports to PLplot developers via the
11
mailing lists at http://sourceforge.net/mail/?group_id=2915 .
13
Please see the license under which this software is distributed
14
(LGPL), and the disclaimer of all warrantees, given in the COPYING.LIB
21
2. Changes relative to PLplot 5.5.3
28
3. Changes relative to PLplot 5.3.1
30
3.1.1 Deprecated functions
32
3.1.3 Extended cmap0 support
33
3.1.4 The PlplotCanvas Widget for Gnome/GTK Applications
37
3.2.3 GD (png, jpeg, gif)
39
3.2.5 AquaTerm (Mac OS X)
43
4.1 Autotools versions
44
4.2 cf/bootstrap.sh output
48
For detailed instructions on how to build and install PLplot from this
49
tarball, please read the INSTALL file. The basic procedure is to execute
50
the following commands:
56
There are a variety of configuration options, and these are explained
57
in the INSTALL document, and below as required. In particular, if you
58
want to install the PLplot Programmer's Reference Manual, please use:
60
./configure --with-prebuiltdoc
62
Note that it is often helpful to use the --with-pkg-config option if your
63
system has the pkg-config program (typically *nix systems).
66
2. Changes relative to PLplot 5.5.3 (the previous development release)
74
The java interface was reworked to use the PLBOOL type.
78
The language bindings have been extended to Fortran 95. While it is
79
possible to use the F77 bindings in a program that uses the Fortran 95
80
features (as Fortran 95 is almost 100% compatible with FORTRAN 77),
81
there are a few aspects specific to this newer standard that made
82
it worthwhile to support Fortran 95 explicitly:
84
- The API is defined via a module, so that the compiler can now check
86
- It is now possible to pass arrays as assumed-shape arrays. This
87
means: less arguments and less chances for interface errors.
88
- The module also defines specific parameters to describe PLplot
89
options. This way, you can use symbolic names instead of
91
- The floating-point type PLFLT is now available as a KIND parameter,
92
making it possible to use the same code for single and double
93
precision applications - simply declare all real variables
94
using the KIND facility and link with the corresponding version of
97
More information is found in bindings/f95/readme_f95.txt
105
Initial version of a postscript driver that supports TrueType fonts.
106
This allows access to a far greater range of fonts and characters than
107
is possible using purely postscript fonts.
109
The driver requires the LASi, pango and pangoft2 libraries to work.
110
The pango and pangoft2 libraries are widely distributed with most
111
Linux distributions at least. The LASi library is not part of most
112
distributions at this time. The source code can be downloaded from
113
http://eyegene.ophthy.med.umich.edu/lasi/. The library is small and
114
easy to build and install.
116
This driver is disabled by default. To try it you will need to add
117
the --enable-psttf --enable-psttfc options when running configure.
121
Performance improvements have been implemented.
125
Major upgrade that eliminated a number of bugs and added support for unicode
130
Support for UNICODE and anti-aliasing fonts added
133
3. Changes Relative to PLplot 5.3.1 (the previous stable release)
139
3.1.1 Deprecated functions
141
plParseOpts, plHLS_RGB, and plRGB_HLS are now deprecated and will eventually
142
be removed from the API. Use plparseopts, plhlsrgb, and plrgbhls instead
143
for all language interfaces.
148
PLplot now supports unicode text. The escape sequence for unicode
153
where nnn can be decimal or hexadecimal. Escape sequences are also defined
154
to change fonts mid-string.
156
There are known bugs for our unicode font implementation that are
157
listed in a special section of the PROBLEMS file, but the current
158
implementation is good enough so we turn on unicode support by default
159
for the psc, ps, png, gif, jpeg, and gcw devices. Although all examples
160
look better with unicode fonts, the new PLplot unicode capabilities are
161
especially demonstrated in examples x23 and x24. (The latter example
162
requires special fonts to be installed and at run time environment
163
variables have to be set to access them; see the self-documentation of
164
the example 24 source code).
167
3.1.3 Extended cmap0 support.
169
There have been many updates to cmap0 handling in the effort to wipe away
170
all vestiges of the old 16 color limit. The theoretical limit should now
171
be 2^15 colors, since the metafile and tk drivers use a short for
172
communication of the cmap0 index. Should be *plenty* for the given
173
application, i.e. fixing colors for lines, points, labels, and such.
175
Since both the metafile & tk data stream formats have changed due to
176
the change from U_CHAR -> short for cmap0 index representation, the format
177
versions have been upgraded. If you see something like this:
180
Error: incapable of reading output of version 2005a.
181
plr_init: Please obtain a newer copy of plserver.
182
Command code: 1, byte count: 14
183
plr_process1: Unrecognized command code 0
186
then you know it's using the wrong version of plserver (in which case
187
either you didn't install or your path is wrong).
189
The second example program (multiple bindings available) contains
190
a demo of the expanded cmap0 capability.
193
3.1.4 The PlplotCanvas Widget for Gnome/GTK Applications
195
PlplotCanvas is a widget for use in Gnome/GTK applications, and
196
is contained in the libplplotgnome2d library. A specialzed API is
197
provided, and bindings are included for the C and Python programming
198
languages. Special example programs that demonstrate the use of
199
PlplotCanvas in Gnome/GTK applications are given for each language
205
Some of the drivers have undergone important revisions in order to provide
206
unicode support. Several now present TrueType or PostScript fonts by
207
default, which produces higher-quality output than in the past: see the
208
examples from the GD (png) driver on the PLplot Web site at
209
http://plplot.sourceforge.net/examples/index.html .
214
The PostScript driver produces "publication quality" output files. It
215
is unicode-enabled, and Type 1 PostScript fonts are used by default.
216
Although the Type 1 symbol fonts have a significant number of
217
mathemetical symbols available, some key special symbols (squares,
218
triangles) are missing. Thus, by default, Hershey fonts are used to
219
produce the symbols generated by calls to "plpoin" and "plsym", while
220
PostScript fonts are used for calls to PLplot routines that plot text
221
strings (e.g., "plmtex"). If you prefer a pure Hershey font environment,
222
specify -drvopt text=0, and if you prefer a pure Postscript font
223
environment, specify -drvopt hrshsym=0.
228
An initial version of a new PostScript driver that has all the functionality
229
of the current postscript driver and also handles TrueType fonts.
232
3.2.2 GD (png, jpeg, gif)
234
The GD driver is used to produce png, jpeg, and gif files. It is
235
unicode-enabled, and uses TrueType fonts by default. The examples on
236
the PLplot Web site at
237
http://plplot.sourceforge.net/examples/index.html were produced using
243
GCW is a new driver for Gnome 2 that displays plots in a tabbed window.
244
The driver is unicode-enabled, and uses TrueType fonts. The GCW user
245
interface supports zooming, and saves to a variety of output file
246
formats (ps, psc, png, jpg, gif). All of the relevant command-line
247
options for PLplot are supported.
249
A specialized API, which allows interaction with the driver,
250
is provided in libplplotgnome2d. Bindings are provided for the C and
251
Python programming languages.
254
3.2.4 AquaTerm (Mac OS X)
256
AquaTerm is a new driver for Mac OS X that provides PLplot output in
257
the AquaTerm graphics terminal program. Aquaterm is a native Cocoa
258
graphics terminal program for Mac OS X that provides a familiar look and
259
feel to Mac users. More details about AquaTerm and how to install it can
260
be found at http://aquaterm.sourceforge.net/. The driver is unicode-enabled
261
and uses default OS X fonts.
266
The plframe widget (and by extension, the Tk driver) now saves a plot using
267
the correct aspect ratio, as represented by the actual window size. For
268
complicit output drivers only, e.g. png.
273
This is a device driver that runs on the wxWidgets cross-platform GUI (see
274
http://www.wxwidgets.org/) that has been donated by Werner Smekal. The driver
275
is unicode-enabled. It currently provides a limited GUI but additional
276
capabilities are being developed.
279
4. Note on the Autotools that were used for this release
281
4.1 Autotools versions
283
autoconf (GNU Autoconf) 2.59
284
Written by David J. MacKenzie and Akim Demaille.
286
automake (GNU automake) 1.9.6
287
Written by Tom Tromey <tromey@redhat.com>.
289
ltmain.sh (GNU libtool) 1.5.22 (1.1220.2.365 2005/12/18 22:14:06)
291
4.2 cf/bootstrap.sh output
293
Running aclocal (GNU automake) 1.9.6... done
294
Running autoheader (GNU Autoconf) 2.59... done
295
Running libtoolize (GNU libtool) 1.5.22... done
296
Running automake (GNU automake) 1.9.6... done
297
Running autoconf (GNU Autoconf) 2.59... done
298
Regenerating libltdl/aclocal+configure... done
302
PLplot Development Release 5.5.4
303
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
305
This is a routine development release of PLplot, and represents the
306
ongoing efforts of the community to improve the PLplot plotting
307
package. Development releases represent a "work in progress", and
308
we expect to provide installments in the 5.5.x series every few weeks.
309
The next full release will be 5.6.0.
311
If you encounter a problem that is not already documented in the
312
PROBLEMS file, then please send bug reports to PLplot developers via the
313
mailing lists at http://sourceforge.net/mail/?group_id=2915 .
315
Please see the license under which this software is distributed
316
(LGPL), and the disclaimer of all warrantees, given in the COPYING.LIB
322
1. Build Instructions
323
2. Changes relative to PLplot 5.5.3
330
3. Changes relative to PLplot 5.3.1
332
3.1.1 Deprecated functions
334
3.1.3 Extended cmap0 support
335
3.1.4 The PlplotCanvas Widget for Gnome/GTK Applications
338
3.2.2 GD (png, jpeg, gif)
340
3.2.4 AquaTerm (Mac OS X)
345
1. Build Instructions
347
For detailed instructions on how to build and install PLplot from this
348
tarball, please read the INSTALL file. The basic procedure is to execute
349
the following commands:
355
There are a variety of configuration options, and these are explained
356
in the INSTALL document, and below as required. In particular, if you
357
want to install the PLplot Programmer's Reference Manual, please use:
359
./configure --with-prebuiltdoc
361
Note that it is often helpful to use the --with-pkg-config option if your
362
system has the pkg-config program (typically *nix systems).
365
2. Changes relative to PLplot 5.5.3 (the previous development release)
373
PlplotCanvas method wrappers for PLplot functions have dropped
374
the prefix "pl" from the function name. For example, the
375
method plplot_canvas_plline is now plplot_canvas_line.
380
Backwards incompatible API change (with respect to 5.5.3, but not with
381
respect to 5.3.1 since this involves a new feature within the 5.5.x
382
development releases). PL_FCI_MARK changed from 0x10000000 to 0x80000000.
383
This should only affect users who have been inserting absolute FCI (font
384
characterization integer) changes within their strings to change the font in
392
Performance improvements have been implemented.
396
Initial version of a device to run on the wxWidgets cross-platform GUI (see
397
http://www.wxwidgets.org/) has been donated by Werner Smekal. Most examples
398
work out of the box, but some (e.g., a segfault for example 8) currently
399
have problems. More development of this immature device driver is planned.
401
3. Changes Relative to PLplot 5.3.1 (the previous stable release)
407
3.1.1 Deprecated functions
409
plParseOpts, plHLS_RGB, and plRGB_HLS are now deprecated and will eventually
410
be removed from the API. Use plparseopts, plhlsrgb, and plrgbhls instead
411
for all language interfaces.
416
PLplot now supports unicode text. The escape sequence for unicode
421
where nnn can be decimal or hexadecimal. Escape sequences are also defined
422
to change fonts mid-string.
424
There are known bugs for our unicode font implementation that are
425
listed in a special section of the PROBLEMS file, but the current
426
implementation is good enough so we turn on unicode support by default
427
for the psc, ps, png, gif, jpeg, and gcw devices. Although all examples
428
look better with unicode fonts, the new PLplot unicode capabilities are
429
especially demonstrated in examples x23 and x24. (The latter example
430
requires special fonts to be installed and at run time environment
431
variables have to be set to access them; see the self-documentation of
432
the example 24 source code).
435
3.1.3 Extended cmap0 support.
437
There have been many updates to cmap0 handling in the effort to wipe away
438
all vestiges of the old 16 color limit. The theoretical limit should now
439
be 2^15 colors, since the metafile and tk drivers use a short for
440
communication of the cmap0 index. Should be *plenty* for the given
441
application, i.e. fixing colors for lines, points, labels, and such.
443
Since both the metafile & tk data stream formats have changed due to
444
the change from U_CHAR -> short for cmap0 index representation, the format
445
versions have been upgraded. If you see something like this:
448
Error: incapable of reading output of version 2005a.
449
plr_init: Please obtain a newer copy of plserver.
450
Command code: 1, byte count: 14
451
plr_process1: Unrecognized command code 0
454
then you know it's using the wrong version of plserver (in which case
455
either you didn't install or your path is wrong).
457
The second example program (multiple bindings available) contains
458
a demo of the expanded cmap0 capability.
461
3.1.4 The PlplotCanvas Widget for Gnome/GTK Applications
463
PlplotCanvas is a widget for use in Gnome/GTK applications, and
464
is contained in the libplplotgnome2d library. A specialzed API is
465
provided, and bindings are included for the C and Python programming
466
languages. Special example programs that demonstrate the use of
467
PlplotCanvas in Gnome/GTK applications are given for each language
473
Some of the drivers have undergone important revisions in order to provide
474
unicode support. Several now present TrueType or PostScript fonts by
475
default, which produces higher-quality output than in the past: see the
476
examples from the GD (png) driver on the PLplot Web site at
477
http://plplot.sourceforge.net/examples/index.html .
482
The PostScript driver produces "publication quality" output files. It
483
is unicode-enabled, and Type 1 PostScript fonts are used by default.
484
Although the Type 1 symbol fonts have a significant number of
485
mathemetical symbols available, some key special symbols (squares,
486
triangles) are missing. Thus, by default, Hershey fonts are used to
487
produce the symbols generated by calls to "plpoin" and "plsym", while
488
PostScript fonts are used for calls to PLplot routines that plot text
489
strings (e.g., "plmtex"). If you prefer a pure Hershey font environment,
490
specify -drvopt text=0, and if you prefer a pure Postscript font
491
environment, specify -drvopt hrshsym=0.
494
3.2.2 GD (png, jpeg, gif)
496
The GD driver is used to produce png, jpeg, and gif files. It is
497
unicode-enabled, and uses TrueType fonts by default. The examples on
498
the PLplot Web site at
499
http://plplot.sourceforge.net/examples/index.html were produced using
505
GCW is a new driver for Gnome 2 that displays plots in a tabbed window.
506
The driver is unicode-enabled, and uses TrueType fonts. The GCW user
507
interface supports zooming, and saves to a variety of output file
508
formats (ps, psc, png, jpg, gif). All of the relevant command-line
509
options for PLplot are supported.
511
A specialized API, which allows interaction with the driver,
512
is provided in libplplotgnome2d. Bindings are provided for the C and
513
Python programming languages.
516
3.2.4 AquaTerm (Mac OS X)
518
AquaTerm is a new driver for Mac OS X that provides PLplot output in
519
the AquaTerm graphics terminal program. Aquaterm is a native Cocoa
520
graphics terminal program for Mac OS X that provides a familiar look and
521
feel to Mac users. More details about AquaTerm and how to install it can
522
be found at http://aquaterm.sourceforge.net/.
524
The driver is unicode-enabled and uses default OS X fonts.
526
To install the AquaTerm driver, use the options "--disable-dyndrivers"
527
and "--disable-f77" during the configure step of the install process.
532
The plframe widget (and by extension, the Tk driver) now saves a plot using
533
the correct aspect ratio, as represented by the actual window size. For
534
complicit output drivers only, e.g. png.
538
Initial version of a device to run on the wxWidgets cross-platform GUI (see
539
http://www.wxwidgets.org/) has been donated by Werner Smekal. Most examples
540
work out of the box, but some (e.g., a segfault for example 8) currently
541
have problems. More development of this immature device driver is planned.
546
PLplot Development Release 5.5.2
547
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
549
This is a routine development release of PLplot, and represents the
550
ongoing efforts of the community to improve the PLplot plotting
551
package. Development releases represent a "work in progress", and
552
we expect to provide installments in the 5.5.x series every few weeks.
553
The next full release will be 5.6.0.
555
If you encounter a problem that is not already documented in the PROBLEMS
556
file then please send bug reports to PLplot developers via the mailing lists
557
at http://sourceforge.net/mail/?group_id=2915 .
559
Please see the license under which this software is distributed, and the
560
disclaimer of all warrantees, given in the COPYING.LIB file.
565
1. Build Instructions
566
2. Changes Relative to PLplot 5.5.1
569
3. Changes Relative to PLplot 5.3.1
572
3.1.2 Extended cmap0 support
575
3.2.2 GD (png, jpeg, gif)
576
3.2.3 GCW "Gnome Canvas Widget"
577
3.2.4 AquaTerm (Mac OS X)
581
1. Build Instructions
583
For detailed instructions on how to build and install PLplot from this
584
tarball, please read the INSTALL file. The basic procedure is to execute
585
the following commands:
591
There are a variety of configuration options, and these are explained in the
592
INSTALL document, and below as required. In particular, if you want to
593
install the PLplot Programmer's Reference Manual (which is required for
594
documentation on any new feature since PLplot 5.3.1), you must use:
596
./configure --with-prebuiltdoc
598
Note that it is often helpful to use the --with-pkg-config option if your
599
system has the pkg-config program (typically *nix systems).
602
2. Changes Relative to our last development release, PLplot 5.5.1
604
Progress toward our next major release with documentation improvements and a
605
substantial number of minor tweaks and bug fixes.
617
3. Changes Relative to our last stable release, PLplot 5.3.1
625
PLplot now allows unicode text, and this is detailed in the PLplot
626
Programmers Reference Manual in the section on "Setting Character
627
Attributes". The escape sequence for unicode characters is
631
where nnn can be decimal or hexadecimal. Escape sequences are also defined
632
to change fonts mid-string.
634
There are known bugs for our unicode font implementation that are listed in
635
a special section of the PROBLEMS file, but the current implementation is
636
good enough so we turn on unicode support by default for the psc, ps, png,
637
gif, jpeg, and gcw devices. Although all examples look better with unicode
638
fonts, the new PLplot unicode capabilities are especially demonstrated in
639
examples x23 and x24. (The latter example requires special fonts to be
640
installed and at run time environment variables have to be set to access
641
them, see the self-documentation of the example 24 source code).
644
3.1.2 Extended cmap0 support.
646
There have been many updates to cmap0 handling in the effort to wipe away all
647
vestiges of the old 16 color limit. The theoretical limit should now be 2^15
648
colors, since the metafile and tk drivers use a short for communication of the
649
cmap0 index. Should be *plenty* for the given application, i.e. fixing colors
650
for lines, points, labels, and such.
652
Since both the metafile & tk data stream formats have changed due to the
653
change from U_CHAR -> short for cmap0 index representation, the format
654
versions have been upgraded. If you see something like this:
657
Error: incapable of reading output of version 2005a.
658
plr_init: Please obtain a newer copy of plserver.
659
Command code: 1, byte count: 14
660
plr_process1: Unrecognized command code 0
663
then you know it's using the wrong version of plserver (in which case either
664
you didn't install or your path is wrong).
666
The second example program (multiple bindings available) contains a demo of
667
the expanded cmap0 capability.
672
Some of the drivers have undergone important revisions in order to provide
673
unicode support. Several now present TrueType or PostScript fonts by
674
default, which produces higher-quality output than in the past: see the
675
examples from the GD (png) driver on the PLplot Web site at
676
http://plplot.sourceforge.net/examples/index.html .
681
The PostScript driver is unicode-enabled, and Type 1 PostScript fonts are
682
used by default. Although the Type 1 symbol fonts do have a significant
683
number of mathemetical symbols available some key special symbols (squares,
684
triangles) are missing so that by default Hershey fonts are used to produce
685
the symbols generated by calls to "plpoin" and "plsym" while PostScript
686
fonts are used for calls to PLplot routines that plot text strings (e.g.,
687
"plmtex"). If you prefer a pure Hershey font environment, specify -drvopt
688
text=0, and if you prefer a pure Postscript font environment, specify
691
Tranforms to the text (i.e., rotations, shears)
692
have been dramatically improved, and the PostScript driver now produces
693
"publication quality" output with the default PostScript fonts for text
694
and Hershey fonts for special symbols.
697
3.2.2 GD (png, jpeg, gif)
699
The GD driver is unicode-enabled, and uses TrueType fonts by default. The
700
examples on the PLplot Web site at
701
http://plplot.sourceforge.net/examples/index.html were produced using this
705
3.2.3 GCW "Gnome Canvas Widget"
707
The GCW "Gnome Canvas Widget" is a new driver that provides PLplot output in
708
a tabbed Gnome window. It can alternatively be used to drive a special
709
widget called the PlplotCanvas that can be embedded in Gnome applications.
710
The driver, associated widget, and specialized API are fully documented in
711
the PLplot Programmer's Reference Manual in the sections titled "The GCW
712
Driver" and "Embedding Plots in Gnome/GTK Applications", respectively.
714
The GCW driver is unicode-enabled, and uses TrueType fonts by default.
716
Special examples that demonstrate the use of the PlplotCanvas are provided
717
for both the C and Python programming languages.
719
To install the GCW driver, use the "--enable-gcw" option during the
720
configure step of the install process.
722
For more information on GTK, see http://www.gtk.org/ .
725
3.2.4 AquaTerm (Mac OS X)
727
AquaTerm is a new driver that provides PLplot output in the AquaTerm
728
graphics terminal program. Aquaterm is a native Cocoa graphics terminal
729
program for Mac OS X that provides a familiar look and feel to Mac users.
730
More details about AquaTerm and how to install it can be found at
731
http://aquaterm.sourceforge.net/.
733
The driver is unicode-enabled, however it currently only supports the
734
default OS X fonts which are not TrueType.
736
To install the AquaTerm driver, use the options "--disable-dyndrivers" and
737
"--disable-f77" during the configure step of the install process.
742
The plframe widget (and by extension, the Tk driver) now saves a plot using the
743
correct aspect ratio, as represented by the actual window size. For complicit
744
output drivers only, e.g. png.
749
PLplot Development Release 5.5.1
750
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
752
This is a routine development release of PLplot, and represents the
753
ongoing efforts of the community to improve the PLplot plotting
754
package. Development releases represent a "work in progress", and
755
we expect to provide installments in the 5.5.x series every few weeks.
756
The next full release will be 5.6.0.
758
Feedback on this development release can be communicated to PLplot
759
developers via the mailing lists at
760
http://sourceforge.net/mail/?group_id=2915 .
762
Please see the license under which this software is distributed, and the
763
disclaimer of all warrantees, given in the COPYING.LIB file.
768
1. Build Instructions
775
1. Build Instructions
777
For detailed instructions on how to build and install PLplot from this
778
tarball, please read the INSTALL file. The basic procedure is to execute
779
the following commands:
785
There are a variety of configuration options, and these are explained in the
786
INSTALL document, and below as required. In particular, if you want to
787
install the PLplot Programmer's Reference Manual (which is required for
788
documentation on any new feature since PLplot 5.3.1), you must use:
790
./configure --with-prebuiltdoc
792
Note that it is often helpful to use the --with-pkg-config option if your
793
system has the pkg-config program (typically *nix).
798
Due to unresolved problems in the build process, tcl has been temporarily
799
disabled for this release.
801
If you must have tcl, here are the instrutions. DO NOT ATTEMPT THIS
802
UNLESS YOU ARE SURE YOU KNOW WHAT YOU ARE DOING.
804
1) Move all plplot files in /usr/lib and /usr/local/lib into a
807
2) Use the --enable-tcl and --enable-itcl options during configure.
821
PLplot Development Release 5.5.0
822
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
824
This is a routine development release of PLplot, and represents the ongoing efforts of the community to improve the PLplot plotting package. The next full release will be 5.6.0.
829
1. Build Instructions
835
2.2.2 GD (png, jpeg, gif)
836
2.2.3 GCW "Gnome Canvas Widget"
839
1. Build Instructions
841
For detailed instructions on how to build and install PLplot from this tarball, please read the INSTALL file. The basic procedure is to execute the following commands:
847
There are a variety of configuration options, and these are explained in the INSTALL document, and below as required. In particular, if you want to build and install the PLplot Programmer's Reference Manual (which is required for documentation on any new feature since PLplot 5.3.1), you must use:
849
./configure --enable-builddoc
851
Detailed instructions on building the documentation, including the packages that you will need for a successful build, are provided in this tarball under doc/docbook/README.developers.
862
PLplot now allows unicode text, and this is detailed in the PLplot Programmers Reference Manual in the section on "Setting Character Attributes". The escape sequence for unicode characters is
866
where nnn can be decimal or hexdecimal. Escape sequences are also defined to change fonts mid-string.
868
The new unicode capabilities are demonstrated in example x23.
873
Some of the drivers have undergone important revisions in order to provide unicode support. Several now present truetype or postscript fonts by default, which produces higher-quality output than in the past: see the examples from the GD (png) driver on the PLplot Web site at http://plplot.sourceforge.net/examples/index.html.
878
The PostScript driver is unicode-enabled, and Type 1 PostScript fonts are used by default. Because many symbols are missing from the Type 1 PostScript fonts, Hershey fonts are used for calls to "plpoin". Tranforms to the text (i.e., rotations, shears) have been dramatically improved, and the PostScript driver now produces "publication quality" output.
881
2.2.2 GD (png, jpeg, gif)
883
The GD driver is unicode-enabled, and uses truetype fonts by default. The examples on the PLplot Web site at http://plplot.sourceforge.net/examples/index.html were produced using this driver.
886
2.2.3 GCW "Gnome Canvas Widget"
888
The GCW "Gnome Canvas Widget" is a new driver that provides PLplot output in a tabbed Gnome window. It can alternatively be used to drive a special widget called the PlplotCanvas that can be embedded in Gnome applications. The driver, associated widget, and specialized API are fully documented in the PLplot Programmer's Reference Manual in the sections titled "The GCW Driver" and "Embedding Plots in Gnome/GTK Applications", respectively.
890
The GCW driver is unicode-enabled, and uses truetype fonts by default.
892
Special examples that demonstrate the use of the PlplotCanvas are provided for both the C and Python programming languages.
894
To install the GCW driver, use the "--enable-gcw" option during the configure step of the install process.