jimw Mon Dec 17 17:46:09 2001 EDT
Modified files:
/phpdoc/en/functions image.xml
Log:
*ttf*: document odd (and inconsistent?) way that gd library handles specification of
font. it would be nice if this behaved sanely. c'est la vie.
Index: phpdoc/en/functions/image.xml
diff -u phpdoc/en/functions/image.xml:1.67 phpdoc/en/functions/image.xml:1.68
--- phpdoc/en/functions/image.xml:1.67 Mon Dec 17 05:28:42 2001
+++ phpdoc/en/functions/image.xml Mon Dec 17 17:46:07 2001
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.67 $ -->
+<!-- $Revision: 1.68 $ -->
<reference id="ref.image">
<title>Image functions</title>
<titleabbrev>Image</titleabbrev>
@@ -3023,7 +3023,10 @@
</term>
<listitem>
<simpara>
- The name of the TrueType font file. (Can also be an URL.)
+ The name of the TrueType font file. (Can also be an URL.) Depending on
+ which version of the GD library that PHP is using, it may attempt to
+ search for files that do not begin with a leading '/' by appending
+ '.ttf' to the filename and searching along a library-defined font path.
</simpara>
</listitem>
</varlistentry>
@@ -3145,10 +3148,14 @@
<function>ImageTTFText</function> draws the string
<parameter>text</parameter> in the image identified by
<parameter>im</parameter>, starting at coordinates
- <parameter>x</parameter>, <parameter>y</parameter> (top left is
- 0, 0), at an angle of <parameter>angle</parameter> in color
- <parameter>col</parameter>, using the TrueType font file
- identified by <parameter>fontfile</parameter>.
+ <parameter>x</parameter>, <parameter>y</parameter> (top left is 0, 0), at
+ an angle of <parameter>angle</parameter> in color
+ <parameter>col</parameter>, using the TrueType font file identified by
+ <parameter>fontfile</parameter>. Depending on which version of the GD
+ library that PHP is using, when <parameter>fontfile</parameter> does not
+ begin with a leading '/', '.ttf' will be appended to the filename and
+ the the library will attempt to search for that filename along a
+ library-defined font path.
</para>
<para>
The coordinates given by <parameter>x</parameter>,
