aboutsummaryrefslogtreecommitdiff
path: root/Perl/README
blob: e0905497abb356a05686aec91ff0770759f5692e (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
Tk::Zinc - another Canvas which proposes many new functions, some based on openGL

Tk::Zinc for Perl/Tk is available for Linux, Windows and MacOSX. 
the easiest way could be to use he CPAN. However new releases are usually 
first available on www.tkzinc.org/


* On a Linux system, you need Perl (>= 5.6) and perl-tk (800 or 804) packages.

* On MacOSX you need:
  - fink with tk-pm package and its dependencies (http://fink.sf.net)
    tk-pm is available in unstable. You can add this binary unstable tree to you /sw/etc/apt/sources.list:
    deb http://fink.opendarwin.org/bbraun 10.3/unstable main crypto
    deb http://fink.opendarwin.org/bbraun 10.3/stable main crypto
  - X11 et X11 sdk from Apple (http://www.apple.com/macosx/x11/)

* On WinXP you need:
  - perl and perl-tk 804, 
  - Visual C++ or the Free Visual C++ Command Line Tools



Install:

  perl Makefile.PL
  # you can use the following options: --with-gl=yes|no --with-om=yes|no --with-shape=yes|no
  # current defaults are  --with-gl=yes --with-om=yes --with-shape=yes

  make
  make test

  # to run demos before installing:
  perl -Iblib/arch -Iblib/lib demos/zinc-demos

  make install



WATCH OUT! On Linux it is quite frequent to have both Mesa and proprietary
           openGL libraries installed. This may lead to big problems at
           runtime if the linker picks the wrong library. It is often the
           the case between the static (libGL.a) Mesa library and the dynamic
           (libGL.so) NVidia library. It is very important to assert that
           the link is done with the library matching the openGL driver
           loaded in the X server.


up-to-date documentation is also available at http://www.tkzinc.org/index.php/Main/Documentation
You will find there the reference manual, a FAQ, a mailing list, its archive
etc...
The source of the reference manual is available in the full source package,
which also includes TkZinc for Tcl/Tk, for Perl/Tk, and for Python (Python binding
are now obsoletes).


After installation, we recommend you to launch the zinc-demos script,
a frontend to more than 30 small demos.

For more information on building Tk::Zinc, a README is available in 
the tkzinc-*tgz tar file (on Tkzinc web site) used for building all
flavor of TkZinc (ie tcl, perl and python)

This software is delivered under LGPL licence.
For the copyright, please, read the COPYRIGHT file.

For any question on Tk::Zinc usage, build or installation pb,
please send email to zinc@tls.cena.fr 
This mailing list can be subscribed from 
http://www.tkzinc.org/index.php/Main/MailingList. You can
also send a question without subscribing, but you will be asked
for a confirmation to avoid spam on the list!


Authors and Contributors:

Tk::Zinc main author is Patrick Lecoanet
Sub-Modules, demos and documentation have been developped by
Daniel Etienne, Christophe Mertz, Jean-Luc Vinot, with contributions 
from Stéphane Chatty, Céline Schlienger, Alexandre Lemort
Stéphane Conversy contributed to the MacOSX port.
Many others contributed with their bug reports!