File: README

package info (click to toggle)
libgd-text-perl 0.82-1
  • links: PTS
  • area: main
  • in suites: woody
  • size: 148 kB
  • ctags: 59
  • sloc: perl: 811; makefile: 51
file content (65 lines) | stat: -rw-r--r-- 2,006 bytes parent folder | download
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
This are Text utilities for use with the GD drawing package. This
package provides three modules:

GD::Text:
    Provides information about a font, irrespective of whether the font
    is a TTF or builtin font.

GD::Text::Align
    Align a string around a coordinate, left, right, center, top, bottom
    or center.

GD::Text::Wrap
    Wrap a long string between a right and left margin, starting at a
    certain y coordinate. Layout the text flush left, flush right,
    center, or justified.

Requirements:

	perl 5.005_03 or higher, preferably 5.6. It may work on older
	versions, but it has not been tested, and I won't spend a lot of
	time trying to support it.

	GD 1.20 or up, built for TTF (freetype) support.

	Please note that the freetype version 2 libraries should be at
	the latest level. Especially version 2.0.3 has an annoying bug
	that rotates text twice.

Installation:

    perl Makefile.PL
    make
    make test
    make demo
    make install

Demo(s) can be found in the demo directory.

DO NOT PANIC when the tests fail. The various Freetype libraries often
have a slightly different implementation of their rendering algorithms,
resulting in slightly different bounding boxes for strings, and slightly
diffferent looking images. If your tests fail, try a 'make demo', and
visually compare demo/GDWrap.png (freshly generated image) and
demo/GDWrap.ref.png (reference image). If they look reasonably similar,
you can call the tests successful. Even if they don't look entirely
similar, it may simply be because your font files are different from the
ones I used to create GDWrap.ref.png. Please see the sources.

Todo:

- Make the interface more flexible
- Alignment for the wrap boxes as a whole
- More demo code
    
COPYRIGHT

Copyright (c) 1999 Martien Verbruggen
mgjv@comdyn.com.au

This package is free software; you can redistribute it and/or
modify it under the same terms as Perl itself.

Enclosed font: 
    Cetus by Greg Meronek, downloaded from http://www.fontpool.com/