README
上传用户:qdrechuli
上传日期:2022-08-01
资源大小:917k
文件大小:8k
源码类别:

视频捕捉/采集

开发平台:

Visual C++

  1. GD.pm A perl5 interface to Thomas Boutell's gd library.
  2. ABSTRACT:
  3. This is a autoloadable interface module for libgd, a popular library
  4. for creating and manipulating GIF files.  With this library you can
  5. create GIF images on the fly or modify existing files.  Features
  6. include:
  7. a.  lines, polygons, rectangles and arcs, both filled and unfilled
  8. b.  flood fills
  9. c.  the use of arbitrary images as brushes and as tiled fill patterns
  10. d.  line styling (dashed lines and the like)
  11. e.  horizontal and vertical text rendering
  12. f.  support for transparency and interlacing
  13. For full information on usage, see the accompanying man and html
  14. documentation.
  15. COPYRIGHT INFO
  16. The GD.pm interface is copyright 1995, Lincoln D. Stein.  You are free
  17. to use it for any purpose, commercial or noncommercial, provided that
  18. if you redistribute the source code this statement of copyright
  19. remains attached.  Code from the gd graphics library is covered
  20. separately, under a 1994 copyright by Quest Protein Database Center,
  21. Cold Spring Harbor Labs, and by Thomas Boutell.
  22. THE LATEST VERSION IS 1.16
  23. WHAT'S NEW IN 1.16
  24. - Patches from Andreas Koenig to use FileHandle correctly (also fixes problems
  25. with mod_perl).
  26. WHAT'S NEW IN 1.16
  27. - Patches from Ulrich Pfeifer to allow to compile
  28.   correctly with FastCGI
  29. - Patches from Douglas Wegscheid to avoid multiple defined
  30.   symbol problems under NetBSD
  31. - Patches from Weinfriend Koenig to fix problems in filled polygons,
  32.   plus new routines for scaling, translating and rotating polygons.
  33. WHAT'S NEW IN 1.14
  34. - Modified gd library now included in the package.
  35. - Performance improvements.
  36. - Extensive code cleanup.
  37. - Runs correctly with FastCGI.
  38. INSTALLATION:
  39. 1.  You'll need perl 5.003 or higher (5.004 is recommended).
  40.     Perl is available from:
  41.      
  42. a. Larry Wall's FTP site:
  43.            ftp://ftp.netlabs.com/pub/outgoing/perl5.0
  44. b. the CPAN archives:
  45.    http://www.perl.com/CPAN/
  46.     Unlike previous versions of this package, you no longer need
  47.     the C-language version of libgd.  This package comes with a
  48.     version of libgd that has been specially modified to work well
  49.     with Perl.
  50. 2.  Unpack the tar file:
  51. zcat GD-1.16.tar.gz | tar xvf -
  52.     This will create the directory GD-1.16. Do NOT install this directory
  53.     into the Perl source tree.
  54. 3.  To compile GD.pm on a system that supports dynamic linking:
  55. a.  cd GD-1.16
  56. b.  perl Makefile.PL
  57. c.  make
  58. d.  make install
  59.     This will create GD.pm and copy it and its dynamically loadable module 
  60.     GD.so into the Perl library tree.  You'll need root privileges to do
  61.     the install step.  If you don't have them, see below.
  62. 4.  To compile GD.pm statically on systems that do not support dynamic
  63.     linking (I think this includes Windows NT):
  64. a.  cd GD-1.16
  65.         b.  perl Makefile.PL
  66.         c.  make perl
  67.         d.  make inst_perl
  68.      This will create a new version of Perl and install it in your system
  69.      binaries directory, OVERWRITING THE PREVIOUS VERSION OF PERL.  If you'd
  70.      like to install Perl under a different name, such as "gdperl",
  71.      follow this recipe:
  72. a.  cd GD-1.16
  73.         b.  perl Makefile.PL MAP_TARGET=gdperl
  74.         c.  make gdperl
  75.         d.  make inst_perl
  76. 5.  Before you install GD, you may want to run the regression tests.  You
  77.     can do this after the "make" step by typing:
  78. make test
  79. 6.  There are some demos you can run in ext/GD/demos.  They print GIF
  80.     files to standard output.  To view the files, pipe their
  81.     output to "display" or "xv" in this way:
  82. a.  cd GD-1.16/demos
  83. b   perl shapes.pl | xv -
  84. 7.  See demos/gd_example.cgi for an example of how to use GD to create
  85.     a picture dynamically with a CGI script.  It's intended to be run
  86.     under a Web server.  To see it work, install it in your server's
  87.     cgi-bin/ directory and invoke it from a browser by fetching a URL like:
  88. http://your.site/cgi-bin/gd_example.cgi
  89. INSTALLING GD IN YOUR HOME DIRECTORY
  90. IF YOU DON'T HAVE PRIVILEGES TO INSTALL GD.pm in your system's main
  91. Perl library directory, don't despair.  You can install it into your
  92. home directory using the following feature of Makefile.PL:
  93. a.  cd GD-1.16
  94. b.  perl Makefile.PL INSTALLDIRS=site 
  95.                              INSTALLSITELIB=/home/fred/lib 
  96.                              INSTALLSITEARCH=/home/fred/lib/arch
  97. c.  make
  98. d.  make install
  99. You'll now need to modify your GD-using scripts to tell Perl where to
  100. find GD.  This example assumes that your home directory is at path
  101. "/home/fred"; change it as appropriate.
  102. #!/usr/local/bin/perl
  103.         use lib '/home/fred/lib/perl/lib',
  104.         '/home/fred/lib/perl/arch';
  105.         use GD;
  106. ... etc ...
  107. USING GD WITH FAST CGI
  108. FastCGI is a protocol from OpenMarket Corporation that markedly speeds
  109. up the execution of CGI scripts.  To use FastCGI with Perl scripts,
  110. you need a specially-modified version of the Perl interpreter which
  111. you can obtain in binary and/or source form from:
  112. http://www.openmarket.com/
  113. To use GD with a FastCGI version of Perl you'll need to recompile it
  114. using the modified Perl.  In this example, I assume that this version
  115. of Perl is found at '/usr/local/fcgi/bin/perl': modify as appropriate
  116. for your system.
  117. a. cd GD-1.16
  118. b. edit Makefile.PL and uncomment the line 
  119.                'DEFINE' => '-DFCGI'
  120.         c. /usr/local/fcgi/bin/perl Makefile.PL
  121.         d. make
  122.         e. make install
  123. IF YOU RUN INTO PROBLEMS
  124. Some versions of Unix and Unix-like systems such as Linux ship with an
  125. incomplete version of the Perl distribution.  If you get warnings such
  126. as "Module ExtUtils::MakeMaker not found", you may have such a
  127. system.  Your only option is to obtain the full Perl distribution and
  128. reinstall it.
  129. If the make and install all seem to go well but you get errors like
  130. "Fatal error: can't load module GD.so", or "Fatal error: unknown
  131. symbol gdFontSmall" when you try to run a script that uses GD, you may
  132. have problems with dynamic linking.  Check whether other
  133. dynamically-linked Perl modules such as POSIX and DB_File run
  134. correctly.  If not, then you'll have to link Perl statically, as
  135. described above.
  136. If you have problems and can't solve it on your own, post a message to
  137. the newsgroup "comp.lang.perl.modules".  There are some systems that
  138. require obscure compiler and linker options in order to compile
  139. correctly, and unfortunately I have a limited number of systems at my
  140. disposal.  You're much more likely to get correct answers from the
  141. gurus on the newsgroup than from myself.
  142. THE QUICKDRAW LIBRARY
  143. Also included in this package is qd.pl, a package of Quickdraw
  144. routines.  If you are familiar with the Quickdraw Macintosh library,
  145. you can create Macintosh pictures (complete with scaleable fonts,
  146. draggable objects, etc. etc.) directly in Perl.  See README.QUICKDRAW
  147. and qd.pl for more information.
  148. FREQUENTLY ASKED QUESTIONS
  149. 1. Are there plans to include additional fonts in GD?
  150.    Maybe some day.  Not soon.  This is Thomas Boutell's provenance.
  151. 2. Is there a utility to convert {True Type, X Windows, Postscript}
  152. fonts into GD fonts.
  153.    No.
  154. 3. Does GD run with MacPerl?
  155.    Yes.  The latest MacPerl binaries come with GD already compiled in and
  156.    ready to go.
  157. 4. Are there any Windows NT binaries of GD?
  158.    David Roth has done a port to Windows NT/95.  You can find it at:
  159. http://roth.net/users/rothd/HOME.HTM
  160.    Be sure to download the .DLL library version that is correct for your
  161.    Perl interpreter.  If there is a mismatch, you may encounter a
  162.    "parse error" message.
  163. 5. GD won't compile on system XX.
  164.    The most frequent problem is missing or redundant symbols during the link.
  165.    If you get an error about missing math symbols (usually "floor"), then
  166.    uncomment the line in Makefile.PL that starts with 'LIBS'.  If you get an
  167.    error about multiple redundant symbols, then comment out the line.
  168. BUG REPORTS
  169. Feel free to contact me via e-mail.
  170. UPDATES:
  171. The current version of GD can be found at:
  172.    http://www.genome.wi.mit.edu/pub/software/WWW/GD.html
  173. AUTHOR:
  174. Lincoln Stein
  175. lstein@w3.org
  176. http://www.genome.wi.mit.edu/~lstein